Log4J Vulnerability

The Enlighted Manage application uses log4j 1.2, which is not subject to the recently reported vulnerabilities associated with log4j version 2 (CVE-2021-44228, CVE-2021-45046, CVE-2021-45105).  Subsequent to the initial log4j version 2 vulnerability reports, CVE-2021-4104 was published describing a similar JNDI exploit on log4j 1.2. However, several additional prerequisites to the log4j 1.2 exploit are not present in the Manage application.

The Manage on-premise appliance does have a log4j version 2 library file on disk. This in an inactive library file associated with past internal software development activities and has not been used by the Manage application deployed to customers. Therefore, the Manage application is not deemed to be at risk of the currently known log4j JNDI exploits.

Manage version 4.3 is currently being prepared for release and already has the inactive log4j version 2 library file removed from the disk. This will help customers who implement log4j vulnerability scans of their IT infrastructure to get a clean scan.

Enlighted plans to proactively upgrade the Manage application from log4j 1.2 to the latest recommended version (2.17.1 as of this writing) within the next release cycle.

Manage Overview

The Enlighted Manage available as a cloud-based software or on-premise server stores, performs analysis, and provides visual reporting of sensor data. In addition to being the collection point for energy, occupancy, and environmental data captured by the Enlighted Sensors, Manage provides a web-based user interface for lighting system management, IoT device management, and optimizing building system performance.

The Enlighted Manage provides an interface that allows you to view

  1. Energy Consumption and Reports
  2. Health and Status of Devices
  3. Adjust Light Level Settings or Create Light Profiles
  4. Add and Configure Devices  

Refer to the IoT Platform and Hardware for an architectural overview of an Enlighted intelligent lighting control system's key physical components.

The physical elements are light fixtures consisting of:

  • A sensor unit, which contains occupancy, ambient light, temperature sensor; a wireless communications interface; and a light level control interface. For more details, refer to the Sensor Spec Sheets.
  • A control unit, which provides power to the sensor unit, an electric power metering chip, and a relay to disconnect power to the luminaire. Refer to the Control Units Spec Sheet
  • A Manage server stores sensor, status, and fault data from fixtures and allows users to configure fixture lighting behavior and monitor their energy consumption and status. Manage can be located on-premise or hosted in the cloud (Cloud). See Manage Spec Sheets. 
  • A Gateway that forwards messages to and from sensors and Manage. View Gateway Spec Sheet.
  • An Enlighted Switch that controls light levels of fixtures. Refer to the Enlighted Room Control (ERC) Spec Sheet. 
  • A Plug Load Controller that switches on and off power outlets based on occupancy input received from sensors. View Plug Load Controller Spec Sheet.
  • A luminaire consisting of one or more lamps. The luminaire will typically contain a ballast with an input control signal so that the light level can be varied. The fixture database tracks and maintains the complete manufacturer-specific information. Learn how to add and manage fixtures.

In addition to these physical elements, the control system includes groups, clusters of sensors that communicate with each other. The sensor groups consist of:

  • Motion Groups — Motion detection sharing. When sensors in a room are configured as a motion group, the occupancy detection is communicated to all fixtures when an occupant enters the room. Refer to the article  Create Motion Group.
  • Switch Groups — Lighting control. A virtual switch can control the light level of any number of selected fixtures on single or multiple floors. Refer the article to Create Switch Group for further details.
      • Scene — Scene control. Each set of light level settings for fixtures controlled by a virtual switch is called a scene. Typical scenes in a conference room are light levels for using a projector, food service, or presentations. Scenes can be created, deleted, or modified without the need for physical rewiring. Refer to the article Create a Scene. One or more ERCs can be associated with a virtual switch when all the fixtures use the same communication attributes. When so, an ERC communicates with the fixtures in a switch group to control the lighting.
  • Daylight Groups — Daylight levels. The fixtures in a daylight group adjust their light levels to achieve a constant group light level, also called Dim Level. As available daylight levels change, the lights will be dimmed or turned off when there is enough natural light. Refer to the article Create Daylight Group for further details.

Configure Groups:

You can add fixtures to be members of a switch or motion group and configure the members simultaneously using Configure Groups option from the floor plan. The Configure Groups option gives you the flexibility to set up the Enlighted System much faster, efficiently, and quickly. Refer to Configure Groups for further details.

Manage 4.5 Admin Guide

Updated versions of the Manage/Energy Manager Admin Guide are periodically released to correspond with the new software version releases

For a brief product description, refer to the Manage Spec Sheets. To upgrade Manage to the latest release, refer to the Manage Release Components. If you need help in upgrading your system, submit a ticket to Enlighted Support

Manage 4.5 Admin Guide 

Download and view Manage Admin Guide, v4.5 (Manage 4.5.pdf)

