Product Documentation

Verifying the Configuration

Mar 15, 2012

To verify that your content switching configuration is correct, you need to view the content switching entities. To verify proper operation after your content switching configuration has been deployed, you can view the statistics that are generated as the servers are accessed.

Viewing the Properties of Content Switching Virtual Servers

Updated: 2013-10-31

You can view the properties of content switching virtual servers that you have configured on the NetScaler. You can use the information to verify whether the virtual server is correctly configured and, if necessary, to troubleshoot. In addition to details such as name, IP address, and port, you can view the various policies bound to a virtual server, and its traffic-management settings.

The content switching policies are displayed in the order of their priority. If more than one policy has the same priority, they are shown in the order in which they are bound to the virtual server.

Note: If you have configured the content switching virtual server to forward traffic to a load balancing virtual server, you can also view the content switching policies by viewing the properties of the load balancing virtual server.

To view the properties of content switching virtual servers by using the command line interface

To list basic properties of all content switching virtual servers in your configuration, or detailed properties of a specific content switching virtual server, at the command prompt, type one of the following commands:

  • show cs vserver
  • show cs vserver <name>

Example

1.  
show cs vserver Vserver-CS-1 
Vserver-CS-1 (10.102.29.161:80) - HTTP Type: CONTENT 
State: UP 
Last state change was at Thu Jun 30 10:48:59 2011 
Time since last state change: 6 days, 20:03:00.760 
Client Idle Timeout: 180 sec 
Down state flush: ENABLED 
Disable Primary Vserver On Down : DISABLED 
Appflow logging: DISABLED 
Port Rewrite : DISABLED 
State Update: DISABLED 
Default: Content Precedence: RULE 
Vserver IP and Port insertion: OFF 
Case Sensitivity: ON 
Push: DISABLED Push VServer: 
Push Label Rule: none 
 
... 
1) Policy : __ESNS_PREBODY_POLICY Priority:0 
2) Policy : __ESNS_POSTBODY_POLICY Priority:0 
 
1) Compression Policy Name: __ESNS_CMP_POLICY Priority: 2147483647 
GotoPriority Expression: END 
Flowtype: REQUEST 
 
1) Rewrite Policy Name: __ESNS_REWRITE_POLICY Priority: 2147483647 
GotoPriority Expression: END 
Flowtype: REQUEST 
 
1) Cache Policy Name: dfbx Priority: 10 
GotoPriority Expression: END 
Flowtype: REQUEST 
 
1) Responder Policy Name: __ESNS_RESPONDER_POLICY Priority: 2147483647 
GotoPriority Expression: END 
 
1) Policy: wiki Target: LBVIP2 Priority: 25 Hits: 0 
2) Policy: plain Target: LBVIP1 Priority: 90 Hits: 0 
3) Policy: DispOrderTest2 Target: KerbAuthLBVS Priority: 91 Hits: 0 
4) Policy: test_Pol Target: LBVIP1 Priority: 92 Hits: 0 
5) Policy: PolicyNameTesting Target: LBVIP1 Priority: 100 Hits: 0 
 Done 
> 
 
2. 
show cs vserver 
1) Vserver-CS-1 (10.102.29.161:80) - HTTP Type: CONTENT 
State: UP 
… 
Appflow logging: DISABLED 
Port Rewrite : DISABLED 
State Update: DISABLED 
 
2) apubendpt (10.111.111.1:80) - HTTP Type: CONTENT 
State: UP 
… 
Client Idle Timeout: 180 sec 
Down state flush: DISABLED 
… 
 
3) apubendpt1 (10.111.111.2:80) - HTTP Type: CONTENT 
State: UP 
… 
Disable Primary Vserver On Down : DISABLED 
Appflow logging: DISABLED 
Port Rewrite : DISABLED 
State Update: DISABLED 
…

Viewing Content Switching Policies

You can view the properties of the content switching policies that you defined, such as the name, domain, and URL or expression, and use the information to find any mistakes in the configuration, or to troubleshoot if something is not working as it should.

To view the properties of content switching policies by using the command line interface

To list either basic properties of all content switching policies in your configuration or detailed properties of a specific content switching policy, at the command prompt, type one of the following commands:

  • show cs policy
  • show cs policy <PolicyName>

Example

show cs policy 
 
show cs policy Policy-CS-1

To view the properties of content switching policies by using the configuration utility

Navigate to Traffic Management > Content Switching > Policies, select a policy and, in the Action list, select Show Bindings.

Viewing a Content Switching Virtual Server Configuration by Using the Visualizer

 

The Content Switching Visualizer is a tool that you can use to view a content switching configuration in graphical format. You can use the visualizer to view the following configuration items:

  • A summary of the load balancing virtual servers to which the content switching virtual server is bound.
  • All services and service groups that are bound to the load balancing virtual server and all monitors that are bound to the services.
  • The configuration details of any displayed element.
  • Any policies bound to the content switching virtual server. These policies need not be content switching policies. Many types of policies, such as Rewrite policies, can be bound to a content switching virtual server.

After you configure the various elements in a content switching and load balancing setup, you can export the entire configuration to an application template file.

Note: The Visualizer requires a graphical interface, so it is available only through the configuration utility.

To view a content switching configuration by using the Visualizer in the configuration utility

  1. Navigate to Traffic Management > Content Switching > Virtual Servers.
  2. In the details pane, select the virtual server that you want to view, and then click Visualizer.
  3. In the Content Switching Visualizer window, you can adjust the viewable area as follows:
    • Click the Zoom In and Zoom Out icons to increase or decrease the viewable area.
    • Click the Save Image icon to save the graph as an image file.
    • In the Search in text field, begin typing the name of the item you are looking for. When you have typed enough characters to identify the item, its location is highlighted. To restrict the search, click the drop-down menu and select the type of element that you want to search for.
  4. To view configuration details for entities that are bound to this virtual server, you can do the following:
    • To view policies that are bound to the virtual server, in the tool bar at the top of the dialog box select one or more feature-specific policy icons. If policy labels are configured, they appear in the main view area.
    • To view the configuration details for a bound service or service group, click the icon for the service, click the Related Tasks tab, and then click Show Member Services.
    • To view the configuration details for a monitor, click the icon for the monitor, click the Related Tasks tab, and then click View Monitor.
  5. To view detailed statistics for any virtual server in the content switching configuration, click the virtual server for which you want to view statistics, then click the Related Tasks tab, and then click Statistics.
  6. To view a comparative list of the parameters whose values either differ or are not defined across service containers for a load balancing virtual server, click the icon for a container, click the Related Tasks tab, and then click Service Attributes Diff.
  7. To view monitor binding details for the services in a container, in the Service Attributes Diff dialog box, in the Group column for the container, click Details. This comparative list helps you determine which service container has the configuration you want to apply to all the service containers.
  8. To view the number of requests received per second at a given point in time by the virtual servers in the configuration, and the number of hits per second at a given point in time for rewrite, responder, and cache policies, click Show Stats. The statistical information is displayed on the respective nodes in the Visualizer. This information is not updated in real time. It has to be refreshed manually. To refresh the information, click Refresh Stats.
    Note: This option is available only on NetScaler nCore builds.
  9. To copy configuration details for an element to a document or spreadsheet, click the icon for that element, click Related Tasks, click Copy Properties, and then paste the information into a document.
  10. To export the entire configuration that is displayed in the Visualizer to an application template file, click the icon for the content switching virtual server, click Related Tasks, and then click Create Template. When creating the application template, you can configure variables in some policy expressions and actions. For more information about creating the application template file and configuring variables for a template, see AppExpert.