ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • vserver rename

    Rename a Vserver

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

    Description

    The vserver rename command renames the Vserver. If the vserver being renamed is participating in an Inter-cluster Vserver peer relationship, all the corresponding remote clusters will be updated with the new peer Vserver name.

    Parameters

    -vserver <text> - Vserver

    This specifies the Vserver that is to be renamed.

    -newname <vserver> - New Vserver name (Use Fully Qualified Domain Name, For example: data.example.com)

    This specifies the Vserver’s new name. The name must be a unique Vserver name in the cluster. Use a fully qualified domain name (FQDN) - for example, "data.example.com" - for the Vserver name to reduce name collisions in cluster leagues.

    Maximum number of characters supported is 47, and 41 for a Vserver with subtype "sync-source". "all" is a reserved name and must not be used as a Vserver name.
    [-foreground {true|false}] - Foreground Process

    This specifies whether the rename job will be run in foreground or backgound. By default, the job runs in foreground.

    Examples

    The following examples rename a Vserver named vs1.example.com as vs2.example.com , and then finally back to its original name:

    (When there is no intercluster Vserver peer relationship with the vserver)
    cluster1::> vserver rename -vserver vs1.example.com -newname vs2.example.com
    (When there is at least one intercluster peer relationship with the Vserver)
    cluster1::> vserver rename -vserver vs1.example.com -newname vs2.example.com
    [Job 277] Job succeeded: Vserver rename completed successfully
    cluster1::> vserver rename -vserver vs2.example.com -newname vs1.example.com -foreground false
    [Job 278] Job is queued: Rename Vserver vs2.example.com to vs1.example.com.
    Top of Page