Introduction to NetScaler Console service connect for NetScaler appliances
NetScaler Console service is a cloud-based solution that helps you manage, monitor, orchestrate, automate, and troubleshoot your NetScaler instances. It also provides analytical insights and curated machine learning based recommendations for your applications health, performance, and security. For more information, see NetScaler Application Delivery Management Service.
NetScaler Application Delivery Management (ADM) service connect is a feature to enable seamless onboarding of NetScaler instances onto NetScaler Console service. This feature helps NetScaler instances and NetScaler Console service to function as a holistic solution, which offers customers multi fold benefits.
NetScaler Console service connect feature lets the NetScaler instance automatically connect with the NetScaler Console service and send system, usage, and telemetry data to it. Based on this data, the NetScaler Console service gives you some insights and recommendations on your NetScaler and Gateway infrastructure like the following:
-
Security advisory insight highlighting your vulnerable ADC appliances.
-
Upgrade advisory insight highlighting ADC appliances that have reached or about to reach end of maintenance and end of life.
-
Quick identification of performance issues, high resource usage, and critical errors.
To harness the power of NetScaler Console service, you can choose to onboard your NetScaler instances to NetScaler Console service. The onboarding process uses ADM service connect, and makes the experience smooth and faster for you.
Points to note
-
NetScaler Console service connect is now available on NetScaler MPX, SDX, and VPX instances and NetScaler Gateway appliances.
-
The initiative in NetScaler Console service that uses this NetScaler Console service connect feature is ADM service connect based low-touch onboarding. For more information, see Low-touch onboarding of NetScaler instances using NetScaler Console service connect.
-
If ADM service connect is enabled on an ADC instance, certain diagnostic details are automatically sent to ADM service.
For more information, see Data governance.
Important
NetScaler Console service connect fails to collect the probe data and cannot help in on-boarding the ADC appliance to ADM service if the following conditions are met:
-
NSinternaluser account is disabled. -
SSH public key is not set up.
To overcome the preceding scenario, Citrix® recommends you follow any one of the following:
-
Enable
internaluseruser account by using theset ns param –internaluserlogin ENABLED. -
Configure the public key authentication. For more information, see Access a NetScaler appliance by using SSH keys and no password .
How does NetScaler Console service connect support with NetScaler Console service?
Here is a high-level workflow of how the NetScaler Console service connect feature on NetScaler interacts with NetScaler Console service.
-
NetScaler Console service connect feature on NetScaler appliance auto connects with NetScaler Console service using a periodic probe request.
-
This request has system, usage and telemetry data, using which the NetScaler Console service gives you some insights and recommendations on your NetScaler infrastructure. Like; quick identification of performance issues, high resource usage, and critical errors.
-
You can view the insights and recommendations and decide to onboard your ADC instances to the NetScaler Console service to start managing your NetScaler instances.
-
When you decide to onboard, the NetScaler Console service connect feature helps complete the onboarding seamlessly.
What versions of NetScaler is NetScaler Console service connect supported on?
NetScaler Console service connect is supported on all NetScaler platforms and all appliance models (MPX, VPX, and SDX). Starting from NetScaler release 13.0 build 61.xx, NetScaler Console service connect is enabled by default for NetScaler appliances.
How to enable NetScaler Console service connect?
If you are an existing NetScaler customer, and upgrade to NetScaler release 13.0 build 61.xx, NetScaler Console service connect is enabled by default as part of the upgrade process.
If you are a new NetScaler customer, installing NetScaler release 13.0 build 61.xx, NetScaler Console service connect is enabled by default as part of the install process.
Note
Unlike the new NetScaler appliances, existing NetScaler appliances find the route through Citrix Insight Service (CIS) or Call Home.
How to enable and disable NetScaler Console service connect?
You can enable and disable NetScaler Console service connect from CLI, GUI, or NITRO API methods.
Using CLI
To enable the NetScaler Console service connect by using the CLI
At the command prompt, type:
set adm parameter –admserviceconnect ENABLED
To disable the NetScaler Console service connect by using the CLI
At the command prompt, type:
set adm parameter –admserviceconnect DISABLED
Important
If your NetScaler is on release 13.0 build 61.xx, the parameter name to enable or disable NetScaler service connect is "autoconnect." For example, to enable service connect, use the
set adm parameter – autoconnect ENABLED command.
Using the GUI
To disable the NetScaler Console service connect by using the NetScaler GUI
-
In a web browser, type the IP address of the NetScaler appliance (for example,
<http://192.0.2.10>). -
In User Name and Password, enter the administrator credentials.
-
Navigate to System > Settings > Configure ADM Parameters.
-
On the Configure ADM Parameters page, clear the Enable NetScaler Console service connect dialog box, and click OK.
Using the NITRO API
You can disable NetScaler Console service connect by using the NITRO command.
-
In NetScaler release 13.0 build 61.xx, you can enable or disable the NetScaler Console service connect by using the following command:
-
curl –X PUT –H "Content-Type:application/json" http://192.0.2.10/nitro/v1/config/admparameter> -d '{"admparameter":{"autoconnect":"enabled"}}' -u nsroot:Test@1
-
-
From NetScaler release 13.0 build 64.xx, the "autoconnect" parameter name is renamed to
admserviceconnect. You can disable the NetScaler Console service connect by using the following command:-
curl –X PUT –H “Content-Type:application/json” http://192.0.2.10/nitro/v1/config/admparameter -d '{"admparameter":{"admserviceconnect":"disabled"}}' -u nsroot:Test@1
-
Diagnostic tool
When you onboard an ADC instance onto NetScaler Console, you might experience a few issues that prevent the ADC instance from successfully onboarding. To troubleshoot the issues, you can either manually use the diagnostic tool or see the diagnostic information in the ADM GUI.
-
For more information about the details captured using ADM service connect, see Data governance.
-
For more information about the diagnostic tool, see Diagnostic tool.
NetScaler Console built-in agent behavior
From NetScaler release 13.0 build 61.xx and higher, the NetScaler Console built-in agent available on NetScaler instances communicates with ADM service. It communicates without the need for manual initialization on the respective ADC instance. After communication with ADM service is established, the built-in agent stays evergreen by auto-upgrading itself to the latest software version regularly.
Previously, you had to initialize the built-in agent on the ADC instances, using
mastools commands, to establish communication with ADM service and for regular auto-upgrades. For more information, see Configure the ADC built-in agent to manage instances.
References
For more information on NetScaler Console service connect, see the following topics:
-
Data governance: Data governance.
-
NetScaler Console service: NetScaler Application Delivery Management Service.