| getlbparameterResult Structure Definition |
The getlbparameterResult structure defines the return type for getlbparameter 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. |
lbparameterList |
List of lbparameters |
| lbparameter Structure Definition |
The lbparameter structure defines the actual return type values for getlbparameter API. |
Syntax |
Members |
httponlycookieflag |
Include the HttpOnly attribute in persistence cookies. The HttpOnly attribute limits the scope of a cookie to HTTP requests and helps mitigate the risk of cross-site scripting attacks. |
usesecuredpersistencecookie |
Encode persistence cookie values using SHA2 hash. NOTE: This attribute is deprecated. This method is decrepricated in 12.0, instead use UseEncryptedPersistenceCookie |
useencryptedpersistencecookie |
Encode persistence cookie values using SHA2 hash. |
cookiepassphrase |
Use this parameter to specify the passphrase used to generate secured persistence cookie value. It specifies the passphrase with a maximum of 31 characters. |
consolidatedlconn |
To find the service with the fewest connections, the virtual server uses the consolidated connection statistics from all the packet engines. The NO setting allows consideration of only the number of connections on the packet engine that received the new connection. |
useportforhashlb |
Include the port number of the service when creating a hash for hash based load balancing methods. With the NO setting, only the IP address of the service is considered when creating a hash. |
preferdirectroute |
Perform route lookup for traffic received by the Citrix ADC, and forward the traffic according to configured routes. Do not set this parameter if you want a wildcard virtual server to direct packets received by the appliance to an intermediary device, such as a firewall, even if their destination is directly connected to the appliance. Route lookup is performed after the packets have been processed and returned by the intermediary device. |
startuprrfactor |
Used to change the factor of service hits after which vserver will come out of slowstart phase. |
monitorskipmaxclient |
When a monitor initiates a connection to a service, do not check to determine whether the number of connections to the service has reached the limit specified by the service's Max Clients setting. Enables monitoring to continue even if the service has reached its connection limit. |
monitorconnectionclose |
Close monitoring connections by sending the service a connection termination message with the specified bit set. |
vserverspecificmac |
Allow a MAC-mode virtual server to accept traffic returned by an intermediary device, such as a firewall, to which the traffic was previously forwarded by another MAC-mode virtual server. The second virtual server can then distribute that traffic across the destination server farm. Also useful when load balancing Branch Repeater appliances.
Note: The second virtual server can also send the traffic to another set of intermediary devices, such as another set of firewalls. If necessary, you can configure multiple MAC-mode virtual servers to pass traffic successively through multiple sets of intermediary devices. |
sessionsthreshold |
This option is used to get the upper-limit on the number of persistent sessions set by the administrator for this system |
builtin |
allowboundsvcremoval |
This is used, to enable/disable the option of svc/svcgroup removal, if it is bound to one or more vserver. If it is enabled, the svc/svcgroup can be removed, even if it bound to vservers. If disabled, an error will be thrown, when the user tries to remove a svc/svcgroup without unbinding from its vservers. |
retainservicestate |
This option is used to retain the original state of service or servicegroup member when an enable server method is issued. |
dbsttl |
Specify the TTL for DNS record for domain based service. The default value of ttl is 0 which indicates to use the TTL received in DNS response for monitors |
maxpipelinenat |
Maximum number of concurrent requests to allow on a single client connection, which is identified by the |
literaladccookieattribute |
String configured as LiteralADCCookieAttribute will be appended as attribute for Citrix ADC cookie (for example: LB cookie persistence , GSLB site persistence, CS cookie persistence, LB group cookie persistence).
Sample usage -
set lb parameter -LiteralADCCookieAttribute ";SameSite=None" |
computedadccookieattribute |
ComputedADCCookieAttribute accepts ns variable as input in form of string starting with $ (to understand how to configure ns variable, please check man add ns variable). policies can be configured to modify this variable for every transaction and the final value of the variable after policy evaluation will be appended as attribute to Citrix ADC cookie (for example: LB cookie persistence , GSLB sitepersistence, CS cookie persistence, LB group cookie persistence). Only one of ComputedADCCookieAttribute, LiteralADCCookieAttribute can be set.
Sample usage -
add ns variable lbvar -type TEXT(100) -scope Transaction
add ns assignment lbassign -variable $lbvar -set "\\";SameSite=Strict\\""
add rewrite policy lbpol |
adccookieattributewarningmsg |
Used to describe any configuration issue with respect to ns variable configured as part of set lb parameter |
storemqttclientidandusername |
This option allows to store the MQTT clientid and username in transactional logs |
dropmqttjumbomessage |
When this option is enabled, MQTT messages of length greater than 64k will be dropped and the client/server connections will be reset. |
lbhashalgowinsize |
This options allows to increase window size used in LB hashing algorithm(DEFAULT). |
lbhashalgorithm |
This option dictates the hashing algorithm used for hash based LB methods (URLHASH, DOMAINHASH, SOURCEIPHASH, DESTINATIONIPHASH, SRCIPDESTIPHASH, SRCIPSRCPORTHASH, TOKEN, USER_TOKEN, CALLIDHASH). |
lbhashfingers |
This option is used to specify the number of fingers to be used in PRAC and JARH algorithms for hash based LB methods. Increasing the number of fingers might give better distribution of traffic at the expense of additional memory |
undefaction |
Action to perform when policy evaluation creates an UNDEF condition. Available settings function as follows:
* NOLBACTION - Does not consider LB action in making LB decision.
* RESET - Reset the request and notify the user, so that the user can resend the request.
* DROP - Drop the request without sending a response to the user. |
overridepersistencyfororder |
This option is used to override persistency when order is configured for services or servicegroups. |
proximityfromself |
Use the ADC location instead of client IP for static proximity LB or GSLB decision. |
radiusmessageauthenticator |
If enabled, NetScaler will verify the message authenticator and also generate message authenticator if not present. |
_nextgenapiresource |
See Also |