[DRAFT] SNS 1.1.1 Base Packages Installation

< NOTE should be added with a link to verify pre-requisites>

The user needs to follow the below steps for installation of SNS 1.1.1 base packages

Use SSH to log in to the server. Please provide password for the user when prompted.
```
ssh <username>@<server_ip>
```
Once logged in, switch to the root user. Please provide password when prompted.
```
sudo su
```

To install the base packages, execute the following command.

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

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

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)

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.

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

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

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.
Once the "Calculating..." window appears, click "Show Details." This shows the current phase of the cluster creation process.
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.
Provide the default username and password:
1. Username: periferyadmin
2. Password: password
Click Log in.

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.

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