Product Documentation

Managing the Real-Time Status of Entities

May 27, 2015

You can manage the virtual servers, services, and service groups configured across all your NetScaler devices from the Command Center console. You can set a time interval for which you want Command Center to poll the values of the entities. You can manage the states of the entities by enabling or disabling them and view the details of command execution using the Audit Trail.

You can poll the latest status of the entities at any given point of time, for example, after you have made a configuration change. You can also conduct a search for the entities based on different parameters, such as health, name, state and Type (CSVserver and LB).

This topic includes the following details:

Configuring the Polling Interval

Updated: 2014-04-18

You can set the time interval for which you want Command Center to poll the real-time values of the virtual servers, services, and service groups. By default, Command Center polls the values every 300 seconds (5 minutes).

Setting the polling interval on any one of the entity nodes (Virtual Servers, Services, or Service Groups) sets it across all the entity nodes.

To configure the polling interval for virtual servers, services, and service groups

  1. On the Monitoring tab, click the Virtual Servers, Services, or Service Groups, and in the right pane, click Configure Polling Interval.
  2. In Configure Polling Interval, type the number of seconds you want to set as the time interval for which Command Center must poll the entity value. Minimum value of the polling interval is 300 seconds (5 minutes). Click OK
    Note: Setting the polling interval on any one of the entity nodes (Virtual Servers, Services, or Service Groups) sets it across all the entity nodes.

To configure the polling interval for virtual servers, services, and service groups

  1. On the Monitoring tab, under NetScaler click the Virtual Servers, Services, or Service Groups, and in the right pane, select the Virtual Server, Service, or Service Group and from the Action drop-down list, select Configure Polling Interval.
  2. In Configure Polling Interval, type the number of seconds you want to set as the time interval for which Command Center must poll the entity value. Minimum value of the polling interval is 300 seconds (5 minutes).
    Note: Setting the polling interval on any one of the entity nodes (Virtual Servers, Services, or Service Groups) sets it across all the entity nodes.
  3. Click OK

Enabling or Disabling Virtual Servers

Updated: 2014-04-15

You can also change the state of a virtual server by enabling or disabling it.

When you enable a virtual server with a state of DOWN or OUT OF SERVICE, its state changes to either UP or DOWN, depending on whether the actual server is UP or DOWN. If the state of the virtual server does not change to UP, log on to the NetScaler to identify the cause and make appropriate changes to the virtual server configuration.

When you disable a virtual server with a state of UP, its state changes to OUT OF SERVICE.

To enable or disable virtual servers

  1. On the Monitoring tab, in the left pane, under NetScaler, click Virtual Servers.
  2. In the right pane, under Virtual Servers, select the virtual server(s) you want to enable or disable, and then click Enable or Disable. Alternately, you can right-click the virtual server, and click Enable or Disable.
  3. Under Enable or Disable Virtual Servers, in Annotation, type a message describing the reason why you are enabling or disabling the virtual server.
  4. Select Save configuration on success if you want to save the configuration, and then click OK.
  5. Under Operation Status, view the status of the task and the following details:
    • Command: Specifies the name of the command executed on the device. Clicking this displays the details of command execution, such as the time when the command was executed and the result of the command execution.
    • Device Name: Specifies the IP address of the device on which the virtual server is configured.
    • Start Time: Specifies the time when the command execution started.
    • Finish Time: Specifies the time when the command execution ended.
    • Status: Specifies the status of command execution (for example, Success and Failed).

Enabling or Disabling Services

Updated: 2014-04-15

You can also change the state of a service by enabling or disabling it.

When you enable a service with a state of DOWN or OUT OF SERVICE, its state changes to either UP or DOWN, depending on whether the actual backend server is UP or DOWN. If the state of the service does not change to UP, log on to the NetScaler to identify the cause and make appropriate changes to the service configuration.

When you disable a service with a state of UP, its state changes to OUT OF SERVICE.

During scheduled network outages such as system upgrades or hardware maintenance, you may have to close or disable some services. To avoid disrupting sessions that have already been established, you can specify a wait time, which places a service in the transition out of service (TROFS) state until the specified wait time expires. The service then enters the OUT OF SERVICE (OFS) state.

Often, however, you cannot estimate the amount of time needed for all the connections to a service to complete the existing transactions. If a transaction is unfinished when the wait time expires, shutting down the service may result in data loss. In this case, you can specify graceful shutdown for the service, so that the service is disabled only when all the established connections are closed by either the server or the client.

Persistence is maintained according to the specified method even if you enable graceful shutdown. The system continues to serve all the persistent clients, including new connections from the clients, unless the service is marked DOWN during the graceful shutdown state as a result of the checks made by a monitor.

The following table describes graceful shutdown options.

Table 1. Graceful Shutdown Options
State Results
Graceful shutdown is enabled and a wait time is specified. Service is shut down after the last of the previously established connections is served, even if the wait time has not expired. The device checks the status of the connections once every second. If the wait time expires, any open sessions are closed.
Graceful shutdown is disabled and a wait time is specified. Service is shut down only after the wait time expires, even if all established connections are served before expiration.
Graceful shutdown is enabled and no wait time is specified. Service is shut down only after the last of the previously established connections is served, regardless of the time taken to serve the last connection.
Graceful shutdown is disabled and no wait time is specified. No graceful shutdown. Service is shut down immediately after the disable option is chosen or the disable command is issued. (The default wait time is zero seconds.)

