Prerequisites

Before bootstrapping a VMware vSphere-based management cluster, complete the following prerequisite steps:

  1. Verify that your planned cloud configuration meets the reference hardware bill of material and software requirements as described in Requirements for a VMware vSphere-based cluster.

  2. Verify that your planned cloud configuration meets the deployment resources requirements.

  3. Configure Ubuntu or RHEL on the bootstrap node:

    • For Ubuntu:

      1. Log in to any personal computer or VM running Ubuntu 18.04 that you will be using as the bootstrap node.

      2. If you use a newly created VM, run:

        sudo apt-get update
        
      3. Install the current Docker version available for Ubuntu 18.04:

        sudo apt install docker.io
        
      4. Grant your USER access to the Docker daemon:

        sudo usermod -aG docker $USER
        
      5. Log off and log in again to the bootstrap node to apply the changes.

      6. Verify that Docker is configured correctly and has access to Container Cloud CDN. For example:

        docker run --rm alpine sh -c "apk add --no-cache curl; \
        curl https://binary.mirantis.com"
        

        The system output must contain no error records. In case of issues, follow the steps provided in Troubleshooting.

        Note

        If you require all Internet access to go through a proxy server for security and audit purposes, configure Docker proxy settings as described in the official Docker documentation.

    • For RHEL:

      1. Log in to any VM running RHEL 7.9 that you will be using as a bootstrap node.

      2. If you do not use RedHat Satellite server locally in your infrastructure and require all Internet access to go through a proxy server, including access to RedHat customer portal, configure proxy parameters for subscription-manager using the example below:

        subscription-manager config \
            --server.proxy_scheme=$SCHEME \
            --server.proxy_hostname=$HOST \
            --server.proxy_port=$PORT \
            --server.proxy_user=$USER \
            --server.proxy_password=$PASS \
            --server.no_proxy=$NO_PROXY
        
      3. Attach the RHEL subscription using subscription-manager.

      4. Install the following packages:

        sudo yum install yum-utils wget vim -y
        
      5. Verify that the extras repository is enabled:

        sudo yum-config-manager --enable rhel-7-server-extras-rpms
        
      6. Install and configure Docker, disable SELinux:

        sudo yum install docker -y
        sudo systemctl start docker
        sudo chmod 666 /var/run/docker.sock
        sudo setenforce 0
        
      7. Verify that Docker is configured correctly and has access to Container Cloud CDN. For example:

        docker run --rm alpine sh -c "apk add --no-cache curl; \
        curl https://binary.mirantis.com"
        

        The system output must contain no error records. In case of issues, follow the steps provided in Troubleshooting.

        Note

        If you require all Internet access to go through a proxy server for security and audit purposes, configure Docker proxy settings as described in the official Docker documentation.

  4. Prepare the VMware deployment user setup and permissions.