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:

Note: Containers instantiated without a license key from Nokia are active for 14 days only.

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. See the note that follows about copying text from a PDF file without broken lines.
    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             |      | waiting-for-config |                                                 |                          |
      | 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      |      | waiting-for-config |                                                 |                          |
      | dhcp_server_mgr     |      | waiting-for-config |                                                 |                          |
      | ethcfm_mgr          |      | waiting-for-config |                                                 |                          |
      | event_mgr           |      | waiting-for-config |                                                 |                          |
      | evpn_mgr            | 1264 | running            | v23.7.1-163-gd408df6a0c                         | 2023-09-29T12:23:10.097Z |
      | fhs_mgr             |      | waiting-for-config |                                                 |                          |
      | 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        |      | waiting-for-config |                                                 |                          |
      | idb_server          | 1198 | running            | v23.7.1-163-gd408df6a0c                         | 2023-09-29T12:23:09.308Z |
      | igmp_mgr            |      | waiting-for-config |                                                 |                          |
      | isis_mgr            |      | waiting-for-config |                                                 |                          |
      | 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_proxy_arp_nd_mgr |      | waiting-for-config |                                                 |                          |
      | l2_static_mac_mgr   |      | waiting-for-config |                                                 |                          |
      | label_mgr           |      | waiting-for-config |                                                 |                          |
      | lag_mgr             | 1313 | running            | v23.7.1-163-gd408df6a0c                         | 2023-09-29T12:23:10.097Z |
      | ldp_mgr             |      | waiting-for-config |                                                 |                          |
      | 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          |      | waiting-for-config |                                                 |                          |
      | 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          |      | waiting-for-config |                                                 |                          |
      | mpls_mgr            |      | waiting-for-config |                                                 |                          |
      | 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             |      | waiting-for-config |                                                 |                          |
      | oc_mgmt_server      |      | waiting-for-config |                                                 |                          |
      | ospf_mgr            |      | waiting-for-config |                                                 |                          |
      | p4rt_server         |      | waiting-for-config |                                                 |                          |
      | pim_mgr             |      | waiting-for-config |                                                 |                          |
      | 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           |      | waiting-for-config |                                                 |                          |
      | 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 |
      | sshd-mgmt           | 1879 | running            | OpenSSH_8.0p1, OpenSSL 1.1.1n  FIPS 15 Mar 2022 | 2023-09-29T12:23:13.690Z |
      | static_route_mgr    |      | waiting-for-config |                                                 |                          |
      | supportd            | 511  | running            |                                                 | 2023-09-29T12:23:08.652Z |
      | te_mgr              |      | waiting-for-config |                                                 |                          |
      | tepolicy_mgr        |      | waiting-for-config |                                                 |                          |
      | twamp_mgr           |      | waiting-for-config |                                                 |                          |
      | vrrp_mgr            |      | waiting-for-config |                                                 |                          |
      | 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 |
      +---------------------+------+--------------------+-------------------------------------------------+--------------------------+