Product Documentation

Migrating Command Center Configurations to NetScaler MAS

Aug 27, 2017

You can now migrate your Command Center configurations to the NetScaler Management and Analytics System (MAS) without losing the existing configuration, settings, or data of your Command Center deployment and NetScaler MAS deployment. You can view the migrated Command Center configurations in NetScaler MAS after the migration process is completed.

Points to note

  • Migrating Command Center configurations to NetScaler MAS is supported on the following deployments:
    • Command Center standalone to NetScaler MAS standalone deployment or NetScaler MAS high availability deployment.
    • Command Center high availability to NetScaler MAS standalone deployment or NetScaler MAS high availability deployment.

Note: You must use only the primary node’s IP address of Command Center and NetScaler MAS high availability deployment while migrating the Command Center standalone or high availability deployment to NetScaler MAS standalone or high availability deployment.

  • You can run the Command Center tool multiple times on same or different NetScaler MAS deployments:
    • Whenever you run the Command Center tool beyond the first time for the same NetScaler MAS, the logs will be shown as failed for the configurations that have already been migrated and exist in NetScaler MAS.
    • If any new configuration has been added in Command Center from the time the tool was run earlier to now for the same NetScaler MAS, all such configuration except the new Custom tasks will be migrated to NetScaler MAS.
  • Migrating Command Center configurations to NetScaler MAS is supported for NetScaler, NetScaler SDX, and NetScaler SD-WAN WO devices.
  • All communication between Command Center and NetScaler MAS is on an HTTPS connection.
  • Backing up of existing data of NetScaler MAS before migrating the Command Center configurations is highly recommended.
  • After the Command Center migration is completed, the Admin Partitions of NetScaler are auto-discovered in the NetScaler MAS. 

Limitations

The following Command Center configurations are not migrated from the Command Center appliance to the NetScaler MAS:

  • Device backup configuration files
  • Timeout details in SD-WAN WO device profiles
  • The following details under event and alarm triggers are not migrated:
    • Abort details for run command action
    • Run task details
    • Triggers with all empty parameters (severity/category/instances/failure objects) are not migrated
    • Triggers having instances with the state as HA cluster, primary, and secondary are not migrated if all the three states of the instances are selected
  • Custom tasks without description are not migrated
  • Event severities settings
  • Event rule schedule details
  • Syslog suppress filters
  • Configuration task details
  • Audit templates
  • Audit policies without devices
  • Audit policy schedule details
  • Groups RBAC authorized scope settings
  • Database monitor and management settings
  • Performance custom reports
  • Performance thresholds
  • Custom views of fault/syslog/reports/Entity Monitoring
  • AppFirewall and NS gateway reports and its schedule details
  • SD-WAN WO auto configuration details
  • High Availability settings
  • Scheduled system backup settings
  • Database retry settings
  • Syslog purge schedule time
  • All statistic data like syslog, events, and audit logs of all modules.

Prerequisites

Before migrating the Command Center configurations to NetScaler MAS, make sure that the following prerequisites are met:

  • You are running Command Center version 5.2 build 48.2 or later.
  • You have installed and configured NetScaler MAS version 12.0 build 51.24 or later.
  • Only the Admin user will run the Command Center configuration migration.
  • For successful migration of custom tasks, the description field is mandatory in Command Center.
  • Communication between the Command Center and NetScaler MAS is NITRO based. You must configure and open the necessary SSL (Secure Socket Layer) and TLS (Transport Layer Security) protocol settings on Command Center and NetSCaler MAS for NITRO communication.

Note

If you are using a Command Center version earlier than 5.2 build 48.2, you must upgrade the Command Center version to 5.2 build 48.2 and then migrate the Command Center configurations to NetScaler MAS. For detailed information about upgrading the Command Center appliance, see "Upgrading Command Center".

Migrating the Configurations

To migrate a Command Center configuration to NetScaler MAS, you need the Command Center appliance IP address and administrator credentials.

To migrate Command Center Configurations to NetScaler MAS

1. In a web browser, type the IP address of the Command Center appliance.

2. In the User Name and Password fields, type the administrator credentials and log in.

3. After successful login, on the screen that appears, select the Administration tab and do one of the following:

  • In the right pane, under NetScaler MAS Migration, select Migrate Configuration, as shown in the following figure.
localized image
  • In the left pane, select NetScaler MAS Migration, and then click Migrate Configuration, as shown in the following figure.
localized image

4. In the Command Center to MAS Migration dialog box, enter the IP address of the NetScaler MAS server, and the administrator credentials, and then click OK.

Note: In case of NetScaler MAS high availability deployment, enter the primary node IP address.

localized image

5. At the confirmation prompt, click Yes.

localized image

The screen reports the progress of the migration tasks.

localized image

The Migrate Configuration operation takes the details of the NetScaler MAS deployment and its admin credentials as input. The Migrate Configuration operation then migrates the configuration of Command Center deployment to NetScaler MAS deployment.

When the tasks are completed, you can verify the migrated Command Center configuration from Command Center migration logs and NetScaler MAS data.

To use the Command Center migration logs to verify the migration

1. In the Command Center GUI, on the Administration tab, do one of the following:

  • In the right pane, under NetScaler MAS Migration, click Migration Log.
localized image
  • In the left pane, select NetScaler MAS Migration, and then click Migration Log.
localized image

2. Review the list of migration logs.

localized image

3. To display more detail, select Module Name, or to display details for a particular module, select that module, and then click Details.

localized image

4. The following example shows the log details for a selected module.

localized image
To use the NetScaler MAS to verify the migration

During the migration process, the Command Center configurations are migrated to NetScaler MAS and are shown as NetScaler MAS configurations in the NetScaler MAS GUI.

After the migration process is completed, the NetScaler MAS Server reboots and there might be a momentary downtime. When the NetScaler MAS server is up and running, access the NetScaler MAS GUI by typing the IP address of the NetScaler MAS server in the address bar of your browser.

The following table shows how the NetScaler MAS terminology for the migrated configurations corresponds to the terminology used in Command Center.

Command Center Terminology NetScaler MAS Terminology

Device profiles 

Instance profiles

Devices and its state (like managed/unmanaged)

Instances and its state (like managed/unmanaged)

Device annotations

Instance annotations

Device groups

Instance groups

Maps

Instance groups

Event and alarm triggers 

Event rules

Built-In and custom task commands

Configuration templates under create Job editor

Scheduled audit policies 

Audit templates

Password policy

Password policy

Users (local users only)

System users

Groups*

System groups

Authentication profiles and authentication settings

Authentication profiles and authentication configuration

Email settings

Email server/Email distribution list

Syslog server

Syslog server

SSL settings

SSL settings

SNMP agent configuration

SNMP manager

Trap forward settings

Trap settings

Event purge settings

Events prune settings

Inventory settings

Instance backup settings

Syslog purge settings

Syslog prune settings

Appliance network settings like DNS, NTP, and time zone

NetScaler MAS network settings like DNS, NTP, and time zone

*Groups with all permissions in Command Center are migrated as groups with an “admin” role in NetScaler MAS. All other Command Center groups are migrated as groups with a “read-only” role in NetScaler MAS.