8.1 edvmkvol

Runs ESCLI commands to make an Exascale volume and associated EDV attachment.

Purpose

The edvmkvol command provides a simple interface to create an Exascale volume and an associated Exascale Direct Volume (EDV) attachment. The command performs the ESCLI mkvolume and mkvolumeattachment commands.

Syntax

$ edvmkvol volume-name vault-name volume-size [ --local | --cluster ] [ --verbose ]

Command Options

The options for the edvmkvol command are:

  • volume-name: Specifies the name of the volume. The value is also used as the device name for the volume attachment.

  • vault-name: Specifies the vault that the volume is created in.

  • volume-size: Specifies the size of the volume. The volume-size can be specified using suffixes K, KB, M, MB, G, GB, T, TB. The suffix is not case-sensitive.

  • --local: Specifies the creation of a node-specific EDV attachment residing on the server running the edvmkvol command.

  • --cluster: Specifies the creation of a cluster-wide EDV attachment on the Oracle Grid Infrastructure (GI) cluster that contains the server running the edvmkvol command.

  • --verbose: Instructs the command to display verbose output, including the underlying ESCLI commands and their output.

Usage Notes

  • The command must run on an EDV client node where the attachment will reside.

  • The command uses the user credentials associated with the first Exascale user wallet available in the following search path:

    1. $OSSCONF/eswallet
    2. $ORACLE_BASE/admin/eswallet
    3. /etc/oracle/cell/network-config/eswallet

  • If neither of the --local or --cluster options are specified, then --cluster is the default option when the host running the command contains an active Oracle Grid Infrastructure (GI) cluster. Otherwise, --local is the default option.

Example 8-1 Create a Volume and Cluster-Wide EDV Attachment

The example shows a simple command to create a volume and cluster-wide EDV attachment. In the example, the volume is named myvol1 and is created in the vault named testVault. The volume size is 1 TB. 

$ edvmkvol myvol1 testVault 1T --cluster

Created volume with id 2:1312220a4a9841a1be28a6c60762702a
Created edv attachment with id 1:57172474ab234589a411178f92e4acc8
Created device: /dev/exc/myvol1

Example 8-2 Create a Volume and Cluster-Wide EDV Attachment with Verbose Output

The example shows a command to create a volume and cluster-wide EDV attachment with verbose command output. The example is the same is the previous example, except that the command is also directed to display verbose output.

$ edvmkvol myvol1 testVault 1T --cluster --verbose

edvutil lsinitiator
id:                                b68b97b1-ab59-6a6e-b68b-97b1ab596a6e
hostName:                          db01vm01
state:                             ONLINE
giClusterID:                       deadbeef-badc-0fee-dead-beefbadc0fee
giClusterName:                     edvTestCluster
EDV Driver Base Version Info:
  EDV Driver Version               25.1.0.0.0.241108
EDV Driver Online Patch Version Info:
  EDV Online Patch Driver Version: None

ESCLI> mkvolume 1T --vault testVault --attributes name=myvol1
Created volume with id 2:1312220a4a9841a1be28a6c60762702a

ESCLI> mkvolumeattachment 2:1312220a4a9841a1be28a6c60762702a myvol1 --giClusterId deadbeef-badc-0fee-dead-beefbadc0fee
Created edv attachment with id 1:57172474ab234589a411178f92e4acc8
Created device: /dev/exc/myvol1

Related Topics

Parent topic: Using Exascale Utility Programs