Migrating Command Center Configurations to NetScaler MAS

You can now migrate your Command Center configurations to the NetScaler Management and Analytics System (MAS) without losing the existing configuration, settings, or data. 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: Use only the primary node’s IP address of Command Center or NetScaler MAS high availability deployment while migrating.

  • You can run the Command Center tool multiple times on same or different NetScaler MAS deployments:

    • Whenever you run the Command Center tool the second time for the same NetScaler MAS, you might see an error. The logs might display a failure for the configurations that have already been migrated and exist in NetScaler MAS.

    • Consider that a new configuration has been added in Command Center after you ran the migration tool earlier. When you next run the migration tool, all such configurations except the new custom tasks are 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.

  • Back up the existing data of NetScaler MAS before migrating the Command Center configurations.

  • 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

  • Time out 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 runs 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. 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, first upgrade the Command Center version to 5.2 build 48.2. 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, the administrator credentials, and then click OK.

    Note

    If you are deploying NetScaler MAS in high availability, 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. Also, 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. To access the NetScaler MAS GUI, type 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.

Migrating Command Center Configurations to NetScaler MAS