Problem
To support better performance in the activity monitor in the Web UI, NetBackup is caching job data in memory. When the job cache reaches a threshold of 17% of total available memory, an alert is generated warning an administrator that system performance may be impacted.
The alert will appear once every 30 days provided the cache size remains above 17% at the time of the next warning interval. If the job cache consumes an extremely large amount of available heap space, the web server may become unresponsive.
Error Message
The activity monitor job cache is using a large amount of heap space. System performance may be impacted. See <Tech Note> for more details.
Cause
A large number of jobs are being cached in memory.
Solution
If system performance is impacted, an administrator can do one or more of the following:
- Change the number of hours jobs that are retained in NetBackup to reduce the number of cached jobs. Default is 78.
- KEEP_JOBS_HOURS
- KEEP_JOBS_SUCCESSFUL_HOURS
- Increase the Xmx heap size for the NetBackup web server by changing the WMC_HEAP variable. Default is 3072m.
- Windows: <NetBackup Install Dir>\wmc\webserver\bin\setenv.bat
- UNIX: <NetBackup Install Dir>/netbackup/bin/nbwmc
Note:
Before NetBackup 9.0, any web service Java Virtual Machine (JVM) tuning values (such as memory allocation) are overwritten during NetBackup upgrades. In NetBackup 9.0, Veritas has defined a set of web server JVM tuning options that persist across upgrades. These options are defined as environment variables in an executable shell script that is stored on the local host. The script's contents override the out of the box JVM tuning options. The script only runs when the NetBackup 9.0 or later web service starts. You can configure the options for which you want to override the default values. You can define this script at any time. Once the values are defined, you do not need to redefine them in any future upgrades.
To define the persistent JVM tuning options:
- Create the
wmcConfig
script in the appropriate NetBackup configuration directory:Windows: install_path\Veritas\NetBackup\var\global\wsl\config\wmcConfig.bat
UNIX and Linux: /usr/openv/var/global/wsl/config/wmcConfig.sh
- Edit the script to include the desired variables from the supported variables list. Each value must be on its own line. Supported variables are:
WMC_HEAP WMC_METASPACE WMC_NEW_RATIO WMC_SURVIVOR_RATIO WMC_GC_CONFIG WMC_HEAP_DUMP_CONFIG
Refer to the JVM documentation from Oracle for more information on the variables and their appropriate ranges.
- Restart the web service to apply the configuration changes.