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 launching a container.
- Launching an SR Linux container manually
Launches a single SR Linux container using a manual procedure.
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:
- Docker CE installed, minimum version 18.09:
- SR Linux container image downloaded from the https://github.com/nokia/srlinux-container-image repository.
Note: Containers instantiated without a license key from Nokia are active for
14 days only.
Launching an SR Linux container manually
-
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.xzwhere X = major, Y = minor, Z = patch, and N = build number
-
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
-
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. -
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
-
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 }--[ ]--
-
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 | +---------------------+------+--------------------+-------------------------------------------------+--------------------------+