SAS Network Setup for Linux (Debian/Ubuntu)

The Lyve Client Software app (available for Windows and macOS operating systems) is required to unlock Lyve Mobile Array devices. A Windows or Mac computer installed with the Lyve Client Software app must be able to access the same management network connected to an Ethernet management port on the back of Rackmount Receiver. Make sure to use the Ethernet management port for the slot in which the Lyve Mobile Array device is inserted.

Requirements

Hardware

• Linux server.
• Lyve Mobile Rackmount Receiver with SAS 12Gb 2-Port SFF-8644 ports connected to the data network.
• SAS cable(s) connecting the Linux station and Rackmount Receiver directly or through a switch. Switch configuration may be necessary depending on your network setup.
• Ethernet cable connecting the management network to the appropriate Ethernet management port (Slot A or B) on the back of Rackmount Receiver.

Software

• The Lyve Client app (available for Windows and macOS operating systems) is required to unlock Lyve Mobile Array devices. The app must be installed on a Windows or Mac computer connected to the management network.
• If needed, install the required SAS Host Bus Adapter (HBA) drivers on the Linux station.

Initial setup on the host side

Multipath Input/Output (MPIO) setup

If your network environment supports a Multipath I/O (MPIO) framework, ensure that MPIO is installed before configuring iSCSI.

To enable MPIO:

1. On the Linux station, open a terminal session.
2. Enter the following command:

sudo apt-get install –y multipath-tools

3. Enter the following command:

sudo systemctl restart multipathd

Pre-Setup

1. Ensure that the SAS cable(s) connect the Linux station and Rackmount Receiver directly or through a SAS switch. (Switch configuration may be necessary depending on your network setup.)
2. Boot the Linux station. Make sure that SAS Host Bus Adapter (HBA) drivers are installed on the Linux station if they're required.
3. Connect the Rackmount Receiver Ethernet management port to the management network. Make sure to use the Ethernet management port for the slot in which the Lyve Mobile Array device is inserted.
4. Insert Lyve Mobile Array into slot A or B on Lyve Mobile Rackmount Receiver. Be sure to select the correct slot for the SAS connections behind Rackmount Receiver.

5. Set the power switch on Lyve Mobile Rackmount Receiver to ON.
6. Make sure that the Lyve Client app is installed on a Windows or Mac computer connected to the management network. Open the Lyve Client app.
   
   The LED on the device inserted in Lyve Mobile Rackmount Receiver blinks white during the boot process and turns solid orange. The solid orange LED color indicates the device is ready to be unlocked.
   
   Lyve Client will automatically unlock the device if the management computer was connected to Lyve Mobile Array in the past and is still authorized for security. If the management computer has never unlocked the device, you will need to enter your Lyve Management Portal username and password in the Lyve Client app. See Setup Requirements.
   
   Once Lyve Client has validated permissions for the device connected to the computer, the LED on the device turns solid green. The device is unlocked and ready for use.

Format and mount the disk

• If no GUI has been enabled for your Linux system, see Manual formatting.
• If a GUI is enabled for your Linux station, see Formatting using a GUI.

Manual formatting

Obtain device details

1. Using the terminal, create a subfolder by entering the following:

sudo mkdir /mnt/SEAGATE

2. List block device details by entering the following:

sudo blkid

Format the disk for Linux

1. Format the disk for Linux by entering the following:

sudo mkfs.ext4 -L LYVE /dev/disk/by-uuid/unique ID

where unique ID is the UUID for the Lyve disk listed in the blkid output, for example:

sudo mkfs.ext4 -L LYVE /dev/disk/by-uuid/22A6-E95E

2. Be sure to note the file system UUID, for example, b2fc70de-a95e-43ef-9008-c8ec4a5a12c6.

Edit the file system table

1. Edit /etc/fstab, for example:

sudo vi /etc/fstab

2. Add a comment to identify the disk, for example:

# SEAGATE SAS device

3. Add a line for the new disk UUID by entering the following:

/dev/disk/by-uuid/unique ID /mnt/SEAGATE ext4 defaults 0 1

where unique ID is the UUID for the Lyve disk listed in the blkid output, for example:

/dev/disk/by-uuid/b2fc70de-a95e-43ef-9008-c8ec4a5a12c6 /mnt/SEAGATE ext4 defaults 0 1

Mount the drive

Mount the drive by entering the following:

sudo mount –a

Formatting using a GUI

1. On the Linux station, open the Disks application.
2. Select the Lyve disk and format it.
3. Mount the Lyve disk.
4. (Optional) The disk is available to the current user only. If you want to enable the disk for all users, edit mount options and disable User Session Defaults.
5. Set user permissions as needed.

Change mode of access

Assign access permissions by entering the following:

sudo chmod permission /mnt/SEAGATE

where permission is the desired chmod setting in absolute or symbolic mode, for example:

sudo chmod 777 /mnt/SEAGATE