Host module OS administration

Administrative tasks can differ depending on the OS you are running on each of the SN10-H host modules.

1. Supported versions of the SN10-H operating systems

The SN10-H host module supports the following OS versions:

Red Hat Enterprise Linux 8.5
Ubuntu Server 20.04.2 LTS (Long-Term Support)

2. Red Hat Enterprise Linux administration

2.1. General notes and warnings

Some third-party software and OS packages may prevent the SambaFlow software stack from functioning properly. In this case, SambaNova Support may require all non-certified third-party software or non-certified packages, including the package version, to be removed to get the DataScale SN10-H host module to a satisfactory state and to continue working on any support issues.

DataScale SN10-H host modules are configured with a default login password for users root and snuser1. SambaNova highly recommends that you change these passwords immediately upon logging in to a DataScale SN10-H host module.

SambaNova strongly recommends that you do not perform a major upgrade or a kernel update to the DataScale SN10-H host module OS without referring to the supported OS, kernel, and package versions noted within this document and the software release notes, because there are some strict packages dependencies the SambaNova software relies on. In general, SambaNova recommends that you do not perform any major updates unless you are directed to do so by SambaNova.

Before performing package updates, see the SambaFlow software release notes to ensure there are no package dependencies that could break the SambaFlow software if the packages are not at the correct level.

2.2. Operating system licensing

SambaNova provides the needed package repositories for Red Hat Enterprise Linux running on the DataScale SN10-8R. A partnership with Red Hat allows SambaNova to distribute a customized repository for the DataScale SN10-8R. Adding other repositories might cause issues with the operation of the SambaFlow software because there are some package and kernel version dependencies.

If the SambaNova software stack has problems running, SambaNova Support might request that you remove any packages that were not included from the SambaNova Red Hat Enterprise Linux repository or that you downgrade certain packages to a version that was certified.

2.3. Logging in to the host module

To access the DataScale SN10-H host module:

Use ssh as user snuser1 to log in to the DataScale SN10-H host module from a system that can access the DataScale SN10-8R access network
When you are prompted, enter the default password for snuser1. See Default username and passwords for components.
```
$ ssh snuser1@<SN10-H_OS_IP_Address>
snuser1@<SN10-H_OS_IP_Address>’s password: <Default Password>
```

SambaNova highly recommends that you change the default password for root and snuser1. To change the snuser1 password from the default password to a more secure password, run the following command and enter the new password information when you are prompted:

$ passwd
Changing password for snuser1.
(current) UNIX password: <Current_Default_Password>
Enter new UNIX password: <New_Secure_Password>
Retype new UNIX password: <New_Secure_Password>
passwd: password updated successfully

2.4. Connecting to the SambaNova repository

DataScale SN10-H host module connectivity to the SambaNova repository is set up as part of the DataScale SN10-8R installation and relies on the site survey that your compay completed before installation. As part of the initial installation, SambaNova provides a sambanova.repo file that contains the credentials and paths to your specific repository.

To check the setup for the SambaNova OS repository, see KB article #1058.

2.5. Modifying the repository configuration file

Do not modify the sambanova.repo repository file. Doing so may break SambaFlow software package dependencies, which might cause unrecoverable package dependency issues and could result in the need to rebuild the SN10-H host module. If you need any packages that are not provided by SambaNova, open a support case with SambaNova Support.

2.6. Updating the DataScale SN10-H host module OS

SambaNova patch releases handle major upgrades to the DataScale SN10-H host module OS (for example, going from RHEL 8.2 to RHEL 8.5 or later). SambaNova provides a release notes file that contains any special notes and information about the commands you need to run to perform the upgrade.

2.7. Updating the SambaFlow software

To update the SambaFlow software packages, log in to the DataScale SN10-H host module(s) where the software packages need to be updated.

To view what packages are installed on the DataScale SN10-H host module, run the following command:

$ rpm -qa | grep samba[nf]

To view which SambaFlow packages have an update you can apply, run the following command:

$ dnf check-update | grep samba[nf]

