Search <book_title>...

APTARE IT Analytics

Last Published: 2020-09-30

Product(s): APTARE IT Analytics (10.4)

Platform: APTARE IT Analytics

Move Hosts and Remove Host Groups

This process, often referred to as Server Group Cleanup, enables removal of backup server groups that had been created automatically in prior APTARE IT Analytics versions. In addition to cleaning up server groups, this process can also be used on other host groups.

Description

Prior versions of APTARE 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.

Note:

Once this process completes, log out of the Portal and log back in before accessing host groups and hosts in the Inventory.

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 APTARE IT Analytics domain. This ensures that each domain has been explicitly processed with log messages that confirm the actions taken.

Note:

CAUTION: THIS COMMAND MOVES CLIENTS TO THE DOMAIN'S HOME HOST GROUP AND THEN PERMANENTLY REMOVES THE SPECIFIED HOST GROUPS FROM THE DATABASE. RUN THIS COMMAND IN VALIDATE MODE FIRST TO VERIFY THAT THE ACTIONS REPRESENT THE INTENDED RESULTS.

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 APTARE 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');