Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Configuring the iSCSI Volumes

 

You can configure iSCSI for a stand-alone JSA console or a JSA console that is the primary high-availability (HA) host in an HA deployment.

Optionally, you can create a partition on the volume of the external iSCSI storage device.

JSA 2014.1 and later uses the XFS file system. You can create the partition on your iSCSI device with either an ext4 or XFS file system.

Disk partitions are created by using a GUID Partition Table (GPT). You can use a new device partition as the mount point for the file system, such as /store or /store/ariel that you migrate.

Note

If you created an iSCSI device partition on your external device and JSA data is stored, then you cannot create a partition or reformat the partition on the volume.

  1. Using SSH, log in to the JSA console as the root user.
  2. Edit the /etc/iscsi/initiatorname.iscsi file to include the iSCSI qualified name for your host.

    InitiatorName=iqn.yyyy-mm.{reversed domain name}:hostname

  3. Open a session to the iSCSI server by typing the following command: systemctl restart iscsi
  4. To detect volumes on the iSCSI server, type the following command:

    iscsiadm -m discovery --type sendtargets --portal IP address:[port]

    The IP address option is the IP address of the iSCSI server. The port is optional. Record the initiator name.

  5. To log in to the ISCSI server, type the following command:

    iscsiadm -m node --targetname <Initiator name from step 4> --portal <IP address:[port]> --login

  6. To find the iSCSI device volume name, type the following command:

    dmesg | grep “Attached SCSI disk”

  7. To create a partition, use the GNU parted command:

    parted /dev/volume

  8. Configure the partition label to use GPT by typing the following command:

    mklabel gpt

  9. If the following message is displayed, type Yes.

    Warning: The existing disk label on /dev/volume will be destroyed and all data on this disk will be lost. Do you want to continue?

  10. Create a partition on the iSCSI disk volume.
    1. To create the partition, type the following command:

      mkpart primary 0% 100%

    2. Set the default units to TB by typing the following command:

      unit TB

    3. Verify that the partition is created by typing the following command:

      print

    4. Exit from GNU parted by typing the following command:

      quit

    5. Update the kernel with the new partition data by typing the following command:

      partprobe /dev/volume

      You might be prompted to restart the appliance.

    6. To verify that the partition is created, type the following command:

      cat /proc/partitions

  11. Reformat the partition and make a file system.
    • To create an XFS file system, type the following command: mkfs.xfs -f /dev/partition

    • For an ext4 files system, type the following command: mkfs.ext4 /dev/partition

See Moving the /store/ariel file system to an iSCSI storage solutionYou can migrate the JSA data that is maintained in the /store/ariel file system and mount the /store/ariel file system to an iSCSI device partition. or Moving the /store file system to an iSCSI storage solutionYou can migrate the JSA data that is maintained in the /store file system and mount the /store file system to an iSCSI device partition..

Moving the /store File System to an iSCSI Storage Solution

You can migrate the JSA data that is maintained in the /store file system and mount the /store file system to an iSCSI device partition.

Migrating the /store files system to your offboard storage device can take an extended period of time.

Configuring the iSCSI Volumes.

  1. Stop the JSA services by typing the following commands in the order specified:
    systemctl stop hostcontext

    systemctl stop ecs-ec-ingress

    systemctl stop tomcat

    systemctl stop hostservices

    systemctl stop systemStabMon

    systemctl stop crond
    Note

    Run the command systemctl stop tomcat on the console.

  2. Unmount the file systems by typing the following commands:

    umount /store

  3. Create the /store_old directory by typing the following command:

    mkdir /store_old

  4. Derive the iSCSI device partition universal unique identifier (UUID) by typing the following command:

    blkid /dev/partition

  5. Edit the /etc/fstab file to update the existing /store file system mount point to /store_old.
  6. Make a new mount point for the /store file system by adding the following text to the /etc/fstab file:
    • If the file system is XFS, add the following text:

      UUID=uuid /store xfs inode64,logbsize=256k,noatime,noauto,nobarrier 0 0

    • If the file system is ext4, add the following text:

      UUID=uuid /store ext4 noatime,noauto,nobarrier 0 0

    Save and close the file.

  7. Mount the /store file system to the iSCSI device partition by typing the following command:

    mount /store

  8. Mount the /store_old file system to the local disk by typing the following command:

    mount /store_old

  9. Move the data from the local disk to the iSCSI storage device by typing the following command:

    cp -af /store_old/* /store

  10. Unmount /store_old by typing the following command:

    umount /store_old

  11. Remove the /store_old directory by typing the following command:

    rmdir /store_old

  12. Edit the /etc/fstab file to remove the /store_old entry.
  13. Start the JSA services by typing the following commands in the order specified:
    systemctl start crond

    systemctl start systemStabMon

    systemctl start hostservices

    systemctl start tomcat

    systemctl start ecs-ec-ingress

    systemctl start hostcontext
  14. Remove the local copy of /store from the logical volume manager (LVM) by typing the following commands:

    lvchange -an /dev/storerhel/store 2>/dev/null

    lvremove /dev/storerhel/store 2>/dev/null

See Mounting the iSCSI Volume Automatically.

Moving the /store/ariel File System to an iSCSI Storage Solution

You can migrate the JSA data that is maintained in the /store/ariel file system and mount the /store/ariel file system to an iSCSI device partition.

Configuring the iSCSI Volumes

  1. Stop the hostcontext service by typing the following command:
    systemctl stop hostcontext

    systemctl start ecs-ec-ingress

    systemctl stop tomcat

    systemctl stop hostservices

    systemctl stop systemStabMon

    systemctl stop crond
  2. Move the existing mount point by typing the following commands:
    cd /store

    mv ariel ariel_old
  3. Verify the Universally Unique Identifier (UUID) of the iSCSI device partition by typing the following command:

    blkid /dev/partition

  4. Add the mount point for the /store/ariel file system by adding the following text to the /etc/fstab file:
    • If the file system is XFS, copy the following text into a text editor, remove the line break, and paste as a single line:

      UUID=uuid /store/ariel xfs inode64,logbsize=256k,noatime, noauto,nobarrier 0 0

    • If the file system is ext4, add the following text

      UUID=uuid /store/ariel ext4 noatime,noauto,nobarrier 0 0

  5. Create the ariel directory for the mount point by typing the following command:

    mkdir /store/ariel

  6. Mount /store/ariel to the iSCSI device partition by typing the following command:

    mount /store/ariel

  7. Verify that /store/ariel is correctly mounted by typing the following command:

    df -h

  8. Move the data from the local disk to the iSCSI storage device by typing the following command:

    cp -af /store/ariel_old/* /store/ariel

  9. Remove the /store/ariel_old directory by typing the following command:

    rmdir /store/ariel_old

  10. Start the JSA services by typing the following commands in the order specified:
    systemctl start crond

    systemctl start systemStabMon

    systemctl start hostservices

    systemctl start tomcat

    systemctl start ecs-ec-ingress

    systemctl start hostcontext

See Mounting the iSCSI Volume Automatically.