Users Guide

Linux Packages and Dependencies
The HIT/Linux installation script attempts to automatically install all required Linux packages (for example, OpenSSL, libpcap, open-iscsi,
DKMS, and Python). All packages are part of the RHEL and SLES base repositories. If the packages are not available in a local repository
from which the package manager can install them, the installation script notifies you of missing dependencies and you must manually install
the required Linux packages.
Installation Procedure
This section describes installing HIT/Linux from the ISO image (equallogic-host-tools-version.iso) you downloaded from
the Dell support site.
NOTE: If you have installed a previous version of HIT/Linux, see Upgrading HIT/Linux for information about updating an
existing installation.
The ISO image contains user-mode and kernel-mode RPM packages, an installation script, and documentation. The installation script uses
the host resident package manager to verify and install the Dell EqualLogic host tools and packages and to resolve any dependencies.
As the installation script executes, it installs the HIT/Linux software and guides you through the initial system configuration. The
installation script accomplishes the following:
• Examines the installation packages, checks and resolves any dependencies
• Installs a compatible prebuilt kernel module, if available. Otherwise, the installation script loads the Dynamic Kernel Module Support
(DKMS) package and compiles the Dell EqualLogic-supplied kernel module.
• Prompts you about entering migration mode if this is a new installation and you have existing connections to Dell EqualLogic PS Series
storage volumes using LVM, multipathd, or are using the SCSI devices directly. Answering "Yes" to this question behaves
identically as if you had run the install script with the --migrate option. See Migrating to HIT/Linux Multipath I/O for more details.
• Prompts you with the Import Capability option that is used to enable the capability to import EqualLogic storage to PowerStore.
Answering "Yes" to this prompt behaves identically as if you had run the install script with the --
accepted_Migration_Capability option. If you do not intend to enable the capability to import to PowerStore, then answer
"No" to this prompt.
• Invokes the EqualLogic Configuration Utility (eqlconfig) by the installation script after the initial installation has completed. This utility
performs several configuration functions, then invokes the EqualLogic Host Performance and Tuning Suite (eqltune):
• Prompts you to enable Multipath I/O, chooses the addressing protocol (IPv4 or IPv6) and available subnets, then configures
MPIO.
• Configures https parameters if the Import Capability option is selected.
NOTE: IPv6 is not supported for importing EqualLogic storage to PowerStore.
• Invokes eqltune to verify your Linux system for optimal iSCSI performance and can fix critical system errors. (You can run both
eqlconfig and eqltune manually. For more information, see EqualLogic Configuration Utility (eqlconfig) and EqualLogic Host
Performance and Tuning Suite (eqltune)).
• Sets the iSCSI initiator daemon to autostart.
• Starts the Dell EqualLogic Host Connection Manager daemon (ehcmd) and sets it to autostart.
• Prompts you for PS Series group credentials used by ASMCLI. If you choose the default (Yes), the installation script asks you for a
group name, user name, and password. If you do not enter credentials at this time, you must provide them to run certain ASMCLI
commands. Group credentials are stored in a group access file that you can access and manage from ASMCLI (see Creating and
Managing Group Access Files).
• Invokes eqltune to fix all critical errors, if you chose to run the installation in noninteractive mode.
Pre-Installation Steps
Before installing HIT/Linux:
1. Verify that you have met the prerequisites described in Installation Prerequisites.
2. Download the installation kit from the EqualLogic customer support site, per the instructions in Obtain the Installation Kit. There are
two downloads, one for the ISO image and another for the public key, RPM-GPG-KEY-DELLEQL, that is used for checking the
integrity and authenticity of the ISO image and its contents.
3. When you download the key, import the key: # rpm -import file-name.
If you are migrating an existing Linux system connected to PS Series storage to use Dell EqualLogic MPIO, see the installation steps in
Migrating to HIT/Linux Multipath I/O.
Installing and Configuring HIT/Linux
13