vserver modify
Modify a Vserver
Availability: This command is available to cluster administrators at the admin privilege level.
Description
The vserver modify
command modifies the attributes of a specified Vserver. If the Vserver subtype is of type dp-destination
, then only the -aggr-list
parameter can be modified.
Parameters
-vserver <vserver>
- Vserver-
This specifies the Vserver that is to be modified.
[-language <Language code>]
- Default Volume Language Code-
This optional parameter specifies the default language encoding setting for the Vserver and its volumes. The recommended format is to append
.UTF-8
for the language encoding values. For example, for the en_US language, the recommended format isen_US.UTF-8
. The default setting isC.UTF-8
. [-snapshot-policy <snapshot policy>]
- Snapshot Policy-
This optional parameter specifies the Snapshot policy for a Vserver being modified.
[-comment <text>]
- Comment-
This optional parameter specifies a comment for the Vserver.
[-quota-policy <text>]
- Quota Policy-
This optional parameter specifies a quota policy to be used for all volumes associated with a Vserver. You can create and configure multiple, different quota policies, but each Vserver must have one and only one associated quota policy.
[-aggr-list <aggregate name>,…]
- List of Aggregates Assigned-
This optional parameter specifies a confined list of aggregates on which volumes can be created for a Vserver by the Vserver administrator. But these aggregates do not become exclusive property of the Vserver, i.e. they might be assigned for use to other Vservers. If the value of this parameter is specified as "-", then the Vserver administrator cannot create any volumes for that Vserver. Note that the cluster administrator will still be able to create volumes on any aggregate and assign them to this Vserver.
[-max-volumes <unsigned32_or_unlimited>]
- Limit on Maximum Number of Volumes allowed-
This optional parameter specifies the maximum number of volumes that can be created for the Vserver, including the root volume.
[-admin-state {running|stopped|starting|stopping}]
- Vserver Admin State (privilege: advanced)-
Use this parameter to set the admin state of the Vserver if the Vserver start or stop job fails. Possible values include
running and stopped.
[-allowed-protocols {nfs|cifs|fcp|iscsi|ndmp|nvme}]
- Allowed Protocols-
This optional parameter specifies the list of protocols to be allowed to run on the Vserver. When part of vserver-modify, this field should include the existing list along with the new protocol list to be added to prevent data disruptions. Possible values include
nfs
,cifs
,fcp
,iscsi
,ndmp
andnvme
. [-disallowed-protocols {nfs|cifs|fcp|iscsi|ndmp|nvme}]
- Disallowed Protocols-
This optional parameter specifies the list of protocols to be disallowed to run on the Vserver. When part of vserver-modify, this field should include the existing list along with the new protocol list to be added to prevent data disruptions. Possible values include
nfs
,cifs
,fcp
,iscsi
,ndmp
andnvme
. [-qos-policy-group <text>]
- QoS Policy Group-
This optionally specifies which QoS policy group to apply to the Vserver. This 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. To remove this Vserver from a policy group, enter the reserved keyword "none".
[-caching-policy <text>]
- Caching Policy Name-
This optionally specifies the caching policy to apply to the Vserver. A caching policy defines how the system caches this volume's data in Flash Cache modules. 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.
-
[-is-space-reporting-logical {true|false}]
- Logical Space Reporting-
This optionally specifies whether to report space logically on residing volumes which are created after this operation. Existing volumes will not be affected by modifying this value on an existing Vserver. To change whether space is reported logically for existing volumes, you will have to modify the setting on those volumes. When space is reported logically, ONTAP reports the volume space such that all the physical space saved by the storage efficiency features are also reported as used.
[-is-space-enforcement-logical {true|false}]
- Logical Space Enforcement-
This optionally specifies whether to perform logical space accounting on residing volumes which are created after this operation. Older volumes will continue to have old value. When space is enforced logically, ONTAP enforces volume settings such that all the physical space saved by the storage efficiency features will be calculated as used.
[-anti-ransomware-default-volume-state {disabled|dry-run}]
- Default Anti_ransomware State of the Vserver's Volumes-
This optional parameter specifies the default anti_ransomware state for the volumes in the Vserver. When this is dry_run, all the volumes created henceforth will by default have anti_ransomware state as dry-run. Similarly, when this is disabled, all the volumes created henceforth will by default have anti_ransomware state as disabled.
Examples
The following example modifies the quota policy for a Vserver named vs0.example.com to pol1, specifies a Snapshot policy named daily, adds the comment "Sales team access".
cluster1::> vserver modify -vserver vs0.example.com -snapshot-policy daily -comment "Sales team access" -quota-policy pol1