Veritas NetBackup™ Administrator's Guide, Volume II

To use custom values in the nbdeployutilconfig.txt file

1. Based on your operating system, copy the nbdeployutilconfig.txt file to the following location:

   For Windows: Install_Dir\NetBackup\var\global

   For UNIX: /usr/openv/var/global

2. Open and edit nbdeployutilconfig.txt to change the parameters and then save the file.

   • FREQUENCY_IN_DAYS=number_of_days

     Based on the frequency you set here, nbdeployutil gathers the data and generates the report.

     Minimum value: 1 day.

     By default, the frequency value in the configuration file is set as 7 days to capture optimum capacity usage data.

     • If there is no value in this parameter, nbdeployutil uses the default value.

     • If you specify the frequency as 0, incremental reporting is disabled and no licensing information is captured.

     • If you delete the parameter, nbdeployutil uses the default value.

   • MASTER_SERVERS=server_names

     nbdeployutil gathers the information for each master server list and generates the report.

     • If there is no value in this parameter, nbdeployutil uses the default value.

     • If you delete the parameter, nbdeployutil uses the default value.

     Examples of server names:

     • MASTER_SERVERS=newserver,oldserver

     • MASTER_SERVERS=newserver,oldserver.domain.com

     • MASTER_SERVERS=myserver1.somedomain.com,newserver.domain.com

   • PARENTDIR=folder_name_with_path

     To change the gather and report location, edit this parameter.

     • If there is no value in this parameter, nbdeployutil uses the default value.

     • If you delete the parameter, nbdeployutil uses the default value.

   • PURGE_INTERVAL=number_of_days

     Gathered data that does not fit into the purge_interval value is deleted automatically.

     • If there is no value in this parameter, nbdeployutil uses the default value.

     • If you delete the parameter, nbdeployutil uses the default value.

     • If you specify a value less than 90 days, nbdeployutil uses 90 days as the value for the parameter. Data that is older than 180 days is purged.

       Data to be purged = current date - purge_interval.

       Minimum value = 90 days.

To change the directory of the gathered data and licensing report

1. If you have older gathered data and licensing reports, copy the complete directory to the new location.
2. Edit nbdeployutilconfig.txt and change the location of the gathered data and licensing report in the PARENTDIR=folder_name field.

To use the previously successful gathered data for generating a capacity licensing report

1. Copy the gather folder that was generated after previous run of nbdeployutil to the following location:

   On Windows: Install_Dir\NetBackup\var\global\incremental

   On UNIX: /usr/openv/var/global/incremental

2. Create the gather_end.json file inside the copied folder and add the following text:

   {"success":0}

   The next incremental run considers the data inside the copied folder to generate a capacity licensing report.

   Note:

   You must delete any other gather folders inside the copied folder to avoid gaps for the period in which data is gathered. The missing data is automatically generated during the next incremental run.

To create a custom interval report using existing gathered data

• To create a report for a time interval that is different than the default interval of 90 days, run the following command:

  On Windows:

  nbdeployutil.exe --capacity --incremental --report --inc-settings "<Install_Dir>\netbackup\var\global\nbdeployutilconfig.txt" --hoursago <custom-time-interval>

  On UNIX:

  nbdeployutil.exe --capacity --incremental --report --inc-settings "/usr/openv/var/global/nbdeployutilconfig.txt" --hoursago <custom-time-interval>

  The number of hours specified in --hoursago must be less than the purge-interval that is specified in the nbdeployutilconfig.txt file.

  Note:

  nbdeployutil uses existing gathered data to generate the custom interval report. You are not required to use the --gather command.