vserver show

Display Vservers

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

Description

The vserver show command displays the following information:

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.
| [-protocols ]
If this optional parameter is specified, the command displays the allowed and disallowed set of protocols for the Vserver(s).
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-vserver <vserver>] - Vserver
If this parameter is specified, the command displays detailed information about the specified Vserver.
[-type <vserver type>] - Vserver Type
If this parameter is specified, the command displays information only about the Vserver or Vservers that have the specified Vserver type. Types include admin for the cluster-wide management Vserver, system for cluster-level communications in an IPspace, data for data serving Vserver, and node for node management Vserver.
[-subtype <vserver subtype>] - Vserver Subtype
If this parameter is specified, the command displays information only about the Vserver or Vservers that have the specified Vserver subtype. Types include:
  • default for default data Vserver
  • dp-destination for Data Protection destination Vserver.
  • sync-source for MetroCluster source Vserver,
  • sync-destination for MetroCluster destination Vserver.
[-uuid <UUID>] - Vserver UUID
If this parameter is specified, the command displays information only about the Vserver that match the specified UUID.
[-rootvolume <volume name>] - Root Volume
If this parameter is specified, the command displays information only about the Vserver or Vservers that have the specified root volume.
[-aggregate <aggregate name>] - Aggregate
If this parameter is specified, the command displays information only about the Vserver or Vservers that have their root volumes contained by the specified aggregate.
[-nisdomain <nis domain>] - NIS Domain
If this parameter is specified, the command displays information only about the Vserver or Vservers that use the specified NIS domain.
[-rootvolume-security-style <security style>] - Root Volume Security Style
If this parameter is specified, the command displays information only about the Vserver or Vservers that have the specified root-volume security style. The unified security style, which applies only to Infinite Volumes, cannot be applied to a Vserver's root volume.
[-ldap-client <text>] - LDAP Client
If this parameter is specified, the command displays information only about the Vserver or Vservers that use the specified LDAP client.
[-language <Language code>] - Default Volume Language Code
If this parameter is specified, the command displays information only about the Vserver or Vservers that use the specified language. To determine the available languages, enter "vserver show -language ?" at the clustershell command prompt and at the Vserver prompt.
[-snapshot-policy <snapshot policy>] - Snapshot Policy
If this parameter is specified, the command displays information only about the Vserver or Vservers that have the specified Snapshot policy.
[-comment <text>] - Comment
If this parameter is specified, the command displays information only about the Vserver or Vservers that match the specified comment.
[-quota-policy <text>] - Quota Policy
If this parameter is specified, the command displays information only about the Vserver or Vservers that use the specified quota policy.
[-aggr-list <aggregate name>, ...] - List of Aggregates Assigned
If this parameter is specified, the command displays information only about the Vserver or Vservers to which the specified aggregate(s) are assigned for use.
[-max-volumes <unsigned32_or_unlimited>] - Limit on Maximum Number of Volumes allowed
If this parameter is specified, the command displays information only about the Vserver or Vservers on which the specified maximum volume count is configured.
[-admin-state {running|stopped|starting|stopping}] - Vserver Admin State
If this parameter is specified, the command displays information only about the Vserver or Vservers that match the specified admin-state.
[-operational-state {running|stopped}] - Vserver Operational State
If this parameter is specified, the command displays information only about the Vserver or Vservers that match the specified operational-state. This field determines the state of the Vserver LIFs. New LIFs created on a Vserver, which is in running state, will be operationally up and the LIFs created on a Vserver, which is in stopped state, will be operationally down.
[-operational-state-stopped-reason {sync destination and switchover is not done|cluster reboot is done|admin state stopped| dp destination not started}] - Vserver Operational State Stopped Reason
If this parameter is specified, the command displays information only about the Vserver or Vservers that are operationally stopped due to the specified reason. This field indicates the reason for the operational-state of the Vserver being stopped
[-allowed-protocols {nfs|cifs|fcp|iscsi|ndmp}, ...] - Allowed Protocols
If this parameter is specified, the command displays information only about the Vserver or Vservers on which the specified protocols are allowed to run.
[-disallowed-protocols {nfs|cifs|fcp|iscsi|ndmp}, ...] - Disallowed Protocols
If this parameter is specified, the command displays information only about the Vserver or Vservers on which the specified protocols are disallowed to run.
[-is-repository {true|false}] - Is Vserver with Infinite Volume
If this parameter is specified, the command displays information only about the Vservers which have the specified is-repository value. This will be true for Vservers with Infinite Volume.
[-qos-policy-group <text>] - QoS Policy Group
Display the Vservers that match the specified qos-policy-group.

A policy group defines measurable service level objectives (SLOs) that apply to the storage objects with which the policy group is associated. If you do not assign a policy group to a Vserver, the system will not monitor and control the traffic to it.

[-caching-policy <text>] - Caching Policy Name
Display the Vservers that match the specified caching-policy.
A caching policy defines the caching behavior of this Vserver at the Flash Cache level. If a caching policy is not assigned to this Vserver, the system uses the default cluster-wide policy. The available caching policies are:
  • none - Does not cache any user data or metadata blocks.
  • auto - Read caches all metadata and randomly read user data blocks, and write caches all randomly overwritten user data blocks.
  • meta - Read caches only metadata blocks.
  • random_read - Read caches all metadata and randomly read user data blocks.
  • random_read_write - Read caches all metadata, randomly read, and randomly written user data blocks.
  • all_read - Read caches all metadata, randomly read, and sequentially read user data blocks.
  • all_read_random_write - Read caches all metadata, randomly read, sequentially read, and randomly written user data.
  • all - Read caches all data blocks read and written. It does not do any write caching.
Default caching-policy is auto.
[-config-lock {true|false}] - Config Lock
This parameter specifies if the Vserver is locked or unlocked for modification. If the config-lock is set to true, then modifying the Vserver's configuration is not allowed.
[-ipspace <IPspace>] - IPspace Name
If this parameter is specified, the command displays information only about the Vservers that are assigned to the specified IPspace.
[-foreground {true|false}] - Foreground Process
This optionally specifies whether the Vserver show operation can be executed in the background. If nothing is specified, by default the Vserver show operation is executed in the foreground.

Examples

The following example displays information about all Vservers.
cluster1::> vserver show

non mcc setup:
							    Admin		Operational   Root
Vserver	    Type    Subtype		    state		state	    Volume	Aggregate		
-----------   ------- --------------- ----------- ----------- ----------- ---------
cluster	    admin   -			    -		-	         -		-
node1	    node    -			    -		-	         -		-
vs0		    data    default		    running	running	    root_vs1	aggr0
vs1		    data    dp-destination   stopped	stopped	    -		-

4 entries were displayed.

mcc setup:

cluster1::> vserver show
							     Admin   Operational Root
Vserver	    Type    Subtype		     state   state	     Volume	  Aggregate
----------    ------- ---------------   ------- ----------- ----------- ---------
cluster	    admin   -				-		-	     -		  -
node1	    node    -				-		-	     -		  -
vs2	         data    sync-source		running	running   rv	       data_aggr
vs3-mc	    data    sync-destination	running	stopped	-		  -

4 entries were displayed.