8. Platform system OS configuration (reference only)

This chapter describes the resulting configuration of the server OS as applied by the Bow Pod DA install script.

8.1. User accounts and groups

The following accounts are required as part of the default server configuration:

Table 8.1 Server user accounts

ipuuser

An account dedicated to Bow-2000 management and administration and related server setup is mandatory. This user requires “sudo” rights

Normal user accounts for Poplar workloads

Account(s) where Poplar SDK user(s) will carry out their ML tasks

8.2. Bow Pod default usernames

The following table gives the default usernames for the Bow-2000 system:

Table 8.2 Bow Pod default usernames

Log in to

Username

Bow-2000 BMC OS

root

Bow-2000 IPU-Gateway OS

itadmin

The default passwords for these accounts are available from the Graphcore support portal.

8.3. Network interfaces

8.3.1. Bow Pod DA network interfaces

The specified network devices during the Bow Pod DA installation will be the ones used for networking. Please consult the installation logs. The names vary between server type and OS installation.

8.4. Services

The Bow Pod DA server requires the following services to be installed for correct operation of the Bow-2000 platform system.

8.4.1. gc-ipu-network service

This is a Graphcore provided service that allows the required network to be configured after a server restart. This service performs a set of actions in order to have a smaller footprint of changes to the server OS.

The service:

  1. Starts a DHCP server that deals with Bow-2000 address allocation from the allocated IP subnet block entered when running the Bow Pod DA install script

  2. Configures IPv4 addresses for the local server interfaces that connect to the Bow-2000s

  3. Configures port forwarding (if enabled during installation) so that web browsers on remote servers can access the V-IPU web user interface on the master Bow-2000 in the Bow Pod.

The code for this service as well as its dependent tools and config files are located at:

/var/lib/gc-ipu-network

You can list the directories/files the gc-ipu-network system service uses for setting up the networking:

$ ls -l /var/lib/gc-ipu-network/
total 4
drwxr-xr-x 2 root root  73 Feb 16 17:42 bin
-rw-r--r-- 1 root root 274 Feb 16 15:51 config.json
drwxr-xr-x 7 root root  90 Feb 16 15:49 interfaces
drwxr-xr-x 2 root root  65 Feb 16 15:51 scripts

You can also list the DHCP leases:

busybox dumpleases -f  /var/lib/gc-ipu-network/interfaces/eno1/udhcpd.leases

The Bow Pod DA install script makes this service execute every time the system boots up into a multi-user configuration.

ln -s /etc/systemd/system/multi-user.target.wants/gc-ipu-network.service /etc/systemd/system/gc-ipu-network.service