EasyAdmin Reports Scheduler - KB4062 - OpenLM Software License Management
Israel +972 4 6308447         USA +1 619 831 0029              JAPAN +81 505 893 6263 担当:萩原

EasyAdmin Reports Scheduler – KB4062

The OpenLM EasyAdmin web interface incorporates a variety of reports that display information related to license usage. EasyAdmin allows sharing these reports by either:

  1. Granting report viewing access to non-administrator accounts
  2. Sharing a custom-generated report URL
  3. Sharing the report by email to specific users, groups or individual addresses in an accessible format (.png, .csv)

By default, these reports are generated manually whenever the user requests or accesses the given feature. The OpenLM Reports Scheduler extension allows administrators to automate this process by giving them the ability to generate reports according to a predefined schedule.

 

1. Overview

2. System requirements

3. Installation

4. Configuring EasyAdmin to produce scheduled reports

4.1. Setting up the email configuration

4.2. Setting up the recipient user’s email account

5. Configuring OpenLM Reports Scheduler

5.1. Editing the report_scheduler.properties file

5.2. Changing administrative credentials

5.3. IIS, SSL and Trusted Authentication

Case 1 – EasyAdmin through IIS (HTTP/S)

Case 2 – Windows / Trusted Authentication on

6. Using OpenLM Reports Scheduler

6.1. Scheduling a report

6.2. Managing scheduled reports

7. Updating ChromeDriver for Chrome updates

7.1. Disabling Chrome auto-updates

7.2. Updating ChromeDriver

 

1. Overview

In order to schedule a report, the OpenLM administrator should:

  1. Configure a valid SMTP server in EasyAdmin’s “Email/SMS” module.
  2. If EasyAdmin authentication is turned on, check that you have an admin account in EasyAdmin and configure it with Scheduler.
  3. Open a specific EasyAdmin report and define filters (e.g. License Usage report).
  4. Click Share → Schedule, define the frequency, report recipients, then click Save.

Once this is done, the scheduled report will be sent to the designated recipients at the specified time. A scheduled report displays the same data as a regular report, the main difference being that it’s generated automatically. This makes them ideal when used with a date range filter that displays a recent period (i.e. “Last 7 days”).

 

2. System requirements

In order to install OpenLM Reports Scheduler the following prerequisites must be met:

  1. A single OpenLM Server installation running on a central network server.
  2. Chrome Browser 77* installed on the same machine that is running OpenLM Server
  3. An OpenLM license that includes support for the Reports Scheduler extension (please contact sales if you cannot locate the “Reports_Scheduler” flag in the Administration → OpenLM License window).
  4. (optional) If you choose not to install the OpenJDK 11 distributive that comes bundled with the Reports Scheduler installer, a compatible version of Java 11 must be present on the target machine.

* This will vary depending on the Reports Scheduler installer package (consult the release notes). Please check section 7 if using a newer version of Chrome.

 

3. Installation

OpenLM Reports Scheduler should be installed on the same machine where OpenLM Server is installed.

1. Download the latest installer of OpenLM Reports Scheduler from the Downloads page.

2. Double-click the installer file (Openlm_Reports_Scheduler_XXXX.exe) to start the installation. The installer window appears:

3. Click Next to advance to the License Agreement screen:

4. Check the I accept the terms of the License Agreement box then click Next

5. The Service configuration screen appears:

If you have enabled authentication in EasyAdmin → Administration → System & Security module, fill in the username and password for the administrator account you have previously configured.

If authentication has not been enabled, leave these fields blank. Click Next.

6. On the Choose Install Location screen you can provide an alternative installation folder. We recommend leaving the default one as-is. Click Next.

7. The Choose Components screen displays the required components that will be installed. JRE can be optionally unchecked if you prefer using an external installation of Java 11, however we recommend leaving the default settings as-is. Click Install.

8. Click Finish to close the wizard.

9. To verify that Reports Scheduler is operational, open the Services window and verify that the “OpenLM Report Scheduler” service is up and running.

 

4. Configuring EasyAdmin to produce scheduled reports

4.1. Setting up the email configuration

Since OpenLM Reports Scheduler sends the reports by email, a working email server must be configured in EasyAdmin’s Start → Administration → Email/SMS module.

It is highly recommended to enter at least one value for Recipient Addresses as it will be used to send notifications in case any errors occur.

 

4.2. Setting up the recipient user’s email account

By default, scheduled reports are attributed to a specific user. In most cases, this user would be the administrator that set up the scheduled reports. This designated user should exist within the OpenLM database and should have a valid email account associated with it.

In order to set a user’s email, open EasyAdmin Start → Users & Groups → Users. Find the user you want to assign an email to and edit the said user’s preferences as depicted in the image below:

