Versions Compared

Version Old Version 11 New Version Current
Changes made by

Rishab Sinha

Anjali Tyagi

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 22

...

Info

Info

Make sure you have the Physical node installed before installing the SNS 1.1.1 base packages.

Follow the steps below to install SNS 1.1.1 base packages:

  1. Use SSH to log in to the server. Please provide password for the user password when prompted.

    Code Block
    ssh <username>@<server_ip>

  2. Once logged in, switch to the root user. Please provide the password when prompted.

    Code Block
    sudo su

  3. To install the base packages, execute the following command.

    Code Block
    sudo su -c "bash <(wget -qO- https://apt.cloud.datacore.com/installssa/install-ssa.sh)" root

  4. There are a few prechecks through the scripts which when passed will ask for confirmation to proceed with installation. Please provide yes to proceed.

    Code Block
    The apt repository for the Swarm Software Appliance has now been added to this machine.
The script will now install the application pending some environmental checks
Do you want to proceed? (yes/no)

  5. It may take a while to finish installation. Once the installation is complete, a URL will be provided to access the UI . Use the provided URL to access the UI.

    Code Block
    Automatic reboots after unattended upgrades have been disabled.
The bootstrapper and api services have now been installed you can now go to http://<serverIP>:9010/ui to continue configuration

    (see the below screenshot).

    image-20250130-123752.pngImage Added
Info

Info

Make sure the template file has been generated before accessing the UI to create a cluster. Run the command ls /etc/hosttype to verify the existence of the file.

If the file exists, execute cat /etc/hosttype to check its contents. If the file is empty or not generated or contains the template name "test", halt the cluster creation process and contact the CEng team DataCore’s Customer Support Engineer to resolve the issue. Once the issue is fixed, you can proceed with the cluster creation as mentioned below. This will help avoid reinstalling the Debian package again.

  1. Access the provided URL (http://<serverIP>:9010/ui) in any browser. It will prompt you to a window with a "Create Cluster" button. Click the "Create Cluster" button to proceed.

    image-20250124-061850.pngImage Removed

    1. Provide the desired cluster name.

    2. Upload the license using the "Choose File" link.

    3. If no license is uploaded, the default 2TB license will be applied.

    4. Click on the "Advanced" drop-down link.

    5. Provide the Domain Name and Bucket Name for creation during cluster setup. If the Domain Name and Bucket Name are not provided, the default Domain Name “test“ and Bucket Name “default” will be used.

    6. After entering all details, click the "Next" button to proceed.

      image-20250124-063105.pngImage Removed

    7. A confirmation page will open to verify the entered details are correct.

    8. If all values are correct, click "Confirm" to proceed further.

    9. If any modifications are needed, click "Back" to modify the values, then click "Next" and "Confirm" again to proceed.

      image-20250124-063433.pngImage Removed

    10. Wait for a few minutes until the provided details are validated and the initial configuration is completed. Once all checks are done, you will see a prompt window saying "New cluster is created successfully!". Click "Done" to finish.

      image-20250124-091249.pngImage Removed

  2. Once the "Calculating..." window appears, click "Show Details." This shows the current phase of the cluster creation process.

    image-20250124-064147.pngImage Removed

    image-20250124-064017.pngImage Removed

  3. System starting up takes some time (a minimum of 15 minutes) depending on the network speed. After that, you will see "Log in to Single Node Swarm" screen.

    image-20250124-065134.pngImage Removed

  4. Provide the default username and password:

    1. Username: periferyadmin

    2. Password: password

  5. Click Log in.

Info

When the installation is performed on a machine with multiple empty NIC card ports, you will see an exclamation mark (!), but the same can be ignored and proceed.

After logging in, the "Update Password" screen appears. Set the desired password and click the "Update Password" button.

...

...

You will be redirected to the Dashboard screen. Now, your cluster is up and running. See the below sections in the UI which navigate you through:

...

  1. S3 Endpoint URL: Shows the S3 endpoint details.

  2. Advanced: Shows the "Content Management" and "Storage Management" links. Clicking on these links will navigate you to the respective UIs in a new window.

  3. Storage: Under the "Storage" box, observe the utilized and free space bars.

  4. periferyadmin: The drop-down at the top-right corner of the UI that contains the following options:

    1. About Single Node Swarm: Provides more details about "Single Node Swarm."

    2. Change Password: Allows updating your password.

    3. Settings: Navigates to the "Access Control" page.

    4. Shut Down: Shuts down the server.

    5. Logout: Logs you out from the UI.

...

Known Issues

UI Notification for Free Ports on Network Switches

...

Issue: If there are any unused ports on the network switches, the UI may display the following warning:
"Nics on <server> has issues!"

...

Tip

Next, see [DRAFT] SWARM Containerized Stack Installation