Install SENSR offline

Instructions

Prerequisites

• 1 x portable disk, containing offline installation package, including this file.
• 1 (or more) x computers
• local network connectivity between computers

Configuration

1. Install openssh-server, on every machine

• By default, Ubuntu 20.04.06 Desktop installation does not have openssh-server, thus these packages needs to be installed manually.

• To verify openssh-server package is installed or not, by running:

  $ apt list --installed openssh-server
  Listing... Done
  openssh-server/focal-updates,focal-security,now 1:8.2p1-4ubuntu0.9 amd64 [installed]
  N: There is 1 additional version. Please use the '-a' switch to see it 

• To install manually, copy these files, then run following command on every machine

  cd ./resources/apt
  apt-get install \
      ./openssh-client_1%3a8.2p1-4ubuntu0.9_amd64.deb
      ./openssh-server_1%3a8.2p1-4ubuntu0.9_amd64.deb
      ./openssh-sftp-server_1%3a8.2p1-4ubuntu0.9_amd64.deb

• After installation, ensure SSH server is active by running ssh localhost on each machine. NOTE: You may ignore Host key verification failed warning, as long as entire network system has properly isolated.

2. Configure sudo group, on every host running SENSR (both master and algo). Register default user to sudo group, by running:

   echo "$USER ALL=(ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers

3. Register SSH key on master

• Create a SSH keypair by running ssh-keygen -t ed25519 -N ""

4. To allow connections from master, iteratively run following command from the master node,

   ssh-copy-id [USER]@[IP ADDRESS]

For example, with a Master node connected to two algo nodes with users called host1 and host2 located at 192.168.1.100 and 192.168.1.101

```bash
ssh-copy-id host1@192.168.1.100
# You will be prompted with host1's password
ssh-copy-id host2@192.168.1.101
# You will be prompted with host2's password
```

5. Verification

• To verify connectivity between machines, try to make a connection from master to algo machines.
• In this example configuration table below, you should be able to run following command:

  ```bash
  ssh host1@192.168.1.100
  ssh host2@192.168.1.101
  ```
  The result should look similar to this

  type	hostname	username	IPv4 address	description
  master	ubuntu-desktop	master	192.168.2.10	heavy duty server
  algo	lpu-01	host1	192.168.2.100	Edge device 1
  algo	lpu-02	host2	192.168.2.101	Edge device 2

6. Create configuration files

   After the SSH connection has been verified, create hosts.ini with following format:

       ubuntu-desktop ansible_user=master       ansible_host=192.168.1.100
       lpu-01       ansible_user=host1        ansible_host=192.168.1.100
       lpu-02       ansible_user=host2        ansible_host=192.168.1.101
   
       [master] # Machines to be run `master` node, and GUI.
       ubuntu-desktop
   
       [algo] # Machines to be run `algo` node.
       lpu-01
       lpu-02
   
       [nvidia] # Machines requires Nvidia driver installation. (not applicable for Jetson devices)
       ubuntu-desktop
       lpu-01
       lpu-02

NOTE: Contents of this file should be consistent with cluster.json file when running sr-launcher-cli create cluster ... in upcoming step.

Installation steps

Bootstrap

• Installs bare-minimum dependencies and configurations, so that master node can update configuration of target machines.
• Configures each machines to be functional wihtout an internet access.

SENSR installation

• Quick command reference to run SENSR.

Bootstrap

Follow these steps on master node's host

NOTE: This sections assumes airgap installation package is stored in /media/ubuntu/usb-disk/sensr-airgap-installer, please change values accordingly.

1. Attach USB-disk into master.

   $ cd /media/ubuntu/usb-disk/sensr-airgap-installer
   $ file bootstrap.sh
   
   bootstrap.sh: Bourne-Again shell script, ASCII text executable

2. Ensure you have the hosts.ini file, created during the configuration stage.

3. Run bootstrap.sh. The result should print failed=0 for all hosts.

   $ ./bootstrap.sh
   
   ...skipped...
   PLAY RECAP **************************************************************************************************
   ubuntu-desktop             : ok=16   changed=5    unreachable=0    failed=0    skipped=3    rescued=0    ignored=0   
   lpu-01                   : ok=23   changed=8    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0   
   lpu-02                   : ok=21   changed=3    unreachable=0    failed=0    skipped=4    rescued=0    ignored=0   

4. If the Nvidia GPU drivers have been installed on the master, reboot it.

SENSR installation

Now you can follow the steps described in the page here