NetBackup IT Analytics System Administrator Guide

Description

Prior versions of NetBackup IT Analytics automatically created several server/host groups during backup data collection. In certain environments, these auto-generated groups may not be needed, as other host groups are more relevant. This utility can be used to clean up a Portal's host groups by moving servers/hosts and child host groups from a host group and then deleting the source host group. While this utility, by default, is intended for system-created host groups, it can be used for any host group that you want to delete, but retain its contents.

Best Practice: In multi-tenancy environments, run this command on a domain-by-domain basis, starting from the bottom of the domain hierarchy to the top NetBackup IT Analytics domain. This ensures that each domain has been explicitly processed with log messages that confirm the actions taken.

Usage

server_mgmt_pkg.serverGroupCleanup(<processingMode>, 
'<domain_name>', (<server_group_names_list>), 
'<log_file_path_name>', '<log_file_name>');

Where:

processing_mode is either 1 = Validate or 2 = Execute. Run this command in Validate mode first to understand what hosts will be moved and what host groups will be deleted.

domain_name, enclosed in single straight quotes, is the case-insensitive name of the NetBackup IT Analytics domain for the group to be deleted. See the Best Practice listed above.

server_group_names_list is a comma-separated list of host group names to remove, in single straight quotes. This list must be enclosed in parentheses and prefaced with stringListType. If NULL is specified, the utility will process these system-created host groups: NetBackup Policy Types, NetBackup Policies, Inactive Policy Clients, and Policy Domains.

log_file_path_name, enclosed in single straight quotes, is the location of the log file for this process.

log_file_name, enclosed in single straight quotes, is the name of the log file.

Example of Validate Mode:

execute server_mgmt_pkg.serverGroupCleanup
(1, 'EMEAfinance', stringListType
('NetBackup Policy Types','NetBackup Policies',
'Inactive Policy Clients', 'Policy Domains'), 
'/tmp', 'serverGrpCleanup.log');

Example of Execute Mode:

execute server_mgmt_pkg.serverGroupCleanup
(2, 'EMEAfinance', stringListType
('NetBackup Policy Types','NetBackup Policies',
'Inactive Policy Clients', 'Policy Domains'), 
'/tmp', 'serverGrpCleanup.log');

Example of Validate without a list of Host Group Names:

exec server_mgmt_pkg.serverGroupCleanup
(1, 'EMEAfinance', NULL, '/tmp', 
'serverGrpCleanup.log');