For more information on how to create users (and other entities) in OpenLM, please refer to this application note: Introducing Entities in OpenLM – Users, Groups, IP and Hosts

 

5. Configuring OpenLM Reports Scheduler

5.1. Editing the report_scheduler.properties file

The report_scheduler.properties file is where all of Reports Scheduler’s settings are stored. Usually, most settings required for operation are defined during the installation process or preserved from a previous version (if upgrading). Manually editing this file is not required as long as the steps in section 4 (“Configuring EasyAdmin to produce scheduled reports”) have been followed.

However, editing is possible and even required in special cases such as:

  • If no SMTP server has been configured in EasyAdmin. By default, the SMTP configuration in EasyAdmin overrides the one in report_scheduler.properties. However, if for some reason SMTP is not configured there, the mail variables can be used to configure SMTP independently. A benefit of doing this is that administrators can be notified by email if any errors occur during the integration of Reports Scheduler with Server.
  • If there are any changes to the OpenLM Server hostname (if installed on a different machine than the Server) or default communication ports.

The following variables are most relevant for administrators to configure:

Variable Possible value Description
mail.smtp.host* User-defined The SMTP server host or IP
mail.smtp.port* User-defined The SMTP server port
mail.smtp.auth* true or false Set depending on whether the SMTP server requires login credentials
mail.smtp.ssl* true or false Set depending on whether the SMTP server uses SSL for connections
mail.smtp.username* User-defined The SMTP server user
mail.smtp.password* User-defined The SMTP server password
mail.smtp.sender* User-defined The email address that will show up on the “from:” field
mail.recipients* User-defined The recipient email(s), separated by a semicolon
openlm.protocol http (default) or https The protocol used on OpenLM’s API port
openlm.host Default: localhost The OpenLM Server hostname that Reports Scheduler will synchronize with
openlm.xml.port Default: 7014 The OpenLM Server XML communication port (deprecated since v1.8)
openlm.soap.port Default: 7020 for OpenLM Server v4.x / 5015 for v5.x The OpenLM Server API port
openlm.ea.port Default: 7019 OpenLM’s Lighttpd port for EasyAdmin. Change if serving EasyAdmin through IIS (e.g. http on port 80 or https through 443).
openlm.ea.protocol http (default) or https OpenLM’s EasyAdmin communication protocol. Can be set to http or https.
openlm.login.username Set by tool Set using the password tool in section 5.2.
openlm.login.password Set by tool Set using the password tool in section 5.2.
scheduler.report.files.directory User-defined If you want reports to also be stored locally in a specific directory, set a path here
webdriver.impl.path Default: chromedriver.exe Change if using a different path for the ChromeDriver

* Note: if not configured, Reports Scheduler will use the SMTP server settings configured in EasyAdmin.

 

5.2. Changing administrative credentials

By default, the Reports Scheduler installer writes the OpenLM Server credentials provided on the Service Configuration screen in the properties file in an encrypted format. If these credentials are changed or you want to use another account, do this:

1. Execute the change_password.bat file located in the Reports Scheduler directory (typically, C:\Program Files\OpenLM\OpenLM Reports Scheduler).

2. Fill in the login credentials of an OpenLM administrator account that you want Reports Scheduler to connect through. Beginning with Reports Scheduler v1.10, if using Trusted Authentication (see 5.3 below), the credentials entered here must be of the Windows Domain user that also has login access to the OpenLM system.

3. Click Test to see if a connection can be made. If the credentials match, you should see the following pop-up:

4. Click Apply to save the changes, then click OK on the notification pop-up that appears.

5. Open the Windows Services window and locate the OpenLM Reports Scheduler service.

6. Right-click on the entry and click on Restart.

7. Close the Windows Services window.

 

5.3. IIS, SSL and Trusted Authentication

Since Reports Scheduler accesses the EasyAdmin interface to generate the reports, it is important to adjust configuration if you have changed EasyAdmin to be served via Microsoft IIS, if it served through a SSL connection or you have enabled Trusted Authentication.

Case 1 – EasyAdmin through IIS (HTTP/S)

Note: it is recommended to have both the IIS port and the OpenLM Server backend port (default: 5015) configured to use the same protocol: either http or https. Mixing them can lead to security limitations which can prevent proper functionality of Reports Scheduler.

  1. Open report_scheduler.properties in a text editor.
  2. Edit the following parameters and save when done:
    openlm.ea.port= set to either 80 or 443
    
    openlm.ea.protocol=set to http or https
  3. (optional) If the OpenLM Server default API port or protocol has also been changed, edit the openlm.protocol and openlm.soap.port parameters as well.
  4. (optional) If SSL has been enabled on OpenLM Server, openlm.host should also be set to reflect the Fully Qualified Domain Name of the OpenLM Server machine as indicated on the SSL certificate.
  5. Restart the “OpenLM Reports Scheduler” service.

 

