Skip to main content

vserver fpolicy show-passthrough-read-connection

Display connection status for FPolicy passthrough-read

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

Description​

The vserver fpolicy show-passthrough-read-connection command displays the status of the passthrough-read connection from all FPolicy servers. Passthrough-read is a way to read data for offline files without restoring the files to primary storage. If you do not specify any parameters, the command displays following information about the passthrough-read connection from FPolicy servers:
  • Vserver name
  • FPolicy policy name
  • Node name
  • FPolicy server IP address
  • Passthrough-read connection status
You can specify the -fields parameter to specify which fields of information to display. In addition to the fields above, you can display the following fields.
  • Session ID of the control channel
  • Time passthrough-read channel was connected
  • Time passthrough-read channel was disconnected
  • Reason for passthrough-read channel disconnection

You can specify the -instance parameter to display information for all passthrough-read connections 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 passthrough-read connections on the specified node.
[-vserver <Vserver Name>] - Vserver
If you specify this parameter, the command displays information only about the passthrough-read connections for the specified Vserver.
[-policy-name <Policy name>] - Policy
If you specify this parameter, the command displays information only about the passthrough-read connections that are attached with the specified FPolicy policy.
[-server <IP Address>] - Server
If you specify this parameter, the command displays information only about the passthrough-read connections from the specified FPolicy server.
[-control-session-id <text>] - Session ID of the Control Channel
If you specify this parameter, the command displays information only about the passthrough-read connections that are connected with the specified control session ID. The passthrough-read connection is attached to a control connection that has a unique control session ID.
[-server-status <Status of fpolicy passthrough-read connection>] - Server Status
If you specify this parameter, the command displays information only about the passthrough-read connections that have the specified status.
[-connected-since <MM/DD/YYYY HH:MM:SS>] - Time Channel Was Connected
If you specify this parameter, the command displays information only about the passthrough-read connections that have the specified connection time.
[-disconnected-since <MM/DD/YYYY HH:MM:SS>] - Time Channel Was Disconnected
If you specify this parameter, the command displays information only about the passthrough-read connections that have the specified disconnection time.
[-disconnect-reason <Reason for fpolicy passthrough-read disconnection>] - Reason for Disconnection
If you specify this parameter, the command displays information only about the passthrough-read connections that are disconnected because of the specified disconnect reason.

Examples​

This example displays information about passthrough-read connections from all FPolicy servers. 

cluster1::> vserver fpolicy show-passthrough-read-connection
                                            FPolicy           Server
Vserver          Policy Name   Node         Server            Status
---------------  ------------- ------------ ----------------- --------------
vs2.example.com  pol_cifs_2    FPolicy-01   2.2.2.2           disconnected
vs1.example.com  pol_cifs_1    FPolicy-01   1.1.1.1           connected
2 entries were displayed.
This example displays information about passthrough-read connections from all connected FPolicy servers.
cluster1::> vserver fpolicy show-passthrough-read-connection -server-status connected
                                            FPolicy           Server
Vserver          Policy Name   Node         Server            Status
---------------  ------------- ------------ ----------------- --------------
vs1.example.com  pol_cifs_1    FPolicy-01   1.1.1.1           connected
This example displays information about passthrough-read connections from FPolicy servers configured in an FPolicy policy.
 cluster1::> vserver fpolicy show-passthrough-read-connection -policy-name pol_cifs_1 -instance

                                             Node: FPolicy-01
                                          Vserver: vserver_1.example.com
                                           Policy: pol_cifs_1
                                           Server: 2.2.2.2
                Session ID of the Control Channel: 8cef052e-2502-11e3-88d4-123478563412
                                    Server Status: connected
      Time Passthrough Read Channel was Connected: 9/24/2013 10:17:45
   Time Passthrough Read Channel was Disconnected: -
Reason for Passthrough Read Channel Disconnection: none