Skip to content
This repository has been archived by the owner on May 3, 2024. It is now read-only.

Files

Latest commit

 

History

History
127 lines (70 loc) · 5.06 KB

Preboarding_and_Onboarding.rst

File metadata and controls

127 lines (70 loc) · 5.06 KB

Configuring the CORTX GUI

This guide provides step-by-step instructions to configure the CORTX GUI. You can configure the CORTX GUI after your CORTX cluster is up and running using one of the following guides:

The configuration of CORTX GUI gets completed in two-step:

Preboarding

The preboarding procedure must be performed only once. On the preboarding process, you need to create an admin user for CORTX GUI.

Click here to expand the preboarding procedure.
  1. Open a browser and navigate to the https://<management IP>/#/preboarding/welcome

    • If you see a message about your connection not being private, it is safe to ignore this message.

    • If you are using Google Chrome, you may proceed by simply typing the following text (click on anywhere)

      thisisunsafe

Note: For 1.0.4 OVA use, Open a browser and navigate to the https://<management IP>:28100/#/preboarding/welcome
  1. Click Start. A page that requests you to accept the End User License Agreement (EULA) appears.

    https://github.com/Seagate/cortx/blob/main/doc/images/Start1.PNG
  2. Click Get Started. A CORTX Terms and Conditions showcasing the EULA appears.

    https://github.com/Seagate/cortx/blob/main/doc/images/Get.PNG
  3. Click Accept to accept the CORTX Terms and Conditions.

    https://github.com/Seagate/cortx/blob/main/doc/images/EULA1.PNG

Onboarding

The onboarding procedure must be performed after completing the preboarding procedure. You should be brought automatically to the correct page after completing the preboarding:

  • If you are not or you want to redo the onboarding, navigate to https://<management IP>/#/onboarding
  • If you logged out navigate to: https://<management IP>/#/preboarding/login

You can also perform the onboarding tasks from the Settings page.

Click here to expand the onboarding procedure.
  1. If prompted, log in with default username and password i.e. cortxadmin/Cortxadmin@123 and change to new password

    https://github.com/Seagate/cortx/blob/main/doc/images/login.PNG
  2. Enter a memorable name in the System Name field, and click Continue.

    https://github.com/Seagate/cortx/blob/main/doc/images/Systemname.PNG
  3. Optional: If you have an SSL certificate, you can upload it. Otherwise, a default self-signed certificate provided by Seagate will be used. Click Continue.

    https://github.com/Seagate/cortx/blob/main/doc/images/image-2021-09-16-18-32-26-155.png
  4. Enter information about the DNS servers and Search domains in relevant fields, and click Continue. Multiple entries must be separated by commas.

    • If you don't know your DNS servers, refer nameserver by running dig command.
    • If you don't know your search domains, please use cortx.test.
  5. Enter the NTP server address in the text box and select the NTP time zone offset from the drop-down menu. Then, click Continue. Multiple entries must be separated by a comma.

    https://github.com/Seagate/cortx/blob/main/doc/images/NTP.PNG
  6. Optional: If you want to receive email notifications, select the Subscribe to email notifications checkbox. The Notification settings: Email page is displayed.

    1. Fill in the fields appropriately.
    2. After filling in the information in all the fields, click Send test mail. If configured correctly, you should receive a test mail from CORTX.
    3. Click Apply. The process of configuring emails is completed.
    https://github.com/Seagate/cortx/blob/main/doc/images/Email.PNG
  7. Click Continue after reviewing the summary. A dialog box is displayed indicating the success of the onboarding process.

  8. Click Go to dashboard. CORTX is now ready for use.

    https://github.com/Seagate/cortx/blob/main/doc/images/DB.PNG

    Note: CSM GUI can now be accessed by navigating to https://<management IP>/#/login

Troubleshooting

As the Consul service is not running, you will encounter the below-depicted error.

https://github.com/Seagate/cortx/blob/main/doc/images/consul.PNG

To resolve the error, execute the below-mentioned commands.

sed -i '11s/host:/host: 127.0.0.1/' /etc/csm/database.yaml

systemctl restart csm_agent