[DRAFT] SNS 1.1.1_Initial SSA Debian Install

Hardware Requirements for Deploying SNS

Server Operating System Requirements for SNS Deployment

Initial Server Access and Configuration

The user needs to follow the below steps to access and configure the initial server:

1. Log in to the server and ensure server readiness. The server must be running Ubuntu 22.04, powered on, and accessible on the network.

2. Use SSH to log in to the server:

   ssh <username>@<server_ip>

3. Once logged in, switch to the root user:

   sudo su

4. Enter the password configured during the server installation when prompted.

Installing the SSA Debian Package

1. To install the SSA Debian package, execute the following command as the root user:

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

2. Installation is done via script. There are a few prechecks to accept.
   It adds the apt repository, then installs the latest periferyssa debian package as shown in the example below:

   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)

3. Accepting those prechecks adds the Swarm deb repo.

4. Type ‘yes’ and press ‘Enter’ to proceed with the Bootstrapper installation and required packages. Once the installation is complete, a URL will be provided to access the UI. Following this, the support bundle packages will be updated, and firewall settings will be configured. Use the provided URL to access the UI.

   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

5. If the installer is at the “Scanning linux images…” stage, press ‘Return’ and it should proceed further.

6. 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.
   

   

   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.
      

      

   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.
      

      

   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.
       

       

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

   

   

8. 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.
   

   

9. Provide the default username and password:

   1. Username: periferyadmin

   2. Password: password

10. Click Log in.

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

    

    
    The system takes a few seconds to update the password and shows a success message "Password updated successfully". For the next login, you need to use the updated password as the initial default password will no longer work.
    

    

12. 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!"

• Impact: This is a false-positive alert and does not affect the system's functionality.