Install a cluster

Daria Barysheva

Step 1. Precheck

Before installing a new cluster it is recommended to run the Precheck action. By doing this, you make sure that all necessary YUM repositories are available, the cluster doesn’t contain hosts with the same IP addresses, and all other prerequisites are met. Do the following:

  1. Apply the Precheck action to the cluster selected on the Clusters page by clicking the actions default dark actions default light icon in the Actions column.

    Run a cluster precheck
    Run the cluster precheck

  2. Verify the requested action in the opened window.

    precheck verify
    Verify the action

  3. Open the Jobs page and wait until the running job is completed. After this, click the first item in the job list.

    View jobs
    View jobs

  4. View logs in the window that opens. To download logs, click Download.

    Job logs
    View logs

Step 2. Run installation

There are two ways to install cluster services:

  1. Whole cluster. In this method all services are installed automatically one by one after applying the Install action to a cluster.

  2. Single services. In this method each service is installed manually after applying one or more actions to it. This way is also suitable for installing new services in the already deployed cluster.

In both cases each service starts automatically after installation.

NOTE
In case of errors, you can find logs on the Jobs page.

Whole cluster

To install all cluster services within a single action, follow the steps:

  1. Apply the Install action to the cluster selected on the Clusters page by clicking the actions default dark actions default light icon in the Actions column.

    Switch to the whole cluster installation
    Switch to the whole cluster installation

  2. Verify the requested action in the opened window. Notice that setting the Reboot cluster servers after installation flag leads to the hosts being reboot after the installation is completed. Otherwise, the reboot should be done manually.

    Verify the action
    Verify the action

  3. Wait until the job is completed.

  4. If some service fails during installation, but the preceding services are installed successfully, you can try to fix errors and restart installation of all failed services. To do this, select the Reinstall action in the Actions column on the Clusters page.

    Installation restart
    Installation restart

Single services

To install one or several cluster services manually, you should add these services to the cluster and then perform the actions described in the following subsections. The process of installing the ADB service differs from all other services.

CAUTION
Notice that services are installed one by one. Do not install another service until the installation of the previous one is completed.

ADB service

  1. Open the Services tab on the cluster page. Find the row corresponding to the ADB service, click the actions default dark actions default light icon in the Actions column, and select the Install ADB action.

    Switch to ADB installation
    Switch to ADB installation

  2. Verify the action in the opened window.

    Verify the action
    Verify the action

  3. Wait until the job is completed. Then check that the ADB service state is changed from created to installed.

    Check the ADB service state after installation
    Check the ADB service state after installation

  4. Click the actions default dark actions default light icon in the Actions column again and select the Init cluster action.

    Switch to ADB initialization
    Switch to ADB initialization

  5. Verify the action in the opened window.

    Verify the action
    Verify the action

  6. Wait until the job is completed. Then check that the ADB service state is changed from installed to initialized.

    Check the ADB service state after initialization
    Check the ADB service state after initialization

Other services

  1. Open the Services tab on the cluster page. For each service that should be installed, click the actions default dark actions default light icon in the Actions column and select the Install action.

    Install single services
    Switch to installation of single services

  2. Verify the action in the opened window.

    Verify the action
    Verify the action

  3. Wait until the job is completed. Then check that the service state has changed from created to a new value that is shown in the New states of ADB services after installation table.

  4. Repeat the previous actions for other services that should be installed.

IMPORTANT

When you install services manually, one by one, use the following order:

  1. ADB

  2. Chrony

  3. ADB to ADB

  4. PXF

  5. ADB ClickHouse Connector

  6. ADB to Kafka

  7. Kafka to ADB

Step 3. Check the cluster state after installation

As a result of successful installation, the cluster and its services change their state according to the following rules:

  • The cluster state, displayed in the State field on the Clusters page, is being changed from created to running.

    The cluster state after successful installation
    The cluster state after successful installation

  • The state of cluster services, displayed on the Services tab of the cluster page, is being changed from created to a new value that is shown in the table below.

    New states of ADB services after installation
    Service New state

    ADB

    initialized

    Chrony

    synced

    PXF

    installed

    ADB ClickHouse Connector

    installed

    ADB to ADB

    installed

    ADB to Kafka

    installed

    Kafka to ADB

    installed
    The state of cluster services after successful installation
    The state of cluster services after successful installation

Step 4. Create a default database

In order to create a default database for the new ADB cluster, perform the following actions:

  1. Open the Services tab on the cluster page and select the Create database action in the drop-down list of actions, available for the ADB service.

    Create a default database
    Create a default database

  2. Verify the requested action in the opened window.

    Verify the action
    Verify the action

  3. Wait until the creation process is completed.

    NOTE
    In case of errors, you can find logs on the Jobs page.

  4. Make sure that the new database is successfully created. To do this:

    • Сonnect to the ADB Master Server (via SSH, etc.) and login under the default user name gpadmin.

      $ sudo su - gpadmin

    • List all ADB databases.

      psql -l

      The result:

                                     List of databases
   Name    |  Owner  | Encoding |  Collate   |   Ctype    |  Access privileges
-----------+---------+----------+------------+------------+---------------------
 adb       | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 | =Tc/gpadmin        +
           |         |          |            |            | gpadmin=CTc/gpadmin
 diskquota | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 |
 gpperfmon | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 | gpadmin=CTc/gpadmin+
           |         |          |            |            | =c/gpadmin
 postgres  | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 |
 template0 | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 | =c/gpadmin         +
           |         |          |            |            | gpadmin=CTc/gpadmin
 template1 | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 | =c/gpadmin         +
           |         |          |            |            | gpadmin=CTc/gpadmin
(6 rows)
Found a mistake? Seleсt text and press Ctrl+Enter to report it