A.49 create StorageArray

Discovers a storage array.

Syntax

create StorageArray plugin=value storageType= { FIBRECHANNEL | ISCSI | LOCAL | UNKNOWN } [ storageName=value ] [ accessHost=value ] [ accessPort=value ] [ accessUsername=value accessPassword=value ] [ useChap= { Yes | No } ] [ adminHost=value adminUserName=value adminPassword=value ] [ pluginPrivateData=value ] name=value [ description=value ] [ lipScan= { Yes | No } ]

Description

This command discovers a storage array and adds it to Oracle VM Manager. If you are adding a non-generic storage array also enter the additional plug-in options to enable Oracle VM Manager to access the storage array's configuration management functions using the adminHost option. To add more access hosts to enable multipathing on ISCSI servers, use the addAccessHost command.

After discovering a storage array, you should add storage initiators to it, add admin servers to it, validate it, then refresh it.

Options

The following table shows the available options for this command.

Option

Description

plugin=value

The name or ID of the Oracle VM Storage Connect plug-in to use for the storage array.

storageType= { FIBRECHANNEL | ISCSI | LOCAL | UNKNOWN }

The storage type for the storage array.

storageName=value

A name to identify the storage for a storage array behind a concentrator.

accessHost=value

The hostname or IP address for the storage array. This is not applicable to fibre channel storage arrays.

accessPort=value

The port on which access to the storage array is allowed. When adding iSCSI storage, add the access port as well. The default access port for iSCSI is 3260. If not specified, the default port is used automatically.

accessUsername=value

A username with administrative access to the storage array, used with accesshostname. This option should only be used where CHAP is enabled on the storage array.

accessPassword=value

The password for the accessusername user. This option should only be used where CHAP is enabled on the storage array.

useChap= { Yes | No }

Whether to use CHAP authentication.

adminHost=value

The host name or IP address where administrative access to the storage array is allowed.

adminUserName=value

A user name with administrative access to the storage array, used with adminHost.

adminPassword=value

The administrator password for the adminUserName user.

pluginPrivateData=value

This option is used to pass additional parameters that a non-generic Oracle VM Storage Connect plug-in may accept to control functionality. For instance, in the case of an Oracle NetApp file system, you can enable SSL using this parameter in the following way:

pluginPrivateData="ssl=Yes"

name=value

A name to identify the storage array.

description=value

Optional description for the storage array. value is a maximum of 4,000 characters.

To set an empty description, use description="".

lipScan= { Yes | No }

This option is only applicable to an Unmanaged FibreChannel Storage Array and should only be used when modifying an existing Unmanaged FibreChannel Storage Array using the edit StorageArray command. An Unmanaged FibreChannel Storage Array is not user created and only gets populated upon the first server discovery.

Note

Any create command only creates a single instance of an object, and therefore only accepts a single object instance as an attribute. Providing more than one object of the same attribute type as a parameter always results in the last attribute value taking precedence.

Examples

Example A.65 Discovering a storage array

OVM> create StorageArray plugin="Oracle Generic SCSI Plugin" name=MyISCSIServer \
  storageType=ISCSI accessHost=10.172.76.130 accessPort=3260

See Also