Environment setup
This section of the HCI Getting Started guide helps you prepare your environment for the HCI product.
Install Docker on the server or virtual machine
In a terminal window, verify whether Docker 1.13.1 or later is installed:
docker --version
If Docker is not installed or if you have a version earlier than 1.13.1, install the current Docker version suggested by your operating system.
The installation method you use depends on your operating system. See the Docker website for instructions.
Configure Docker on the server or virtual machine
Procedure
Ensure that the Docker installation folder on the instance has at least 20 GB available for storing the HCI Docker images.
Ensure that the Docker storage driver is configured correctly on the instance.
After installation, any changes to the Docker storage driver will need a reinstallation of HCI.To view the current Docker storage driver on an instance, run: docker info .To enable SELinux on the system instances, use a Docker storage driver that supports it.
The storage drivers that SELinux supports differ depending on the Linux distribution you're using. For more information, see the Docker documentation.If you are using the Docker
To view Docker metadata storage usage on an instance, run: docker infodevicemapper
storage driver, ensure that there's at least 40 GB of Docker metadata storage space available on the instance. HCI needs 20 GB to install successfully and an additional 20 GB to successfully update to a later version.NoteOn a production system, do not rundevicemapper
inloop-lvm
mode. This can cause slow performance or, on certain Linux distributions, HCI might not have enough space to run.
Configure the mmap count
/etc/sysct1.conf
file:vm.max_map_count = 262144
If the line already exists, ensure that the value is greater than or equal to 262144.
Configure the firewall rules on the server or virtual machine
Edit the firewall rules to allow communication over all network ports that you want your system to use. To do this, use a firewall management tool such as firewalld.
Restart the server or virtual machine.
Run Docker on the server or virtual machine
To unpack your installation package, Docker needs to be both started and kept running. You can use whatever tools you typically use for keeping services running in your environment.
For example, to run Docker using systemd:
Procedure
Verify that Docker is running:
systemctl status dockerIf Docker is not running, start the
sudo systemctl start dockerdocker
service:(Optional) Configure the Docker service to start automatically when you restart the server or virtual machine:
sudo systemctl enable docker