Skip to main content

vserver fpolicy show-passthrough-read-connection

Contributors
Suggest changes

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