Add some hints about firmware changes

seveas · Oct 6, 2020 · 4d0d306 · 4d0d306
1 parent a0db305
commit 4d0d306
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 2 deletions.
diff --git a/docs/firmware.rst b/docs/firmware.rst
@@ -2,8 +2,14 @@ Dealing with iLO firmware updates
 =================================
 
 One of the key features of python_hpilo is that it makes iLO firmware updates
-painless. It can download the firmware for you, or you can feed it the .bin or
-.scexe files HP ships.
+painless. It can download the firmware for you, or you can feed it the .bin,
+.scexe or .fwpkg files HP ships.
+
+Note that the newest versions of the firmware, as of August 2020, are shipped
+in a new format and you will need to use python-hpilo 4.4 or newer to extract
+and use them. If you cannot upgrade, you can manually extract the .bin file
+from the .fwpkg file (just open it with anything that can open zip files) and
+pass the .bin file to python-hpilo.
 
 From the CLI
 ------------

diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
@@ -38,6 +38,9 @@ so it's always a good idea to start with a firmware update::
 
   hpilo_cli example-server.int.kaarsemaker.net update_rib_firmware version=latest
 
+If this fails to extract the firmware, try upgrading python-hpilo as newer
+firmware versions are shipped in a different, incompatible format.
+
 Syntax error: Line #0
 ---------------------
 Occasionally you might see this error at the end of a traceback::