Skip to content

Latest commit

 

History

History
211 lines (156 loc) · 8.78 KB

code_update.md

File metadata and controls

211 lines (156 loc) · 8.78 KB
Raw

Code Update

Redfish Code Update

Currently supported BMC and PNOR update formats are UBI. For code update information, please refer to code-update.md

  • UBI Format

    For BMC code update, download the system type *.ubi.mdt.tar image from https://jenkins.openbmc.org/job/latest-master/ and run as follows:

    For Witherspoon system:

    * Code Update with OnReset Policy

    $ cd redfish/update_service/test_redfish_bmc_code_update.robot
    $ robot -v OPENBMC_HOST:x.x.x.x -v IMAGE_FILE_PATH:<image path>/obmc-phosphor-image-witherspoon.ubi.mtd.tar --include Redfish_Code_Update_With_ApplyTime_OnReset redfish/update_service/test_redfish_bmc_code_update.robot

* Code Update with Immediate Policy

    $ cd redfish/update_service/test_redfish_bmc_code_update.robot
    $ robot -v OPENBMC_HOST:x.x.x.x -v IMAGE_FILE_PATH:<image path>/obmc-phosphor-image-witherspoon.ubi.mtd.tar --include Redfish_Code_Update_With_ApplyTime_Immediate redfish/update_service/test_redfish_bmc_code_update.robot

    For host code update, download the system type *.pnor.squashfs.tar image from https://openpower.xyz/job/openpower-op-build/ and run as follows:

    For Witherspoon system:

    * Code Update with OnReset Policy

    $ cd redfish/update_service/test_redfish_host_code_update.robot
    $ robot -v OPENBMC_HOST:x.x.x.x -v IMAGE_FILE_PATH:<image path>/witherspoon.pnor.squashfs.tar --include Redfish_Code_Update_With_ApplyTime_OnReset redfish/update_service/test_redfish_host_code_update.robot

* Code Update with Immediate Policy

    $ cd redfish/update_service/test_redfish_host_code_update.robot
    $ robot -v OPENBMC_HOST:x.x.x.x -v IMAGE_FILE_PATH:<image path>/witherspoon.pnor.squashfs.tar --include Redfish_Code_Update_With_ApplyTime_Immediate redfish/update_service/test_redfish_host_code_update.robot

REST Code Update

Currently supported BMC and PNOR update formats are UBI and non-UBI. For code update information, please refer to code-update.md

  • UBI Format

    For BMC code update, download the system type *.ubi.mdt.tar image from https://jenkins.openbmc.org/job/latest-master/ and run as follows:

    For Witherspoon system:

    $ cd extended/code_update/
$ robot -v OPENBMC_HOST:x.x.x.x -v IMAGE_FILE_PATH:<image path>/obmc-phosphor-image-witherspoon.ubi.mtd.tar --include REST_BMC_Code_Update  bmc_code_update.robot

    For host code update, download the system type *.pnor.squashfs.tar image from https://openpower.xyz/job/openpower-op-build/ and run as follows:

    For Witherspoon system:

    $ cd extended/code_update/
$ robot -v OPENBMC_HOST:x.x.x.x -v IMAGE_FILE_PATH:<image path>/witherspoon.pnor.squashfs.tar --include REST_Host_Code_Update  host_code_update.robot

  • Non-UBI Format

    For BMC code update, download the system type *all.tar image from https://jenkins.openbmc.org/job/latest-master/ and run as follows:

    For a Zaius system:

    $ cd extended/code_update/
$ robot -v OPENBMC_HOST:x.x.x.x -v FILE_PATH:<image path>/zaius-<date time>.all.tar --include Initiate_Code_Update_BMC update_bmc.robot

    For host code update, download the system type *.pnor from https://openpower.xyz/job/openpower-op-build/ and run as follows:

    For a Zaius system:

    $ cd extended/
$ robot -v OPENBMC_HOST:x.x.x.x -v PNOR_IMAGE_PATH:<image path>/zaius.pnor test_bios_update.robot

Generating Bad Firmware Image for testing

Procedure is to create bad firmware image for BMC and same steps applicable for Host image.

  • No MANIFEST file

    Command to list the content of the firmware image.

