Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

  1. Import the OVA file into your ESXi/vSphere environment. During the import process, add any network interfaces and configure as necessary.

    Info
    titlePrivate subnet

    To support a private subnet for Storage and Elasticsearch nodes, the Platform server needs both public and private network interfaces (like the dual-network CSN).

    Important: With nodes on a private subnet, you must complete Deploying a Proxy to provide access to the health report server and other network resources, such as replication feed targets, NTP servers, and DNS. Without an interface into that private network, the Swarm UI cannot be accessed by an external browser.

  2. Once the OVA is imported and booted for the first time, configure the networking as necessary within the OS. You can ssh into the Platform server using the following username/password: caringoadmin/caringo

  3. Once the networking configuration completes and validates, run the following command where STORAGE_NIC_IP is the static IP of the NIC connected to the storage network:

    Code Block
    languagebash
    sudo /opt/reinit.sh -i STORAGE_NIC_IP 
    Info
    titleOffline mode

    If the server cannot access the Internet, use Offline mode by adding the -o flag when running reinit.sh.

    Info
    titleImportant

    If you enter the wrong IP address in the above command, the bootstrap command will be caught waiting and not return. See "Bootstrap Command Hangs" in Platform Troubleshooting.

  4. When the reinit.sh script has finished, reboot the Platform Server.

...

Info

Required

This process requires that you already have a running Ubuntu system with all the networking configuration done setup and working.

For a private network for the Swarm storage cluster, verify two separate network interfaces exist on your Platform server: one for the private subnet and one for the publicly available subnet.

  1. SSH into the Platform server.

  2. If the system is missing unzip capability, install it before proceeding: 

    Code Block
    sudo apt-get install unzip
  3. Unzip the package into an empty non-temporary directory and change directories into it:

    Code Block
    languagebash
    unzip caringo-platform-VERSION.zip
    cd caringo-platform-VERSION
  4. Run the self-extracting installation script as a user with root privileges. For the following commands, use the interface name (such as ens192) that you found in step 2 of the Installation Checklist, above.
    For Run as follows for physical hardware or within a container, run as follows:

    Code Block
    languagebash
    sudo ./installplatform.sh -i INTERFACE_NAME

    For Add the -e flag for VMware ESXi virtual machines, add the -e flag:

    Code Block
    languagebash
    sudo ./installplatform.sh -i INTERFACE_NAME -e
    Info
    titleOffline mode

    If the server cannot access the Internet, use Offline mode by adding the -o flag when running installplatform.sh.

    For the complete command help, run the script without arguments: ./installplatform.sh 

    Code Block
    Usage: installplatform.sh [-v|b|e|s] -i INTERFACE
    
    Install the Caringo Platform server software.
    
       -h   display help and exit
       -i   the interface to manage for the storage network
       -v   this server is a VMWare Desktop/Fusion VM
       -b   this server is running in VirtualBox VM
       -e   this server is running in ESXi
       -s   this server is running on bare metal on in a container (default)
       -r   install as rack server pointing to region controller
       -o   offline installation
  5. Once installation completes, the CLI binary is installed, and it can be run from anywhere.

...