Backup the Configuration File

Before the upgrade, user can backup the configuration file, prior to upgrading the switch.
If user is running L2/L3, the configuration file is /pica/config/pica_startup.boot. If user is running OVS mode, the configuration file is /ovs/ovs-vswitchd.conf.db.

Download the PicOS 2.3 Image

Download the PicOS 2.x image for P-3920 from the Pica8 website. Visit http://www.pica8.com/portal/ to register for a Pica8 Portal account. Once registration is approved, log in and download the images from the portal. Save the downloaded image at a local TFTP or FTP server.

Prepare the SD Card

PicOS 2.3 requires user to partition the SD card. This will require user to bring up a utility program to perform the disk partition and re-formatting. To bring up the utility program, user needs to first stop the boot loader from the booting process. The boot loader, uBoot, provides the different boot commands to enter either the flash Linux environment or the PicOS system on the CF card. By default, it brings up PicOS.
User needs to stop the booting process by hitting the Enter key at the prompt of "Hit any key to stop autoboot". This will drop into the uBoot prompt. 

Hit any key to stop autoboot: 5

At the uBoot prompt, enter the following command to bring up the utility program.

=>run flash_bootcmd

This boots through a Linux kernel and stops at a menu of the utility tool as the following:

Please choose which to start. (Will choose active entry if no input in 10 seconds)
Current boot mode: normal
===================Main Menu=====================
*1 - Start Application (active)
2 - Start Diagnostic Application
3 - Utility 
==================================================
Enter your choice (1-3): 3
This will bring up the Utility Menu. Enter 7 as your choice:
===================Utility Menu========================
1 - Format FLASH device to JFFS2 file system
2 - List file 
3 - Delete file
4 - Download file
5 - Active file
6 - Reboot
7 - System Shell
8 - Exit
=======================================================
Enter your choice (1-8): 7
(none) 
login: root
Password: 
login[1096]: root login on 'ttyS0'

Partition the CF Card

Bring up the fdisk tool, which can set up the partition table.

fdisk /dev/mmcblk0

First, check whether the SD card has one or two partitions:

Command (m for help): p 
Disk /dev/mmcblk0p: 3997 MB, 3997163520 bytes
128 heads, 63 sectors/track, 968 cylinders
Units = cylinders of 8064 * 512 = 4128768 bytes  
    Device Boot      Start         End      Blocks  Id System
/dev/mmcblk0p1           1         631     2544160+ 83 Linux

If it shows one partition (as shown above) or no partition, please use the following steps to partition the CF card into two partitions. If it shows two partitions, it means that it has been done in the factory, and user can skip the steps to partition the CF card by issuing command "q" to exit from fdisk and continue on Mount SD Card.

If it shows only one partition, enter "d" to delete the old partition.

Command (m for help): d
Selected partition 1

Now create the new partition with the "n" command.

Command (m for help): n
Command action
e extended
p primary partition (1-4)

This is where user needs to use the recorded SD size. User needs to reserve about 400 MB for partition 2. The rest of the SD card belongs to partition 1. If the size of the SD card is 4GB, partition should be 3.6GB (3600M) and partition 2 is 400M.
Since we need both partitions to be bootable, we will need to set both as primary. Enter "p" to select primary partition, and "1" to configure partition 1.

Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-968, default 1): 1
Last cylinder or +size or +sizeM or +sizeK (1-968, default 968): 864

Create partition 2 with the rest of the sectors.

Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (865-968, default 865): <Enter> Using default value 865
Last cylinder or +size or +sizeM or +sizeK (865-968, default 968): <Enter> Using default value 968

Enter "w" to write the partition table and exit.

Command (m for help): w

This should complete the disk formatting process.

Formatting the File Systems

We need to format the two partitions into the EXT3 file system.

mke2fs -j /dev/mmcblk0p1

mke2fs -j /dev/mmcblk0p2

Mount SD CARD

Mount the partition 1 and change the working directory to /mnt/sd_card with the following commands:

mount /dev/mmcblk0p1 /mnt/sd_card
cd /mnt/sd_card

Setting Up an IP Address

In order to download the 2.0 image to the switch, user will need to set up the network connection of the management port. There are two ways to set up the IP address of the management port:

1. Obtain the IP address through DHCP, or.

2. Setup a static IP address.

If the switch is connected to a DHCP server, enter the following command to obtain the DHCP-assigned IP:

#udhcpc

If a DHCP server is not available, set up a static IP instead:

#ifconfig eth0 <IP address>

Ping the TFTP server first to make sure the network is set up properly.

Downloading and Installing the PicOS Image

Use TFTP or FTP to retrieve the image from a remote server.
When using TFTP, enter rootfs.tar.gz for<local-image-name>. User will need the file name of the new image, which should be stored at the TFTP server. Use the file name as <remote-image-name>.
<TFTP-server-IP> is the IP address of the TFTP server. The process may take several minutes. 

#cd /mnt/sd_card
#tftp -g -l <local-image-name> -r <remote-image-name> <TFTP-server-IP>
...
#sync

When using FTP, use the following syntax.

After downloading the image, unzip the compressed image file.

#tar zxvf rootfs.tar.gz
...
#sync

Finally, reboot the system:
#reboot

Please refer to section "Upgrade PicOS from 2.0 to 2.x" for instructions for upgrading to 2.x version.