Scheduling reports for capacity licensing
By default, NetBackup triggers nbdeployutil to run on a specified schedule to incrementally gather data and to generate licensing reports. For the first run, the duration of the report uses the frequency that is specified in the configuration file.
For capacity licensing, the report duration is always for the last 90 days based on the availability of the gathered data. Any data older than 90 days is not considered in the report. Each time nbdeployutil runs, it gathers information for the time between the latest run of nbdeployutil and the previous successful run.
The current capacity licensing report resides in the following directory:
On Windows: install_path\NetBackup\var\global\incremental
On UNIX: /usr/openv/var/global/incremental
It contains the following files:
The generated report for the latest nbdeployutil result.
Folders containing incrementally gathered data.
The archive folder that contains the older generated reports.
nbdeployutil log files.
The older reports are placed in the archive folder. Cohesity recommends that you retain at least 90 days of reporting data. Data can be kept longer than 90 days, depending on the requirements of your environment. Older reports can help to show how the capacity usage has changed over time. Delete the reports or the folder when they are no longer required.
From the NetBackup web UI, you can download the reports that are automatically generated using the nbdeployutil utility. On the web UI, click . For more information, see the NetBackup Web UI Administrator's Guide.
The feature requires that you have sufficient permissions on the gather directory. For the custom path specified in the PARENTDIR configuration setting, ensure that the required read permissions are provided for the NetBackup Web service user. If you delete the default incremental folder and then manually create it, ensure that the required read permissions are provided for the NetBackup Web service user.
The nbdeployutilconfig.txt file is not required when you use the default parameters. nbdeployutil uses the following default values for capacity licensing:
FREQUENCY_IN_DAYS=7
MASTER_SERVERS=local_server
PARENTDIR=folder_name
For Windows: install_path\NetBackup\var\global\incremental
For UNIX: /usr/openv/var/global/incremental
PURGE_INTERVAL=120 (number of days)
MACHINE_TYPE_REQUERY_INTERVAL = 90 (number of days)
If the file nbdeployutilconfig.txt is not present, create a file using the following format:
[NBDEPLOYUTIL_INCREMENTAL] MASTER_SERVERS=<server_names> FREQUENCY_IN_DAYS=7 PARENTDIR=<folder_name_with_path> PURGE_INTERVAL=120 MACHINE_TYPE_REQUERY_INTERVAL=90
To use custom values for the licensing report
- Copy the nbdeployutilconfig.txt file to the following location:
For Windows: install_path\NetBackup\var\global
For UNIX: /usr/openv/var/global
- Open the nbdeployutilconfig.txt file.
- Edit the
FREQUENCY_IN_DAYSvalue to reflect how often you want the report to be created.Default (recommended)
7
Minimum
1
Parameter deleted
nbdeployutil uses the default value.
Note:
If you enter a value that is less than 1, nbdeployutil automatically uses 7, which is the default value.
- Edit the
MASTER_SERVERSvalue to include a comma-separated list of the primary servers you want to include in the report.Note:
Cohesity Usage Insights requires that primary servers be at NetBackup 8.1.2 or later.
No value
nbdeployutil uses the default value.
Parameter deleted
nbdeployutil uses the default value.
For example:
MASTER_SERVERS=newserver, oldserver
MASTER_SERVERS=newserver, oldserver.domain.com
MASTER_SERVERS=myserver1.somedomain.com, newserver.domain.com
- Edit the
PARENTDIRvalue to include the full path for location where the data is gathered and reported.No value
nbdeployutil uses the default value.
Parameter deleted
nbdeployutil uses the default value.
- Edit the
PURGE_INTERVALto indicate the interval (in days) for how often you want to delete the report data. Data that is older than 120 days is automatically purged.Default
120
Minimum
90
No value
nbdeployutil uses the default value.
Parameter deleted
nbdeployutil uses the default value.
- Edit the
MACHINE_TYPE_REQUERY_INTERVALto indicate how often to scan physical clients for updates to the machine type.Default
90
Minimum
1
No value
nbdeployutil uses the default value.
Parameter deleted
nbdeployutil uses the default value.