Register ARTESCA with Maestro

This procedure allows you to register an ARTESCA cluster to connect it to Maestro after an online deployment.

Prerequisites

You must perform this procedure after following the Add an ARTESCA Deployment to Maestro documentation, available in the Documentation portal > Maestro > Get Started > Add an ARTESCA Deployment to Maestro.

Important

Platform Administrator privileges are required to perform this procedure.

Procedure

  1. Log in to the ARTESCA UI and click the username on the right side of the main menu.

  2. Select Maestro. The External connections page displays.

    This page allows you to:

    • View the Cluster Endpoint address.

    • View the status of your registered Maestro Connections Endpoint, and their Status.

    • Add a new Maestro connection by clicking the Add Maestro connection button.

  3. Click Add Maestro connection. The form displays.

  4. Fill in required fields.

    For this step, you can either:

    • Import by copying or using the connection-details.json file containing the connection details (the token, the certificate, and the Maestro URL). This information is obtained when you follow the Add an ARTESCA Deployment to Maestro procedure in the Maestro documentation.

    • Manually fill in the Maestro Endpoint, the Maestro CA certificate, and the Maestro Join Token fields.

      Tip

      By filling in these fields manually, you can modify the endpoint or provide a custom Maestro CA certificate.

  5. Click Continue.

  6. The cluster form is submitted and this new Maestro connection displays in the list with an Initializing status.

  7. Ensure that the connection is established between the ARTESCA cluster and Maestro, check the Status information. Note that the connection can take a few minutes to be established.

  1. Under /home/artesca-os, upload the connection-details.json file (downloaded from Maestro) to the ARTESCA bootstrap node.

    # Example: Using scp to upload the file
scp connection-details.json artesca-os@<bootstrap-node>:/home/artesca-os/

  2. Under /home/artesca-os, download the register_maestro.sh script on the ARTESCA bootstrap node.

    rm -rf register_maestro.sh && curl -s --fail -Lo register_maestro.sh https://downloads.scality.com/maestro/register_maestro.sh && chmod +x register_maestro.sh

  3. Run the registration script.

    ./register_maestro.sh register connection-details.json

    Note

    When running the registration script, you will be asked for the local ARTESCA Platform Administrator credentials to authenticate and perform the registration operation.