To update the SambaFlow packages, see the list provided in the output produced by the check-update command, and then run the following command to update a package and any of its package dependencies:

$ sudo dnf update <package_name>

For example, if the output produced by the check-update command shows an update is available for the sambanova-runtime package, run the following command:

$ sudo dnf update sambanova-runtime

Repeat this step for each SambaFlow package that needs to be updated.

3. Ubuntu Linux Server administration

3.1. General notes and warnings

Some third-party software and OS packages might prevent the SambaFlow software stack from functioning properly. SambaNova Support might require that you remove all non-certified third-party software or non-certified packages, including the package version, to get the DataScale SN10-H host module to a satisfactory state and to continue to work on any support issues.

DataScale SN10-H host modules are configured with a default login password for users root and snuser1. SambaNova recommends that you change these passwords immediately upon logging in to a DataScale SN10-H host module.

SambaNova strongly recommends that you do not perform a major upgrade or a kernel update to the DataScale SN10-H host module OS without referring to the supported OS, kernel, or package versions noted within this document and the software release notes, because there are some strict dependencies that the SambaFlow software relies on. In general, SambaNova recommends that you do not perform any major updates unless you are directed to do so by SambaNova.

3.2. Operating system licensing

SambaNova provides the package repositories for Ubuntu running on the DataScale SN10-8R. A partnership with Ubuntu allows SambaNova to distribute a customized repository for the DataScale SN10-8R. Adding other repositories might cause issues with the operation of the SambaFlow software because there are some package and kernel version dependencies.

If the SambaFlow software stack has problems running, SambaNova Support may request that you remove any packages that were not installed from the SambaNova Ubuntu repository or that you downgrade certain packages to a version that was certified.

3.3. Logging in to the host module

To access the DataScale SN10-H host module:

From a system that can access the DataScale SN10-8R access network, use ssh as user snuser1 to log in to the DataScale SN10-H host module.
When you are prompted, enter the default password for snuser1. See Default username and passwords for components.
```
$ ssh snuser1@<SN10-H_OS_IP_Address>
snuser1@<SN10-H_OS_IP_Address>’s password: <Default Password>
```

$ passwd
Changing password for snuser1.
(current) UNIX password: <Current_Default_Password>
Enter new UNIX password: <New_Secure_Password>
Retype new UNIX password: <New_Secure_Password>
passwd: password updated successfully

3.4. Connecting to the SambaNova repository

DataScale SN10-H host module connectivity to the SambaNova repository is set up as part of the DataScale SN10-8R installation and relies on the site survey that was completed prior to that step. As part of the initial installation, a sources.list file under the /etc/apt/ directory is provided, and the credentials for accessing your specific repository are configured in the /etc/apt/auth.conf file. If you need to check the setup for the SambaNova OS repository, see KB article #1057.

3.5. Modifying the repository configuration files

Do not modify the sources.list repository file. Doing so may break SambaFlow software package dependencies, which might cause unrecoverable package dependency issues and could result in the need to rebuild the SN10-H host module. If you need any packages that are not provided by SambaNova, open a support case with SambaNova Support.

3.6. Updating the DataScale SN10-H host module OS

SambaNova patch releases handle major upgrades to the DataScale SN10-H host module OS (for example, going from 18.4 LTS to 20.04 LTS or kernel updates). A readme file contains any special notes and information about the commands to execute to perform the upgrade.

3.7. Updating the SambaFlow software

To update the SambaFlow software packages, log in to the DataScale SN10-H host module(s) where the software packages need to be updated.

To view what packages are installed on the DataScale SN10-H host module, run the following command:

$ dpkg -l | grep samba[nf]

To view which SambaNova packages have an update you can apply, run the following command:

$ apt list --upgradable | grep samba[nf]

To update all the packages that need to be updated, run the following command, which updates the packages and any package dependencies:

$ sudo apt install --only-upgrade samba[nf]

To update a specific package, replace samba[nf] with the name of a specific package. For example, to update sambanova-runtime, run the following command:

$ sudo apt install --only-upgrade sambanova-runtime