Displaying information about connections to external FPolicy servers

You can display status information about connections to external FPolicy servers (FPolicy servers) for the cluster or for a specified storage virtual machine (SVM). This information can help you determine which FPolicy servers are connected.

About this task

If you do not specify any parameters, the command displays the following information:

In addition to displaying information about FPolicy connections on the cluster or a specific SVM, you can use command parameters to filter the command's output by other criteria.

You can specify the -instance parameter to display detailed information about listed policies. Alternatively, you can use the -fields parameter to display only the indicated fields in the command output. You can enter ? after the -fields parameter to find out which fields you can use.


Display filtered information about connection status between the node and the FPolicy server by using the appropriate command:
If you want to display connection status information about FPolicy servers... Enter...
That you specify vserver fpolicy show-engine -server IP_address
For a specified SVM vserver fpolicy show-engine -vserver vserver_name
That are attached with a specified policy vserver fpolicy show-engine -policy-name policy_name
With the server status that you specify vserver fpolicy show-engine -server-status status

The server status can be one of the following:

  • connected
  • disconnected
  • connecting
  • disconnecting
With the specified type vserver fpolicy show-engine -server-type type

The FPolicy server type can be one of the following:

  • primary
  • secondary
That were disconnected with the specified reason vserver fpolicy show-engine -disconnect-reason text

Disconnect can be due to multiple reasons. The following are common reasons for disconnect:

  • Disconnect command received from CLI.
  • Error encountered while parsing notification response from FPolicy server.
  • FPolicy Handshake failed.
  • SSL handshake failed.
  • TCP Connection to FPolicy server failed.
  • The screen response message received from the FPolicy server is not valid.


This example displays information about external engine connections to FPolicy servers on SVM vs1.example.com:

cluster1::> vserver fpolicy show-engine -vserver vs1.example.com
FPolicy                                              Server-       Server-
Vserver         Policy    Node         Server        status        type
--------------- --------- ------------ ------------- ------------- ---------
vs1.example.com policy1   node1      connected     primary
vs1.example.com policy1   node1      disconnected  primary
vs1.example.com policy1   node2      connected     primary 
vs1.example.com policy1   node2      disconnected  primary

This example displays information only about connected FPolicy servers:

cluster1::> vserver fpolicy show-engine -fields server -server-status connected
node       vserver         policy-name server
---------- --------------- ----------- -------
node1      vs1.example.com policy1
node2      vs1.example.com policy1