Changing PicOS Mode from CLI

Owned by Tracy Yang
Nov 18, 2024
4 min read

User can switch between L2/L3 and OVS modes using the picos_boot script already included in PicOS. User can run the script from the Linux shell on user's PicOS switch. The script will modify the PicOS boot file /etc/picos/picos_start.conf automatically, without user having to edit the file manually.

Warning:

On FS S5810 Series and S5860 Series switches, run "save_config" command when perform picos_boot. Otherwise, the picos_boot configuration will be lost after PicOS reboot. For detail, please refer to Configuration Saving Guide.



Switching from L2/L3 Mode to OVS Mode

This section describes the procedure to switch from the L2/L3 mode to OVS mode on a PicOS switch named LEAF-A. The switch name is arbitrary.

  1. Login with username admin to arrive at the Linux shell prompt.

    Username: admin Password: admin@LEAF-A$



NOTE:

For PICOS go2cli version, 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:~$



2. Run the picos_boot script located in /usr/bin directory. The full path does not need to be used because the /usr/bin directory is on the system PATH by default.

3. Enter option 2 to select OVS mode.

4. Choose how the IP address of the management interface should be configured: DHCP or static IP. If Static IP is chosen, values for static IP address, subnet mask, and default gateway must be provided. If DHCP is chosen, no more questions are asked.



5. Restart the picos service to activate PicOS OVS mode.

As an alternative to restarting the picos service, user can just reboot the switch to bring the PicOS mode change into effect.



The picos_boot script has the following options:

Option 1 selects the PICOS L2/L3 (Layer 2 / Layer 3) mode. When user chooses option 1, PICOS will load in L2/L3 mode after a reboot.

Option 2 selects the PICOS OVS (Open vSwitch) mode. When user chooses option 2, PICOS will load in OVS mode after a reboot.

Option 3 does not modify the present PICOS mode.

Switching from OVS Mode to L2/L3 Mode

 This section describes the procedure used to switch from OVS mode to L2/L3 mode on a PicOS switch named LEAF-A. The switch name is arbitrary.

  1. Log in with username admin to arrive at the Linux shell prompt.



2. Run the picos_boot script located in /usr/bin directory. The full path does not need to be used because the /usr/bin directory is on the system PATH by default.

3. Enter option 1 to select L2/L3 mode.

4. Restart the picos service to activate PicOS L2/L3 mode.

5. Optionally, user can run the cli command at the Linux shell to enter the PicOS L2/L3 operation mode.



As an alternative to restarting the picos service, user can just reboot the switch to bring the PicOS mode change into effect.

Enabling CrossFlow in L2/L3 Mode

This section describes the procedure to enable CrossFlow in L2/L3 mode.

  1. Enter L2/L3 operation mode, using the cli command at the Linux shell.





  2. Enter configuration mode, using the configure command in the operation mode.



  3. Enable CrossFlow mode, using the set xovs enable true command in configuration mode. Commit the changes, and exit the configuration mode. Then, exit the operation mode.



  4. User can now run the OVS mode commands from the Linux shell.



Copyright © 2024 Pica8 Inc. All Rights Reserved.