Skip to main content

We've Moved!

Product Documentation has moved to
Hitachi Vantara Knowledge

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

  1. In a terminal window, verify whether Docker 1.13.1 or later is installed:

    docker --version
  2. 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

Before installing HCI, configure Docker with settings suitable for your environment. For guidance on configuring and running Docker, see the applicable Docker documentation.


  1. Ensure that the Docker installation folder on the instance has at least 20 GB available for storing the HCI Docker images.

  2. 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 .
  3. 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.
  4. If you are using the Docker devicemapper 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.

    To view Docker metadata storage usage on an instance, run: docker info
    NoteOn a production system, do not run devicemapper in loop-lvm mode. This can cause slow performance or, on certain Linux distributions, HCI might not have enough space to run.

Configure the mmap count

To configure the mmap count, add the following line to the /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

  1. 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.

  2. 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:


  1. Verify that Docker is running:

    systemctl status docker
  2. If Docker is not running, start the docker service:

    sudo systemctl start docker
  3. (Optional) Configure the Docker service to start automatically when you restart the server or virtual machine:

    sudo systemctl enable docker


  • Was this article helpful?