Veritas NetBackup™ Administrator's Guide, Volume II

Manually generating licensing reports

You can manually generate reports for either the capacity or the traditional reporting model. The utility is located in the following directory:

On Windows: Install_dir\NetBackup\bin\admincmd\

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

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

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]
      [--anonymize | --anonymize -anon-master=SOME_NAME]

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:

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 on 90 days 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

For capacity licensing reports for any agents that support the accurate licensing method, use the overlap option to detect any data that NetBackup protects with multiple policies. To enable overlap detection, run the nbdeployutil report with the --overlap-details option.

If you used scripts to automate data gathering before NetBackup 8.0, these scripts must be updated when you upgrade. The data gathering process requires that you enter the credentials for the NetBackup web service.

See Providing web service credentials for the capacity licensing report.

In this example, the nbdeployutil utility gathers information for the local master server.

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

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