New/Enhanced Features in 4.5

  • API authentication works without computing SHA1 of ‘apikey’ on the client side.
    Note: The previous API authentication procedure will continue to function normally. To distinguish between the two strategies a client can use, this method has a new header. TLS is used by the new technique to ensure transit security.

Toggle the New User Experience button to switch to the new Manage UI to enjoy the following features. If you do not see the toggle button to switch between the New UI and Classic UI, please contact Enlighted Support to enable the toggle button in your Manage application. 

  • Groups - Switch, Motion, and Daylight Groups can be easily and quickly set up in an Enlighted lighting system using the Groups feature.
  • Energy Consumption - The Energy Consumption screen displays Energy Savings and Usage for the day. In the new UI, the following features have been added,
    • To prevent data overcrowding, you can select to show or hide categories in the Energy Consumption graph based on your needs.
    • Ability to see Hourly details for any given day within a year when selecting a single date.
    • The graph displays the amount of CO2 emitted, user-configurable CO2 equivalent factor for energy savings calculations has been introduced.
  • System Health Report - This is a Premium Support Service. The report provides diagnostic information on the status of Enlighted devices, recommending devices that require a firmware upgrade, detecting failed components, and the time to repair or service the network or failed devices.
  • Configure Recall the Lighting Scene Color - This feature helps to recall a lighting scene color intensity for Tunable White fixtures before the lights are turned off.  The lights will come back on with the last scene color temperature instead of the max. color temperature before the lights are turned off. 


Manage 4.4 Admin Guide 

Download and view Manage Admin Guide, v4.4 (Manage 4.4.pdf)

New/Enhanced Features in 4.4

  • Floor Plan - Zoom In and Zoom Out - Icon size scales directly within the floorplan zoom level so that the same parts of the floorplan are always visible regardless of the zoom level.
  • Get Aggregate Sensor Energy Data by Floor API - Manage returns the total energy consumption in watt-hour for all fixtures on the floor with this API.
  • Recall Preset Scene Lighting API - User can recall the preset scene color with API. Each light assigned to a scene will go to its predefined level when lights are switched on.
  • BACnet on EMC  - The Enlighted Manage in the Cloud (EMC) can provide data to a BMS via BACnet when an on-premise server is configured to communicate with an EMC over HTTPS. To request this feature, please contact or submit a ticket to Enlighted Support


Admin Guide Archives

Manage 4.1 Admin Guide

Download and view Manage Admin Guide, v4.1 (Manage 4.1.pdf)

New/Enhanced Features

  • Single Sign-On (SSO) for enhanced security.
  • EnOcean Battery-Free Switch - We are introducing a battery-less wall switch option to reduce maintenance costs and meet the demand for battery-less devices. EnOcean switches can now be used to control Enlighted sensors with the same functionality provided by Enlighted ERCs.
  • New Floor Plan Views  - Configuring devices and gaining insight on a floor is now faster and easier because the entire floorplan image will always be displayed within the floorplan viewport at the lowest zoom level.


Manage 4.0.x Admin Guide

Download and view Manage Admin Guide, v4.0.x (Manage 4.0.x_AG.pdf)

New/Enhanced Features

  • Background Lighting - Building engineers can save energy, improve building occupant safety, and meet building code by enabling background lighting in the advanced profile options.
  • License Management - The system will automatically generate Real-time Area Occupancy licenses based on the count of areas with ‘Zone Sensor Enabled’ even if the quantity of Zone Sensor licenses uploaded is zero prior to upgrading to 4.0.2
  • Subfloors - Users can now create subfloors so that sensors can be commissioned on a new floorplan using gateways commissioned on an existing floorplan.


Energy Manager 3.9.14 Admin Guide 

Download PDF: Energy Manager Admin Guide  v3.9.14 PDF (EM_AG3.9.14_93-xxx-02._Rev22.pdf).

New/Enhanced Features

  • Operating System (OS) upgrade - A new OS upgrade is introduced to continue receiving product updates for the Energy Manager. Enlighted recommends that all systems perform an Operating System (OS) upgrade.


Energy Manager 3.9.13 Admin Guide 

Download PDF: Energy Manager Admin Guide  v3.9.13 PDF (EM_AG3.9.13_93-xxx-02._Rev21.pdf).

New/Enhanced Features


Manage O&M Manual

An O&M (operation and maintenance) manual is a comprehensive document that provides all the details necessary about Enlighted Manage as well as individual devices and sensors to help the maintenance staff keep everything running smoothly. This document is provided to the client as part of the handover procedure after project completion.  

Download the manual. This includes the latest version of the Manage Admin Guide, sensors, and device Spec sheets. In addition, refer to the Sensor Cleaning and Maintenance. 


Daylight Groups Quick Guide


Engineers, technicians, and facility managers may use this guide to configure the Energy Manager to take advantage of Daylight Groups in an office environment. See Advanced Daylight Group Configuration for a more advanced understanding of this feature and recommendations for different spaces.

