Steps to perform a Xylan OmniSwitch/Router software upgrade

An unofficial guide.

1) Login to switch with the serial console port. Don't 'telnet' in.

	Welcome to the Xylan Omni Switch/Router! Version 3.4.5
	login   : admin
	password: switch (or whatever your password is)

2) Issue an 'ls' command and write down on paper a list of all the filenames that end with ".img" or ".pga". Double-check that you didn't forget any.
```
	/ % ls
```

3) Connect the laptop / server with the new Xylan software revision to an ethernet port on the switch. You may have to change the IP Address of your laptop / server to be on the same IP subnet as the switch to be able to communicate with it.

UNIX	Windows
First, Become root. Use 'su' to do this. Then, change your primary ethernet interface (usually "le0" or "hme0" on Sun's, "eth0" on Linux, "net0" on HP/UX, or "ec0" or "ef0" on SGI's) to an IP address on the same subnet as the switch: # ifconfig le0 192.168.10.5	Click {START}. Select Settings. Select Control Panel. Double-click on Network. Look in the box for the entry that binds your TCP/IP driver to your Ethernet Card, like "TCP/IP -> 3Com Etherlink III". Double-click on this entry. From here you can set your computer's IP address.

4) FTP from the laptop to the switch.

	C:\WINDOWS>ftp 192.168.10.1
	Connected to 192.168.10.1.
	220 Omni Switch/Router FTP server ready
	Name (192.168.10.1:blah): admin
	331 Password required
	Password: switch (or whatever the password is)
	230 User admin logged in
	ftp>

5) Make a local directory on your laptop to save the current software. It is best to name the directory after the name of the switch. Change into that new directory.
UNIX Windows
ftp> !mkdir ~/oldosr1 ftp> lcd ~/oldosr1
ftp> !mkdir \oldosr1 ftp> lcd \oldosr1

6) Backup all the old "code" that's on the switch by downloading it to your laptop / server. First, do an "ls" to a get a list of all the files...

	ftp> ls
*	-rw-------    admin       1749 MAY 07 15:30 gated.conf                    
*	-rw-------    admin     503884 MAY 07 15:30 gated.img                     
	-rw-------    admin      18072 MAY 07 15:31 mpm.log                       
*	-rw-------    admin         52 MAY 07 15:31 mpx.cmd                       
*	-rw-------    admin    1727644 MAY 07 15:31 mpx.img                       
*	-rw-------    admin      32768 MAY 21 17:49 mpm.cnf                       
*	-rw-------    admin       1024 MAY 21 17:49 mpm.cfg

(Only files with the following extensions should be downloaded: img,pga,cnf,cfg,conf,cmd. As an example, all the files that we have indicated with asterisks before them would be backed up.)

now set the FTP session to "binary" mode...

	ftp> bin
	200 Type set to I, binary mode

then "get" all the ".img", ".pga", ".cnf", ".cfg", ".conf", and ".cmd" files that were in the "ls" listing, one at a time...

	ftp> get mpx.cmd
	200 Port set okay
	150 Opening BINARY mode data connection
	226 Transfer complete
	18 bytes received in 0.00123 seconds (14610 bytes/s)

	ftp> get mpx.img
	200 Port set okay
	150 Opening BINARY mode data connection
	226 Transfer complete
	1595201 bytes received in 4.62 seconds (344992 bytes/s)
	
	ftp>

(and so on until you have all the ".img", ".pga", ".cnf", ".cfg", ".conf", and ".cmd" files.) Double-check that you didn't forget any. Get a list of the files in your local directory with "!dir" (or "!ls" on UNIX).

	ftp> !ls -l
	total 10039
	-rw-r--r--   1 eric     other          18 May 24 14:24 mpx.cmd
	-rw-r--r--   1 eric     other           6 Apr  2 09:47 mpm.cnf
	-rw-r--r--   1 eric     other     1595201 May 24 14:27 mpx.img

(and all of the files you just downloaded should show up here.)

NOTE: If you have a 32 or 56 megabyte SIMM, you also need to backup all the ".img", ".pga", ".cnf", ".cfg", ".conf", and ".cmd" files in the "/simm" directory.

