Deploying SR Linux container images

This chapter describes SR Linux container installation topics. The container installation topics include:

SR Linux container prerequisites

Ensure that prerequisites are met before installing an SR Linux container.

Minimum system requirements:

  • 4 GB RAM
  • 2 v CPU
  • The host machine user must have sudo privileges

Minimum software requirements:

Launching an SR Linux container manually

This procedure manually launches a single container.
  1. Download the SR Linux container image from the SR Linux container image repository.
    $ docker pull -i ghcr.io/nokia/srlinux:X.Y.Z-N.tar.xz
    where X = major, Y = minor, Z = patch, and N = build number
  2. Check that the Docker image was imported correctly:
    $ docker images
    REPOSITORY TAG          IMAGE ID              CREATED         SIZE
    ghcr.io/nokia/srlinux 23.7.1         ebf0aaf37625          6 weeks ago     3.58GB
    
  3. Launch an instance of the SR Linux container on the host using the options in the following command line. This command must be entered in a single line.
    sudo docker run -t -d --rm --privileged \ -u 0:0 \ -v srl23-7-1.json:/etc/opt/srlinux/config.json \ --name srlinux ghcr.io/nokia/srlinux:23.7.1 \ sudo bash /opt/srlinux/bin/sr_linux
    
    Note: Copying a long command string from a PDF file introduces line breaks. As a workaround, copy the text string and place into Notepad++. Highlight the text and select CTRL+J. The result is a single line with no returns.
  4. Check that the docker container has been created with the name 'srlinux':

    $ docker ps

     CONTAINER ID  IMAGE               COMMAND             CREATED     STATUS   PORTS   NAMES
     9d5dbd03f7f8  srlinux:23.7.1     "/tini--fixuid-q.." 3 mins ago  Up3 mins.     srlinux
    
  5. Open an SSH session to the DUT using the following credentials:
    • username: admin
    • password: NokiaSrl1!
    # ssh admin@$(docker inspect srlinux --format {{.NetworkSettings.IPAddress}})
    admin@172.17.0.4's password: 
          ___         ___                               ___         ___         ___
         /  /\       /  /\                  ___        /__/\       /__/\       /__/|
        /  /:/_     /  /::\  ___           /  /\       \  \:\      \  \:\     |  |:|
       /  /:/ /\   /  /:/\:\/__/\         /  /:/        \  \:\      \  \:\    |  |:|
      /  /:/ /::\ /  /:/~/:/\  \:\     __/__/::\    _____\__\:\ ___  \  \:\ __|__|:|
     /__/:/ /:/\:/__/:/ /:/__\  \:\   /  \__\/\:\  /__/::::::::/__/\  \__\:/__/::::\____
     \  \:\/:/~/:\  \:\/:::::/\  \:\ /  /:/ \  \:\/\  \:\~~\~~\\  \:\ /  /:/  ~\~~\::::/
      \  \::/ /:/ \  \::/~~~~  \  \:\  /:/   \  \:\/\  \:\  ~~~ \  \:\  /:/    |~~|:|~~
       \__\/ /:/   \  \:\       \  \:\/:/     \__\::/\  \:\      \  \:\/:/     |  |:|
         /__/:/     \  \:\       \  \::/      /__/:/  \  \:\      \  \::/      |  |:|
         \__\/       \__\/        \__\/       \__\/    \__\/       \__\/       |__|/
    Hello admin,
    Welcome to the srlinux CLI.
    Type 'help' (and press <ENTER>) if you need any help using this.
    --{ running }--[  ]--
    
  6. Verify the application versions running on the system:
    # show system application *
    --{ running }--[  ]--
    # show system application * 
    +-------------------+------+---------+-------------------------+--------------------------+
    |        Name       | PID  |  State  |       Version           |       Last Change        |
    +===================+======+=========+====================================================+
    | aaa_mgr           | 1209 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | acl_mgr           | 1220 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | app_mgr           | 1157 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.310Z |
    | arp_nd_mgr        | 1231 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | bfd_mgr           |      | running |                         |                          |
    | bgp_mgr           | 1608 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:12.022Z |
    | chassis_mgr       | 1242 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | dev_mgr           | 1178 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:09.109Z |
    | dhcp_client_mgr   | 1253 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | dhcp_relay_mgr    |      | running |                         |                          |
    | dhcp_server_mgr   |      | running |                         |                          |
    | ethcfm_mgr        |      | running |                         |                          |
    | event_mgr         |      | running |                         |                          |
    | evpn_mgr          | 1264 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | fhs_mgr           |      | running |                         |                          |
    | fib_mgr           | 1275 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | gnmi_server       | 2323 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:16.809Z |
    | gribi_server      |      | running |                         |                          |
    | idb_server        | 1198 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:09.308Z |
    | igmp_mgr          |      | running |                         |                          |
    | isis_mgr          |      | running |                         |                          |
    | json_rpc          | 2325 | running |                         | 2023-09-29T12:23:16.762Z |
    | l2_mac_learn_mgr  | 1286 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | l2_mac_mgr        | 1297 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | l2_static_mac_mgr |      | running |                         |                          |
    | label_mgr         |      | running |                         |                          |
    | lag_mgr           | 1313 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | ldp_mgr           |      | running |                         |                          |
    | license_mgr       | 1324 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | linux_mgr         | 1341 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | lldp_mgr          | 2319 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:16.745Z |
    | log_mgr           | 1354 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | macsec_mgr        |      | running |                         |                          |
    | mcid_mgr          | 1365 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.097Z |
    | mfib_mgr          | 1376 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.098Z |
    | mgmt_server       | 1387 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.098Z |
    | mirror_mgr        |      | running |                         |                          |
    | mpls_mgr          |      | running |                         |                          |
    | mplsoam_mgr       | 1398 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.098Z |
    | net_inst_mgr      | 1416 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.098Z |
    | oam_mgr           |      | running |                         |                          |
    | oc_mgmt_server    |      | running |                         |                          |
    | ospf_mgr          |      | running |                         |                          |
    | p4rt_server       |      | running |                         |                          |
    | pim_mgr           |      | running |                         |                          |
    | plcy_mgr          | 1617 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:12.012Z |
    | qos_mgr           | 1626 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:12.036Z |
    | radius_mgr        | 1434 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.098Z |
    | sdk_mgr           | 1446 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.098Z |
    | segrt_mgr         |      | running |                         |                          |
    | sflow_sample_mgr  | 1457 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.098Z |
    | snmp_server-mgmt  | 2405 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:18.809Z |
    | static_route_mgr  |      | running |                         |                          |
    | supportd          | 511  | running |                         | 2023-09-29T12:23:08.652Z |
    | te_mgr            |      | running |                         |                          |
    | tepolicy_mgr      |      | running |                         |                          |
    | twamp_mgr         |      | running |                         |                          |
    | vrrp_mgr          |      | running |                         |                          |
    | vxlan_mgr         | 1635 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:12.071Z |
    | xdp_lc_1          | 1472 | running | v23.7.1-163-gd408df6a0c | 2023-09-29T12:23:10.098Z |
    +-------------------+------+---------+-------------------------+--------------------------+