Software installation
This section of the HCI Getting Started guide helps you with the software installation of the HCI product.
Unpack the installation package
- Download the installation package
HCI-<version_number>.tgz
and store it in a folder on the server or virtual machine. - In the largest disk partition on the server or virtual machine, create a folder named
/hci
:mkdir /<path>/hci
- Move the installation package to the folder
/hci
:mv /<path>/HCI-<version_number>.tgz /<path>/hci
- Navigate to the installation folder:
cd /<path>/hci
- Unpack the installation package:
tar -zxf HCI-<version_number>.tgz
This creates a number of directories and folders within the installation folder.
- Run the installation script
install
, located within the folder matching the version number of the installation package:sudo ./cluster/<version_number>/bin/install
- Don't change directories after running the installation script. The following steps are performed in your current folder, not under the version-specific folder.
- The installation script can be run only one time per instance. You cannot rerun this script to try to repair or upgrade a system instance.
Start the application on your server or virtual machine
Start the application script
run
using whatever methods you usually use to run scripts.ImportantEnsure that the method you use can keep therun
script running and can automatically restart it in the event of a server restart or other availability event.- You can run the script in the foreground: sudo /<path>/hci/bin/run
When executed this way, the
run
script does not automatically complete, but instead remains running in the foreground. - You can run the script as a service using
systemd
:- Open the HCI.service file in a text editor.
- Update
ExecStart=
to include the run file:ExecStart=/<path>/hci/bin/run
- Update
ExecStopPost=
to include the stop file:ExecStopPost=/<path>/hci/bin/stop
- Save the file.
- Copy the HCI.service file to the appropriate location for your OS. For example:
cp /<path>/hci/bin/HCI.service /etc/systemd/system
- Enable and start HCI.service:
sudo systemctl enable HCI.service sudo systemctl start HCI.service
NoteWhen you enable HCI.service, systemctl might display this message:The unit files have no [Install] section. They are not meant to be enabled using systemctl. Possible reasons for having this kind of units are:
1) A unit may be statically enabled by being symlinked from another unit's .wants/ or .requires/ directory.
2) A unit's purpose may be to act as a helper for some other unit which has a requirement dependency on it.
Depending on your OS, the HCI.service may or may not have successfully been enabled. To avoid this, make sure that you moved HCI.service to the appropriate location, typically3) A unit may be started when needed via activation (socket, path, timer, D-Bus, udev, scripted systemctl call, ...).
/etc/systemd/system
.- You can run the script in the foreground: sudo /<path>/hci/bin/run