Skip to main content

vserver vscan connection-status show-all

Contributors
Suggest changes
PDFs

Display Vscan servers connection status

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

Description

The vserver vscan connection-status show-all command displays connection status information of the external virus-scanning servers, or "Vscan servers". If you do not specify any parameters, the command displays the following information for all Vscan servers:

  • Vserver name

  • Node name

  • Vscan server

  • Connection status

  • Disconnect reason

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:

  • Server type

  • Vscan server vendor

  • Vscan server version

  • Privileged user

  • Vscan server connected since

  • Vscan server disconnected since

  • Vserver LIF used for connection

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-node {<nodename>|local}] - Node

If you specify this parameter, the command displays information only about the Vscan servers attached to the specified node.

[-vserver <vserver name>] - Vserver

If you specify this parameter, the command displays information only about the Vscan servers for the specified Vserver.

[-server <IP Address>] - Server

If you specify this parameter, the command displays information only about the Vscan server that you specify.

[-server-status <Status>] - Server Status

If you specify this parameter, the command displays information only about the Vscan servers that have the specified status.

[-server-type <Server type>] - Server Type

If you specify this parameter, the command displays information only about the Vscan servers that have the specified server type.

[-vendor <text>] - Vscanner Vendor

If you specify this parameter, the command displays information only about the Vscan servers that are running scan-engine of the specified vendor.

[-version <text>] - Vscanner Version

If you specify this parameter, the command displays information only about the Vscan servers that are running scan-engine of the specified version.

[-disconnect-reason <reason>] - Server Disconnect Reason

If you specify this parameter, the command displays information only about the Vscan servers that are disconnected because of the specified reason.

[-disconnected-since <MM/DD/YYYY HH:MM:SS>] - Time When Vscanner Was Disconnected

If you specify this parameter, the command displays information only about the Vscan servers that have been disconnected since the specified time.

[-privileged-user <text>] - Privileged User Used for Connection

If you specify this parameter, the command displays information only about the Vscan servers that are connected to ONTAP using the specified privileged user.

[-connected-since <MM/DD/YYYY HH:MM:SS>] - Time When Vscanner Was Connected

If you specify this parameter, the command displays information only about the Vscan servers that have been connected since the specified time.

[-lif <IP Address>] - Vserver LIF Used for Connection

If you specify this parameter, the command displays information only about the Vscan servers that have used the specified IP address for connecting to ONTAP.

Examples

The following example displays connection-status information about all Vscan servers.

cluster1::> vserver vscan connection-status show-all
                                              Connection
Vserver     Node              Server          Status         Disconnect Reason
----------- ----------------- --------------- -------------- -----------------
vs1         Cluster-01        1.1.1.1         disconnected   remote-closed
vs1         Cluster-01        2.2.2.2         connected      -
vs2         Cluster-01        3.3.3.3         disconnected   no-data-lif
vs2         Cluster-01        4.4.4.4         disconnected   no-data-lif
4 entries were displayed.

The following example displays detailed connection-status information about all Vscan servers which are connected.

cluster1::> vserver vscan connection-status show-all -instance
            -server-status connected
Node: Cluster-01
                            Vserver: vs1
                             Server: 2.2.2.2
                      Server Status: connected
                        Server Type: primary
                    Vscanner Vendor: XYZ
                   Vscanner Version: 1.12.2
           Server Disconnect Reason: -
  Time When Server Was Disconnected: -
Privileged User Used for Connection: cifs\u2
     Time When Server Was Connected: 6/3/2013 08:44:21
    Vserver LIF Used for Connection: 10.238.41.223