tar -tvf obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar
-rw-r--r-- jenkins-op/jenkins-op 306804 2021-05-15 22:00 image-u-boot
-rw-r--r-- jenkins-op/jenkins-op 3039300 2021-05-12 03:32 image-kernel
-rw-r--r-- jenkins-op/jenkins-op 19861504 2021-05-15 22:00 image-rofs
-rw-r--r-- jenkins-op/jenkins-op   850304 2021-05-15 22:00 image-rwfs
-rw-r--r-- jenkins-op/jenkins-op      176 2021-05-15 22:00 MANIFEST
-rw-r--r-- jenkins-op/jenkins-op      272 2021-05-15 22:00 publickey
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-u-boot.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-kernel.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-rofs.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-rwfs.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 MANIFEST.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 publickey.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-full.sig

Delete MANIFEST file from the tar firmware image.

tar --delete -vf obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar MANIFEST

tar -tvf obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar
-rw-r--r-- jenkins-op/jenkins-op 306804 2021-05-15 22:00 image-u-boot
-rw-r--r-- jenkins-op/jenkins-op 3039300 2021-05-12 03:32 image-kernel
-rw-r--r-- jenkins-op/jenkins-op 19861504 2021-05-15 22:00 image-rofs
-rw-r--r-- jenkins-op/jenkins-op   850304 2021-05-15 22:00 image-rwfs
-rw-r--r-- jenkins-op/jenkins-op      272 2021-05-15 22:00 publickey
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-u-boot.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-kernel.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-rofs.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-rwfs.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 MANIFEST.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 publickey.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-full.sig

Command to re-name tar firmware image.

mv obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar bmc_bad_manifest.ubi.mtd.tar

  • No kernel image

    Command to list the content of the firmware image.

tar -tvf obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar
-rw-r--r-- jenkins-op/jenkins-op 306804 2021-05-15 22:00 image-u-boot
-rw-r--r-- jenkins-op/jenkins-op 3039300 2021-05-12 03:32 image-kernel
-rw-r--r-- jenkins-op/jenkins-op 19861504 2021-05-15 22:00 image-rofs
-rw-r--r-- jenkins-op/jenkins-op   850304 2021-05-15 22:00 image-rwfs
-rw-r--r-- jenkins-op/jenkins-op      176 2021-05-15 22:00 MANIFEST
-rw-r--r-- jenkins-op/jenkins-op      272 2021-05-15 22:00 publickey
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-u-boot.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-kernel.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-rofs.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-rwfs.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 MANIFEST.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 publickey.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-full.sig

Delete image-kernel file from the tar firmware image.

tar --delete -vf obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar image-kernel

tar -tvf obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar
-rw-r--r-- jenkins-op/jenkins-op 306804 2021-05-15 22:00 image-u-boot
-rw-r--r-- jenkins-op/jenkins-op 19861504 2021-05-15 22:00 image-rofs
-rw-r--r-- jenkins-op/jenkins-op   850304 2021-05-15 22:00 image-rwfs
-rw-r--r-- jenkins-op/jenkins-op      176 2021-05-15 22:00 MANIFEST
-rw-r--r-- jenkins-op/jenkins-op      272 2021-05-15 22:00 publickey
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-u-boot.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-kernel.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-rofs.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-rwfs.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 MANIFEST.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 publickey.sig
-rw-r--r-- jenkins-op/jenkins-op      128 2021-05-15 22:00 image-full.sig

Command to re-name tar firmware image.

mv obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar bmc_nokernel_image.ubi.mtd.tar

  • Invalid key image

    Command to untar the firmware image.

tar -xvf obmc-phosphor-image-witherspoon-20210516025203.ubi.mtd.tar -C /directory_path/untar_files/
image-u-boot
image-kernel
image-rofs
image-rwfs
MANIFEST
publickey
image-u-boot.sig
image-kernel.sig
image-rofs.sig
image-rwfs.sig
MANIFEST.sig
publickey.sig
image-full.sig

Change few random characters in public key file that in turn corrupts the public key file.

Command to tar the firmware image files.

tar -cvf bmc_invalid_key.ubi.mtd.tar *