volume_group ‑add

Creates a new volume group and adds it to the Oracle FS System.

SYNOPSIS

volume_group ‑add 
   ‑name 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

Use the volume_group ‑add command to create a volume group. Volume groups allow you to organize logical volumes into organizational units. You can create volume groups in the root volume group of the Oracle FS System to create a broad, shallow grouping of volume groups. Alternatively, you can create one or more volume groups within an existing volume group to create a nested hierarchy of volume groups.

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

OPTIONS

‑in

Specifies the ID or fully qualified name (FQN) of the parent volume group for the new volume group. If omitted, this command creates a volume group by default at the root level, which is designated by the forward slash (/) character. If you do not set a volume group, any LUN or file system would be created in this default volume group.

‑name

Specifies the name of the volume group that you are defining on the Oracle FS System. 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 creates 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:

Non-printable characters, including ASCII 0 through 31, decimal
/ (slash) and \ (backslash)
. (dot) and .. (dot-dot)
Embedded tabs

Note: The volume_group ‑add command fails:

If the Oracle FS System already contains a volume group with the specified name
If you specify a parent that does not exist on the Oracle FS System.

EXAMPLE

Task

Create a volume group in a parent volume group on the Oracle FS System.

Parameters

The name of the volume group: user1_vg
The name of the parent volume group: /⁠all_users

$ fscli volume_group -add -name user1_vg ‑in /⁠all_users