The Goal of Daylight Groups

Create Daylight Groups to provide a uniform dim level across a group of fixtures for improved aesthetics while still gaining energy efficiency by taking advantage of daylight.

Configure Lighting Behavior

The following configuration steps may be performed before or after creating Daylight Groups. Refer to the Manage Admin Guide for more details.

  1. Set the Target Ambient Light Level of sensors to Automatically Calibrate Now.
  2. Create a lighting profile for all sensors that will be in the Daylight Group.
  • Sensors in the Daylight Group will ignore the ambient sensitivity in the profile.
  • In the Advanced section of the profile, choose whether to allow daylight harvesting to dim the lights below the Minimum Light Level. See Daylight Harvesting
  1. Assign the same lighting profile to every sensor in the planned Daylight Group.
  2. Create motion, switch, and Plug Load groups as needed.

Motion, switch, and Plug Load groups continue to function independently of the Daylight Group. Create motion groups with the same group of sensors in the Daylight Group to maintain a constant light level.

Create a Daylight Group

  1. Select sensors.

From the Floor Plan, select sensors, right-click, Create/Configure Groups, Create Daylight Group.

  • A sensor may be part of only one Daylight Group.
  • Daylight Groups may span gateways.
  1. Choose Average Daylight or Daylight at Master Sensor method for calculating the group light level. Enlighted recommends choosing one of two methods for setting the group light level:
  • Average Daylight - Averages the ambient readings and target ambient light levels for all reporting sensors to calculate the light level for the Daylight Group.
  • Daylight at Master Sensor - Uses the ambient reading and target ambient light level at the master sensor to calculate the light level for the Daylight Group.
  1. Set Group Ambient Sensitivity to 5. A value of 5 will never turn off the lights due to daylight. To use daylight more aggressively, set the value to 10.
  2. Keep the default role for each sensor as Report & Act. Sensors in the group will report their ambient reading and act based on the light level set for the group.
  3. Click Apply to create the Daylight Group.
  4. View Daylight Groups. From the Floor Plan tab, View > Daylight Group. Each group is a different color. Double click the sensor to see the sensor’s Daylight Group Name.
  5. Delete or Edit Daylight Groups. From the Groups tab, select Daylight, and delete or edit the desired group.

Daylight Group Interaction with Other Lighting Behavior

  • Switches and manual overrides will override daylight group behavior.
  • Motion and vacancy settings (Min. Light Level, Max. Light Level, Ramp-up time, Active motion window Dim and Linger, etc.) will still influence light levels if you do not want motion to influence light levels, set Motion Sensitivity to 0.
  • Advanced ambient settings in the profile are ignored when sensors are in a Daylight Group.

Limitations and Comments

  • Sensors in Daylight Groups must have a good wireless connection to the Energy Manager. If sensors cannot communicate with the Energy Manager for 30 minutes, they will revert to behaving as if they are not in a Daylight Group.
  • Daylight Groups require sensor firmware version 5.1 and higher.
  • By default, Daylight Groups respond to daylight over a 10 to 30 minute period. Occupants will likely not notice changes to the light levels.

Recommended articles:


Getting a VMware vSphere Hypervisor license for Enterprise Manage

The Enlighted Enterprise Manage (EEM), sourced from Dell, comes with VMware vSphere Hypervisor pre-loaded on the EEM server. The free license of the VMware Hypervisor starts with the full unlocked version. After the trial period of 60 days expires, it becomes limited in functionality though you can continue to use the system.

When the trial period expires, Enlighted recommends that the customer registers and downloads the license and provides the license key to the Enlighted Support team, who can help to install the software on the customer's server.

Note: Please submit a ticket to Enlighted Support with the license key.

Refer to the VMWare License and Evaluation period explaining the license limitations. A description of different license types is available here: https://kb.vmware.com/s/article/2109507.

To get the free license,  

  1. The owner of the server needs to go to following VMWare URL  and register.
    For ESXi 6- https://customerconnect.vmware.com/en/web/vmware/evalcenter?p=free-esxi6
    For ESXi 7 - https://customerconnect.vmware.com/en/web/vmware/evalcenter?p=vsphere-eval-7
  2. At the top of the webpage, go to "Products," "All Products."
  3. Select "Products" from the left panel.
  4. Select "vSphere Hypervisor (ESXi)"  
  5. Click "Download Product."
  6. From the "License & Download" tab, click Register and fill out the form and submit. It's not necessary to actually download the software.
  7. The license key will appear after you register. Copy the license key that is on the "License & Download" tab.
  8. Paste the license key into the instance of VMware on your Enlighted Manage (you can refer to steps 7 and 8 on this website to see screenshots of this step: https://www.virten.net/2016/11/free-esxi-6-5-how-to-download-and-get-license-keys/)
  9. The Terms & Conditions are referenced at the bottom of the VMware web page.