8. Platform system OS configuration (reference only)

This chapter describes the resulting configuration on the server OS as applied by the IPU-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 IPU-M2000 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. IPU-POD default usernames

The following table gives the default usernames for the IPU-M2000 system:

Table 8.2 IPU-POD default usernames

Log in to

Username

IPU-M2000 BMC OS

root

IPU-M2000 IPU-Gateway OS

itadmin

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

8.3. Network interfaces

8.3.1. IPU-POD DA network interfaces

The specified network devices during the IPU-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 IPU-POD DA server requires the following services to be installed for correct operation of the IPU-M2000 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 IPU-M2000 address allocation from the allocated IP subnet block entered when running the IPU-POD DA install script

  2. configures IPv4 addresses for the local server interfaces that connect to the IPU-M2000s

  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 IPU-M2000 in the IPU-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 IPU-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