Veritas NetBackup™ Administrator's Guide, Volume II

Generating licensing reports manually

Run the nbdeployutil utility to gather data for a local master server, a remote master server, or a subset of clients. nbdeployutil can be run manually to generate a report for either the capacity or the traditional reporting model.

The utility generates the report in multiple steps. Data is gathered in the first step, and then analyzed and presented. The utility is located in the following directory:

On Windows: Install_dir\NetBackup\bin\admincmd\

On UNIX: /usr/openv/netbackup/bin/admincmd/

nbdeployutil --gather [--output=DIRECTORY]
      [--capacity | --traditional] [--hoursago=N]
      [--start="mm/dd/yyyy HH:MM:SS" 
      [--end="mm/dd/yyyy HH:MM:SS"]]
      [--clientlist=FILENAME | --clients=HOSTNAME[,...]]
      [--master=HOSTNAME[,...]] [--log=FILENAME]
      [--runtimestats] [--nolog] [--bpimagelist=OPTIONS]
      [--use-bpflist]

nbdeployutil --report
      <--capacity | --traditional> <directory> ...
      [--dirlist=FILENAME | --parentdir=DIRECTORY]
      [--capacity] [--debug-inputs] [--log=FILENAME]
      [--clientlist=FILENAME | --clients=HOSTNAME[,...]]
      [--day-boundary=TIME] [--runtimestats] [--nolog]
      [--overlap-details]

On the master servers that have NetBackup 8.0 or later, when you manually run nbdeployutil for the gather operation in capacity licensing, you must enter the following credential information for authentication of the NetBackup web management service:

In a multi-master server scenario, you must enter the credentials for all the master servers that are mentioned with the gather command.

The performance of the nbdeployutil utility is dependent on the system running it as well as the size of the NetBackup catalog. The --gather option only executes as quickly as the bpimagelist command can run for 90 days' worth of images. The speed of report generation is dependent on the number of images and fragments. The operating system running the command also affects the utility's performance.

Depending on the environment, the nbdeployutil utility can take from several seconds to several minutes to run the --gather or the --report options.

Veritas posts the most recent information about the nbdeployutil utility on the following website:

http://www.veritas.com/docs/TECH145972

In this example, the nbdeployutil utility is used to gather information for the local master server. Use the --capacity or the --traditional option, depending on the type of report you want to generate

C:\Program Files\Veritas\NetBackup\bin\admincmd>nbdeployutil --gather
NetBackup Deployment Utility, version 8.1
Gathering license deployment information...
  Discovered master server master.example.com
  Master Server:master.example.com
		Domain Type (NIS, NISPLUS, WINDOWS, vx, unixpwd, ldap):WINDOWS
		Domain Name:example.com
		User Name:Administrator
		Password:
		Output for master.example.com at: 
		C:\Program Files\Veritas\NetBackup\var\global\reports\
   20160525_151315_master.example.com
Gather DONE
Execution time: 9 secs
To create a report for this master server, run one of the following:
  capacity   : nbdeployutil.exe --report --capacity 
		"C:\Program Files\Veritas\NetBackup\var\global\reports\
   20160525_151315_master.example.com"
  traditional: nbdeployutil.exe --report --traditional 
		"C:\Program Files\Veritas\NetBackup\var\global\reports\
   20160525_151315_master.example.com"

The utility generates a log file named nbdeployutil-gather-timestamp.log during the gathering operation. By default, the log file is created in the directory where the gathered data resides.

nbdeployutil --gather --master=sidon.example.com

nbdeployutil --gather --client=dynamo,lettuce,marble2

or

nbdeployutil --gather --clientlist=filename.txt

Before you run nbdeployutil in a multi-master servers environment, complete the following steps as a one-time activity: