Installing Veritas NetBackup KM

To be able to use Veritas NetBackup KM for PATROL, you will have to:

  • ensure that requirements are met
  • get the installation packages from the Sentry’s Website
  • install the KM
  • load the KM on the PATROL console(s).

Preparing for Installation

Meeting the Prerequisites

System Requirements

Veritas NetBackup KM for PATROL supports the following operating systems:

Operating System Version
AIX 5.1 and higher
HP-UX 11 and higher
Linux All distributions
Oracle Solaris 8 and higher
Windows 2008 and higher

Software Requirements

Veritas NetBackup KM for PATROL supports:

Software Version
Veritas NetBackup 5 and higher
BMC PATROL Agent Any version
BMC PATROL Console Any version
BMC Portal 2.3 and higher
BMC ProactiveNet Performance Management 9.5 and higher
BMC TrueSight Operations Management 10 and higher
Java 1.8 and higher

If you are running the Veritas NetBackup KM with sudo user account, or on AIX, LINUX, or Microsoft Windows x64 managed nodes, please verify these additional software requirements:

Purpose Software Version
When running Veritas NetBackup KM with sudo user account on Solaris, HP-UX, AIX or Linux managed nodes Sudo (superuser do) 1.6.7 or higher
When running Veritas NetBackup KM on AIX managed nodes Default ncargs value for processing bpdbjobs output may not be sufficient. Check this attribute using: lsattr -EH -l sys0 | grep ncargs. If the value is below 16, increase it using: chdev -l sys0 -a ncargs=16 Any
When running Veritas NetBackup KM on Linux managed nodes Korn shell binary (/bin/ksh). Alternatively a soft link from /bin/ksh to /bin/bash will be needed. Any
When running Veritas NetBackup KM on Microsoft Windows x64 managed nodes Reg.exe patch KB948698 Any

Changes Required
For Veritas NetBackup

No changes need to be done to Veritas NetBackup to use Veritas NetBackup KM for PATROL.

To Improve the KM Performance

Some changes must however be made to BMC PATROL to improve the performance of Veritas NetBackup KM for PATROL. The PATROL Agent tuning variable /AgentSetup/AgentTuning/pslInstructionMax should be disabled by setting it to 0 (zero) or increased to at least 5,000,000. This applies for all Veritas NetBackup master servers and media servers where the KM is installed. This adjustment will allow the data collectors to execute without incurring an internal scheduling delay.

This PATROL Agent tuning variable can be updated using wpconfig (on Microsoft Windows), xpconfig (on Unix) or PATROL Configuration Manager (PCM). Alternatively, you can use one of the following single line PSL command through the PATROL Console OS> prompt to update this tuning variable.

To disable the pslInstructionMax variable

%PSL pconfig("REPLACE","/AgentSetup/AgentTuning/pslInstructionMax",0);

To set the tuning variable to at 5,000,000

%PSL v="/AgentSetup/AgentTuning/pslInstructionMax";if(get(v)<5000000){pconfig("REPLACE",v,5000000);}

In large Veritas NetBackup systems, the value of 5,000,000 for the tuning variable “pslInstructionMax” may still be insufficient. In such situations, error messages will appear on the PATROL Console System Output Window (SOW) reporting that some NetBackup KM data collectors are in an infinite loop. In this case you can set the tuning variable to 0 (zero) to disable this functionality.

For the Access Control List (ACL)

The KM stores all configuration information in the PATROL Agent configuration database (pconfig), under the /NBU/<node-id> and /Runtime/NBU/<node-id> paths. PATROL Agent user (default: patrol) should be able to read and write to these pconfig variables at anytime. If Access Control List (ACL) is used to control which users are authorized to connect to a PATROL Agent, please make sure that the mode for PATROL Agent user includes “C” in the PATROL Agent variable /AgentSetup/accessControlList. Please refer the PATROL Agent Reference Manual for more details.

To support bash shell platforms when ksh is not installed

To collect NetBackup stats when ksh was not installed on UNIX/Linux servers, you need to create a soft link for /bin/ksh to /bin/bash:

ln –s  /bin/bash /bin/ksh

Security Requirements

A user account with administrative privileges must be configured in BMC PATROL or BMC TrueSight Operations Management to read and execute Veritas NetBackup application programs and access file systems. Depending on the operating systems used, several options will be available.

The following user accounts can be used:

  • On Unix platforms:

    • a root user
    • a non-root user, such as patrol, that has sudo privileges on Veritas NetBackup to execute application programs and access file systems
    • a non-root account, such as patrol, configured in Veritas NetBackup application to administer the Veritas NetBackup application.
  • On Windows platforms:

    • an administrator user
    • a non-administrator account, such as patrol, configured in Veritas NetBackup application to administer the Veritas NetBackup application. Refer to the Veritas NetBackup System Administrator’s Guide for details on how to set up this type of account.
  • Users added to NBU_Admin user group in VxSS. Please make sure the credentials of this user do not expire using the utility nbac_cron.

The user login details are configured in the KM. The password is encrypted and stored in the PATROL Agent.

Access Permissions

The NetBackup KM user needs “read & execute” permission to executable and library files under the paths listed below. The Veritas NetBackup installation path INSTALL_PATH, referenced in the tables below is usually:

  • /usr/openv or /opt/VRTSnetbp (on Unix)
  • C:\Program Files\Veritas (on Microsoft Windows)

Here are the executable and library files accessed by the NetBackup KM User:

UNIX Microsoft Windows
INSTALL_PATH/netbackup INSTALL_PATH\NetBackup
INSTALL_PATH/netbackup/bin INSTALL_PATH\NetBackup\bin
INSTALL_PATH/netbackup/bin/admincmd INSTALL_PATH\NetBackup\bin\admincmd
INSTALL_PATH/netbackup/bin/goodies INSTALL_PATH\NetBackup\bin\goodies
INSTALL_PATH/volmgr/bin INSTALL_PATH\Volmgr\bin
INSTALL_PATH/volmgr/bin/goodies INSTALL_PATH\Volmgr\bin\goodies
INSTALL_PATH/lib C:\Program Files\Common Files\VERITAS Shared
/usr/openwin/lib INSTALL_PATH\NetBackup\lib

If the KM is enabled to failover in a clustered environment, the login user needs execute permissions to the following cluster commands:

  • /opt/VRTSvcs/bin/hagrp (in Veritas Cluster Server)
  • vxdctl (in Veritas Cluster File System)
  • /usr/cluster/bin/clrg (in Oracle Solaris Cluster)
  • cluster (in Microsoft Cluster)

The Veritas NetBackup KM for PATROL includes some scripts which should be executable by the PATROL Agent user and the NetBackup KM user. These scripts are stored under KM_HOME path, normally PATROL_HOME/lib/NBU.

To list all OS commands used by the Veritas NetBackup KM for PATROL, execute the following PSL code from the PATROL Console, using PSL Task menu, after installing and loading the KM.

foreach var (grep("^/Runtime/NBU/.*CommandControls/",pconfig("LIST")))
{
  ctl=get(var);
  opt=ntharg(grep("Option",ctl),"2-"," =");
  nsa=ntharg(grep("NoSudoAttempt",ctl),"2-"," =");
  sua=ntharg(grep("SingleUserAttempt",ctl),"2-"," =");
  typ=ntharg(grep("CommandType",ctl),"2-"," =");
  cmd=nthargf(grep("CommandText",ctl),"2-","=","=");
  if(osp=="") { osp=trim(nthargf(grep("OSPlatform",ctl),"2-","=","="), " "); }
  fields=lines(ntharg(var,"1-","/"));
  old_host=host;
  host=(fields == 5)? ntharg(var,"3","/") : "localhost";
  if(host!=old_host)
  {
    if((osp!="WINDOWS") && sudoers) { printf("\n\nCommands used with sudo:\n%s",sort(sudoers)); }
    printf("\n\nOn %s:\n\n", host);
    i=0; sudoers=""; osp="";
  }
  if((typ == "")||(typ == "OS"))
  {
    met="";
    if(opt == "NoLogin") { met = "(run as patrol user)"; }
    elsif(nsa == "YES") { met = "(run as configured user without sudo)"; }
    elsif(sua == "YES") { met = "(run as supplied user - used in menu)"; }
  else
  {
    scmd=cmd;
    s=index(scmd,"%sudo");
    if(s) { scmd=replace(substr(scmd,s,length(scmd)),"%sudo",""); }
    sudoers=union(sudoers,ntharg(ntharg(scmd,1,">|"),"1-"," "," "));
  }
  printf("(%2d) %-30s %-40s: %s\n",i++,ntharg(var,fields,"/"),met,cmd);
  }
}
if((osp!="WINDOWS") && sudoers) { printf("\n\nCommands used with sudo:\n%s",sort(sudoers)); }
Paths and Files Accessed by PATROL Agent User
Unix Microsoft Windows
INSTALL_PATH/netbackup/db INSTALL_PATH\NetBackup\db
INSTALL_PATH/volmgr/database INSTALL_PATH\Volmgr\database
INSTALL_PATH/var INSTALL_PATH\NetBackup\var
INSTALL_PATH/netbackup/db/error/daily_messages.log INSTALL_PATH\NetBackup\db\error\log_date
/var/adm/messages (on Solaris)
/var/adm/syslog/syslog.log (on HP-UX)
/var/log/messages (on Linux)

On Windows platforms the Veritas NetBackup installation is identified by checking the Microsoft Windows Registry: HKEY_LOCAL_MACHINE\SOFTWARE\Veritas\NetBackup\

The configured login user should have sufficient privileges to run regedit command on the managed node.

Sudo User for Operating System Access

If a non-root user with sudo privileges is preferred as the KM user, configure the account as a sudoer through the visudo utility using code appropriate for your platform as detailed below. This user should be able to execute NetBackup commands and OS commands listed in above.

The code below also applies to all non-root users who may execute NetBackup KM administration and report menu commands using their sudo privileges. The KM accepts any non-root user with the following sudo configuration in the sudoers file. Please replace user1, user2, user3 with appropriate KM user names. The Veritas NetBackup installation path INSTALL_PATH, referenced below is normally /usr/openv or /opt/VRTSnetbp and PATROL_HOME is the path where the PATROL Agent is installed (including the target, like /opt/bmc/Patrol3/Solaris29-sun4/).

Warning! This non-root sudo user configured in the KM will be able to execute Veritas NetBackup commands. To prevent unauthorized access, ensure this user is only used within the KM and not made public for general use.
Warning! Entering the non-root sudo user with ‘Use Sudo’ option selected into the login configuration dialog, before updating the sudoers file, will generate sudo errors. Also if the sudo user is configured differently, the KM may run sudo commands using incorrect sudo settings, which may expose the sudo user password..
On Solaris
User_Alias NBUKMUSERS = user1, user2, user3
Defaults:NBUKMUSERS !lecture,!authenticate,!requiretty,\
env_keep+="PATH LD_LIBRARY_PATH INSTALL_PATH KM_HOME KM_TEMP",env_reset
NBUKMUSERS ALL=/bin/*,/sbin/*,/usr/bin/*,/usr/sbin/*,\
INSTALL_PATH/netbackup/bin/*,\
INSTALL_PATH/netbackup/bin/admincmd/*,\
INSTALL_PATH/netbackup/bin/goodies/*,\
INSTALL_PATH/volmgr/bin/*,\
INSTALL_PATH/volmgr/bin/goodies/*,\
PATROL_HOME/lib/NBU/*,PATROL_HOME/bin/*

user1, user2, user3 must be replaced with username(s) used by the KM; INSTALL_PATH and PATROL_HOME with the relevant paths. PATROL_HOME paths are only required for local monitoring.

Replace PATROL_HOME/lib/NBU/* with the Remote Temp Directory Path, default /var/tmp/*, when monitoring remotely.

On HP-UX
User_Alias NBUKMUSERS = user1, user2, user3
Defaults:NBUKMUSERS !lecture,!authenticate,!requiretty,\
env_keep+="PATH SHLIB_PATH INSTALL_PATH KM_HOME KM_TEMP",env_reset
NBUKMUSERS ALL=/bin/*,/sbin/*,/usr/bin/*,/usr/sbin/*,\
INSTALL_PATH/netbackup/bin/*,\
INSTALL_PATH/netbackup/bin/admincmd/*,\
INSTALL_PATH/netbackup/bin/goodies/*,\
INSTALL_PATH/volmgr/bin/*,\
INSTALL_PATH/volmgr/bin/goodies/*,\
PATROL_HOME/lib/NBU/*,PATROL_HOME/bin/*

user1, user2, user3 must be replaced with username(s) used by the KM; INSTALL_PATH and PATROL_HOME with the relevant paths. PATROL_HOME paths are only required for local monitoring.

Replace PATROL_HOME/lib/NBU/* with the Remote Temp Directory Path, default /var/tmp/*, when monitoring remotely.

On AIX & Linux
User_Alias NBUKMUSERS = user1, user2, user3
Defaults:NBUKMUSERS !lecture,!authenticate,!requiretty,\
env_keep+="PATH LIBPATH INSTALL_PATH KM_HOME KM_TEMP",env_reset
NBUKMUSERS ALL=/bin/*,/sbin/*,/usr/bin/*,/usr/sbin/*,\
INSTALL_PATH/netbackup/bin/*,\
INSTALL_PATH/netbackup/bin/admincmd/*,\
INSTALL_PATH/netbackup/bin/goodies/*,\
INSTALL_PATH/volmgr/bin/*,\
INSTALL_PATH/volmgr/bin/goodies/*,\
PATROL_HOME/lib/NBU/*,PATROL_HOME/bin/*

user1, user2, user3 must be replaced with username(s) used by the KM; INSTALL_PATH and PATROL_HOME with the relevant paths. PATROL_HOME paths are only required for local monitoring.

Replace PATROL_HOME/lib/NBU/* with the Remote Temp Directory Path, default /var/tmp/*, when monitoring remotely.

Disk Space Requirements

Veritas NetBackup KM for PATROL requires approximately:

  • 2.5 MBytes of available disk space on each monitored PATROL Agent system
  • 3.5 MBytes of available disk space on each PATROL Console system
  • 600 KBytes of available disk space on each PATROL Central Console Server system
  • 1.4 MBytes of available disk space on each PATROL Central Web Server system

It is installed under the PATROL installation path.

When monitoring a standard installation of Veritas NetBackup, the PATROL Agent will generate approximately 500 KBytes of history data per day. An enterprise installation of Veritas NetBackup on a master server with multiple media servers, clients, robotic libraries, and standalone drives will generate more history data (as per other KMs used by the PATROL Agent). These history data files are recycled by PATROL depending on the PATROL Agent history retention period.

During execution, the KM creates and maintains temporary files under KM_TEMP and KM_DEBUG paths. By default, they are all under PATROL_HOME/lib/NBU, where PATROL_HOME path is usually /opt/bmc/Patrol3/ (on Unix) or C:\Program Files (x86)\BMC Software\Patrol3\ (on Microsoft Windows). Please make sure you have sufficient space under KM_TEMP and KM_DEBUG paths.

If the location of the KM_TEMP or KM_DEBUG is not suitable, it can be changed using the Configuration > Paths menu from the server instance. These folders should have read, write and execute permissions for both the PATROL Agent user and the local KM login user.

Remote Monitoring Requirements

Remote monitoring is required for all servers or appliances on which no PATROL Agent can be installed. This feature is also interesting if you lack resources or time to deploy a PATROL Agent and Veritas NetBackup KM for PATROL on several servers since it allows to monitor multiple hosts from one agent.

Remote monitoring is not possible from a UNIX/Linux PATROL Agent system to a Windows-based NetBackup server.

Please refer to the sections below to find out the remote monitoring requirements:

JAVA

Veritas NetBackup KM requires Java 1.8 or higher and a Java Runtime Environment (JRE) to be installed on the same system that runs the PATROL Agent.

The KM will automatically detect the JRE path if it has been installed in the default location or under the BMC PATROL Agent installation path. If it has been installed in a different location, you will have to set JAVA_HOME for the Patrol Agent default account before starting the PATROL Agent.

You can download the Java Runtime Environment along with the KM on Sentry Software Web site.

NetBackup CLI User Account

A NetBackup CLI user is required to monitor NetBackup appliances. To create a NetBackup user account:

  1. Open an SSH session on the NetBackup appliance
  2. Log on as admin
  3. Enter the following command:

    Main > Manage > NetBackupCLI > Create UserName where UserName is the name to be used for the new user

  4. Enter a password for this new user account

  5. A confirmation message appears stating the new user account was created successfully.

This user should have the privileges to execute NetBackup and OS commands as described in the Security Requirements section. The following sudo settings are therefore required on a NetBackup appliance:

# Added for NetBackup KM

User_Alias NBUKMUSERS = UserName

Defaults:NBUKMUSERS !lecture,!authenticate,\

env_keep+="PATH LIBPATH INSTALL_PATH KM_HOME KM_TEMP",env_reset

SSH/WMI Connection

An SSH (UNIX/Linux platforms) or a WMI (Windows platforms) connection is required to monitor remote NetBackup servers and appliances. When using an SSH connection, the SSH host key authentication, which is enabled by default on most NetBackup servers and appliances, must be disabled on the remote host.

To disable the SSH host key authentication:

  1. Open the global SSH configuration file (ssh_config) stored in the /etc/ssh/ directory on the remote host
  2. Add the line StrictHostKeyChecking no
  3. Save the file.

Getting the Installation Packages

The Veritas NetBackup KM for PATROL installation packages are designed for use with the BMC Software Installation Utility. They need to be merged with the latest available version of the BMC Software Installation Utility.

Getting the BMC Utility Package

The latest version of the BMC Software Installation utility is required to install Veritas NetBackup KM for PATROL. It can be downloaded from the Sentry Software Web site.

Choose the appropriate package depending on the platform you plan to install Veritas NetBackup KM for PATROL on:

  • For UNIX/Linux systems: ins_ALL_<version>.tar
  • For Windows systems: ins_WINDOWS_<version>.zip

The packages are valid for all the PATROL components: Agent, Console, Console Server, etc.

Getting the Veritas NetBackup KM Packages

Two packages are available to download on the Sentry Software Web site. They can be used to install the KM on every PATROL component (Agent, Console, etc.) according to the platform you are using.

  • For UNIX/Linux systems: veritas-netbackup-<version>-thorium.tar
  • For Windows systems: veritas-netbackup-<version>-thorium.zip

Getting the JRE Package

Java Runtime Environment version 1.8.00 or higher is required for the KM to operate properly.

A package with a suitable Java Runtime Environment, designed for use with the BMC Software Installation Utility, is made available to download on the Sentry Software Web site.

Installing Veritas NetBackup KM

Like most Knowledge Modules for PATROL, you need to install Veritas NetBackup KM for PATROL on the following components of your PATROL architecture:

  • Every managed system with a PATROL Agent
  • Every PATROL Console (Classic) that will show information and alerts
  • The Console Server
  • PATROL Central Web Edition

To install Veritas NetBackup KM for PATROL

  1. Extract the setup files:

    • On Windows:

      1. Unzip the BMC Installation Utility: ins_Windows_<version>.zip
      2. Unzip the veritas-netbackup-<version>-thorium.zip package in the same folder
      3. (Optional) If you need to install the latest Java Runtime Environment program, unzip the jre_windows_WINDOWS_<version>.zip package in the same folder. The content of the packages merges into a subfolder named bmc_products. Windows may ask for your confirmation to overwrite files and folders. This is normal behavior and you can accept all overwrite confirmation requests
    • On Linux:

      1. First, untar the BMC Installation Utility: tar xvf jre_unix_LINUX-SOLARIS_<version>.tar
      2. Next, untar the Veritas NetBackup KM for PATROL package named: veritas-netbackup-<version>-thorium.tar
  2. Browse to the bmc_products folder where the files have been extracted

  3. Launch the setup.exe program (Windows) or setup.sh script (UNIX)

  4. The welcome screen of the installer appears. Click Next to continue

    Installation Wizard - Welcome

  5. Read the license agreement, click the Accept option and then click Next to continue

    Installation Wizard - License Agreement

  6. Select Install products on this computer now and click Next to continue

    Installation Wizard - Selecting Installation Options

  7. Specify the BMC Software Products installation directory. Click Next to continue

    Installation Wizard - Selecting the Installation Directory

  8. Installing Veritas NetBackup KM for PATROL does not require any customization. Select Default and click Next to continue

    Installation Wizard - Selecting an Installation Type

  9. Select one or several of the following options:

    • Managed System to install Veritas NetBackup KM for PATROL on a PATROL Agent
    • Console Systems to install Veritas NetBackup KM for PATROL on a PATROL Classic Console
    • Common services to install Veritas NetBackup KM for PATROL on the Console Server or on PATROL Central Web Edition

    Installation Wizard - Selecting Roles

  10. Click Next to continue

  11. Install the KM:

    • Check the Veritas NetBackup KM for PATROL box (it should be selected by default)
    • Select the Java Runtime Environment program if you want to install it along with the KM (this option is only provided when you have previously downloaded and merged the package with the BMC Installation Utility)
    • Click Next to continue

    Installation Wizard - Selecting Products and Components

  12. Review the installation parameters and click Start Install to launch the installation procedure

    Installation Wizard - Reviewing Installation Options

  13. The setup program displays the actions performed and indicates the percentage of completion. Once the installation is complete, click Next to view the installation results

    Installation Wizard - Installation Status

  14. The wizard displays the installation results. Click View Log to display a detailed log of the installation procedure. Click Next and then Finish to exit the setup program

    Installation Wizard - Installation Results

  15. Click the Finish button to complete and close the installation wizard.

    Installation Wizard - Completing and closing the Installation Wizard

Loading / Unloading Veritas NetBackup KM

Loading Veritas NetBackup KM

In order to monitor your Veritas NetBackup environment within your PATROL Console, Veritas NetBackup KM for PATROL must be loaded on the appropriate managed system. Loading a Knowledge Module in PATROL Central Operator both loads the Knowledge Module on the managed system and adds the name of the Knowledge Module to your management profile.

Before loading the Veritas NetBackup KM:

  1. Make sure you properly installed the KM on PATROL Console and PATROL Agent systems
  2. Start the PATROL Console and update the connection to all PATROL Agent systems where the Veritas NetBackup KM is installed
  3. Check the value of the PATROL Agent tuning variable, /AgentSetup/AgentTuning/pslInstructionMax, and if necessary, increase it.

On PATROL Classic

  1. In the Console menu bar, click File > Load KM
  2. In the Files of Type list, select KM Files
  3. Select Veritas NetBackup KM for PATROL (NBU_LOAD.kml)
  4. Click Open.

The Veritas NetBackup KM will be loaded to the PATROL Console, and all connected PATROL Agents. The Veritas NetBackup container instance will be created. Any previous Veritas NetBackup KM configuration will be upgraded and their instances will be created.

If you want to save the new list of loaded files as the PATROL Console user preference:

  1. From the PATROL Console menu bar, choose File > Save Configuration
  2. Load the NBU_LOAD.kml file on each PATROL Console
  3. Configure the KM.

On PATROL Central

  1. In the Common Tasks tab of the PATROL Central Operator Taskpad, click the Load Knowledge Modules icon
  2. To start the wizard, click Next
  3. Select the check boxes for the managed systems that you want to load Veritas NetBackup KM for PATROL on. Click Next
  4. Select the check box for Veritas NetBackup KM for PATROL (NBU_LOAD.kml)
  5. Click Finish

    The Veritas NetBackup KM will be loaded to the PATROL Central Console Server, and all connected selected managed systems. The Veritas NetBackup container instance will be created. Any previous Veritas NetBackup KM configuration will be upgraded and their instances will be created.

  6. Configure the KM.

Configuring the PATROL Agent to Preload the KM

If you want Veritas NetBackup KM for PATROL to operate all the time, without a PATROL Console connection, you will have to add it to the PATROL Agent configuration variable /AgentSetup/preloadedKMs.

To configure the PATROL Agent to preload the KM:

  1. In the Console, right-click the Veritas NetBackup icon > Configuration > Preloading
  2. Click Add to add the KM files to the list of preloaded KMs.

The same menu is used to remove the KM files from the preloaded KMs list.

Unloading Veritas NetBackup KM

This section describes the procedures for unloading (not uninstalling) the Veritas NetBackup KM from the PATROL Agent, PATROL Console or PATROL Central Console. Read this section if you no longer want to use some parts of the KM; if you want to completely uninstall the KM, refer to the uninstall procedure.

When the KM is unloaded:

  • from a PATROL Agent: PATROL stops monitoring the Veritas NetBackup application on that system when there is no connection to a PATROL Console with Veritas NetBackup KM KM loaded.

  • from a PATROL Console: the PATROL Console stops displaying and monitoring the Veritas NetBackup application on any PATROL Console connected system.

From the PATROL Agent

To unload the KM from the PATROL Agent:

  1. In the Console, right-click the Veritas NetBackup icon and select KM Commands > Configuration > Preloading…
  2. Click Remove
  3. Restart the PATROL Agent
  4. Repeat these steps on every PATROL Agent system (managed node) where the Veritas NetBackup KM is to be unloaded.
Note: You can also use the utility wpconfig (on Microsoft Windows) or xpconfig to unload the KM. You will then have to remove NBU_LOAD.kml from the PATROL Agent configuration variable /AgentSetup/preloadedKMs.

The KM cannot be partially unloaded from the PATROL Agent using the above steps. If you need to unload some parts of the KM from the PATROL Agent, set their instance limits to 0 (zero).

From the PATROL Console

Application classes are unloaded individually. This allows for a partial unloading of the KM to enable it to run as a reduced installation.

To unload the Veritas NetBackup KM completely or partially:

  1. Remove the unwanted application classes that starts with NBU_ in the list of loaded application classes as described below:

    With the PATROL Console for Unix:

    • From the PATROL Console main window, choose Attributes> Application Classes…
    • Select a Veritas NetBackup KM application class to be removed and choose Edit > Delete
    • Repeat for all classes to be removed

    With the PATROL Console for MS Windows:

    • From the PATROL Console tree view, choose the KM tab and expand the folder Application Classes
    • Right-click on a Veritas NetBackup KM application class to be removed and choose Delete
    • Repeat for all classes to be removed
  2. Select File > Save Configuration to save the modified list of loaded application classes as the PATROL Console user preference

  3. Repeat these steps on every PATROL Console system where the Veritas NetBackup KM is to be unloaded.

From the PATROL Central Console

A KM can be unloaded from particular managed systems or for all systems across the monitored environment. Application classes may be unloaded individually, or by selecting all classes at once. This allows for a partial unloading of the KM to enable it to run as a reduced installation on some or all of the managed systems.

To completely or partially unload the Veritas NetBackup KM for PATROL from some or all of the managed systems:

  1. Right-click the PATROL Main Map, and choose Unload Knowledge Modules…

  2. Select the managed systems where the Veritas NetBackup KM is to be unloaded, and click Next>

  3. Select the application classes to be removed that starts with NBU_ for the appropriate managed systems, click Next> and Finish

  4. Repeat the above steps for each PATROL Central Management Profile where the Veritas NetBackup KM is to be unloaded.

Keywords:
storage netbackup km patrol