Case 2 – Windows / Trusted Authentication on

If Trusted Authentication has been turned on for EasyAdmin as per this guide, it is necessary to adjust the Scheduler configuration.

Note: although it’s possible to enable Trusted Authentication without SSL being turned on, it is recommended to do so to avoid exposing credentials. In this case, the instructions in Case 1 above should be followed first before proceeding with the steps below:

  1. Run the password change tool described in section 5.2 and set the credentials to be the same as the ones for the Windows domain user/password instead of the OpenLM Server credentials.
  2. Go to Windows Services → double-click “OpenLM Reports Scheduler”, go to the Log On tab.
  3. Select “This account:”, click Browse and specify a user that: 1) belongs to the domain for which Trusted Authentication has been configured 2) has enough rights to start and run Services. It is recommended to create a separate account that is not associated with an actual user. Keep in mind that the password expiration policy may affect functionality when it expires. Click OK when done.
  4. While logged in to the user account set in step 4, go to Control Panel → Internet Options → Security tabselect Local Intranet → click Sites → click Advanced
  5. Enter the address of the OpenLM Server, in the format https:// + <the fully qualified domain name as shown on the issued SSL certificate> then click Add.
  6. (optional) With Local intranet still selected, click Custom LevelUser AuthenticationAutomatic logon with current user name and password
  7. Go to Windows Services and restart the “OpenLM Reports Scheduler” service.

Once configured, schedule at least one test report to make sure that everything is working.

 

6. Using OpenLM Reports Scheduler

6.1. Scheduling a report

1. To schedule a report, open any of the EasyAdmin reports (e.g. License Usage).

2. Configure the report fields, filters and other options as you require.

3. Click Share in the bottom-left corner of the report window then click on Schedule.

8

4. The Schedule Report window appears:

Here you can set up:

  • Frequency of the report (e.g. Every Sunday at 01:00 AM),
  • Recipient(s): this can be either an existing user(s), group(s), or any number of direct email addresses. Please note that for the user and group recipients, a valid email address must be associated with the user and/or the users in those groups
  • Job Description: any text you enter here will be included in the email report
  • Receiving User Timezone: if the recipient is in a different timezone than the OpenLM Server, this option can be used to adjust the timing

5. Click OK to save the report, then Close the window.

 

6.2. Managing scheduled reports

In order to manage scheduling tasks that you have already created:

1. Click EasyAdmin Start → Scheduling Tasks

2. In the window that appears, select any of the tasks you wish to modify. You can Edit, Delete, Disable/Enable and Show URL of any of the scheduled reports (this feature is identical to the one when clicking Share → Share Link)

 

7. Updating ChromeDriver for Chrome updates

Note: this section applies only to Reports Scheduler versions earlier than v1.9.8. New releases contain functionality which allows Scheduler to automatically update the ChromeDriver when required.

Beginning with v1.7.14, OpenLM Reports Scheduler uses ChromeDriver to generate the reports. This means that a Chrome browser installation must be present on the same machine as Reports Scheduler.

However, by default, Chrome is set to auto-update. This can be problematic because the bundled ChromeDriver included with Reports Scheduler requires the same version as Chrome. So if a Chrome auto-update occurs (e.g. to v80) and the ChromeDriver has not been updated manually (e.g. still at v78), Reports Scheduler will stop working. Because of this, we recommend disabling Chrome auto-updates and performing all updates manually.

7.1. Disabling Chrome auto-updates

1. Open the Services window (press Win + R, type in services.msc then click OK)

2. Locate the Google Update Service (gupdate) service:

3. Double-click on the entry and click on Stop (if the service is running).

4. In the “Startup type” drop-down menu, select Disabled.

5. Click OK.

6. Repeat steps 3 – 5 for the Google Update Service (gupdatem) as well.

7. Close the Services window.

 

7.2. Updating ChromeDriver

  1. Go to https://chromedriver.chromium.org/downloads
  2. Download the version number release that matches your Chrome browser (to check, click on the Chrome three dots menu → Help → About Google Chrome)
  3. Replace chromedriver.exe in the Reports Scheduler installation folder (e.g. C:\Program Files\OpenLM\OpenLM Reports Scheduler) with the newer version. Alternatively, the report_scheduler.properties file can be edited to point to a path where the newer ChromeDriver resides by editing the “webdriver.impl.path” attribute.
  4. Restart the OpenLM Reports Scheduler service to finalize the upgrade.

in EasyAdmin configsMonitoring licenses and usage reports

Related Articles