= The Quanta LB9 XORPlus install Guide =

The Pronto 3295 we received shipped with indigo preinstalled, so the install / upgrade procedures for the 3290 don't work. Namely, the command "run flash_bootcmd" returns an error. 

By default, the switch boots straight to the CF card, bypassing the flash, with a U-Boot environment residing on the CF card, which then loads indigo.

On the flash exists an ONIE install. To boot this, use command "run onie_bootcmd". This install will attempt to grab an image off of the network and install it. This can be bypassed by killing the process once booted. it finds the correct image to download based off of the dhcp option "default-url"

Instructions for using this to install picos version 2.4 are at http://www.pica8.org/document/v2.4/pdf/picos-getting-started-and-upgraded-guide.pdf page 12-15.

Steps:
1. connecting to switch
 1. SSH to igolgi1 or igolgi2 (the switch console port is connected to these machines)
 1. run "sudo minicom" (settings are already configured: 115200, 8n1, flow control disabled
1. preliminary setup
 1. chose any boot option, then type "reboot" to reboot switch
 1. press enter while switch is booting to enter u-boot prompt (short window to do so)
 1. type "printenv ethaddr" to show management ethernet mac address
1. dhcp modifications
 1. on dhcp1, add a dhcp host entry of this form, with an appropriate MAC and IP address.
{{{ 
host igolgisw1 {
        hardware ethernet 08:9e:01:f8:8e:02;
        fixed-address 10.50.100.42;
        option default-url = "tftp://10.50.0.42/pronto3295.bin";
        }
}}}
 1. Reboot dhcp: "/etc/init.d/dhcp3-server restart"
1. Installation
 1. Back on the switch, type "run onie_bootcmd"
 1. It should boot off of the flash, get an IP address from DHCP, and then start fetching the image file off of repository1. This will take several minutes. Afterwards, it will extract the image, and then reboot. This is also a long process.
 1. Finally, it will reboot into the xorplus prompt. Default login is admin/pica8, it will prompt for a password change.

== Installing v2.3 manually ==
2.4 has licencing check, and using automated onie install does not partition CF card. We will follow old instructions for upgrading switch, but use ONIE to format CF card, as u-boot flash environment does not exist.

Steps:
1. reboot into uboot
1. run onie_rescue
1. partitioning the cf card
  1. We need 2 partitions, partition 2 needs to be at least 400MB, and partition 1 gets what's left, but a minimum of 550MB to hold the image, so we need a 1gb cf card at minimum, larger is better.
  1. run fdisk -l
  1. you will see
{{{
Disk /dev/sda: 1045 MB, 1045094400 bytes
32 heads, 63 sectors/track, 1012 cylinders
Units = cylinders of 2016 * 512 = 1032192 bytes

   Device Boot      Start         End      Blocks  Id System
/dev/sda1   *           1        1012     1020064+  6 FAT16
Partition 1 has different physical/logical endings:
     phys=(999, 31, 63) logical=(1011, 31, 63)
}}}
  1. calculate cylinder boundaries
   1. Note total cylinders (1012) , and total size, in MB (1045)
   1. Divide total size by 400, (1045/400)= 2.6125
   1. Divide total cylinders by 2.6125 (1012/2.6125)=387.36...
   1. Round up to nearest 10 or so. 387... to 390.
   1. subtract 1012-390 = 622
  1. type fdisk /dev/sda
  1. type d, then 1 to delete partition 1
{{{
Command (m for help): d
Selected partition 1
}}}
  1. create new partition with n p 1 622
{{{
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-3970, default 1): 1
Last cylinder or +size or +sizeM or +sizeK (1-1012 default 1012): 622
}}}
  1. create second partition with n p 2 enter enter (uses defaults)
{{{
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (623-1012, default 623): <Enter> Using default value 623
Last cylinder or +size or +sizeM or +sizeK (623-1012, default 1012): <Enter> Using default value 1012
}}}
  1. press w to write and exit.
 1. Formatting
  1. mke2fs -j /dev/sda1*
  1. mke2fs -j /dev/sda2*
 1. Mount the cf card
  1. mkdir /cf_card
  1. mount /dev/sda1 /cf_card
 1. Download image.
  1. tftp -g -l rootfs.tar.gz -r (picos image name) 10.50.0.42
 1. extract image
  1. tar -zxvf rootfs.tar.gz -C /cf_card/
  1. cf /cf_card
  1. sync
 1. reboot into new os
  1. reboot

== Additional documentation: ==

[http://opencomputeproject.github.io/onie/docs/design-spec/discovery.html onie image discovery specs]

[https://groups.google.com/a/onie.org/forum/#!topic/onie/wSpolmh1yfc onie forum thread with old command names]

[https://support.cumulusnetworks.com/hc/en-us/articles/203771426-Using-ONIE-to-Install-Cumulus-Linux using onie to install cumulus linux]