oosVersion 2.1

iSCSI Initiator

OOS iSCSI Initiator manual, detailing target discovery, IQN mapping, authentication, and container storage mounting.

iSCSI is a protocol that carries SCSI commands over TCP/IP networks to access remote block-level storage in a Storage Area Network (SAN). It lets OOS use storage on a remote server over the network as if it were a directly connected disk. OOS is the Initiator, which starts the connection; the storage provider is the Target. Use this chapter when you want to make remote storage available to a container.

Before You Begin

Have the storage administrator create a Target and provide the server IP, port, Portal, IQN, and authentication method. A Portal is the connection address and port; an IQN identifies the storage target. If CHAP (an identity verification method) is used, obtain the corresponding credentials as well. Do not use the screenshot addresses or names as your own settings.

Setting Up iSCSI Initiator

  1. Confirm that the remote server has an iSCSI Target and that OOS can reach that server.
  2. Go to Settings > iSCSI Initiator.
  3. Click the Add button.
  4. Enter the Name and select the Authentication mode.
  5. Enter the target server IP and port, then click Discovery to detect available Portals and IQNs.

iSCSI Target and Portal Discovery Screen

  1. Select or enter the Portal (format: IP:Port).
  2. Select the discovered IQN or enter the target IQN supplied by the administrator. Its format resembles iqn.YYYY-MM.com.reversed.domain[:optional_string]; do not invent a new name when connecting to an existing Target.
  3. Click the Add button.

Added iSCSI Initiator List Screen

  1. Click the Login icon to connect.

Click Login Icon to Connect Screen

The status indicator turns green when connected. If it does not, check the address, port, IQN, and authentication settings, then ask the storage administrator to confirm that the target is available.

iSCSI Initiator Connected Status Indicator

  1. Go to Application > Template > Container > Add Template. Under the Add device option, select the mapped iSCSI device name.

Select Mapped iSCSI Device in Container Template

Check that the expected device is available under Add device in the container template. Before selecting it, confirm its storage space and purpose with the storage administrator to avoid writing to the wrong target.

Parameter Definitions

ParameterDescription
iSCSI InitiatorClient device that initiates requests to access storage on an iSCSI target.
iSCSI TargetServer storage resource (such as a disk or LUN).
CHAP (Challenge-Handshake Authentication Protocol)Authentication mechanism verifying initiator and target identities to secure connections.
DiscoveryFeature to scan and find remote iSCSI targets and portals on the network.
PortalThe network address and port (IP:Port) used to reach an iSCSI target.
IQN (iSCSI Qualified Name)Worldwide unique identifier format for naming iSCSI entities on a network.
Device NameThe system device identifier made available in container templates once logged into a target.