Project

General

Profile

Bug #8062

Minor (but confusing) error in Alert instructions on how to update LSI adapter firmware

Added by Ray Pavlak over 5 years ago. Updated about 4 years ago.

Status:
Resolved
Priority:
No priority
Assignee:
Josh Paetzel
Category:
OS
Target version:
Seen in:
Severity:
New
Reason for Closing:
Reason for Blocked:
Needs QA:
Yes
Needs Doc:
Yes
Needs Merging:
Yes
Needs Automation:
No
Support Suite Ticket:
n/a
Hardware Configuration:
ChangeLog Required:
No

Description

The bottom of Section 21 of the online manual gives this command to update the LSI adapter firmware and bios:

sas2flash -f firmwareimagename -v biosname -c controllernumber

The "-v" option is incorrect and should be "-b" which I found in the sas2flash manual.
I tried "-v" and it gives an invalid command error while trying "-b" works.
This appears to be a keyboard typo since v and b are adjacent.

Also, I'm not sure this is worth opening another ticket (I leave this up to you), but the version of sas2flash in FreeNAS 9.3 is P14 (run sas2flash -ver) whereas the FreeNAS recommended LSI firmware for 9.3 is P16. There is a P16 installer for FreeBSD on the LSI web site which is a P16 version of sas2flash. It is probably a good idea to use the same revision of sas2flash that matches the firmware being installed. In reality, it's probably not critical, since sas2flash probably doesn't care what's in the firmware or bios image files, but it could contain some logic related to what bios or firmware version(s) it can load over previous versions, etc., which might prevent "bricking" the HBA in some circumstances.

FYI, my release is FreeNAS-9.3-STABLE-201501212031 which was not a choice in the Seen in drop down box.


Related issues

Related to FreeNAS - Bug #8064: Incorrect sas2flash instructionsResolved2015-02-17

Associated revisions

Revision f1c93a1d (diff)
Added by Josh Paetzel over 5 years ago

Update sas2flash to P16 and update docs to correct typo in flash instructions. Ticket: #8062 Ticket: #8064

Revision 89e6037f (diff)
Added by Josh Paetzel over 5 years ago

Update sas2flash to P16 and update docs to correct typo in flash instructions. Ticket: #8062 Ticket: #8064 (cherry picked from commit f1c93a1d62b8ed0065bcb2d751cb00aea3e56c3b) Conflicts: docs/userguide/truenas_options.rst

History

#1 Updated by Ray Pavlak over 5 years ago

I should add that bugs 4988 and 4990 are related to the Alert message for LSI firmware / FreeNAS driver mismatches.

Also just noticed that Bug #7497 also mentions the sas2flash version discrepancy.

#2 Updated by Jordan Hubbard over 5 years ago

  • Category set to 76
  • Assignee set to Josh Paetzel
  • Target version set to Unspecified

#3 Updated by Dru Lavigne over 5 years ago

I'll open a separate ticket for the typo in the docs.

#4 Updated by Dru Lavigne over 5 years ago

  • Related to Bug #8064: Incorrect sas2flash instructions added

#5 Updated by Josh Paetzel over 5 years ago

  • Status changed from Unscreened to 19

#6 Updated by Josh Paetzel over 5 years ago

  • Status changed from 19 to 15

Dru,

Is there anything in the docs that should be left out of 9.3-STABLE? In order to merge the doc fix there's a ton of stuff that has to get merged.

#7 Updated by Dru Lavigne over 5 years ago

You can merge the doc change to master and it will show as correct in the next SU as well as the one hosted at doc.freenas.org.

#8 Updated by Josh Paetzel over 5 years ago

  • Status changed from 15 to Ready For Release

#9 Updated by Jordan Hubbard over 5 years ago

I'm confused by this. The 9.3 docs are not being built from master (as noted on any number of occasions). Why would this work?

#10 Updated by Dru Lavigne over 5 years ago

I commit doc changes to master and the stuff that is automatically built for doc.freenas.org shows my edits. If you are not doing the same thing in your automated SU builds, the SU's that were built after I sent you the tarballs are not getting updated. We agreed early in the new year that I wouldn't switch the docs from master until it came time to tag 10 and branch the docs.

#11 Updated by Jordan Hubbard over 5 years ago

Hmmm. OK, I must have missed something in that communication. I think right now we're going to have to do a forklift merge from master into 9.3-STABLE and then periodically sync it up from master before I roll SUs, because it's just not an easy thing to check just the documentation out of master. Every SU I've built for the last month or so has been done with the 9.3-STABLE doc tree. I'll figure out how to do this - no worries.

#12 Updated by Jordan Hubbard over 5 years ago

Hammer merged in 5116ce651e4e1ceb327766fdc42aa89b23ef86fc

#13 Updated by Jordan Hubbard over 5 years ago

  • Status changed from Ready For Release to Resolved

#14 Avatar?id=14398&size=24x24 Updated by Kris Moore about 4 years ago

  • Target version changed from Unspecified to N/A

Also available in: Atom PDF