Skip to content

Argonne Leadership Computing Facility

Argonne Leadership
Computing Facility

Getting Started

On-Boarding

See Get Started to request an acccount and additional information.

Setup

System View

Connection to a Sambanova node is a two step process. First step is to ssh to a "login node". This step requires a MFA passcode for authentication - a 8 digit passcode generated by an app on your mobile device, e.g., mobilePASS+. The second step is to login to a sambanova node from the login node.

SambaNova System View

Login to Login Node

Login to the SambaNova login node from your local machine using the below command. This uses the MobilPass+ token generated everytime you login to the system. This is the same passcode used to authenticate into other ALCF systems, such as Theta and Cooley.

In the examples below, replace ALCFUserID with your ALCF user id.

ssh ALCFUserID@sambanova.alcf.anl.gov
ALCFUserID@sambanova.alcf.anl.govs password: < MobilPass+ code >

Note: Use the ssh "-v" option inorder to debug any ssh problems.

Login to SambaNova Node

Once you are on the login node, the sambanova system can be accessed using the alias “sm-01” that resolves to hostname sm-01.ai.alcf.anl.gov.

ssh sm-01

SDK setup

The SambaNova system has a bash shell script to setup the required software environment. This sets up the SambaFlow software stack, the associated environmental variables and activates a pre-configured virtual environment.

Use

ALCFUserID@sm-01:~$ source /software/sambanova/envs/sn_env.sh
(venv) ALCFUserID@sm-01:~$

The contents of the sn_env.sh script is shown below for convenience.

alias snpath='export PATH=$PATH:/opt/sambaflow/bin' # This is the path to SambaFlow which is the software stack that is running on SambaNova systems. This stack includes the Runtime, the compilers, and the SambaFlow Python SDK which is used to create and run models.

alias snthreads='export OMP_NUM_THREADS=1' # The OMP_NUM_THREADS environment variable sets the number of threads to use for parallel regions. The value of this environment variable must be a list of positive integer values. The values of the list set the number of threads to use for parallel regions at the corresponding nested levels.For the SambaNova system it is usually set to 1.

alias snvenv='source /opt/sambaflow/venv/bin/activate' # This activates the pre-configured virtual environment that consists of sambaflow and other built-in libraries.

NOTE:  SambaNova operations will fail unless the SambaNova venv is set up.

You may deactivate the environment if finished.

deactivate