Skip to content

Server on Windows

Important

Before completing these deployment steps, please review the system requirements for a SAS Enterprise Session Monitor installation on Windows.

Note

The following instructions will assume a target installation directory of D:\esm\esm-server

Obtain Installation Assets

The appropriate SAS Enterprise Session Monitor Server installation package for your Windows operating system can be obtained from the Boemska Downloads site or by contacting SAS Technical Support.

Once downloaded, unzip the archive to your desired location. The installer is ~280 MB uncompressed.

Install the Server

  1. Double click "esm-server-setup.exe" to start the installation wizard.
  2. You will now be presented with a Welcome Screen. Click Next
  3. You will now be presented with a License Agreement. You must agree to the terms set out in the license agreement in order to continue with the installation. Click I Agree.
  4. You will now be presented with a choice of database:
    1. Unless instructed by SAS Technical Support, select the Embedded option.
    2. Most environments will be a Small deployment. See the Server sizing guidelines for further information.
    3. Unless instructed by SAS Technical Support, do not modify the Database URL
    4. The Database username and Database password are used by the Java application to connect to the database. In most cases, it is sufficient to change the only password. You should make a note of the value that you have set this to for your records.
    5. Click Next.
  5. The default Embedded database port is 15432. Unless this port is taken by another application running on the local machine. Click Next.
  6. Configure the ports you would like the SAS Enterprise Session Monitor Server Web Application to use when accepting incoming connections. The default ports are recommended, but may be changed if there is a conflict with another application running on the local machine. Click Next.
  7. Choose a Username and Password for the SAS Enterprise Session Monitor Web Application Administrative User. This is used to access the administrative functionality of SAS Enterprise Session Monitor via the web browser. Keep these details safe. Click Next.
  8. You are now prompted to create a Windows service for the SAS Enterprise Session Monitor Server and start it after installation. Service creation is recommended and the names of the services are configurable, however this option can be unchecked if you wish to start the SAS Enterprise Session Monitor Server manually or via another scripted method. Click Next.
  9. Specify the target install location for the SAS Enterprise Session Monitor Server using the file browser ensuring that sufficient disk space is available. A new folder can be created from the browse window if necessary. The installer will automatically create an esm-server subfolder within the selected destination folder. Click Next.
  10. You may specify the target installation location for the embedded database binaries if you wish for them to be placed outside of the Server installation directory. Otherwise, accept the defaults. Click Next.
  11. You may specify the target installation location for the embedded database tablespace if you wish for it to be placed outside of the Server installation directory. Otherwise, accept the defaults. Click Next.
  12. You may specify the target installation location for the embedded database logs if you wish for them to be placed outside of the Server installation directory. Otherwise, accept the defaults. Click Install.
  13. The installation process will begin. This may take a few minutes to complete. Details of the installation process steps can be seen by clicking the Show Details button.
  14. Click Close.
  15. Once the installation has completed. You should apply your license.

Apply the License

Note

It may take up to five minutes for the web interface to become accessible after the installation.

  1. From a supported browser on the machine where the Server was installed, open: http://localhost:18080/esm/.
  2. The application will load and you will be presented with a login dialog. Enter the credentials used in step 7 of the installation process.
  3. After successfully logging in, a new dialog will appear with two options for updating your license.
  4. If you have the license file, you can browse to the file using the "Choose File" button, and then clicking Renew
  5. If you have a license key string, you can paste the value into the "Insert Key" field, and the click Renew.
  6. If the license key is accepted, the details of the key will be shown and a "Refresh" button will appear at the bottom of the dialog. Click Refresh.

Validate the Server Installation

Ensure Connectivity to the User Interface

  1. From a supported browser on the machine where the Server was installed, open: http://localhost:18080/esm/.
  2. The application will load and you will be presented with a login dialog. Enter the credentials used in step 7 of the installation process.
  3. After successfully logging in, you will be taken to an empty Dashboard page.

Completing the above steps has successfully demonstrated connectivity to the Enterprise Session Monitor UI.

Ensure Connectivity to the Database

  1. From a supported browser on the machine where the Server was installed, open: http://localhost:18080/esm/.
  2. The application will load and you will be presented with a login dialog. Enter the credentials used in step 7 of the installation process.
  3. After successfully logging in, from the main menu on the left, select "Admin Settings" ( icon).
  4. Open the Database Maintenance tab. A page will be displayed showing the current size of the database and two sets of vertical bar charts. If this page displays data, a connection to the database has been successfully made.

Completing the above steps has successfully demonstrated connectivity to the Enterprise Session Monitor database.

Last update: April 24, 2023
Created: April 24, 2023