Support

Knowledge Base  /  Frequently Asked Questions  /  Room Alert Manager

How To Use An SSL Certificate With Room Alert Manager

For a more secure web interface, you can configure Room Alert Manager to use an SSL certificate. This will allow the software’s web interface to use HTTPS, as shown in the screenshot below:

In order to complete the steps in this FAQ, you must already have an SSL certificate. For more information, please see the Before you begin tab below.

Before you begin

Before you begin, you must have a PKCS #12 file (which can have the file extension .pfx or .p12) that includes both your certificate and private key.

You can find more information in this Wikipedia post: https://en.wikipedia.org/wiki/PKCS_12

This is an advanced tutorial that assumes you already know how to obtain an SSL certificate and are familiar with various certificate formats.

Step 1: Create a Java Key Store (JKS) file from your SSL certificate PFX file.

If you don’t already have a PFX file, please see the Before you begin tab.

Follow these instructions to create a Java Key Store (JKS) file from your PFX file:

To create the JKS file, you’ll need access to Java’s Keytool utility, which is bundled into Room Alert Manager. It’s located here by default:
C:\Program Files\AVTECH Room Alert Manager\jre\bin\keytool.exe.

  1. Open Windows Command Prompt.
  1. First change your directory to the location of your cert.pfx file by entering this command:

    cd <path to cert.pfx file>

    • Our .pfx file “cert.pfx” was previously saved in a folder on our base C:/ drive named “ssl cert files.”
  1. Next, at the prompt, enter the following command:

    "<path to keytool>" -importkeystore -srckeystore cert.pfx -srcstoretype pkcs12 -destkeystore cert.jks -deststoretype jks

    • In Enter destination keystore password, enter a new password that Room Alert Manager will use later to connect to the SSL certificate.
    • Repeat this password in Re-enter new password.
    • In Enter source keystore password, enter the password you previously created for the .pfx file.
  1. After you run the command, the new .jks file should appear in the folder with your cert.pfx file.

Step 2: Save the JKS file to Room Alert Manager's installation directory.

Follow these instructions to save the JKS file to Room Alert Manager’s installation directory.

  1. Stop the Room Alert Manager service.
  2. Navigate to the “home” folder in Room Alert Manager’s installation directory. By default, it’s located here:
    C:\Program Files\AVTECH Room Alert Manager\home
  3. Add a new subfolder within the “home” folder, and name it “ssl” as shown below:
  4. Save the JKS file into this new “ssl” folder.
    The JKS file must be named: cert.jks. Please rename the file when you save it to this folder, if needed.
  5. Don’t start the Room Alert Manager service yet — we’ll do that in Step 3.
Step 3: Configure Room Alert Manager to use the certificate.

Follow these instructions to configure Room Alert Manager to use the certificate.

  1. The Room Alert Manager service should already be stopped.
  2. Navigate to Room Alert Manager’s installation folder on its host system. By default, it’s at C:\Program Files\AVTECH Room Alert Manager.
  3. Locate the “config” folder and open it.
  4. In the “config” folder, locate the “application.properties” file.
  5. Open that file in any text editor, such as Notepad or Notepad++.
  6. Add the following lines to the end of your application properties:

    server.ssl.enabled=true
    server.ssl.key-alias=1
    server.ssl.key-password=<the password you set for your PFX file>
    server.ssl.key-store-password=<the password you set for your JKS file>
    server.ssl.key-store=./home/ssl/cert.jks
    server.ssl.key-store-type=JKS
    server.ssl.key-store-provider=SUN


  7. When you’re done making changes, save the “application.properties” file.
  8. You may now close Room Alert Manager’s installation folder.
  9. Then start the Room Alert Manager service.
Step 4: Access Room Alert Manager's web interface using HTTPS.

Based on the SSL certificate, your web browser expects to see a particular domain included within the web address. As a result, when you access the software’s web interface at localhost:9393 or <IP address of host system>:9393, your browser may display a certificate warning.

To avoid the certificate warning from appearing in your web browser, you can either setup the proper zone in your local DNS or add an entry to your local computer’s hosts file.

Because the instructions for editing your DNS differ according to the server being used, this FAQ does not walk you through that process.

Add an entry to your hosts file

These instructions apply to Windows 10 and Windows 8 systems. If you’re using a different Operating System, you can find the proper instructions by doing a Google search for “add entry to hosts file + <your operating system>”

  1. Go to c:\Windows\System32\Drivers\etc on your computer.
  2. Open the hosts file in a text editing program, such as Notepad.
    • You’ll need to run the text editing program as an administrator in order to save your changes later.
  3. Add a new entry for Room Alert Manager.
    • Be sure to include the proper domain so that your browser recognizes the SSL certificate.
    • In our example, we want our hostname to be “roomalertmanager.yourexampledomain.com” so we’re adding the following line to our hosts file:
      127.0.0.1 roomalertmanager.yourexampledomain.com

  4. Save your changes.
  5. You can then enter “https://<hostname>:9393” into your web browser’s address bar to open the software’s web interface.
    • Be sure to include https:// in the web address, as shown below.

Facebooktwitterredditpinterestlinkedinmail
Room Alert is Made in the USA, ships worldwide from our locations in the US and EU, and has been protecting facilities since 1988.

You may find Windows Command Prompt at the following path:

  • Windows 7 & 8
    Start--> All Programs--> Accessories--> Command Prompt
  • Windows 10
    Start--> All Apps--> Windows System--> Command Prompt

To run Windows Command Prompt as an administrator:

  • Windows 7 & 8
    Right-click on Command Prompt and select Run as administrator.
  • Windows 10
    Right-click on Command Prompt, select More and then select Run as administrator.

Example Polling Method Properties saved in Orion SolarWinds:

If you are using this client, you should configure the general SNMPv3 Credentials, but leave the Read / Write SNMPv3 Credentials section blank.

Room Alert Link- Supported Firmware Updates



Current S modelsCurrent E models
Room Alert 32SRoom Alert 32E
Room Alert 12SRoom Alert 12E
Room Alert 4E
Room Alert 3E

Room Alert Manager - Compatible Devices

The latest version of Room Alert Manager supports only the devices below.

It does not support any legacy Room Alert or TemPageR models.

Current S modelsCurrent E models
Room Alert 32SRoom Alert 32E
Room Alert 12SRoom Alert 12E
Room Alert 3SRoom Alert 4E
Room Alert 3E
Room Alert 3W