From 8eeaed71527102ee855d0ce244ed50f8bc0bbfa1 Mon Sep 17 00:00:00 2001 From: Gunnar Mills Date: Thu, 7 Dec 2017 10:41:46 -0600 Subject: Add information about factory reset Change-Id: If50645398370d66da0f81f1934e8491999f23bc9 Signed-off-by: Gunnar Mills --- code-update/host-code-update.md | 5 +++-- code-update/ubi-code-update.md | 19 +++++++++++++++++++ 2 files changed, 22 insertions(+), 2 deletions(-) (limited to 'code-update') diff --git a/code-update/host-code-update.md b/code-update/host-code-update.md index e94cace..fa382a0 100644 --- a/code-update/host-code-update.md +++ b/code-update/host-code-update.md @@ -126,7 +126,8 @@ Copy the partition binary file to `/usr/local/share/pnor/` on the BMC. The partition binary file must be named the same as the partition name that intends to patch, ex: `ATTR_TMP`. -### Associations +### Associations, MANIFEST File, Deleting an Image, Software Field Mode, and Software Factory Reset -Information about Associations can be found at +Information about associations, the MANIFEST file, deleting an image, software +field mode, and software factory reset can be found at [ubi-code-update.md#associations](ubi-code-update.md#associations) diff --git a/code-update/ubi-code-update.md b/code-update/ubi-code-update.md index 5054d6a..45ee485 100644 --- a/code-update/ubi-code-update.md +++ b/code-update/ubi-code-update.md @@ -314,6 +314,25 @@ reboot More information on field mode can be found here: https://github.com/openbmc/phosphor-dbus-interfaces/blob/master/xyz/openbmc_project/Control/FieldMode.interface.yaml +### Software Factory Reset + +Software factory reset resets the BMC and host firmware to its factory state +by clearing out any read/write data. +To software factory reset run the following command and then reboot the BMC: + +``` +curl -b cjar -k -H 'Content-Type: application/json' -X POST -d '{"data":[]}' \ + https://${bmc}/xyz/openbmc_project/software/action/Reset + +``` + +The factory reset on the BMC side will clear `/var`, `/home`, and `/etc`. +On the host side, the factory reset will clear the read/write volume for each +host image on the system, clear the shared preserve host volume, pnor-prsv, and +clear any host patches located in `/usr/local/share/pnor/`. + +The factory reset interface can be found here: +https://github.com/openbmc/phosphor-dbus-interfaces/blob/02b39246d45ea029a1652a49cc20eab7723dd63b/xyz/openbmc_project/Common/FactoryReset.interface.yaml ### Implementation -- cgit v1.2.3