Sample tools for remotely fingerprinting GEN4 appliances and upgrading the BIOS/idrac firmware
This is a community offering on BlueCat labs and as such it provided without formal support, this software is provided on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. Flashing BIOS/iDRAC remotely is an invasive task and should be fully tested before using in production environments.
Utilising the REDFISH REST API upon the embedded iDRAC9 (Out of Band management) remotely scans any BlueCat GEN4 hardware appliance for various hardware configuration details
python3 gen4.py [-h] [--json] idrac username password
idrac IP Addresss of the GEN4 appliance iDRAC
username iDRAC username
password iDRAC password
-h, --help show this help message and exit
--json output JSON instead of default stdout
[BlueCat GEN4 BIOS]
BIOS Manufacturer: BlueCat Networks
BIOS Model: BlueCat GEN4-5000
ServiceTag: C2HQ9T2
Express Service Code: 26272099622
Serial number: CNWS3008BE000L
Asset tag: GEN4-5000-UK-PM
[BlueCat GEN4 Appliance Firmware]
BIOS Version: 1.0.2
BIOS Date: 11/13/2018
iDRAC Firmware Version: 3.34.34.34
[BlueCat GEN4 FingerPrint]
BlueCat Appliance Model: BlueCat GEN4-5000
BlueCat SKU Model: BAM-5000/BDDS-75
SystemID LFC: 8e2b
SystemID SYS: 0x88e
Server Generation: 14G
Server OEM chassis: R340
Server OEM class: R340
[BlueCat GEN4 Appliance State]
Current Power state: On
Current System status: OK
[BlueCat GEN4 Configuration]
Appliance CPU type: 1 x Intel(R) Xeon(R) E-2136 CPU @ 3.30GHz
Appliance Memory size: 32 GB
[BlueCat GEN4 Network Cards]
BRCM GbE 5720 2P Embedded
BRCM GbE 2P 5720-t Adapter
[BlueCat GEN4 Logical NIC to MAC Mapping]
eth0 6C-2B-59-7C-9F-5D 172.17.44.92 /255.255.255.0
eth1 6C-2B-59-7C-9F-5E
eth2 00-0A-F7-BF-AE-6C
eth3 00-0A-F7-BF-AE-6D
[BlueCat GEN4-5000 Physical to Logical Mapping - Rear - Left to Right]
Port MAC Status IPv4 Address Network Mask
-------------- ----------------- --------- --------------- ---------------
eth0 6C-2B-59-7C-9F-5D LinkUp 172.17.44.92 255.255.255.0
eth1 6C-2B-59-7C-9F-5E LinkDown
eth2 00-0A-F7-BF-AE-6C LinkDown
eth3 00-0A-F7-BF-AE-6D LinkUp
NOTE :- IP Address and Network Mask will only be populated if the Dell iSM (iDRAC service module) is deployed and appliance is running
{
"BIOS Manufacturer": "BlueCat Networks",
"BIOS Model": "BlueCat GEN4-5000",
"ServiceTag": "C2HQ9T2",
"ExpressServiceCode": "26272099622",
"Serial": "CNWS3008BE000L",
"Asset": "GEN4-5000-UK-PM",
"BIOS version": "1.0.2",
"BIOS Release Date": "11/13/2018",
"IDRAC version": "3.34.34.34",
"BlueCat Appliance Model": "BlueCat GEN4-5000",
"BlueCat SKU Model": "BAM-5000/BDDS-75",
"SystemID LFC": "8e2b",
"SystemID SYS": "0x88e",
"Server Generation": "14G",
"Model OEM LFC": "R340",
"Model OEM SYS": "R340",
"Appliance Power State": "On",
"Appliance System State": "OK",
"Appliance CPU": "1 x Intel(R) Xeon(R) E-2136 CPU @ 3.30GHz",
"Appliance Memory": "32 GB",
"Network Adapter 1": "BRCM GbE 5720 2P Embedded",
"Network Adapter 2": "BRCM GbE 2P 5720-t Adapter",
"Network Adapter 3": "",
"Network Ports Rear": {
"eth0": {
"mac": "6C-2B-59-7C-9F-5D",
"ip": "172.17.44.92",
"mask": "255.255.255.0",
"status": "LinkUp"
},
"eth1": {
"mac": "6C-2B-59-7C-9F-5E",
"status": "LinkDown"
},
"eth2": {
"mac": "00-0A-F7-BF-AE-6C",
"status": "LinkDown"
},
"eth3": {
"mac": "00-0A-F7-BF-AE-6D",
"status": "LinkUp"
}
}
}
NOTE :- IP Address and Network Mask will only be populated if the Dell iSM (iDRAC service module) is deployed and appliance is running
Utilising the REDFISH REST API upon the embedded iDRAC9 (Out of Band management) can remotely update the BIOS and IDRAC firmware.
Before running the firmwareupdate.py tool
-
Ensure the following folders are created in the source directory; IDRAC, R640 and R340
-
Download the latest R640 BIOS to the R640 folder (For GEN4-7000 BDDS125/BAM7000)
⬇️ R640 BIOS
- Download the latest R340 BIOS to the R340 folder (For GEN4-2000/4000/5000 BDDS25/50/75 BAM5000)
⬇️ R340 BIOS
- Download the latest iDRAC9 with lifecycle controller firmware to the IDRAC folder
NOTE :- When downloading the latest BIOS/iDRAC firmware always selects the .EXE version
python3 firmwareupdate.py [-h] idrac username password
idrac IP Addresss of the GEN4 appliance iDRAC
username iDRAC username
password iDRAC password
-h, --help show this help message and exit
NOTE :- If the download BIOS/idrac firmware can be upgraded you must enter YES or yes to confirm
BlueCat Appliance Model: BlueCat GEN4-2000
SystemID LFC: 8e29
SystemID SYS: 0x88e
Chassis Model: R340
Available BIOS/iDRAC Release
BIOS Release: 1.2.0
BIOS File: BIOS_76NP7_WN64_1.2.0.EXE
BIOS Release: 3.34.34.34
BIOS File: iDRAC-with-Lifecycle-Controller_Firmware_3HT97_WN64_3.34.34.34_A00.EXE
Current BIOS/iDRAC Release
iDRAC version: 3.34.34.34 (CURRENT)
BIOS release: 1.0.2 (OLD)
BIOS release date: 11/26/2018
Can be upgraded to BIOS 1.2.0
Upgrade to new BIOS image?yes
Uploading "BIOS_76NP7_WN64_1.2.0.EXE" firmware payload to iDRAC
Uploaded firmware payload to iDRAC
Firmware version of uploaded payload is: 1.2.0
Creating firmware update job ID
JID_680244344194 firmware update job ID successfully created
Appliance rebooting and applying new BIOS firmware
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request :D
v1.00 - Initial Release
v1.01 - Improved SystemID detection, added BIOS release date and Service Express Code to output
v1.02 - Added firmwareupdate.py POC to update any firmware payload via idrac9 redfish
v1.03 - Adjust firmwareupdate.py to take filename and versions from the location folders instead of hardcoding releases
v1.04 - Fixed JSON return for null ethernet details being return under idrac 4.xx and 5.xx
v1.05 - Fixed cprint table return for above
B.Shorland
Copyright 2022 BlueCat Networks, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.