LRA Emergency Mode - root@lightrules

LRA Emergency Mode - root@lightrules

Overview

File system errors may cause a LightRules Appliance (LRA) to be unable to boot properly. When a LRA to be unable to boot properly, error messages will appear on a monitor such as "warning mounting unchecked fs, running e2fsck is recommended" and/or "welcome to emergency mode."

Running fsck will often resolve the file system issues and allow the LRA to boot properly.

Setup

Emergency mode only occurs in scenarios where the LRA is unable to boot and the LightRules web application is unaccessible.  Connecting a VGA monitor, keyboard and mouse directly to the LRA will allow for further troubleshooting and potentially display the root@lightrules command line.

For reference, the Emergency mode screen will often appear similar to below before [enter] is pressed to access the root@lightrules command line:

Process

Sometimes rebooting the LRA per the below steps will resolve the issue:
  1. When in Emergency mode you can access a command prompt by pressing [enter].
  2. At the command prompt type:  shutdown -h now 
  3. Press [enter] to start the shutdown sequence.
  4. Once the LRA is off, press the power button to turn the LRA back on.
If shutdown -h now does not resolve the issue, then you can run fsck to attempt to repair the filesystem:
  1. When in Emergency mode you can access a command prompt by pressing [enter].
  2. At the root@lightrules command prompt type: fdisk -l
  3. fdisk will inform you what your partitions are. Most likely it will be  /dev/sda[1-4]
  4. Run fsck on each partition per the below commands. Press [enter] after each command before proceeding to the next command. If the umount command notes that sda[1-4] is "not mounted", that is not a problem. We wanted it to be "not mounted" :)
    1. umount /dev/sda1
    2. fsck -y /dev/sda1
    3. umount /dev/sda2
    4. fsck -y /dev/sda2
    5. umount /dev/sda3
    6. fsck -y /dev/sda3
    7. umount /dev/sda4
    8. fsck -y /dev/sda4
  5. After running fsck on all partitions, reboot the LRA
If fsck does not resolve the issue, please check that fsck was completed on the correct partition. If fsck was completed on the correct partition and the LRA is still unable to boot into the LightRules app, then the LRA has a hardware issue that is not resolvable using software commands.



    • Related Articles

    • Troubleshooting LightRules Gateways

      The following guide will provide troubleshooting steps that will not only remedy several issues that can arise, but expedite the support process if initial troubleshooting is unsuccessful. Gateway Status The first step is to understand the status of ...

    • How do I exit the LightRules 3.X Screen Saver?

      Overview When a monitor and keyboard are connected to a LightRules Appliance (LRA) running LightRules 3.0 or newer, pressing CTRL - ALT - DELETE on the keyboard will enter into the "XScreenSaver 5.34" mode seen below. Instructions To exit out of this ...

    • LightRules System Troubleshooting Guide

      Overview Troubleshooting steps to diagnose fixtures connected to LightRules not behaving as expected. The most common causes are network communications issues, individual fixtures malfunctioning, groups of fixtures not receiving power or incorrectly ...

    • Create a LightRules Backup Drive

      Overview The following instructions detail how to create a LightRules Appliance Backup USB Drive for LightRules versions 2.8.X or higher. Disclaimer Please follow these instructions precisely as deviation from them may result in improperly configured ...

    • How to Resolve "Fixture is in Safe Mode (DIPs)" Messages

      Overview Messages Indicating Fixture is in Safe Mode LightRules and Commissioner will alert the user when fixtures are in Safe Mode unless the fixture model is an ILE-HB-3, ILE-MB-3 or ILE-3 fixtures of hardware revisions 1 to 14. Alerts will show up ...