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 first Exascale wallet found in the following search path:

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

    The wallet provides the Exascale user credentials and endpoint address that the command uses to connect to Exascale control services, also known as the ERS endpoint. The command cannot function if the credentials are invalid or the client cannot connect to the ERS endpoint.

  • If neither --local nor --cluster is 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 my-vol1 and is created in the vault named testVault. The volume size is 1 TB. 

$ edvmkvol my-vol1 testVault 1T --cluster

Created volume with id vol0002_1312220a4a9841a1be28a6c60762702a
Created edv attachment with id att0001_57172474ab234589a411178f92e4acc8
Created device: /dev/exc/my-vol1

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 as the previous example, except that the command is also directed to display verbose output.

$ edvmkvol my-vol1 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=my-vol1
Created volume with id vol0002_1312220a4a9841a1be28a6c60762702a

ESCLI> mkvolumeattachment vol0002_1312220a4a9841a1be28a6c60762702a my-vol1 --giClusterId deadbeef-badc-0fee-dead-beefbadc0fee
Created edv attachment with id att0001_57172474ab234589a411178f92e4acc8
Created device: /dev/exc/my-vol1

Related Topics

Parent topic: Using Exascale Utility Programs