Versions Compared

Version Old Version 9 New Version 10
Changes made by

Kranthi Kumar G

Anjali Tyagi

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
outlinefalse
styledisc
typelist
printabletrue

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

...

Info

Multipath things need to add here

The network switch must support a minimum of 10 Gbps or 25 Gbps Ethernet (10/25GbE).

Note: Multipath things need to add here

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

Info

...

Mimimum space for /var/lib should be added

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)

...

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

...

.

Initial Server Access and Configuration

Logging into the Server

Ensure Server Readiness:

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

...

  1. , powered on, and accessible on the network.

...

  2. Use SSH to log in to the server:

    Code Block
    ssh <username>@<server_ip>

Switch to Root User:

...

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

    Code Block
    sudo su

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

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

  2. Installation is done via script.

...

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

    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)

...

  2. Accepting those prechecks adds the Swarm deb repo.
  3. Type 
...
  1. ‘yes’ and press 
...
  1. ‘Enter’ to proceed with the Bootstrapper installation 
...
  1.  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.
     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
  2. If the installer is at the “Scanning linux images…” stage, press 
...
  1. ‘Return’ and it should proceed further.
...
 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 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) 
...
  1. in any browser
...
  1. . It will prompt you to a window with a "Create Cluster" button
...
  1. . Click the "Create Cluster" button to proceed.
    image-20250124-061850.pngImage Modified
...
    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" 
...
    1. drop-down link.
    2. Provide the Domain Name and Bucket Name for creation during cluster setup. 
...
    1.  If the Domain Name and Bucket Name are not provided, the default Domain Name “test“ and Bucket Name “default” will be used.
    2. After entering all details, click the "Next" button to proceed.
      image-20250124-063105.pngImage Modified
    3. A confirmation page will open 
...
    1. to verify the entered details are correct.
    2. If all values are correct, click "Confirm" to proceed further.
    3. If any modifications are needed, click "Back" to modify the values, then click "Next" and "Confirm" again to proceed.
      image-20250124-063433.pngImage Modified
    4. Wait for a few minutes 
...
    1. until the provided details are validated and the initial configuration is completed. Once all checks are done, you will see a 
...
    1. prompt window saying "New cluster is created successfully!". 
...
    1.  Click "Done" to finish.
      image-20250124-091249.pngImage Modified
  2. Once the "Calculating..." window 
...
  1. appears, click 
...
  1.  "Show Details." This 
...
  1. shows the current phase of the cluster creation process.
    image-20250124-064147.pngImage Modified
    image-20250124-064017.pngImage Modified
...
  1. System starting up takes some time (a minimum of 15 minutes
...
  1. ) depending on the network speed. After that, 
...
  1. you will see "Log in to Single Node Swarm" 
...
  1. screen. 
    image-20250124-065134.pngImage Added
  2. Provide the default username and password
...
  1. :
    1. Username: periferyadmin
    2. Password: password
  2. 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.
image-20250124-065134.pngImage Removed
  1. After logging in, the "Update Password" 
...
  1. screen appears. Set the desired password 
...
  1.  and click the "Update Password" button. 
...

  1. image-20250124-092101.pngImage Added

    The system takes a few seconds 
...
  1. to update the password 
...
  1.  and shows a success message "Password 
...
  1. updated successfully". For the next login, you need to use the updated password 
...
  1.  as the initial default password will no longer work.
...
  1. image-20250124-092244.pngImage Modified
  2. You 
...
  1. will be redirected to the Dashboard 
...
  1. screen. Now, your cluster is up and running. See the below sections in the UI which navigate you through:
    image-20250124-092408.pngImage Added
    1. S3 Endpoint URL: Shows the S3 endpoint details.
    2. Advanced
...
    1. : 
...
    1. Shows the "
...
    1. Content Management" and "Storage Management" 
...
    1. links. Clicking on these links will navigate you to the respective UIs in a new window.
    2. Storage
...
    1. : Under the "Storage" box, observe the utilized and free space bars.
    2. periferyadmin
...
    1. : The drop-down at the top-
...
    1. right corner of the UI 
...
    1. that contains the following options:
      1. About Single Node Swarm: Provides more details about "Single Node Swarm."
      2. Change Password: Allows 
...
      1. updating your password.
      2. Settings: Navigates to the "Access Control" page.
      3. Shut Down: Shuts down the server.
      4. 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.