-
Low-touch onboarding of Citrix ADC instances using Citrix ADM service connect
-
-
Importing and synchronizing StyleBooks from GitHub repository
-
Migrate Citrix ADC application configurations
-
-
-
-
Use ADM audit logs for managing and monitoring your infrastructure
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已动态机器翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
This content has been machine translated dynamically.
This content has been machine translated dynamically.
This content has been machine translated dynamically.
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.
Este artigo foi traduzido automaticamente.
这篇文章已经过机器翻译.放弃
Translation failed!
Migrate Citrix ADC application configuration using StyleBooks Configuration Builder
Note
This feature is in preview.
The StyleBooks Configuration Builder is used to create an application configuration StyleBook from an existing Citrix ADC configuration. This feature also automates the application configuration migration from one Citrix ADC instance to another instance or an Autoscale group.
Using Configuration Builder you can simplify the requirement to create a customized StyleBook. This feature enables you to create a StyleBook without in-depth knowledge of StyleBooks grammar and constructs. Otherwise, the knowledge of StyleBooks grammar and constructs is necessary to create a StyleBook.
The Configuration Builder also creates a configuration pack that reflects the same ADC configuration on a new ADC instance. With this configuration pack, the initial ADC configuration from one ADC instance can be duplicated to another ADC instance. The initial configuration source can be one of the following:
-
A Citrix ADC instance: Specify the instance where the application configuration that you want to duplicate is hosted.
The Configuration Builder converts the ADC configuration to StyleBook and configuration pack even if you do not specify the target instance. You can later use this configuration pack to migrate the ADC configuration to other ADC instances.
If the target instance is an Autoscale group, the configuration pack appears in the Network > AutoScale Group page. Under the Configuration tab.
-
A set of CLI Commands: Paste the configuration from
ns.conf
orApplication config
.
The Configuration Builder identifies the list of distinct applications embedded in the source configuration. When you select the application configuration of your interest, the Configuration Builder extracts the set of CLI commands for the selected application. These CLI commands are extracted from the source configuration. Also it identifies the deployment and configuration attributes that might require your input.
-
Deployment attributes - You can view and edit the IP address and port of the virtual servers, services, service group members from the original configuration.
-
Configuration attributes - These attributes can be passwords or certificates specified in the source configuration.
After specifying the necessary information, start migrating or duplicating the application configuration on a target ADC instance.
After the application creation and migration, a configuration pack is created in Citrix ADM along with its corresponding StyleBook. This configuration pack represents the application configuration on the target ADC instance. To view the created configuration pack, navigate to Applications > StyleBooks > Configurations.
Supported Citrix ADC Features
The StyleBook Configuration Builder recognizes and supports the following Citrix ADC features in the source configuration:
- Content Switching
- Load Balancing
- Monitoring
- SSL Offloading
- Rate limiting
- Rewrite
- Responder
- Web application firewall (WAF)
Create a StyleBook to migrate the Citrix ADC application configuration
The following procedure is to create a StyleBook that migrates the Citrix ADC application migration in Citrix ADM:
-
Navigate to Applications > StyleBooks > Configurations.
-
Click Migrate ADC Configuration.
-
Click Get Started.
-
In Specify Configuration, select the configuration source:
-
Import from an ADC: This option discovers the active applications on the selected ADC instance.
-
Import using CLI Commands: This option analyses the CLI commands and extracts the applications from the CLI commands.
-
-
Specify the Source ADC Instance from which you want to migrate or duplicate the application configuration.
To migrate the application configuration to an Autoscale group, ensure the following information is not included in the source configuration:
IPset
- Device profile
- Protocol
- Port
-
Specify the Target ADC Instance to which you want to migrate or duplicate the application configuration.
To migrate an application configuration to an Autoscale group, select the Autoscale group from the list.
-
In Define Application,
-
In Application Name, specify the name of the application.
If the target instance is an Autoscale group, specify the following Autoscale parameters:
-
Access Type - You can use the ADM autoscaling solution to both external and internal applications. Select the required application access type.
-
Domain Name - Specify the domain name of an application. This option is applicable only when you select User-Defined FQDN type.
-
Zone of the Domain - Select the zone name of an application from the list. This option is applicable only when you select User-Defined FQDN type.
This domain and zone name redirects to the virtual servers in Azure. For example, if you host an application in
app.example.com
, theapp
is the domain name andexample.com
is the zone name.
-
-
Select the virtual servers that you want to migrate.
-
Click Next.
-
-
In Equivalent CLI Commands, review the commands and click Next.
These commands are specific to the selected application configuration.
-
In Deployment Attributes, you can view and edit the IP address and port of the virtual servers, services, and service group members.
To edit the IP address and port, click the edit icon on the virtual server, service, or service group member in the flow diagram.
Note
If the target instance is an Autoscale group, editing the front end IP address is disabled.
This tab appears only in the following cases:
-
The source and target instances are different.
-
Import configurations using CLI commands.
-
-
In Configuration Attributes, specify the necessary details and click Next.
This tab lists the secrets such as keys to decrypt passwords and certificates.
Note
Before you start the migration, the missed or unsupported configurations are displayed in any of the following tabs:
Unsupported Configurations
Unsupported Global Configurations
To migrate these configurations successfully, you must apply the missed or unsupported configurations separately on the target instance. And, click Next.
-
In Migrate, specify the required StyleBook details. Click Migrate.
Limitations
-
The named expressions and
responderhtmlpages
mentioned in the source instance are not identified. Make sure to configure the named expressions andresponderhtmlpages
on the target instance before migration. -
If the source has a configuration for
servicegroup
and monitor binding as follows:bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>
The following error appears:
CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
This error occurs because Citrix ADC saves the binding between Service Group and Monitor in an invalid format. This issue is fixed from Citrix ADC 12.1.52.15 build.
Share
Share
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select Do Not Agree to exit.