volume_group ‑modify

Changes the properties of a volume group on the Oracle FS System.

SYNOPSIS

volume_group ‑modify 
   ‑volumeGroup volume‑group‑id‑or‑fqn
   [‑name new‑volumeGroup‑name]
   [‑in parent‑id‑or‑fqn]

   [{‑sessionKey | ‑u admin‑user ‑oracleFS oracle‑fs‑system}]
   [{‑outputformat | ‑o} { text | xml }]
   [{‑timeout timeout‑in‑seconds | ‑verify | ‑usage | ‑example | ‑help}]

DESCRIPTION

Run the volume_group ‑modify command to rename a volume group or to reassign a volume group to a different volume group. You can use this command to nest one volume group within another volume group, and to move a nested volume group into a different parent volume group.

Note: Only administrators with primary administrator or admin1 roles are authorized to run the volume_group -modify command.

OPTIONS

‑in

Specifies the ID or fully qualified name (FQN) of the parent volume group to which you are moving the existing volume group. If this subcommand is omitted, the volume_group ‑modify command moves the existing volume group under the root filesystem, which is designated by the forward slash (/) character.

‑name

Specifies a new name for the volume group. The name that you provide must be between 1 and 40 characters. The name that you provide is used to create the fully qualified name (FQN) after the Oracle FS System renames the volume group. Use double quotation marks around names containing one or more spaces or dashes to ensure that the Pilot software handles the spaces or dashes correctly. The following characters are invalid in a volume group name:

Tab
/ (slash) and \ (backslash)
. (dot) and .. (dot-dot)
Embedded tabs

Note: The volume_group ‑modify command fails if the Oracle FS System already contains a volume group with the specified name.

‑volumeGroup

Specifies the FQN or the ID of the volume group that you are changing.

EXAMPLE

Task

Change the fully qualified name (FQN) of a volume group on the Oracle FS System and move the volume group under a different volume group.

Parameters

The FQN of the volume group to rename: /user1_vg
The new name of the volume group: user2_vg
The FQN of the volume group destination: /parent2_vg

$ fscli volume_group -modify -volumegroup /⁠⁠user1_vg ‑name user2_vg -in /⁠parent2_vg