ocf_heartbeat_nvmet-port - Man Page
NVMe-oF target export agent
Synopsis
nvmet-port [start | stop | status | monitor | meta-data | validate-all]
Description
Manages NVMe-oF ports. An NVMe-oF port is part of an NVMe-oF target. A port must be created after the subsystem. It exposes one or multiple subsystem(s) including the enclosed namespace(s) to the network.
Supported Parameters
- port_id
The NVMe port number is a 16 bit number.
(unique, optional, integer, default 0)
- type
The NVMe transport type. Should be one of 'tcp', 'rdma', 'fc' or 'loop'.
(optional, string, default "tcp")
- addr_fam
The address family of the address. Should be 'ipv4', 'ipv6' or 'fc'.
(optional, string, default "ipv4")
- svcid
The transport service identifier. The TCP/IP port number this target binds to, or its RDMA protocol equivalent.
(optional, integer, default 4420)
- addr
The transport address. The TCP/IP address this targets binds to, or its RDMA protocol equivalent.
(required, string, no default)
- nqns
A space-separated list of NQNs that should be exported through this NVMe-oF-Target port. This list needs to have at least one entry.
(required, string, no default)
Supported Actions
This resource agent supports the following actions (operations):
- start
Starts the resource. Suggested minimum timeout: 10s.
- stop
Stops the resource. Suggested minimum timeout: 10s.
- status
Performs a status check. Suggested minimum timeout: 10s. Suggested interval: 10s.
- monitor
Performs a detailed status check. Suggested minimum timeout: 10s. Suggested interval: 10s.
- meta-data
Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.
- validate-all
Performs a validation of the resource configuration. Suggested minimum timeout: 10s.
Example CRM Shell
The following is an example configuration for a nvmet-port resource using the crm(8) shell:
primitive p_nvmet-port ocf:heartbeat:nvmet-port \ params \ addr=string \ nqns=string \ op monitor timeout="10s" interval="10s" depth="0"
Example PCS
The following is an example configuration for a nvmet-port resource using pcs(8)
pcs resource create p_nvmet-port ocf:heartbeat:nvmet-port \ addr=string \ nqns=string \ op monitor timeout="10s" interval="10s" OCF_CHECK_LEVEL="0"
See Also
Author
ClusterLabs contributors (see the resource agent source for information about individual authors)