Setting Up LEC Asset ID Manager

Note: Before setting up an installation of LEC Asset ID Manager (AIM) customers should install and configure Live Energy Connect and Network Management System.

The LEC AIM application files are included with the Live Energy Connect installation materials available on Oracle eDelivery and the My Oracle Support portal (via the Patches and Updates tab). Although it is packaged with the LEC installer, the LEC AIM application is intended to be installed on the machine running NMS (or CGI OMS) not the machine running LEC.

On this page:

Installation Steps

  1. Enable and configure Internet Information Services (IIS) for Windows and ASP .NET 4.5 or higher on the machine running LEC Server. Refer to Enabling and Configuring IIS and ASP .NET Framework 4.5 or Higher for more details.
  2. On the machine running NMS or CGI (OMS), extract the files in the LiveEnergyConnectAIM7.1.x.x.x.zip directory included with your download of the LEC product.
  3. Move the LEC AIM application files to the directory from which you would like to run AIM.
  4. Install the Python packages required for LEC AIM using Pip. The machine running LEC AIM should already have a version of Python 3 installed because NMS requires a Python 3 installation.
    To use the LEC AIM application, you only need to install the additional Python packages that just the LEC AIM application uses. These packages have been provided as Pip wheel files in your download of LEC. They are located in the LiveEnergyConnectAIM7.1.x.x.x/aim/packages/3x/ where 3x is the version of Python currently installed on your machine. The following list includes the required packages:
    • six-1.15.0
    • urllib3-1.25.10
    • certifi-2020.6.20
    • chardet-3.0.4
    • idna-2.10
    • numpy-1.19.2
    • pandas-1.1.2
    • python_dateutil-2.8.1
    • pytz-2020.1
    • requests-2.24.0

For information about the open source licensing of these packages, refer to the Live Energy Connect Licensing Information User Manual.

To install each package, use the following command where <pathToWheelFile> is the path to the .whl file included in the LEC AIM directory for the appropriate version of Python installed on your machine.

pip install <pathToWheelFile>

For example, to install the numpy package on a machine with Python 3.8 installed, you would use the following command:

pip install "C:\aim\packages\38\numpy-1.19.2-cp36-cp36mmanylinux1_ x86_64.whl"

Back to Top

Launching the LEC AIM User Interface

  1. LEC AIM files are deployed, you can launch the command-line user interface for the LEC AIM application by running the menu.py program with the Python interpreter, for example, python.exe bin/menu.py --conf menu.conf. This will start the console app’s user interface with the default user menu. Most customers will have a site-specific menu.conf file prepared for them by engineers.
  2. After configuring and testing their AIM application, most customers create a shell script (or a batch script if running on Windows) that can be used to start LEC AIM manually or automatically. If you set up a shell script to run LEC AIM automatically, you can schedule the execution of this script as a cron job (if running on a Linux machine) or as a scheduled task (if running on Windows). An example of such a script called runaim.sh is provided with your download of LEC AIM.

    For example, if you’d like to run LEC AIM interactively and you are running LEC AIM with NMS on a Linux machine, the contents of this shell script would contain something like the following (depending on where you placed your LEC AIM files):

    #!/bin/bash python aim/bin/menu.py --conf /home/nmsadmin/aim/organization/menu.conf

    If you’d like to run LEC AIM interactively and you are running Utilities LEC AIM with CGI PragmaLINE OMS on a Windows machine, the contents of your batch script would look something like the following:

    @echo off
    REM interactive mode
    python.exe pathToAim\aim\menu.py --conf
    pathToAim\aim\organization\menu.conf

    If you’d like the shell script (Linux) or batch script (Windows) to run the LEC Asset ID Manager application automatically, use the --auto parameter. For example: python.exe bin/menu.py --conf menu.conf --auto

    In the above example, the parameter --conf specifies your organization’s customized LEC AIM application’s menu configuration file.

    The parameter --auto indicates that you want to have the commands in the menu ran automatically.

Note: The interval at which LEC AIM can be run automatically is specified in the cron job table (Linux) or by the Task Scheduler (Windows). For more information, refer to Microsoft’s Task Scheduler Help.

Back to Top