A.47 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 ]

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.

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.63 Discovering a storage array

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