| getlbvserverResult Structure Definition |
The getlbvserverResult structure defines the return type for getlbvserver API. |
Syntax |
Members |
rc |
If the method succeeds, rc is 0 else rc > 0. Values above 0x8000 indicate Warnings. |
message |
If the method succeeds, message is NULL else message contains Error/Warning message. |
lbvserverList |
List of lbvservers |
| lbvserver Structure Definition |
The lbvserver structure defines the actual return type values for getlbvserver API. |
Syntax |
Members |
name |
Name of the virtual server. |
insertvserveripport |
The virtual IP and port header insertion option for the vserver. |
vipheader |
Name for the inserted header. The default name is vip-header. |
value |
SSL status. |
ipaddress |
The IP address of the virtual server. NOTE: This attribute is deprecated. This is no more in use. |
ipaddress2 |
IPv4 or IPv6 address to assign to the virtual server. |
listenpolicy |
The string is listenpolicy configured for lb vserver |
listenpriority |
This parameter is the priority for listen policy of LB Vserver. |
ipmapping |
The permanent mapping for the V6 Address |
port |
Port number for the virtual server. |
ipset |
The list of IPv4/IPv6 addresses bound to ipset would form a part of listening service on the current lb vserver |
range |
Number of IP addresses that the appliance must generate and assign to the virtual server. The virtual server then functions as a network virtual server, accepting traffic on any of the generated IP addresses. The IP addresses are generated automatically, as follows:
* For a range of n, the last octet of the address specified by the IP Address parameter increments n-1 times.
* If the last octet exceeds 255, it rolls over to 0 and the third octet increments by 1.
Note: The Range parameter assigns multiple IP addresses to one virtual server. To generate an array of virtual servers, each of which owns only one IP address, use brackets in the IP Address and Name parameters to specify the range. For example:
add lb vserver my_vserver[1-3] HTTP 192.0.2.[1-3] 80 |
servicetype |
Protocol used by the service (also called the service type). |
ngname |
Nodegroup name to which this lbvsever belongs to |
type |
Type of LB vserver. |
state |
Current LB vserver state. |
effectivestate |
Effective state of the LB vserver , based on the state of backup vservers. |
status |
Current status of the lb vserver. During the initial phase if the configured lb method is not round robin , the vserver will adopt round robin to distribute traffic for a predefined number of requests. |
lbrrreason |
Reason why a vserver is in RR. The following are the reasons:
1 - MEP is DOWN (GSLB)
2 - LB method has changed
3 - Bound service's state changed to UP
4 - A new service is bound
5 - Startup RR factor has changed
6 - LB feature is enabled
7 - Load monitor is not active on a service
8 - Vserver is Enabled
9 - SSL feature is Enabled
10 - All bound services have reached threshold. Using effective state to load balance (GSLB)
11 - Primary state of bound services are not UP. Using effective state to load balance (GSLB)
12 - No LB decision can be made as all bound services have either reached threshold or are not UP (GSLB)
13 - All load monitors are active
|
cachetype |
Cache type CS/CR |
redirect |
Cache redirect type. |
precedence |
Precedence. |
redirecturl |
The redirect URL. |
authentication |
Authentication. |
authn401 |
HTTP 401 response based authentication. |
authnvsname |
Name of an authentication virtual server with which to authenticate users. |
homepage |
Home page. |
dnsvservername |
DNS vserver name. |
domain |
Domain. |
policyname |
The bound bot policy names. |
servicename |
Service to bind to the virtual server. |
servicegroupname |
The service group names. |
weight |
Weight to assign to the specified service. |
dynamicweight |
Dynamic weight |
cachevserver |
Cache virtual server. |
backupvserver |
Name of the backup virtual server to which to forward requests if the primary virtual server goes DOWN or reaches its spillover threshold. |
priority |
The priorities of bound bot policies. |
clttimeout |
The client timeout in seconds. |
somethod |
The spillover method to be in effect. |
sopersistence |
State of spillover persistence. |
sopersistencetimeout |
The maximum time persistence is in effect for a specific client on a spillover vserver. |
healththreshold |
Threshold in percent of active services below which vserver state is made down. |
sothreshold |
Threshold at which spillover occurs. Specify an integer for the CONNECTION spillover method, a bandwidth value in kilobits per second for the BANDWIDTH method (do not enter the units), or a percentage for the HEALTH method (do not enter the percentage symbol). |
sobackupaction |
Action to be performed if spillover is to take effect, but no backup chain to spillover is usable or exists |
lbmethod |
The load balancing method to be in effect |
backuplbmethod |
Indicates the backup method in case the primary fails |
hashlength |
The hash length. |
dataoffset |
The data offset length for TOKEN load balancing method. |
health |
Health of vserver based on percentage of weights of active svcs/all svcs. This does not consider administratively disabled svcs |
datalength |
The data length for TOKEN load balancing method. |
netmask |
The netmask of the destination network. |
v6netmasklen |
The netmask of the destination network. |
rule |
Rule type. |
resrule |
Use this parameter to specify the expression to be used in response for RULE persistence type.
The string is an in-line expression with a maximum of 1499 characters. |
gotopriorityexpression |
The next_expr-s of bound bot policies. |
ruletype |
Rule type. |
groupname |
LB group to which the lb vserver is to be bound. |
m |
The LB mode. |
tosid |
TOS ID |
persistencetype |
The persistence type for the specified virtual server |
timeout |
The maximum time persistence is in effect for a specific client. |
cookiedomain |
Domain name to be used in the set cookie header in case of cookie persistence. |
persistmask |
The persistence mask for v4 traffic |
v6persistmasklen |
The persistence mask for v6 traffic. |
persistencebackup |
The maximum time backup persistence is in effect for a specific client. |
backuppersistencetimeout |
Time period for which backup persistence is in effect. |
cacheable |
The state of caching. |
rtspnat |
Use network address translation (NAT) for RTSP data connections. |
sessionless |
To enable sessionless load balancing, enable this option |
trofspersistence |
When value is ENABLED, Trofs persistence is honored. When value is DISABLED, Trofs persistence is not honored. |
map |
Map. |
connfailover |
The connection failover mode of the virtual server |
redirectportrewrite |
Rewrite the port and change the protocol to ensure successful HTTP redirects from services. |
downstateflush |
Flush all active transactions associated with a virtual server whose state transitions from UP to DOWN. Do not enable this option for applications that must complete their transactions. |
disableprimaryondown |
Tells whether traffic will continue reaching backup vservers even after primary comes UP from DOWN state. |
gt2gb |
Allow for greater than 2 GB transactions on this vserver. |
consolidatedlconn |
Use consolidated stats for LeastConnection. |
consolidatedlconngbl |
Fetches Global setting. |
thresholdvalue |
Tells whether threshold exceeded for this service participating in CUSTOMLB |
type2 |
The bindpoint to which the policy is bound |
invoke |
The invoke flag of bound bot policies. |
labeltype |
The invoke-label-types of bound bot policies. |
labelname |
The invoke-labels of bound bot policies. |
cookieipport |
Encryped Ip address and port of the service that is inserted into the set-cookie http header |
cookiename |
Use this parameter to specify the cookie name for COOKIE peristence type. It specifies the name of cookie with a maximum of 32 characters. If not specified, cookie name is internally generated. |
vserverid |
Vserver Id |
version |
Cookie version |
totalservices |
Total number of services bound to the vserver. |
activeservices |
Total number of active services bound to the vserver. |
statechangetimesec |
Time when last state change happened. Seconds part. |
statechangetimeseconds |
Time when last state change happened. Seconds part. |
statechangetimemsec |
Time at which last state change happened. Milliseconds part. |
tickssincelaststatechange |
Time in 10 millisecond ticks since the last state change. |
hits |
Hits of bound cs policy |
pipolicyhits |
The hits of bound CSW PI policies. |
authenticationhost |
Fully qualified domain name (FQDN) of the authentication virtual server to which the user must be redirected for authentication. Make sure that the Authentication parameter is set to ENABLED. |
push |
Process traffic with the push virtual server that is bound to this load balancing virtual server. |
pushvserver |
Name of the load balancing virtual server, of type PUSH or SSL_PUSH, to which the server pushes updates received on the load balancing virtual server that you are configuring. |
pushlabel |
Expression for extracting a label from the server's response. Can be either an expression or the name of a named expression. |
pushmulticlients |
Allow multiple Web 2.0 connections from the same client to connect to the virtual server and expect updates. |
tcpprofilename |
Name of the TCP profile whose settings are to be applied to the virtual server. |
httpprofilename |
Name of the HTTP profile whose settings are to be applied to the virtual server. |
dbprofilename |
Name of the DB profile whose settings are to be applied to the virtual server. |
comment |
Any comments that you might want to associate with the virtual server. |
policysubtype |
Flag to indicate bind entity is CS Vserver/CS Policylabel. For CS Vserver it is 1, for CS policylabel it is 2 |
l2conn |
Use Layer 2 parameters (channel number, MAC address, and VLAN ID) in addition to the 4-tuple ( |
oracleserverversion |
Oracle server version |
mssqlserverversion |
For a load balancing virtual server of type MSSQL, the Microsoft SQL Server version. Set this parameter if you expect some clients to run a version different from the version of the database. This setting provides compatibility between the client-side and server-side connections by ensuring that all communication conforms to the server's version. |
mysqlprotocolversion |
MySQL protocol version that the virtual server advertises to clients. |
mysqlserverversion |
MySQL server version string that the virtual server advertises to clients. |
mysqlcharacterset |
Character set that the virtual server advertises to clients. |
mysqlservercapabilities |
Server capabilities that the virtual server advertises to clients. |
appflowlog |
Apply AppFlow logging to the virtual server. |
netprofile |
Name of the network profile to associate with the virtual server. If you set this parameter, the virtual server uses only the IP addresses in the network profile as source IP addresses when initiating connections with servers. |
icmpvsrresponse |
How the Citrix ADC responds to ping requests received for an IP address that is common to one or more virtual servers. Available settings function as follows:
* If set to PASSIVE on all the virtual servers that share the IP address, the appliance always responds to the ping requests.
* If set to ACTIVE on all the virtual servers that share the IP address, the appliance responds to the ping requests if at least one of the virtual servers is UP. Otherwise, the appliance does not respond.
* If set to ACTIVE on some virtual servers and PASSIVE on the others, the appliance responds if at least one virtual server with the ACTIVE setting is UP. Otherwise, the appliance does not respond.
Note: This parameter is available at the virtual server level. A similar parameter, ICMP Response, is available at the IP address level, for IPv4 addresses of type VIP. To set that parameter, use the add ip method in the CLI or the Create IP dialog box in the GUI. |
rhistate |
Route Health Injection (RHI) functionality of the NetSaler appliance for advertising the route of the VIP address associated with the virtual server. When Vserver RHI Level (RHI) parameter is set to VSVR_CNTRLD, the following are different RHI behaviors for the VIP address on the basis of RHIstate (RHI STATE) settings on the virtual servers associated with the VIP address:
* If you set RHI STATE to PASSIVE on all virtual servers, the Citrix ADC always advertises the route for the VIP address.
* If you set RHI STATE to ACTIVE on all virtual servers, the Citrix ADC advertises the route for the VIP address if at least one of the associated virtual servers is in UP state.
* If you set RHI STATE to ACTIVE on some and PASSIVE on others, the Citrix ADC advertises the route for the VIP address if at least one of the associated virtual servers, whose RHI STATE set to ACTIVE, is in UP state. |
newservicerequest |
Number of requests, or percentage of the load on existing services, by which to increase the load on a new service at each interval in slow-start mode. A non-zero value indicates that slow-start is applicable. A zero value indicates that the global RR startup parameter is applied. Changing the value to zero will cause services currently in slow start to take the full traffic as determined by the LB method. Subsequently, any new services added will use the global RR factor. |
newservicerequestunit |
Units in which to increment load at each interval in slow-start mode. |
newservicerequestincrementinterval |
Interval, in seconds, between successive increments in the load on a new service or a service whose state has just changed from DOWN to UP. A value of 0 (zero) specifies manual slow start. |
vsvrbindsvcip |
used for showing the ip of bound entities |
vsvrbindsvcport |
used for showing ports of bound entities |
preferredlocation |
Used for displaying the location of bound services. |
persistavpno |
Persist AVP number for Diameter Persistency.
In case this AVP is not defined in Base RFC 3588 and it is nested inside a Grouped AVP,
define a sequence of AVP numbers (max 3) in order of parent to child. So say persist AVP number X
is nested inside AVP Y which is nested in Z, then define the list as Z Y X |
skippersistency |
This argument decides the behavior incase the service which is selected from an existing persistence session has reached threshold. |
minautoscalemembers |
Minimum number of members expected to be present when vserver is used in Autoscale. |
maxautoscalemembers |
Maximum number of members expected to be present when vserver is used in Autoscale. |
authnprofile |
Name of the authentication profile to be used when authentication is turned on. |
macmoderetainvlan |
This option is used to retain vlan information of incoming packet when macmode is enabled |
dbslb |
Enable database specific load balancing for MySQL and MSSQL service types. |
dns64 |
This argument is for enabling/disabling the dns64 on lbvserver |
bypassaaaa |
If this option is enabled while resolving DNS64 query AAAA queries are not sent to back end dns server |
recursionavailable |
When set to YES, this option causes the DNS replies from this vserver to have the RA bit turned on. Typically one would set this option to YES, when the vserver is load balancing a set of DNS servers thatsupport recursive queries. |
processlocal |
By turning on this option packets destined to a vserver in a cluster will not under go any steering. Turn this option for single packet request response mode or when the upstream device is performing a proper RSS for connection based distribution. |
vsvrdynconnsothreshold |
Spillover threshold for dynamic connection |
backupvserverstatus |
Staus of BackUp Vserver . |
dnsprofilename |
Name of the DNS profile to be associated with the VServer. DNS profile properties will be applied to the transactions processed by a VServer. This parameter is valid only for DNS and DNS-TCP VServers. |
lbprofilename |
Name of the LB profile which is associated to the vserver |
redirectfromport |
Port number for the virtual server, from which we absorb the traffic for http redirect |
httpsredirecturl |
URL to which all HTTP traffic received on the port specified in the -redirectFromPort parameter is redirected. |
retainconnectionsoncluster |
This option enables you to retain existing connections on a node joining a Cluster system or when a node is being configured for passive timeout. By default, this option is disabled. |
analyticsprofile |
Name of the analytics profile bound to the LB vserver. |
nodefaultbindings |
to determine if the configuration will have default ssl CIPHER and ECC curve bindings |
adfsproxyprofile |
Name of the adfsProxy profile to be used to support ADFSPIP protocol for ADFS servers. |
tcpprobeport |
Port number for external TCP probe. NetScaler provides support for external TCP health check of the vserver status over the selected port. This option is only supported for vservers assigned with an IPAddress or ipset. NOTE: This attribute is deprecated. The functionality is intact, but we advise to use -probePort and -probeProtocol options |
quicbridgeprofilename |
Name of the QUIC Bridge profile whose settings are to be applied to the virtual server. |
probeprotocol |
Citrix ADC provides support for external health check of the vserver status. Select HTTP or TCP probes for healthcheck |
probeport |
Citrix ADC provides support for external health check of the vserver status. Select port for HTTP/TCP monitring |
probesuccessresponsecode |
HTTP code to return in SUCCESS case. |
quicprofilename |
Name of QUIC profile which will be attached to the VServer. |
order |
Order number to be assigned to the service when it is bound to the lb vserver. |
order2 |
Order in string form assigned to the service when it is bound to the lb vserver. |
toggleorder |
Configure this option to toggle order preference |
orderthreshold |
This option is used to to specify the threshold of minimum number of services to be UP in an order, for it to be considered in Lb decision. |
currentactiveorder |
current order that takes the traffic in case service or servicegroup is bound with order |
apiprofile |
The API profile where one or more API specs are bounded to. |
dnsoverhttps |
This option is used to enable/disable DNS over HTTPS (DoH) processing. |
_nextgenapiresource |
svcipaddress |
svcport |
svctype |
svcstate |
svcgrpsvcname |
svcgrpmemgrpname |
svcgrpmemip |
svcgrpmemport |
svcgrpmemsvctype |
svcgrpmemstate |
svcgrpmemweight |
svcgrpmemdynwtmethod |
svcgrpmemcookieipport |
svcgrpmemcookiename |
svcgrpmemvserverid |
syslogpolicyname |
syslogpriority |
nslogpolicyname |
nslogpriority |
appfwpolicyname |
The bound AS policy names. |
appfwpriority |
The priorities of bound application firewall policies. |
appfwpolicygotoprioexpression |
The next_expr-s of bound Application firewall policies. |
appfwbindpoint |
The bindpoints of bound application firewall policies. |
appfwinvoke |
The invoke flag of bound application firewall policies. |
appfwpolicyinvokelabeltype |
The invoke-label-types of bound application firewall policies. |
appfwpolicyinvokelabelname |
The invoke-labels of bound application firewall policies. |
appqospolicyname |
The bound AppQoS policy names. |
appqospolicypriority |
appqospolicygotoprioexpr |
appqospolicybindpoint |
transformpolicyname |
The bound transform policy names. |
transformpolicypriority |
The priorities of bound transform policies. |
transformpolicygotoprioexpression |
The next_expr-s of bound transform policies. |
transformpolicybindpoint |
The bindpoints of bound transform policies. |
transforminvoke |
The invoke flag of bound application policies. |
transformpolicyinvokelabeltype |
The invoke-label-types of bound transform policies. |
transformpolicyinvokelabelname |
The invoke-labels of bound transform policies. |
rwpolicyname |
The bound RW policy names. |
rwpolicypriority |
The priorities of bound RW policies. |
rwpolicygotoprioexpression |
The next_expr-s of bound RW policies. |
rwpolicybindpoint |
The bindpoints of bound RW policies. |
rwinvoke |
The invoke flag of bound RW policies. |
rwpolicyinvokelabeltype |
The invoke-label-types of bound RW policies. |
rwpolicyinvokelabelname |
The invoke-labels of bound RW policies. |
cmppolicyname |
The bound Compression policy names. |
cmppolicypriority |
The priorities of bound Compression policies. |
cmppolicygotoprioexpr |
The next_expr-s of bound CMP policies. |
cmppolicybindpoint |
The bindpoints of bound CMP policies. |
cmpinvoke |
The invoke flag of bound CMP policies. |
cmppolicyinvokelabeltype |
The invoke-label-types of bound CMP policies. |
cmppolicyinvokelabelname |
The invoke-labels of bound CMP policies. |
feopolicyname |
The bound Content optimizatoin policy names. |
feopolicypriority |
The priorities of bound CO policies. |
feopolicynextexpr |
The next_expr-s of bound CO policies. |
feopolicybindpoint |
The bindpoints of bound CO policies. |
authorpolicyname |
The bound Authorization policy names. |
authorpolicypriority |
The priorities of bound Authorization policies. |
authorpolicygotoprioexpr |
The next_expr-s of bound AUTHOR policies. |
authorpolicybindpoint |
The bindpoints of bound AUTHOR policies. |
authorinvoke |
The invoke flag of bound AUTHOR policies. |
authorpolicyinvokelabeltype |
The invoke-label-types of bound AUTHOR policies. |
authorpolicyinvokelabelname |
The invoke-labels of bound AUTHOR policies. |
cachepolicyname |
The bound Cache policy names. |
cachepolicypriority |
The priorities of bound Cache policies. |
cachepolicygotoprioexpression |
The next_expr-s of bound CACHE policies. |
cachepolicybindpoint |
The bindpoints of bound CACHE policies. |
cacheinvoke |
The invoke flag of bound CACHE policies. |
cachepolicyinvokelabeltype |
The invoke-label-types of bound CACHE policies. |
cachepolicyinvokelabelname |
The invoke-labels of bound CACHE policies. |
videooptdetectionpolicyname |
The bound videooptimization detectionpolicy names. |
videooptdetectionpolicypriority |
The priorities of bound videooptimization detectionpolicies. |
videooptdetectionpolicynextexpr |
The next_expr-s of bound videooptimization detectionpolicies. |
videooptdetectionpolicybindpoint |
The bindpoints of bound videooptimization detectionpolicies. |
policyinvoke |
The invoke flag of bound videooptimization detectionpolicies. |
policylabeltype |
The invoke-label-types of bound video optimization policies. |
policylabelname |
The invoke-labels of bound videooptimization detectionpolicies. |
videooptpacepolicyname |
The bound videooptimization pacingpolicy names. |
videooptpacepolicypriority |
The priorities of bound videooptimization pacingpolicies. |
videooptpacepolicynextexpr |
The next_expr-s of bound videooptimization pacingpolicies. |
videooptpacepolicybindpoint |
The bindpoints of bound videooptimization pacingpolicies. |
policyinvoke2 |
The invoke flag of bound videooptimization pacingpolicies. |
policylabeltype2 |
The invoke-label-types of bound videooptimization pacingpolicies. |
policylabelname2 |
The invoke-labels of bound videooptimization pacingpolicies. |
rsppolicyname |
The bound Responder policy names. |
rsppolicypriority |
The priorities of bound Responder policies. |
rsppolicygotoprioexpression |
The next_expr-s of bound Responder policies. |
rspinvoke |
The invoke flag of bound Responder policies. |
rsppolicyinvokelabeltype |
The invoke-label-types of bound Responder policies. |
rsppolicyinvokelabelname |
The invoke-labels of bound Responder policies. |
rsppolicybindpoint |
The bindpoint of bound resonder policies. |
lbpolicyname |
The bound LB policy names. |
lbpolicypriority |
The priorities of bound LB policies. |
lbpolicygotoprioexpression |
The next_expr-s of bound LB policies. |
lbinvoke |
The invoke flag of bound LB policies. |
lbpolicyinvokelabeltype |
The invoke-label-types of bound LB policies. |
lbpolicyinvokelabelname |
The invoke-labels of bound LB policies. |
lbpolicybindpoint |
The bindpoint of bound LB policies. |
appflowpolicyname |
The bound AppFlow policy names. |
appflowpolicypriority |
The priorities of bound AppFlow policies. |
appflowpolicygotoprioexpression |
The next_expr-s of bound AppFlow policies. |
appflowpolicybindpoint |
The bindpoints of bound CMP policies. |
appflowinvoke |
The invoke flag of bound AppFlow policies. |
appflowpolicyinvokelabeltype |
The invoke-label-types of bound AppFlow policies. |
appflowpolicyinvokelabelname |
The invoke-labels of bound AppFlow policies. |
cipolicyname |
The bound CI policy names. |
cipolicypriority |
The priorities of bound CI policies. |
cipolicygotoprioexpression |
The next_expr-s of bound CI policies. |
cipolicybindpoint |
The bindpoints of bound CI policies. |
ciinvoke |
The invoke flag of bound CI policies. |
cipolicyinvokelabeltype |
The invoke-label-types of bound CI policies. |
cipolicyinvokelabelname |
The invoke-labels of bound CI policies. |
botbindpoint |
The bindpoints of bound bot policies. |
csvserver |
csvserver for which lbvserver is target |
cswpolicyname |
Bound cs policies |
cspriority |
Priority of bound cs policy |
tmtrafficpolicyname |
The bound tm traffic policy names. |
tmtrafficpolicypriority |
The priorities of bound tm traffic policies. |
spilloverpolicyname |
The bound spillover policy names. |
spilloverpolicygotoprioexpression |
spilloverpolicyflowtype |
spilloverpolicypriority |
The priorities of bound spillover policies. |
dns64policyname |
The bound DNS64 policy names. |
dns64policypriority |
The priorities of bound DNS64 POLICIES. |
dns64policygotoprioexpression |
The priority of the next dns64 policy to evaluate. |
See Also |