Programmable Internetworking & Communication Operating System Docs ... Click Spaces -> Space Directory to see docs for all releases ...
Page tree
Skip to end of metadata
Go to start of metadata

The Pica8 PicOS software operates in two modes.

L2/L3 (Layer 2/Layer 3) Mode:  This is the default PicOS mode. In this mode, the switch is used for traditional Layer 2 switching and Layer 3 routing. The OVS daemon is not running in the L2/L3 mode.

OVS (Open vSwitch) Mode:  In this mode, the switch is completely dedicated to Open vSwitch and the L2/L3 daemon is not running. 

By default PicOS has two users, root and admin.

Password for the admin account must be manually set during the first login. User should use pica8 as the password at first login. Then, the system will prompt user to enter user's own password with at least 6 characters. The prompt admin@XorPlus$ appears when the password has been successfully configured.

When logging in as root, user should use sudo as the password, and the system will prompt user to enter the a secure password.

  • On N3048EP-ON and N3132PX switches, run "save_config" command when update the password. Otherwise, the password will be lost after PicOS reboot. For detail, please refer to Configuration Saving Guide.
  • The PicOS Password Recovery process is available in the event of a forgotten password.
XorPlus login: admin
Password: (input default password "pica8")
You are required to change your password immediately (root enforced)
Changing password for admin.
(current) UNIX password: (input "pica8" again)
Enter new UNIX password: (input new password: the new password should be no less than six characters)
Retype new UNIX password: (input new password again)
admin@XorPlus$
admin@XorPlus$
admin@XorPlus$cli
Synchronizing configuration...OK.
Pica8 PicOS Version 2.5.0
Welcome to PicOS L2/L3 on XorPlus
admin@XorPlus>

SSH Access to the Switch

The PicOS CLI (command-line interface) can be used to assign a management IP address to the switch. The management IP address can also be configured using the Linux shell.

The following example configures the switch to obtain the management IP address from a DHCP server. Once the Switch has an IP address, it can be accessed through the SSH (Secure Shell) protocol.

admin@PicOS-OVS$sudo ifdown eth0 && sudo ifup -v eth0
Internet Systems Consortium DHCP Client 4.2.4
Copyright 2004-2012 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/
Listening on LPF/eth0/08:9e:01:53:78:86
Sending on   LPF/eth0/08:9e:01:53:78:86
Sending on   Socket/fallback
DHCPRELEASE on eth0 to 172.16.0.1 port 67
Configuring interface eth0=eth0 (inet)
run-parts --verbose /etc/network/if-pre-up.d
run-parts: executing /etc/network/if-pre-up.d/ethtool
dhclient -1 -v -pf /run/dhclient.eth0.pid -lf /var/lib/dhcp/dhclient.eth0.leases eth0 	
Internet Systems Consortium DHCP Client 4.2.4
Copyright 2004-2012 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/
Listening on LPF/eth0/08:9e:01:53:78:86
Sending on   LPF/eth0/08:9e:01:53:78:86
Sending on   Socket/fallback
DHCPDISCOVER on eth0 to 255.255.255.255 port 67 interval 2
DHCPREQUEST on eth0 to 255.255.255.255 port 67
DHCPOFFER from 172.16.0.1
DHCPACK from 172.16.0.1
bound to 172.16.0.126 -- renewal in 70452 seconds.
run-parts --verbose /etc/network/if-up.d
run-parts: executing /etc/network/if-up.d/ethtool
run-parts: executing /etc/network/if-up.d/mountnfs
run-parts: executing /etc/network/if-up.d/ntpdate
run-parts: executing /etc/network/if-up.d/openssh-server
run-parts: executing /etc/network/if-up.d/upstart

Connection Management

Pica8 switches support three connection methods:

  • Console
  • SSH
  • Telnet

By default, console and SSH are enabled while telnet is disabled.

Log in via console port:

Pica8@dev:~$ telnet 192.168.10.123 2030
Trying 192.168.10.123...
Connected to 192.168.10.123.
Escape character is '^]'.
XorPlus login: admin

The following example shows how user can connect to a switch via SSH with admin as username:

Pica8@dev:~$ ssh 192.168.50.10 -l admin
admin@192.168.50.10's password:
admin@XorPlus$

The following example shows how user can connect to a switch via telnet. The connection attempt fails because telnet is disabled by default. 

Pica8@dev:~$ telnet 192.168.50.10
Trying 192.168.50.10...
telnet: Unable to connect to remote host: Connection refused

User can enable telnet using the set system services telnet disable false command:

admin@XorPlus# set system services telnet disable false
admin@XorPlus# commit
Commit OK.
Save done.
By default, root login is disabled via both telnet and SSH.

The following example enables root login via telnet:

admin@XorPlus# set system services telnet root-login allow
admin@XorPlus# commit
Merging the configuration.
Commit OK.
Save done.

The following example enables root login via SSH:

admin@XorPlus# set system services ssh root-login allow
admin@XorPlus# commit
Merging the configuration.
Commit OK.
Save done.

The root user account password is locked (non-existent). If logging in via root, user needs to reset the password.

By default, a telnet or SSH session is never terminated. However, user can set a time limit for idle sessions. In other words, if a session is idle for certain time, it will automatically be terminated. Use the set cli idle-timeout command, in L2/L3 mode, to configure the maximum time in minutes a session can stay idle before it is terminated.

XorPlus login: admin
Password:
admin@XorPlus$
admin@XorPlus$cli
Synchronizing configuration...OK.
Pica8 PicOS Version 2.6
Welcome to PicOS L2/L3 on XorPlus
admin@XorPlus> set cli idle-timeout 10
admin@XorPlus>

The Default Login

  • No labels