Changing PicOS Mode by Modifying the Configuration File
The PicOS configuration is kept in the picos_start.conf file located at /etc/picos.
admin@LEAF-A$ls /etc/picos/picos_start.conf /etc/picos/picos_start.conf
User can use the cat command at the Linux shell to display the contents of the picos_start.conf file.
admin@LEAF-A$cat /etc/picos/picos_start.conf # configuration file for PicaOS [PICOS] picos_start=xorpplus [XORPPLUS] xorpplus_rtrmgr_verbose= xorpplus_log_facility=local0 xorpplus_finder_client_address=127.0.0.1 xorpplis_finder_server_address=127.0.0.1 [OVS] ovs_database_file=/ovs/ovs-vswitchd.conf.db ovs_inband_database_file=/ovs/inband.conf.db ovs_db_sock_file=/ovs/var/run/openvswitch/db.sock ovs_switch_ip_address=192.168.42.120 ovs_switch_ip_netmask=255.255.255.0 ovs_switch_gateway_ip=192.168.42.1 ovs_switch_tcp_port=6640 ovs_host_name=PicOS-OVS ovs_use_dhcp=false [ZTP] ztp_disable=false otp_disable=true
The picos_start option in the [PICOS] section of the picos_start.conf file dictates the PicOS mode (L2/L3 or OVS). The picos_start option has two possible values: xorpplus and ovs.
To change the PicOS mode, user has to open the picos_start.conf file in a text editor like vi and change the value of picos_start. After changing the value and saving the file, user must restart the picos service to bring the PicOS mode change into effect.
The following example shows an excerpt from the picos_start.conf file. If the value of picos_start is ovs, PicOS will run in OVS mode after the next PicOS restart.
picos_start=ovs
Once the picos_start.conf file has been updated, user needs to restart the picos service by using the /etc/init.d/picos restart command, or rebooting the switch.
admin@LEAF-A$sudo /etc/init.d/picos restart Stopping: PicOS L2/L3................ Stopping enhanced syslogd: rsyslogd. Starting enhanced syslogd: rsyslogd. Stopping internet superserver: xinetd. Restarting OpenBSD Secure Shell server: sshd. Starting: PicOS Open vSwitch/OpenFlow. Starting web server: lighttpd. admin@LEAF-A$
User is in PicOS OVS mode now.
The following example shows an excerpt from the picos_start.conf file. If value of picos_start is xorpplus, PicOS will run in L2/L3 mode after the next PicOS restart.
picos_start=xorpplus
Once the picos_start.conf file has been updated, user needs to restart the picos service by using the /etc/init.d/picos restart command or by rebooting the switch.
admin@LEAF-A$sudo /etc/init.d/picos restart Stopping web server: lighttpd. Stopping: PicOS Open vSwitch/OpenFlow. Starting: PicOS L2/L3........................... admin@LEAF-A$
Once the switch is in L2/L3 mode, user can use the cli command at the Linux shell to reach the L2/L3 operation mode.
admin@LEAF-A$cli Synchronizing configuration...OK. Pica8 PicOS Version 2.6 Welcome to PicOS L2/L3 on LEAF-A admin@LEAF-A>
Related content
Copyright © 2025 Pica8 Inc. All Rights Reserved.