1. Getting started

This chapter describes this document, includes summaries of changes from previous releases and precautionary messages, and lists command conventions.

1.1. About this document

This document describes basic configuration for the Nokia Service Router Linux (SR Linux). Examples of commonly used commands are provided.

This document is intended for network technicians, administrators, operators, service providers, and others who need to understand how the router is configured.

Note:

This manual covers the current release and may also contain some content that will be released in later maintenance loads. Refer to the SR Linux Release Notes for information on features supported in each load.

1.2. Summary of changes

Table 1 lists the changes that were made in this release.

Table 1: Change summary

Topic	Location
Key-based SSH authentication for local users	Configuring SSH key-based authentication
Support for SNMP IF-MIB ifEntry OIDs	Configuring SNMP
CLI prompt indicating the running configuration differs from the startup configuration	Saving a configuration to a file
Rescue configuration if the default configuration fails at startup	Rescue configuration
Generating a checkpoint automatically when a configuration is committed	Generating a checkpoint
Locally configured users	Local users
Role-based access control	Configuring authorization
Assigning multiple IPv4 addresses and prefixes and multiple global unicast IPv6 addresses and prefixes to a subinterface	Basic subinterface configuration example
LAG instances with up to 64 member links	LAG
LACP fallback	LACP fallback
DHCP relay for IRB subinterfaces and Layer 3 subinterfaces	DHCP relay
OSPFv2 support	OSPF
BFD support for additional adjacency types	BFD configuration
BFD failure detection for static routes	Configuring failure detection for static routes
Supported ACL actions by hardware platform	ACL actions
System filter ACLs	System filters
QoS enhancements	Quality of service
Control groups (cgroups) to limit resource consumption for applications	Partioning and isolating application resources

1.3. Precautionary messages

Observe all dangers, warnings, and cautions in this document to avoid injury or equipment damage during installation and maintenance. Follow the safety procedures and guidelines when working with and near electrical equipment.

Table 2 describes information symbols contained in this document.

Table 2: Information symbols

Symbol	Meaning	Description
	Danger	Warns that incorrect handling and installation could result in bodily injury. An electric shock hazard could exist. Before you begin work on this equipment, be aware of hazards involving electrical circuitry, be familiar with networking environments, and implement accident prevention procedures.
	Warning	Warns that incorrect handling and installation could result in equipment damage or loss of data.
	Caution	Warns that incorrect handling may reduce your component or system performance.
	Note	Notes contain suggestions or additional operational information.

1.4. Conventions

Nokia SR Linux documentation uses the following command conventions.

Bold type indicates a command that the user must enter.
Input and output examples are displayed in Courier text.
An open right-angle bracket indicates a progression of menu choices or simple command sequence (often selected from a user interface). Example: start > connect to.
Angle brackets (< >) indicate an item that is not used verbatim. For example, for the command show ethernet <name>, name should be replaced with the name of the interface.
A vertical bar (|) indicates a mutually exclusive argument.
Square brackets ([ ]) indicate optional elements.
Braces ({ }) indicate a required choice. When braces are contained within square brackets, they indicate a required choice within an optional element.
Italic type indicates a variable.

Generic IP addresses are used in examples. Replace these with the appropriate IP addresses used in the system.