Install Operations Hub

Before you begin

  • Ensure that the machine on which you want to install Operations Hub meets the hardware and software requirements.
  • Log in to the machine as a root user or a user with sudo privileges.
  • Ensure that you have the following information:
    • The path of the installation folder
    • The domain name of the site that will host Operations Hub
    • The folder path and common name of the SSL certificates
    • The IP address of the PostgreSQL server if you want to use a dual server to install Operations Hub
    • User name and password of the PostgreSQL server
    • The name for the PostgreSQL database

Procedure

  1. Copy the installation files to a folder on the machine on which you want to install Operations Hub.
    Note: The installation folder name must not contain spaces.
  2. Copy the SSL certificates to a folder on the machine.
  3. Access the folder that contains the installation files by running the following command: cd /<folder path> (for example, cd /home/installation_files).
  4. Decompress the installation folder by running the following command: tar -zxvf OpHub_<version>.tar.gz, where <version> is the version number of the installer.
  5. Access the bin folder located inside the installation folder by running the following command: cd /<installation folder path>/bin
  6. Run the installer by running the following command: sudo ./install.sh
  7. Enter the information that the installer prompts you to enter.
    A message appears, displaying the information that you have entered, and asking you if you want to install Operations Hub with these settings.
  8. Enter y, and then press Enter.
    A message appears, asking you to confirm that you want to install various software applications that are required to use Operations Hub.
  9. Enter details as specified in the following table.
    Software ApplicationDescription
    CurlIf curl is installed on the machine, enter n. If not, enter y.
    Note: If a later version of curl is available on the machine and you enter y, an error message appears. You can, however, ignore the error message and proceed to the next step.

    libltdl7

    If libltdl7 is installed on the machine, enter n. If not, enter y.

    UnzipUnzip is required to decompress files. If Unzip is installed on the machine, enter n. If not, enter y.
    DockerIf Docker is installed on the machine, enter n. If not, enter y.
    Docker ComposeIf Docker Compose is installed on the machine, enter n. If not, enter y.
    PostgreSQLPostgreSQL is a database that is used to store the data created by Operations Hub. If PostgreSQL is installed on the machine or if you want to use an external PostgreSQL, enter n. If not, enter y.
    MQTT Broker containerAn MQTT Broker container is used to receive messages sent by devices that publish messages to the same MQTT server. If an MQTT Broker container is installed on the machine or if you want to use an external MQTT Broker container, enter n. If not, enter y.
    Operations Hub, along with the selected software applications, is installed. The Tomcat server is started.
  10. Verify that the Tomcat server is started by running the following commands: cd <installation folder> sudo docker-compose logs -f java
    The following message appears, indicating that the Tomcat server is running: INFO: Server startup in <time duration> ms

What to do next

Create a tenant.