Topic
You should consider using this procedure under the following condition:
- You want to remotely clear LCD warnings and the Alarm LED.
Prerequisites
You must meet the following prerequisite to use this procedure:
- You have command line access to the BIG-IP system.
Description
In some cases, you may want to remotely clear LCD warnings and the Alarm LED. Performing this action may prevent onsite personnel from discovering and reporting an old warning, or having to teach the onsite personnel how to clear the LCD. You can use the lcdwarn command line utility to control the LCD and the Alarm LED. To display its usage, run the lcdwarn command without any arguments.
Note: Starting in BIG-IP 12.1.0, you can use the tmsh show sys alert lcd command to display the list of alerts sent to the LCD front panel display.
Procedures
Impact of procedure: Performing the following procedure should not have a negative impact on your system.You can use the lcdwarn command to remotely clear the LCD warnings. To do so, use the following command syntax appropriate for your BIG-IP version:
BIG-IP 12.1.5, BIG-IP 13.1.0 and later
lcdwarn -c <level>
In this command syntax, note the following:
- <level> specifies the alert level to be cleared. Acceptable values include [0|1|2|3|4|5] or [warning|error|alert|critical|emergency|information]. The level can be seen under the “Priority” column when you run tmsh show sys alert from the Advanced Shell (bash) or show sys alert from within the tmsh shell:
root@(C3553740-bigip1)(cfg-sync Standalone)(Active)(/Common)(tmos)# show sys alert
—————————————————————-
Sys::LCDAlerts
Slot Timestamp Priority Id Description
—————————————————————-
0 04/22/21 02:21:07 info 0x10c0019 Unit going Active.
0 04/22/21 01:22:55 info 0x10c0019 Unit going Active.
0 04/22/21 01:16:28 info 0x10c0019 Unit going Active.
0 04/22/21 01:16:28 info 0x10c0019 Unit going Active.
For example, to clear LCD warnings with an alert level of 0, type the following command:
lcdwarn -c 0
BIG-IP 13.0.0, BIG-IP 12.1.4 and earlier
lcdwarn -c <level> <slotid>
In this command syntax, note the following:
- <level> specifies the alert level to be cleared. Acceptable values include [0|1|2|3|4|5] or [warning|error|alert|critical|emergency|information].
- <slotid> specifies the slot for which warnings should be cleared. Acceptable values include [0|1|2|3|4|5|6|7|8].Note: In BIG-IP 13.0.0, BIG-IP 12.1.4 and earlier, specifying any slot other than 0 is necessary only on the VIPRION platform. On a VIPRION platform, the slot ID is counted from 1, so blade 2 is 2 in the command line.
For example, to clear LCD warnings with an alert level of 0, type the following command:
lcdwarn -c 0 0
On a VIPRION system, to clear LCD warnings with an alert level of 0 for slot 2, type the following command:
lcdwarn -c 0 2
To clear the Alarm LED, you must clear all LCD warnings at all alert levels (on all slots for VIPRION systems). To do so, perform the following single command appropriate for your BIG-IP platform:
Impact of procedure: Performing the following procedure should not have a negative impact on your system.
- VIPRION platforms
- BIG-IP iSeries platforms
- All other BIG-IP platforms (except for VIPRION platforms and BIG-IP iSeries platforms)
You can clear all LCD warnings at all alert levels on all VIPRION slots using the following single command:
BIG-IP 12.1.5, BIG-IP 13.1.0 and later
for i in 0 1 2 3 4 5; do lcdwarn -c “${i}”; done
BIG-IP 13.0.0, BIG-IP 12.1.4 and earlier
for i in 0 1 2 3 4 5; do for j in 1 2 3 4 5 6 7 8; do lcdwarn -c “${i}” “${j}”; done; done
If you run this command on a VIPRION system that has unpopulated blade slots, the system logs benign error messages to the /var/log/ltm file that appear similar to the following example:
012a0004:4: ledSet error: LopDev: sendLopCmd: Lopd status: 1 packet: action=2 obj_id=3c sub_obj=0 slot_id=2 result=2 len=0 crc=e071 payload= (error code:0x2)
You can safely ignore this message; it does not affect the traffic processing capability of the VIPRION system.
To prevent this error message on a VIPRION system with unpopulated blade slots, adjust the input values for the j variable. For example, on a VIPRION system where only blade slots 1 and 2 are populated, type the following command:
for i in 0 1 2 3 4 5; do for j in 1 2; do lcdwarn -c “${i}” “${j}”; done; done
For information about clearing the Alarm LED on BIG-IP iSeries platforms, refer to K24127736: Clear LCD alarms on iSeries device.
All other BIG-IP platforms (except for VIPRION platforms and BIG-IP iSeries platforms)
You can clear all LCD warnings at all alert levels on all other BIG-IP platforms (except for VIPRION platforms) using the following single command:
BIG-IP 12.1.5, BIG-IP 13.1.0 and later
for i in 0 1 2 3 4 5; do lcdwarn -c “${i}”; done
BIG-IP 13.0.0, BIG-IP 12.1.4 and earlier
for i in 0 1 2 3 4 5; do lcdwarn -c “${i}” 0; done
Note: Running this command on legacy BIG-IP platforms that are not equipped with an LCD (such as the 1000, 2400, 5100, and 5110) only clear the Alarm LED.