Access the Terminal User Interface

in some cases, you may need to use the terminal user interface (tui) as you may have no direct network access to the device in this case, you can connect locally to the device using a keyboard, mouse, and monitor this will allow you to perform the required network setup to make the device accessible through the web ui using the tui on the gateway device makes it possible to configure litmus edge if network access is not possible and you have physical access to the device connect a keyboard and monitor the gateway device has back panel connectors for the monitor and a keyboard these allow you to access the configuration options of the installed litmus edge operating system you can connect a keyboard (for example, a usb connection) connect a monitor (for example, an hdmi, micro hdmi, or vga connection) log in to the tui after initial installation when the system startup is complete, the tui welcome screen displays the ip addresses and network interface settings see the section below, navigating the tui , for tips on using the keyboard to navigate the eth0 ethernet interface is required on first boot to log in to the tui after the initial installation press f2 to enter the setup when logging in for the first time, you need to select the keyboard layout the us layout is sufficient for most english keyboards to select another layout, scroll up/down the list using the up/down arrows on your keyboard press enter to apply the layout and display the login screen if this is the first time anyone is logging in to this edge device, the credentials are admin / litmusedge enter your credentials if this is the first time anyone is logging in to this edge device, the credentials are admin / litmusedge use the tab key to move fields tab to log in and press enter if this is the first time logging in to litmus edge, refer to the following log in to litmus edge for the first time section log in to litmus edge for the first time if you are logging in to litmus edge for the first time, the end user license agreement (eula) is displayed to log in to litmus edge for the first time use the down arrow key to scroll through the agreement press enter to accept the agreement the change password screen is displayed enter the old password ( litmusedge ) when logging in for the first time enter the new password and confirm it by entering that password again see policy management docid\ kvpb8qgtzjfidvzh0rj6b for more information tab to select change , and then press enter navigating the tui the tui logs you out if no activity occurs within a few minutes to log in again, press f2 the tui is limited to keyboard input here are some tips for navigating the tui with the keyboard f2 enter setup to configure settings f5 refresh the screen tab move the cursor from one field to the next arrows keys move the cursor to select an item in a list, such as the tui configuration options use the arrow keys to select an item, tab to next at the bottom of the screen, then press enter to advance to the screen of the selected option enter accept the data and move to the next field submit the form and display the next screen in the workflow example of tui navigation when selecting an option use the arrow keys to move through the list of tui configuration options use the tab key to select the item highlighted by the cursor the cursor moves to the next button press enter when the cursor is on the next button to advance to the screen of the selected option configure litmus edge using the tui the tui has many of the same options that are available through the web browser interface many of these settings need to be set when first deploying a device several options can be set later configure interfaces select the interface configuration type and enter the details in the following example, you can set a static ip address by providing the following information cidr this classless inter domain routing (cidr) notation identifies a block of ip addresses, similar to network subnetting this example of cidr notation ( 192 168 0 15/24 ) means that the first 24 bits of the ip address are used for network routing gateway the default gateway address on a network can be found using the ipconfig command configure dns use this dialog to enter space separated ip addresses of the dns servers at least one server is required if internet access is enabled, only the first three servers are used configure docker subnet enter the default subnet for docker and select apply configure time network time is the recommended configuration enter ntp (network time protocol) servers and select apply two or more ntp servers is recommended set time zone the time zone setting is significant because it is used for data collected by the system and log timestamps see system troubleshooting docid\ wc8bkvv7kc5cawew0u3jr to learn more it is best practice to use utc for your time zone change country country is the physical location of the device this affects the frequency band of the wlan adapter choosing the appropriate frequency band of the wlan adapter is a legal requirement change keyboard layout use this menu to change the keyboard layout to match the keyboard layout of your country manage cloud activation use this option to activate the litmus edge device with litmus edge manager this tui option should only be used when someone at another location is accessing litmus edge manager through a web browser contact litmus to provide the activation code to the tui user the validity period of the activation code is usually several minutes see activate a node locked license online docid\ c4rxnts6xmpvg iibp9zf for more information enter the activation code and select activate if your edge device had already been cloud activated, the activation details are shown to deactivate the edge device, select deactivate manage license use this option to enter a license key notes for litmus edge version 3 11 0 and later, you can't enter a site based license key through the tui to enter a site based license or to complete offline license activation, you will need to use the web ui for litmus edge or litmus edge manager refer to the following for more information licenses docid\ vbauxhnhfhdn2mk8 8zgq for litmus edge licenses docid\ zurp8hvnsyjmgcz1mceuq for litmus edge manager manage services select or deselect the required service and select apply change password see policy management docid\ kvpb8qgtzjfidvzh0rj6b for more information configure static routes note the ability to configure static routes is available for litmus edge version 3 11 0 and later see mange static routes for more information warning incorrect static routes can break network connections please add or modify with caution reboot if you decide to not reboot use the arrow keys to select cancel , then press enter the operating system reboots and returns to the initial screen where you can once again press f2 to log in, then choose tui configuration options shutdown if you decide to not shut down the operating system use the arrow keys to select cancel , then press enter when you shut down litmus edge, the tui interface closes