Migrate the NetScaler configuration to the NetScaler App Delivery and Security service
In NetScaler App Delivery and Security service – NetScaler managed, you can either create an application or migrate an application from an existing NetScaler appliance using the Migrate Application feature. With this feature, you can recreate an application configuration in NetScaler App Delivery and Security service – NetScaler managed that exists on a NetScaler appliance.
To migrate an application, you require a set of CLI commands as a starting point. For example, you can use the NetScaler configuration file (
ns.conf). NetScaler App Delivery and Security service – NetScaler managed analyzes the CLI commands and identifies the list of distinct applications embedded in the configuration. You can then select one application configuration that you want to migrate. NetScaler App Delivery and Security service – NetScaler managed extracts the corresponding CLI commands, which you can review before the migration process starts. You can also view and change any of the following values:
- IP Address/ports - The IP address and port of the services and service group members from the original application configuration.
- Configuration Files/Secrets - Resource files or secrets specified in the application configuration. For example, password and certificate files.
You’re ready to start migrating the application configuration. Migration creates an application. Deploy this application on the target NetScaler App Delivery and Security service – NetScaler managed environment.
NetScaler features supported in the NetScaler App Delivery and Security service
For a list of supported NetScaler features in the NetScaler App Delivery and Security service, see Supported NetScaler features.
How to migrate a NetScaler configuration to the NetScaler App Delivery and Security service
Follow these steps to migrate a NetScaler configuration as applications to the NetScaler App Delivery and Security service.
Click Applications and select Migrate ADC Configuration.
Select one of the following options:
Import using CLI commands: Add the CLI commands manually, or paste the commands copied from the configuration file (
ns.conf) of a source NetScaler appliance.
Upload configuration file: Click Choose file and navigate to the file on your computer. The commands appear in the box.
Select the target application environment where you want to deploy the application. Click OK and then click Next.
The service starts discovering the applications from the configuration. Click OK.
Specify the following parameters and then click Next.
- Application Name
- Select the virtual servers that form the application endpoint. You can filter the list of virtual servers based on Virtual-Server-Name, Protocol, IP-Address, and LB-Group. For each virtual server, specify the following parameters:
- Name: Name for the endpoint associated with the selected virtual server.
- Access Type: Select Internal or External.
- FQDN Type: Select Auto allocated or User defined.
- Auto Redirect HTTP traffic to HTTPS Select to ensure that the clients communicate over secure SSL. (Applicable only if the virtual server is of type SSL.)
The service starts parsing the commands and extracting the application configuration. Click OK.
Click Next. The service validates the CLI commands. Click OK.
The commands are displayed in three sections, as applicable. The first section lists the commands that are not applicable to the NetScaler App Delivery and Security service.
The second section lists the commands for features that are currently not supported in the NetScaler App Delivery and Security service.
The third section lists the commands that contain references to entities that do not exist in your configuration.
Click Next. Any issues found in the configuration are highlighted in red color. The suggested configuration, after fixing the issues, is also listed.
- Do one of the following:
- Click Next to accept the fix.
- Click Application Configuration to edit the configuration. You are taken to the Application Configuration page where you can edit the commands.
(Optional) Change the IP address and port values for the application servers by clicking the pencil icon. Click Next.
(Optional) Click the upload icon to upload any SSL certificates required by the application and specify their passwords. You are taken to the SSL certificate store. Select a certificate from the list and click Select. Then, click Next.
Review the configuration summary and click Migrate. After successful migration, an application is created with the specified configuration. The following page appears. Click Close.
You are taken to the applications landing page.
Navigate to your application using the pagination at the bottom of the page. Click the three dots in the Actions column and select Deploy.
The application summary page appears.
After successful deployment, the application status is updated on the Applications page.
If you face any issues, contact NetScaler support at https://www.citrix.com/support/.