vserver fpolicy show-engine

Display FPolicy server status

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver fpolicy show-engine command displays status information for all FPolicy external engines or displays status information only for FPolicy servers for a specified Vserver. The command output depends on the parameter or parameters specified with the command. If you do not specify any parameters, the command displays the following information for all FPolicy servers:
  • Vserver name
  • Node name
  • FPolicy policy name
  • FPolicy server IP Address
  • FPolicy server status
  • FPolicy server type

You can specify the -fields parameter to specify which fields of information to display about FPolicy servers. You can specify specific parameters to display only information that matches those parameters. For instance, to display information only about all FPolicy servers (external engines) that are connected, run the command with the -fields parameter set to server and -server-status parameter set to connected.

You can specify the -instance parameter to display all information for all policies in the list form.

Parameters

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command only displays the fields that you specify.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all entries.
[-node {<nodename>|local}] - Node
If you specify this parameter, the command displays information only about the FPolicy external engine attached to the specified node.
[-vserver <Vserver Name>] - Vserver
If you specify this parameter, the command displays information only about the FPolicy server for the specified Vserver.
[-policy-name <Policy name>] - Policy
If you specify this parameter, the command displays information only about the FPolicy servers that are attached with the specified policy.
[-server <IP Address>] - Server
If you specify this parameter, the command displays information only about the FPolicy servers that you specify.
[-server-status <Status>] - Server Status
If you specify this parameter, the command displays information only about the FPolicy servers that have the specified status.
[-server-type <Server Type>] - Server Type
If you specify this parameter, the command displays information only about the FPolicy servers that have the specified server type.
[-connected-since <MM/DD/YYYY HH:MM:SS>] - Time FPolicy Server was Connected
If you specify this parameter, the command displays information only about the FPolicy servers that have been connected since the specified time.
[-disconnected-since <MM/DD/YYYY HH:MM:SS>] - Time FPolicy Server was Disconnected
If you specify this parameter, the command displays information only about the FPolicy servers that have been disconnected since the specified time.
[-disconnect-reason <text>] - Reason for FPolicy Server Disconnection
If you specify this parameter, the command displays information only about the FPolicy servers that are disconnected because of the specified reason.
[-disconnect-reason-id <integer>] - ID for FPolicy Server Disconnection
If you specify this parameter, the command displays information about the FPolicy servers that are disconnected because of the specified disconnect reason ID. There is a unique ID associated with each disconnect reason, which can be used to identify the reason for FPolicy server disconnection.
[-session-id <text>] - Session ID
If you specify this parameter, the command displays information about the FPolicy server that is connected with the specified session ID. There is a unique session ID associated with each connection to FPolicy server, which can be used to identify the established connection.

Examples

This example displays information about all FPolicy servers (external engines).
cluster1::> vserver fpolicy show-engine
 FPolicy                                                      Server-        Server-
 Vserver         Policy        Node         Server            status         type
 --------------- ------------- ------------ ----------------- -------------- -----------
 vs2.example.com vs2_pol       FPolicy-01   9.9.9.9           connected      primary
 vs1.example.com vs1_pol       FPolicy-01   1.1.1.1           connected      primary
 2 entries were displayed.

        
This example displays information only about all connected FPolicy servers (external engines).
 cluster1::> vserver fpolicy show-engine -fields server -server-status connected
 node       vserver         policy-name server
 ---------- --------------- ----------- -------
 FPolicy-01 vs1.example.com vs1_pol     1.1.1.1
        
This example displays information about an FPolicy server.
 cluster1::> vserver fpolicy show-engine -server 10.72.204.118 -instance

                                   Node: fpol-01
                                Vserver: vserver_1.example.com
                                 Policy: pol_cifs
                                 Server: 10.72.204.118
                          Server Status: disconnected
                            Server Type: primary
      Time FPolicy Server was Connected: -
   Time FPolicy Server was Disconnected: 2/5/2013 05:06:22
Reason for FPolicy Server Disconnection: TCP Connection to FPolicy server failed.
    ID for FPolicy Server Disconnection: 9307
                             Session ID: