/
Checking PicOS Mode

Checking PicOS Mode


NOTE:

For PICOS go2cli version, the operation is different.

Users go to PICOS CLI prompt after log in:

admin@Xorplus>

At PICOS CLI prompt, run “start shell sh” to enter Linux shell.

admin@Xorplus> start shell sh
admin@Xorplus:~$

If you want to return from the Linux shell back to the CLI prompt, run "exit".

admin@Xorplus:~$ exit
exit

admin@Xorplus>


User can use the sudo picos-status command at the Linux shell, to check the current PicOS mode--L2/L3 or OVS. The following output shows that the switch is running in PicOS L2/L3 mode:

admin@Xorplus:~$ sudo picos-status
**********************************************************************
      The setting of PICOS mode in picos_start.conf is Xorplus.
**********************************************************************
PICOS is Running!
Xorplus is Running!
OVS is NOT Running!
**********************************************************************

In the L2/L3 mode, the xorp_rtrmgr process is running while the ovsdb-server and ovs-vswitchd processes are not running.

If the L2/L3 mode is active, user can use the cli command at the Linux shell to reach the PicOS L2/L3 CLI (command-line interface).

admin@Xorplus$cli
Synchronizing configuration...OK.
Welcome to PICOS on Xorplus
admin@Xorplus>

If the L2/L3 mode is not active and user tries to use the cli command, the following message will be displayed:

admin@LEAF-A$cli
The PicOS CLI can only be launched in L2/L3 Mode. Please activate the L2/L3 mode.
admin@LEAF-A$

The following output shows that the switch is running in PicOS OVS mode:

admin@Xorplus:~$ sudo picos-status
**********************************************************************
      The setting of PICOS mode in picos_start.conf is OVS.
**********************************************************************
PICOS is Running!
Xorplus is NOT Running!
OVS is Running!
**********************************************************************


In the OVS mode, the ovsdb-server and ovs-vswitchd processes are running while the xorp_rtrmgr process is not running.

If the picos_start variable has a blank value (picos_start= ) in the PicOS configuration file (picos_start.conf), the PicOS switch runs Linux, but neither L2/L3 nor OVS mode is active. 

admin@Xorplus:~$ sudo picos-status
**********************************************************************
      The setting of PICOS mode in picos_start.conf is OVS.
**********************************************************************
PICOS is NOT Running!
Xorplus is NOT Running!
OVS is NOT Running!
**********************************************************************

In this case, xorp_rtrmgrovsdb-server, and ovs-vswitchd are not running.

Copyright © 2025 Pica8 Inc. All Rights Reserved.