HOW TO TELL: If you DON'T KNOW if you have a 32/56 meg SIMM, you can check by trying to change into the "/simm" directory and getting a file list. If it fails with the "invalid directory" message on either the "cd" or "ls" commands, then you DO NOT have a 32/56 megabyte SIMM.

	ftp> cd /simm
	550 No files found or invalid directory or permission problem

--or--

	ftp> ls
	550 No files found or invalid directory or permission problem

(You can return to the main directory by typing "cd /flash")

	ftp> cd /flash
	250 Changed directory to "/flash"
	ftp>

7)Now that all the files are backed up, we can proceed with the upgrade. Change into the directory on your local system where the Xylan CD is, or where you downloaded the new images to. Get a directory listing to confirm that you see the ".img" files.
UNIX Windows
ftp> lcd /cdrom/cdrom0 Local directory now /cdrom/cdrom0 ftp> !ls
ftp> lcd C:\XOS\OS318 Local directory now C:\XOS\OS318 ftp> !dir

8) Delete All the ".img" and ".pga" files on the switch. An easy way to do this is with the "imgcl" command. You will be prompted to confirm. This can take a few minutes, as the switch needs to defragment the flash file system in the process.

/ % imgcl
Remove the following?
        /flash/mpx.img
        /flash/esx.img
        /flash/tsx.img
        /flash/asx.img 
Are you sure you want to remove them? (n) y
............................4 files removed
/ %

9) Proceed to upload, one-at-a-time, every ".img" and ".pga" file that was on the switch before (you should have penciled this down in step 2. The FTP session should still be in "binary" mode. You can issue another "bin" command to confirm this. Check them off your paper as you upload them. First, issue a "hash" command to turn on visual hash-marks.

	ftp> hash
	Hash mark printing on (1024 bytes/hash mark).
	ftp>

Now start doing the "put"'s:

	ftp> put mpx.img
	200 Port set okay
	150 Opening BINARY mode data connection
	######################################################################
	######################################################################
	######################################################################
	######################################################################
	######################################################################
	######################################################################
	######################################################################
	######################################
	226 Transfer complete
	1688400 bytes sent in 14.6 seconds (115419 bytes/s)
	ftp>

(And so on until all the ".img"'s that were on the switch before have been uploaded.)

10) Reboot the switch. This can been done hours, or days later if desired. Whenever you're ready to experience a one-to-five minute downtime and risk the switch possibly not coming back up is a good time. It is best to be at the laptop / server that you backed up the old code onto before rebooting.
```
	/ % reboot
	   Confirm? (n) : y
	Locking filesystem...locked.
	System going down immediately...
	switch[48041de0]: System rebooted by admin
	                                          
	        System rebooted by user 'admin' on session 0
```
The switch should just come back up and begin operating as before in a few minutes. Allow it to fully initialize before attempting login.
NOTE: If you ever see a message saying "Chassis status changing, hit CTRL-C to abort", DO NOT hit CTRL-C. That option is for emergencies only. Using CTRL-C may appear to help but actually will just leave the switch in an uncertain state. Just be patient and a minute or two later it should be ready.

For Dual-MPX switches only:

After the switch finishes booting up, login to the Primary MPX (the one with the PRI L.E.D. light lit) and issue the "imagesync" and "configsync" commands to load the upgraded "code" onto the Seconday MPX. If the wrong MPX boots up as Primay, you can issue the "renounce" command to have the switch reboot with the Secondary MPX as Primary.

If you have any questions or encounter any problems during or prior to an upgrade, please contact Xylan technical support.

UNIX	Windows
ftp> !mkdir ~/oldosr1 ftp> lcd ~/oldosr1	ftp> !mkdir \oldosr1 ftp> lcd \oldosr1

UNIX	Windows
ftp> lcd /cdrom/cdrom0 Local directory now /cdrom/cdrom0 ftp> !ls	ftp> lcd C:\XOS\OS318 Local directory now C:\XOS\OS318 ftp> !dir