Table of Contents | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Hardware Requirements for Deploying SNS
...
Category
...
Subcategory
...
Specifications
...
Operating System Disk
...
Disk Protection
...
RAID 1 (recommended).
...
Capacity
...
Minimum 150 GB or higher.
...
Storage Type
...
SSD storage is preferred but not mandatory.
HDD is acceptable if SSD is unavailable.
...
Elasticsearch & Container Storage
...
Recommended Storage Types
...
NVMe is preferred.
SSD is an alternative.
15K SAS drives are acceptable but may cause slower bucket listings.
...
Swarm Storage Requirements
...
Drives must be unformatted.
Drives should appear as single paths (e.g.,
/dev/sdc
).
...
CPU Requirements
...
CPU Types
...
Supported: x86/64-based architecture.
Not Supported: ARM or RISC processors.
Higher core counts are recommended for better performance.
...
Minimum CPU Count
...
--
...
Clock Speed
...
Minimum: 2.2 GHz per core.
Lower clock speeds are supported but may result in reduced performance.
...
Network Switch Specifications
Minimum Capability
...
Network Configuration
...
IP Address
...
Ensure the server is assigned a static IP address for reliable communication and consistent networking.
...
Storage Drives
...
Drive Format
...
Storage drives must remain unformatted.
...
Path Visibility
...
Drives should appear as single paths in the system (e.g., /dev/sdc
, /dev/sdd
).
Initial Server Access and Configuration
The user needs to follow the below steps to access and configure the initial server:
...
Info |
---|
...
Multipath things need to add here
...
The network switch must support a minimum of 10 Gbps or 25 Gbps Ethernet (10/25GbE).
...
RAM Specifications
...
Minimum Requirement
...
64 GB RAM
Server Operating System Requirements for SNS Deployment
...
Category
...
Subcategory
...
Operating System
...
Required OS
...
Ubuntu 22.04
...
Partitioning Recommendations
...
The operating system partitions and /var/lib should be mounted on a separate RAID-protected SSD set. this is required to safeguard the operating system in the event of a single drive failure.
Info |
---|
InfoMimimum space for /var/lib should be added |
InfoMake 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:
Use SSH to log in to the server:. Please provide the user password when prompted.
Code Block ssh <username>@<server_ip>
Once logged in, switch to the root user:. Please provide the password when prompted.
Code Block sudo su
Enter the password configured during the server installation when prompted.
...
To install the SSA Debian packagebase packages, execute the following command as the root user:.
Code Block sudo su -c "bash <(wget -qO- https://apt.cloud.datacore.com/installssa/install-ssa.sh)" root
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: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)
Accepting those prechecks adds the Swarm deb repo.
Type ‘yes’ and press ‘Enter’ to proceed with the Bootstrapper installation and required packagesIt may take a while to finish installation. 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.
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
If the installer is at the “Scanning linux images…” stage, press ‘Return’ and it should proceed further.
(see the below screenshot).
Info |
---|
InfoMake sure the template file has been generated before accessing the UI to create a cluster. Run the command If the file exists, execute |
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.
Provide the desired cluster name.
Upload the license using the "Choose File" link.
If no license is uploaded, the default 2TB license will be applied.
Click on the "Advanced" drop-down link.
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.
After entering all details, click the "Next" button to proceed.
A confirmation page will open to verify the entered details are correct.
If all values are correct, click "Confirm" to proceed further.
If any modifications are needed, click "Back" to modify the values, then click "Next" and "Confirm" again to proceed.
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:
Username: periferyadmin
Password: password
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:
...
S3 Endpoint URL: Shows the S3 endpoint details.
Advanced: Shows the "Content Management" and "Storage Management" links. Clicking on these links will navigate you to the respective UIs in a new window.
Storage: Under the "Storage" box, observe the utilized and free space bars.
periferyadmin: The drop-down at the top-right corner of the UI that contains the following options:
About Single Node Swarm: Provides more details about "Single Node Swarm."
Change Password: Allows updating your password.
Settings: Navigates to the "Access Control" page.
Shut Down: Shuts down the server.
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 |
---|