w1kl4s/quanta-brocade
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

add proper md output & disclaimers

Browse Source
This commit is contained in:
BuildTools
2017-12-17 19:54:53 -05:00
parent be8986d40f
commit b86db07f79
1 changed files with 75 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files

119
documentation/index.md
View File

@@ -1,13 +1,21 @@
#Flashing the LB6M to a Brocade TurboIron 24X
##Prerequisites & Preparation
This guide assumes you're familiar with the basics like tftp, obtaining a serial console to the device, etc. If you're not, this guide is probably not for you. Before touching your switch, read this document from beginning to end to get a basic idea of what you'll be doing.
##Caveats & Disclaimer
We are not responsible for any damaged devices or property resulting from this guide. This guide assumes you own a legitimate Brocade TurboIron and therefore have rights to the firmware & its use.
Two things will also change due to hardware differences:
If you miss a part of it you'll render your switch unusable, but that risk can be entirely mitigated by being prepared and following closely. It's also a good idea to have the switch on a UPS while you do this, if you lose power after the *erase* command before you've flashed the new bootloader, your device is a brick (however it can be recovered with a PowerPC capable JTAG unit, if you're desperate).
* The Brocade does not physically have LED lights for the SFP+ ports, so the code has no provison to control anyway. Therefore flashing this will render your SFP+ status/activity LED lights inactive. The Chassis LEDs and copper port LEDs still work as normal
* The Brocade only has one Out Of Band management port. Your #2 OOB port will no longer do anything. You'll still have OOB managenet as usual on mgmt #1, and of course in-band management on all the normal ports.
##Prerequisites & Preparation
This guide assumes you're familiar with the basics like tftp, obtaining a serial console to the device, etc. If you're not, this guide is probably not for you. Before touching your switch, read this document from beginning to end to get a basic idea of what you'll be doing - do **not** skip this step.
If you miss a part of it you'll render your switch unusable, but that risk can be entirely mitigated by being prepared and following closely. It's also a good idea to have the switch on a UPS while you do this, if you lose power after the *erase* command before you've flashed the new bootloader, your device is a brick (however it can be recovered with a PowerPC capable JTAG unit).
Firstly grab this [Brocade Firmware Zip](http://brokeaid.com/files/Brocade-TI.zip) - it contains your bootloader, OS, and all the documentation you'll need. We're not promising it will be available here long, so keep it somewhere safe. If you redistribute it, please do not exclude or rename any files (keep it complete). Start a tftp server and make sure both *brocadeboot.bin* and *brocadeimage.bin* are being served by your tftp server.
Connect to the serial console port on the switch and open a terminal window. Also be sure to connect one of the management ports on the switch to a network that has layer 2 access to your tftp server, so it can succesfully retrieve them while in u-boot.
Connect to the serial console port on the switch and open a terminal window (9600 8N1). Also be sure to connect the #1 management port on the switch to a network that has layer 2 access to your tftp server, so it can succesfully retrieve them while in u-boot.
##Flash Preparation
@@ -23,19 +31,20 @@ With all the following commands, copy and paste them *exactly* as you see them.
Now use the memory read command to verify your quanta bootloader is where it should be, to ensure the commands to follow will use the correct location:
```
md 0xfff80000 100
md 0xfff80000 20
```
the output should match this exactly:
```
fff80000: 4d55 4348 0205 7be5 0005 a2d6 0000 4058 MUCH..{.......@X
fff80010: 0000 0000 0001 2f2c 0004 d880 0060 0028 ....../,.....`.(
fff80020: 00REPLACE WITH QUANTA fff ffff 0000 0000 ...0............
fff80030: 4e6a b6ae 0703 0000 7472 7a30 3733 3030 Nj......trz07300
fff80040: 0000 0000 0000 0000 0000 0000 0000 0000 ................
fff80050: 0000 0000 0000 0000 0000 0000 0000 0000 ................
fff80060: 0000 0000 0000 0000 0000 0000 0000 0000 ................
fff80000: 27051956 552d426f 6f742032 3030392e '..VU-Boot 2009.
fff80010: 30362028 41707220 31392032 30313120 06 (Apr 19 2011
fff80020: 2d203135 3a35373a 30362900 60000000 - 15:57:06)....
fff80030: 3c20d000 60213f80 38000000 9401fffc < ..!?.8.......
fff80040: 9401fffc 9421fff8 3c00ffff 6000fffc .....!..<......
fff80050: 9421fff8 9001000c 48000005 7dc802a6 .!......H...}...
fff80060: 800e171c 7dc07214 480020dd 3c600002 ....}.r.H. .<..
fff80070: 60631200 7c600124 4c00012c 48002065 c..|.$L..,H. e
```
If the output on your switch does not match this exactly, **STOP!** Pastebin your switches output and get in touch with us on [ServeTheHome](https://forums.servethehome.com/index.php?threads/quanta-lb6m-10gbe-discussion.8002/) - we'll help you figure it out.
@@ -45,9 +54,9 @@ Carrying on, assuming your **md** output matched ours: It's time to load in the
```
#give the switch a temporary unique IP
setenv ipaddr 192.168.1.50 #VERIFY THIS IS CORRECT
setenv ipaddr 192.168.1.50
#give it the IP of your tftp server
setenv serverip 192.168.1.49 #VERIFY THIS IS CORRECT
setenv serverip 192.168.1.49
#copy the brocade bootloader to a temp address in RAM
tftpboot 0x100000 brocadeboot.bin
```
@@ -55,35 +64,37 @@ tftpboot 0x100000 brocadeboot.bin
The tftpboot command should have output like below:
```
=> tftpboot 0x100000 trz07300.bin
=> tftpboot 0x100000 brocadeboot.bin
Enet starting in 1000BT/FD
Speed: 1000, full duplex
Using TSEC0 device
TFTP from server 192.168.85.253; our IP address is 192.168.85.252
Filename 'trz07300.bin'.
TFTP from server 192.168.1.51; our IP address is 192.168.1.142
Filename 'brocadeboot.bin'.
Load address: 0x100000
Loading: #################################################################
######################################
Loading: Got error 4
####################################
done
Bytes transferred = 524288 (80000 hex)
=>
```
Now you need to verify that the temporary address contains the brocade bootloader:
If you see Error 4 that's normal, just be sure the bytes transferred matches. Now you need to verify that the temporary address contains the brocade bootloader:
```
md 0x100000 100
md 0x100000 20
```
The output should match the below exactly:
```
00100000: 4d55 4348 0205 7be5 0005 a2d6 0000 4058 MUCH..{.......@X
00100010: 0000 0000 0001 2f2c 0004 d880 0060 0028 ....../,.....`.(
00100020: 0003 0030 0004 ffff ffff ffff 0000 0000 ...0............
00100030: 4e6a b6ae 0703 0000 7472 7a30 3733 3030 Nj......trz07300
00100040: 0000 0000 0000 0000 0000 0000 0000 0000 ................
00100050: 0000 0000 0000 0000 0000 0000 0000 0000 ................
00100060: 0000 0000 0000 0000 0000 0000 0000 0000 ................
00100070: 0000 0000 0000 0000 0000 0000 0000 0000 ................
00100000: 4d554348 02057be5 0005a2d6 00004058 MUCH..{.......@X
00100010: 00000000 00012f2c 0004d880 00600028 ....../,.....`.(
00100020: 00030030 0004ffff ffffffff 00000000 ...0............
00100030: 4e6ab6ae 07030000 74727a30 37333030 Nj......trz07300
00100040: 00000000 00000000 00000000 00000000 ................
00100050: 00000000 00000000 00000000 00000000 ................
00100060: 00000000 00000000 00000000 00000000 ................
00100070: 00000000 00000000 00000000 00000000 ................
```
If it doesn't match, **STOP**. You can safely reboot back to quanta by typing reset or power cycling it. if you'd like, pastebin the output and get in touch with us on ServeTheHome. If it does match, continue on.
@@ -102,20 +113,20 @@ cp.b 0x100000 0xfff80000 0x80000
Congratulations, you've installed the brocade bootloader (which can load the brocade software image). **DO NOT REBOOT YET!** First verify the brocade bootloader is in the bootloader location:
```
md 0xfff80000 100
md 0xfff80000 20
```
The output from your switch should match the below exactly:
```
00100000: 4d55 4348 0205 7be5 0005 a2d6 0000 4058 MUCH..{.......@X
00100010: 0000 0000 0001 2f2c 0004 d880 0060 0028 ....../,.....`.(
00100020: 0003 0030 0004 ffff ffff ffff 0000 0000 ...0............
00100030: 4e6a b6ae 0703 0000 7472 7a30 3733 3030 Nj......trz07300
00100040: 0000 0000 0000 0000 0000 0000 0000 0000 ................
00100050: 0000 0000 0000 0000 0000 0000 0000 0000 ................
00100060: 0000 0000 0000 0000 0000 0000 0000 0000 ................
00100070: 0000 0000 0000 0000 0000 0000 0000 0000 ................
fff80000: 4d554348 02057be5 0005a2d6 00004058 MUCH..{.......@X
fff80010: 00000000 00012f2c 0004d880 00600028 ....../,.....`.(
fff80020: 00030030 0004ffff ffffffff 00000000 ...0............
fff80030: 4e6ab6ae 07030000 74727a30 37333030 Nj......trz07300
fff80040: 00000000 00000000 00000000 00000000 ................
fff80050: 00000000 00000000 00000000 00000000 ................
fff80060: 00000000 00000000 00000000 00000000 ................
fff80070: 00000000 00000000 00000000 00000000 ................
```
If it matches, continue on to **Booting Brocade** below - the scary part is over. However if it doesn't, stay calm. Does it match the output you got earlier when you ran "md 0xfff80000 100" at the beginning of this guide? If so, that means the Quanta bootloader is still there. Either you didn't properly disable write protection, or something else has gone wrong. You can reboot into quanta like normal, and contact us on the forums.
@@ -128,7 +139,8 @@ You now have the Brocade bootloader in the bootloader section of the PowerPC fla
```
reset
```
It will now reboot into the Brocade bootloader. We need to tftpboot the brocade software image:
It will now reboot into the Brocade bootloader. In the bootloader and brocade software via telnet, you need to use shift+backspace to backspace. You can remedy this by changing your putty settings to "Control+H" for backspace method under Terminal>Keyboard. Once you get it up and running, you can also configure SSH which uses normal backspaces.
We need to tftpboot the brocade software image:
```
#give the bootloader a temporary unique IP
@@ -137,22 +149,32 @@ ip address 192.168.1.50/24
boot system tftp 192.168.1.49 brocadeimage.bin
```
It will now boot into the full brocade firmware, however we still need to actually flash it to the device flash:
It will now boot into the full brocade firmware, however we still need to actually flash it to the device flash as well as fix flash permissions by re-flashing the bootloader using Brocade's official bootloader flashing routine:
```
enable
#for user, use root. If it asks for a password, just hit enter
#give the mgmt interface an address so it can contact your tftp server
conf t
int mgmt 1
int management 1
ip addr 192.168.1.50/24
exit
write mem
#now load and write the firmware
#reflash the bootloader using brocade flash routine, to fix permissions
#Substitute IP's with your tftp server
copy tftp flash 192.168.10.49 brocadeboot.bin bootrom
#reboot the switch so the new bootloader fixes perms
#you won't be able to write to flash until you do this
reload
#now load and write the firmware.
#If your management IP config from earlier didn't save,
#you'll need to redo those steps to give it an IP again
copy tftp flash 192.168.1.49 brocadeimage.bin primary
#It now perfectly matches a stock brocade Turboiron
#reboot it and it will come up on it's own like a stock device
reload
```
That's it! You can now type reload and hit enter, and it will reboot the switch. It'll come up as a TurboIron. Some commands to check out your new system:
That's it! You can ditch the serial cable and telnet to the management IP. If you want to use SSH, you'll need to enable it (follow the included brocade docs). Some commands to check out your new system:
```
show version
@@ -160,4 +182,13 @@ show flash
show chassis
show media
```
This is the full layer 3 image that has all the layer 2 and layer 3 features, so please follow the included userguide to configure your new switch. A quick guide is available on the left.
This is the full layer 3 image that has all the layer 2 and layer 3 features, so please follow the included userguide to configure your new switch. A quick guide is available on the left, but this site is not a substitute for learning Brocade's documentation.
###Credits
[**Jon Sands**](http://fohdeesha.com/)
[**Bengt-Erik Norum**](http://amateurfoundation.org/)
Thanks to **fvanlint** from STH for being our first method tester.