4.17. storageconnection

The storageconnection resource type allows you to add, edit, and delete storage connections.

Table 4.43. Storage connection parameters

Name Type Description Required User Creatable User Updatable
--address
string
The hostname or IP address of the storage domain.
Yes (NFS and iSCSI only)
Yes
Yes
--correlation_id
string
A tagging identifier for the storage connection.
No
No
Yes
--expect
'201-created'
Request becomes asynchronous until the expected HTTP header is returned. Useful for long-running tasks that would otherwise return as successful before the task is completed.
No
No
No
--iqn
string
The target IQN for the storage device.
Yes (iSCSI only)
Yes
Yes
--mount_options
string
The options for mounting the PosixFS share.
No
Yes
Yes
--nfs_retrans
integer
The number of retransmissions the NFS client will attempt to complete a request.
No
Yes
Yes
--nfs_timeo
integer
The amount of time, in deciseconds, the NFS client will wait for a request to complete.
No
Yes
Yes
--nfs_version
string
The version of NFS used.
No
Yes
Yes
--password
string
A CHAP password for logging into a target of an iSCSI storage domain.
No
Yes
Yes
--path
string
The mounted file path of the storage domain. The path cannot be updated to one already used by a storage connection.
Yes (NFS, local, and PosixFS only)
Yes
Yes
--port
integer
The TCP port used for the iSCSI storage domain.
Yes (iSCSI only)
Yes
Yes
--storagedomain-identifier
string
A reference to a storage domain for the disk.
No
No
No
--type
string
The type of storage domain.
Yes
Yes
No
--username
string
A CHAP user name for logging into a target of an iSCSI storage domain.
No
Yes
Yes
--vfs_type
string
The Linux-supported file system type of the PosixFS share.
Yes (PosixFS only)
Yes
Yes

Example 4.35. Creating a new storage connection

[RHEVM shell (connected)]# add storageconnection --address storage.example.com --path /storage/nfs --type nfs