NetScaler Application Delivery Controller Plugin Reference 24.3.x
The Citrix NetScaler Application Delivery Controller plugin allows XL Deploy to manage deployments to application and web servers whose traffic is managed by a NetScaler load-balancing device.
This document provides information that is specific to this version of the NetScaler plugin. For general information about the plugin, refer to Introduction to the XL Deploy NetScaler plugin.
Requirements
- XL Deploy 5.0.0 or later
- XL Deploy Load Balancer plugin (provided with the NetScaler plugin distribution ZIP file)
- Plugins bundled with XL Deploy:
- XL Deploy Group Orchestrator plugin
- XL Deploy Web Server plugin
- NetScaler 8.1, 9.x, or 10.x
Important: Ensure that you download the plugin distribution ZIP file from the XebiaLabs Software Distribution site, as it includes the Load Balancer plugin.
CI Reference
Configuration Item Overview
Deployables
| CI | Description |
|---|---|
| lb.LoadBalancerDeployable | The supertype of all Deployables. |
Deployeds
| CI | Description |
|---|---|
| lb.DisableServerInLoadBalancer | The supertype of all Deployeds. |
| lb.EnableServerInLoadBalancer | The supertype of all Deployeds. |
| lb.LoadBalancerDeployed | The supertype of all Deployeds. |
Containers
| CI | Description |
|---|---|
| lb.LoadBalancer | The Load Balancer super type. |
| netscaler.NetScaler | A Citrix NetScaler LoadBalancer |
Other Configuration Items
| CI | Description |
|---|---|
| netscaler.NetScalerParameters | Default implementation of a CI that provides ID, name and type information. |
| netscaler.NetScalerScriptParameters | Default implementation of a CI that provides ID, name and type information. |
Configuration Item Details
lb.DisableServerInLoadBalancer
| Type Hierarchy | lb.LoadBalancerDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Deployed, udm.EmbeddedDeployedContainer |
The supertype of all Deployeds.
| Parent | ||
|---|---|---|
|
|
|
container:
CI<udm.Container>
|
|
The container on which this deployed runs.
|
| Public properties | ||
|---|---|---|
|
|
|
deployable:
CI<udm.Deployable>
|
|
The deployable that this deployed is derived from.
|
||
|
|
|
netscalerServiceGroup: STRING
|
|
The Service Group that contains the service to disable while this deployed is deploying.
|
||
|
|
|
netscalerServiceGroupName: STRING
|
|
The name of the service in the service group that needs to be disabled while this deployed is deploying.
|
||
|
|
|
netscalerServiceGroupPort: INTEGER
|
|
The port of the service in the service group that needs to be disabled while this deployed is deploying.
|
| Hidden properties | ||
|---|---|---|
|
|
|
boundConfigurationItems:
SET_OF_CI<udm.ConfigurationItem>
|
|
The set of created CIs.
|
lb.EnableServerInLoadBalancer
| Type Hierarchy | lb.LoadBalancerDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Deployed, udm.EmbeddedDeployedContainer |
The supertype of all Deployeds.
| Parent | ||
|---|---|---|
|
|
|
container:
CI<udm.Container>
|
|
The container on which this deployed runs.
|
| Public properties | ||
|---|---|---|
|
|
|
deployable:
CI<udm.Deployable>
|
|
The deployable that this deployed is derived from.
|
||
|
|
|
netscalerServiceGroup: STRING
|
|
The Service Group that contains the service to disable while this deployed is deploying.
|
||
|
|
|
netscalerServiceGroupName: STRING
|
|
The name of the service in the service group that needs to be disabled while this deployed is deploying.
|
||
|
|
|
netscalerServiceGroupPort: INTEGER
|
|
The port of the service in the service group that needs to be disabled while this deployed is deploying.
|
| Hidden properties | ||
|---|---|---|
|
|
|
boundConfigurationItems:
SET_OF_CI<udm.ConfigurationItem>
|
|
The set of created CIs.
|
lb.LoadBalancer
| Virtual Type | |
|---|---|
| Type Hierarchy | udm.BaseContainer >> udm.BaseConfigurationItem |
| Interfaces | udm.Container, overthere.HostContainer, udm.Taggable |
The Load Balancer super type.
| Public properties | ||
|---|---|---|
|
|
|
managedServers:
SET_OF_CI<udm.Container>
|
|
The servers managed by this load balancer
|
| Hidden properties | ||
|---|---|---|
|
|
|
disableInLoadBalancer: BOOLEAN
|
|
Whether this server should be disabled in the load balancer when it is being deployed to
|
||
|
|
|
netscalerAddress: STRING
|
|
The IP address or name this server is registered under in the NetScaler load balancer
|
||
|
|
|
netscalerShutdownDelay: INTEGER
|
|
The amount of seconds before the server is disabled in the NetScaler load balancer (A value of -1 triggers use of the defaultShutdownDelay of the NetScaler device)
|
||
|
|
|
netscalerType: STRING = server
|
|
Whether this is a 'server' or a 'service' in the NetScaler load balancer
|
||
|
|
|
tags: SET_OF_STRING
|
|
If set, only deployables with the same tag will be automatically mapped to this container.
|
lb.LoadBalancerDeployable
| Type Hierarchy | udm.BaseDeployable >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Deployable, udm.Taggable |
The supertype of all Deployables.
| Public properties | ||
|---|---|---|
|
|
|
netscalerServiceGroup: STRING = {{NETSCALER_SERVICE_GROUP}}
|
|
The Service Group that contains the service to disable while this deployed is deploying.
|
||
|
|
|
netscalerServiceGroupName: STRING = {{NETSCALER_SERVICE_GROUP_NAME}}
|
|
The name of the service in the service group that needs to be disabled while this deployed is deploying.
|
||
|
|
|
netscalerServiceGroupPort: STRING = {{NETSCALER_SERVICE_GROUP_PORT}}
|
|
The port of the service in the service group that needs to be disabled while this deployed is deploying.
|
||
|
|
|
tags: SET_OF_STRING
|
|
If set, this deployable will only be mapped automatically to containers with the same tag.
|
| Hidden properties | ||
|---|---|---|
|
|
|
boundTemplates:
SET_OF_CI<udm.Template>
|
|
The set of CI templates.
|
lb.LoadBalancerDeployed
| Virtual Type | |
|---|---|
| Type Hierarchy | udm.BaseDeployed >> udm.BaseConfigurationItem |
| Interfaces | udm.Deployed, udm.EmbeddedDeployedContainer |
The supertype of all Deployeds.
| Parent | ||
|---|---|---|
|
|
|
container:
CI<udm.Container>
|
|
The container on which this deployed runs.
|
| Public properties | ||
|---|---|---|
|
|
|
deployable:
CI<udm.Deployable>
|
|
The deployable that this deployed is derived from.
|
||
|
|
|
netscalerServiceGroup: STRING
|
|
The Service Group that contains the service to disable while this deployed is deploying.
|
||
|
|
|
netscalerServiceGroupName: STRING
|
|
The name of the service in the service group that needs to be disabled while this deployed is deploying.
|
||
|
|
|
netscalerServiceGroupPort: INTEGER
|
|
The port of the service in the service group that needs to be disabled while this deployed is deploying.
|
| Hidden properties | ||
|---|---|---|
|
|
|
boundConfigurationItems:
SET_OF_CI<udm.ConfigurationItem>
|
|
The set of created CIs.
|
netscaler.NetScaler
| Type Hierarchy | lb.LoadBalancer >> udm.BaseContainer >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Container, overthere.HostContainer, udm.Taggable |
A Citrix NetScaler LoadBalancer
| Parent | ||
|---|---|---|
|
|
|
host:
CI<overthere.Host>
|
|
Host
|
| Public properties | ||
|---|---|---|
|
|
|
defaultShutdownDelay: INTEGER
|
|
The amount of seconds to wait before the servers are disabled in the load balancer
|
||
|
|
|
managedServers:
SET_OF_CI<udm.Container>
|
|
The servers managed by this load balancer
|
| Hidden properties | ||
|---|---|---|
|
|
|
disableServersOrder: INTEGER = 8
|
|
Disable Servers Order
|
||
|
|
|
disableServersScript: STRING = netscaler/disable-server.cli.ftl
|
|
Disable Servers Script
|
||
|
|
|
enableServersOrder: INTEGER = 94
|
|
Enable Servers Order
|
||
|
|
|
enableServersScript: STRING = netscaler/enable-server.cli.ftl
|
|
Enable Servers Script
|
||
|
|
|
runScript: STRING = netscaler/run-script.cli.ftl
|
|
Run Script
|
||
|
|
|
sourceCommand: STRING = source
|
|
Source Command
|
||
|
|
|
disableInLoadBalancer: BOOLEAN
|
|
Whether this server should be disabled in the load balancer when it is being deployed to
|
||
|
|
|
netscalerAddress: STRING
|
|
The IP address or name this server is registered under in the NetScaler load balancer
|
||
|
|
|
netscalerShutdownDelay: INTEGER
|
|
The amount of seconds before the server is disabled in the NetScaler load balancer (A value of -1 triggers use of the defaultShutdownDelay of the NetScaler device)
|
||
|
|
|
netscalerType: STRING = server
|
|
Whether this is a 'server' or a 'service' in the NetScaler load balancer
|
||
|
|
|
tags: SET_OF_STRING
|
|
If set, only deployables with the same tag will be automatically mapped to this container.
|
| Control task | Parameter CI | Attributes | Description |
|---|---|---|---|
| disableService | netscaler.NetScalerParameters |
no description |
|
| enableService | netscaler.NetScalerParameters |
no description |
|
| runScript | netscaler.NetScalerScriptParameters |
no description |
netscaler.NetScalerParameters
| Type Hierarchy | udm.Parameters >> udm.BaseConfigurationItem |
|---|
Default implementation of a CI that provides ID, name and type information.
| Public properties | ||
|---|---|---|
|
|
|
serviceGroup: STRING
|
|
NetScaler service group
|
||
|
|
|
serviceGroupName: STRING
|
|
NetScaler service name
|
||
|
|
|
serviceGroupPort: INTEGER
|
|
NetScaler service port
|
netscaler.NetScalerScriptParameters
| Type Hierarchy | udm.Parameters >> udm.BaseConfigurationItem |
|---|
Default implementation of a CI that provides ID, name and type information.
| Public properties | ||
|---|---|---|
|
|
|
netScalerScript: STRING
|
|
Script to execute on the NetScaler device
|