To enable or disable services

  1. On the Monitoring tab, in the left pane, under NetScaler, click Services.
  2. In the right pane, under Services, select the check box for the service(s) you want to enable or disable, and then click Enable or Disable.
  3. Under Enable or Disable, in Annotation, type a message describing the reason why you are enabling or disabling the service.
  4. In Disable Services, you can specify a wait time and the graceful shutdown time to ensure services are not shut down abruptly.
  5. Select Save configuration on success if you want to save the configuration, and then click OK.
  6. Under Operation Status, view the status of the task and the following details:
    • Command: Specifies the name of the command executed on the device. Clicking this displays the details of command execution, such as the time when the command was executed and the result of the command execution.
    • Device Name: Specifies the IP address of the device on which the service is configured.
    • Start Time: Specifies the time when the command execution started.
    • Finish Time: Specifies the time when the command execution ended.
    • Status: Specifies the status of command execution (for example, Success and Failed).

Enabling or Disabling Service Groups

Updated: 2014-04-15

You can also change the state of a service group by enabling or disabling it.

When you enable a service group member with a state of DOWN or OUT OF SERVICE, the state of the service group to which it belongs changes to either UP or DOWN, depending on whether the actual backend server is UP or DOWN. If the state of the service group does not change to UP, log on to the NetScaler to identify the cause and make appropriate changes to the configuration of the service group.

When you disable a service group member with a state of UP, the state of the service group to which it belongs changes to OUT OF SERVICE.

During scheduled network outages such as system upgrades or hardware maintenance, you may have to close or disable some services. To avoid disrupting sessions that have already been established, you can specify a wait time, which places a service in the transition out of service (TROFS) state until the specified wait time expires. The service then enters the OUT OF SERVICE (OFS) state.

Often, however, you cannot estimate the amount of time needed for all the connections to a service to complete the existing transactions. If a transaction is unfinished when the wait time expires, shutting down the service may result in data loss. In this case, you can specify graceful shutdown for the service, so that the service is disabled only when all the established connections are closed by either the server or the client.

Persistence is maintained according to the specified method even if you enable graceful shutdown. The system continues to serve all the persistent clients, including new connections from the clients, unless the service is marked DOWN during the graceful shutdown state as a result of the checks made by a monitor.

The following table describes graceful shutdown options.

Table 2. Graceful Shutdown Options
State Results
Graceful shutdown is enabled and a wait time is specified. Service group is shut down after the last of the previously established connections is served, even if the wait time has not expired. The device checks the status of the connections once every second. If the wait time expires, any open sessions are closed.
Graceful shutdown is disabled and a wait time is specified. Service group is shut down only after the wait time expires, even if all established connections are served before expiration.
Graceful shutdown is enabled and no wait time is specified. Service group is shut down only after the last of the previously established connections is served, regardless of the time taken to serve the last connection.
Graceful shutdown is disabled and no wait time is specified. No graceful shutdown. Service group is shut down immediately after the disable option is chosen or the disable command is issued. (The default wait time is zero seconds.)

To enable or disable service groups

  1. On the Monitoring tab, in the left pane, under NetScaler, click Service Groups.
  2. In the right pane, under Service Groups, select the service group(s) you want to enable or disable, and then click Enable or Disable.
  3. Under Enable or Disable, in Annotation, type a message describing the reason why you are enabling or disabling the service group.
  4. In Disable Services, you can specify a wait time and the graceful shutdown time to ensure services are not shut down abruptly.
  5. Select Save configuration on success if you want to save the configuration, and then click OK.
  6. Under Operation Status, view the status of the task and the following details:
    • Command: Specifies the name of the command executed on the device. Clicking this displays the details of command execution, such as the time when the command was executed and the result of the command execution.
    • Device Name: Specifies the IP address of the device on which the service group is configured.
    • Start Time: Specifies the time when the command execution started.
    • Finish Time: Specifies the time when the command execution ended.
    • Status: Specifies the status of command execution (for example, Success and Failed).

Viewing the Audit Trail

Updated: 2014-04-17

You can view the audit trail to identify enabled and disabled operations on virtual servers, services, servers, and service group members.

To view the audit trail

  1. On the Monitoring tab, in the left pane, under NetScaler, navigate to Virtual Servers, Services, Servers, or Service Groups >Audit Trails.
  2. Under Audit Trails, you can view the following:
    • Device: Specifies the IP address of the device on which the operation is performed.
    • Operation: Specifies the operation performed on the virtual server, service, or service group member.
    • Name: Specifies the name of the virtual server, service, or service group member on which you have performed the operation.
    • Executed By: Specifies the username of the NetScaler user who performed the operation.
    • Time: Specifies the time when the operation was performed.
    • Status: Specifies the status of the operation performed, which can be Success or Failed.
    • Annotation: Specifies the message describing the reason why the enable or disable operation was performed. This message was entered when performing the operation.

Searching Virtual Servers, Services, and Service Groups

Updated: 2014-04-15

You can use the search option of the Monitoring feature to search for virtual servers, services, or service groups.

To search for a virtual server, service, or service group

  1. On the Monitoring tab, in the left pane, under NetScaler, click Virtual Servers, Services, or Service Groups.
  2. In the right pane, under Virtual Servers, Services, or Service Groups, click Search.
  3. Select the options, and then click Refine Search.

Polling the Status of Virtual Servers, Services, and Service Groups

Updated: 2014-04-15

You can poll the status of specific virtual servers, services, or service groups at any given point of time.

To poll the status of a virtual server, service, or service group

  1. On the Monitoring tab, in the left pane, under Network, click Virtual Servers, Services, or Service Groups.
  2. In the right pane, under Virtual Servers, Services, or Service Groups, select the virtual server, services, or service groups, and then click Poll.