Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

Article Number: 000178027

How to configure Multipath using Equallogic Host Integration Toolkit (HIT) on Linux for Oracle

Summary: Our charter is to deliver solutions that simplify IT by providing database solutions, custom development, dynamic datacenters, flexible computing.

Article Content


Applies to:

RHEL, OL 5.7, 5.8


Carthik Annayan


How to configure Multipath Using Equallogic Host Integration Tool Kit (HIT) & on Linux for Oracle?


What is Equallogic Host Integration Toolkit (HIT)?

The Equallogic Host Integration Toolkit (HIT) is a collection of applications and utilities to simplify the configuration and administration of Dell Equallogic PS Series Storage Arrays.

Host Integration Tools for Linux provides the following features:

  • Remote Setup Wizard Command Line Interface (RSWCLI) — A setup utility you use to:
  • Discover and initialize PS Series arrays
  • Configure and manage access to a PS Series group
  • Set configuration parameters for Multipath I/O (MPIO)
  • Manage which subnets are used for MPIO
  • Automate iSCSI session management to create and maintain the optimal iSCSI session
  • configuration for high availability and increased performance.
  • EqualLogic iSCSI Multipathing — A combination of user and kernel mode binaries that:
Improve I/O performance by intelligently routing I/O directly to the correct PS Series
array member, thereby reducing intra-group I/O forwarding.

Initially, let’s see how to configure the equallogic HIT Kit. Download the Hit Kit (1.1) for Linux. If you have a support ID and Password, download from the below link

Installation Steps

To install HIT Kit for Linux, perform the following steps.

Create a directory in which you will mount ISO image:

# mkdir -p /media/iso   –nogpgcheck

Mount the ISO image in the /media/iso directory:

# mount -o loop equallogic-host-tools-version.iso /media/iso

The installation script provides several options for installing under certain conditions. To see these options, enter /media/iso/install --help. To run the installation script for a fresh install, simple enter:

# /media/iso/install

SLN310477_en_US__1icon NOTE: The iSCSI RPM should have been installed/ is a per-requisite for the installation to proceed.

Steps to Discover and Configure the Storage:

First the Equallogic storage should be discovered, in-order to discover the Equallogic storage, use the Remote Setup Command Line Interface (RSWCLI).

Discovering a PS Series Array:

# rswcli –discover –detail

SLN310477_en_US__1icon Note: For the Discovery command to work, make sure that your host network is configured in the Storage IP range.

Once the PS Array is discovered, group access should be granted to the group that you would like to access. We use the RSWCLI command to grant the group access.

# rswcli --add-group-access --gn  groupname  --gip groupip

Example #rswcli --add-group-access --gn  hitkitgroup   --gip

The next step is to discover the targets.

# iscsiadm -m discoverydb

Use the Below Command to discover new Targets (after the initial discovery):

# iscsiadm -m discoverydb [-I iface] -p group-IP-address -t st -o new –D

# iscsiadm -m discoverydb -p -t st -o new –D

Logging into a Volume with Multipath I/O:

To login to a volume with multipath we use the ehcmcli commands . These commands are used to simplify login and logout from iSCSI targets. Now let’s see how to login using the ehcmcli commands.

# ehcmcli login --target target_name --portal portal

SLN310477_en_US__1icon NOTE: # ehcmcli status command displays the status of each volume, the paths its used to login and the target names  


# ehcmcli login --target 1a2000001aa4f479-myvolume

 Login succeeded. Device to mount:


To set a volume for automatic login on the next system startup, use the --login-at-boot option with the ehcmcli login command:

# ehcmcli login --target target [--portal portal] --login-at-boot

Conditions for Configuring Multipath Devices:

Certain conditions should be met to successfully to configure multipath devices using HIT Kit for Linux. Use of the multipathd Daemon is not required. Do not run this daemon before configuring multipath devices. Use the following command to disable multipath service.

 #chkconfig multipathd off

#service multipathd stop

If you must create, delete, or modify the partition table on a volume, use a partition management utility (for example, fdisk) against the EqualLogic DM devices present under.


where volume_name is the name specified at volume creation and p# is the partition number (for example, p1, p2, etc.)
SLN310477_en_US__1icon NOTE: When configuring, Creating Oracle ASM Disks and when using EqualLogic Hit Kit, Make sure you use the devices under the location /dev/eql/device_name.

Article Properties

Last Published Date

21 Feb 2021



Article Type