version: update to 20190114
[SLOF.git] / INSTALL
1 Slimline Open Firmware - SLOF
2
3 Copyright (C) 2005, 2012 IBM Corporation
4
5
6 INSTALL ON JS20/JS21
7 ===============================================================================
8
9  Detailed information about how to use SLOF on JS20 and JS21 can be found in
10  the document FlashingSLOF.pdf
11
12  The JS20 and JS21 blades both have 2 "flashsides". They have a 8MB flash part
13  which is divided into a 4MB "temporary" side and a 4MB "permanent" side.
14
15  The temporary side is the flashside used for the normal operation and the
16  permanent side is used as a backup if the temporary should ever fail.
17
18  Therefore it is important that the permanent flash side is not changed so
19  that if ever required the original firmware can be restored.
20
21  SLOF usually warns or in most cases does not easily allow to overwrite the
22  permanent side.
23
24  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
25  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
26  !                                                       !
27  ! NOTE: WHEN FLASHING A NEW FIRMWARE IMAGE YOU MIGHT    !
28  ! DESTROY YOUR FIRMWARE IMAGE AND LOOSE YOUR WARRANTY!  !
29  !                                                       !
30  ! YOU MAY NEED TO CALL SERVICE, IF THE FIRMWARE IMAGE   !
31  ! IS DESTROYED !                                        !
32  !                                                       !
33  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
34  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
35
36
37 REMOVING SLOF FROM JS20/JS21
38 ===============================================================================
39
40  If you want to boot the original firmware again, you need to boot the blade 
41  from the management module. If auto-boot is enabled you have to press "s"
42  to reach the firmware prompt.
43  On the SLOF command line, type:
44
45   0 > other-firmware
46
47  and it should get you back to running the original firmware. To permanently 
48  get it back, after booting Linux from there, type
49
50   $ update_flash -r
51   $ halt
52  
53  You will boot on the PERM side. To boot from the TEMP side again, you need to
54  restart the Blade System MGMT Processor.
55
56     Following steps are needed on
57         Management Module -> Blade Tasks -> Power/Restart
58         
59         Power Off Blade
60         Restart Blade System Mgmt Processor 
61         Power On Blade
62
63
64 INSTALL ON KVM/QEMU
65 ===============================================================================
66
67  Recent versions of QEMU should already be shipped with a version of SLOF.
68  To upgrade SLOF in your QEMU installation, back-up the old firmware file
69  .../share/qemu/slof.bin from your QEMU installation, then simply copy the
70  new SLOF image (for example "boot_rom.bin" after building board-qemu) to
71  this location.
72