Skip to content

Server on Linux

Important

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

Note

The following instructions will assume a target installation directory of /opt/sas/esm

Obtain Installation Assets

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

Once downloaded, untar the archive to a suitable temporary location. The installer is ~230 MB uncompressed.

Install the Server

  1. Change directory to the destination of the unpacked installation package and execute the setup.sh script to start the SAS Enterprise Session Monitor Server Installation Wizard.
  2. 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. Accept by pressing 'y' and Enter.
  3. You will now be presented with a choice of environment size. Most environments will be a Small deployment. Accept by pressing '1' and Enter. See the Server sizing guidelines for further information.
  4. Now select the database that server will use. Unless instructed by SAS Technical Support, select the Embedded option. Accept by pressing '1' and Enter.
  5. The default Embedded database port is 15432. Unless this port is taken by another application running on the local machine. Press Enter.
  6. Unless instructed by SAS Technical Support, do not modify the Database URL. Proceed by pressing Enter.
  7. 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. Proceed to the next steps by pressing Enter.
  8. Specify the target install location for the SAS Enterprise Session Monitor Server ensuring that sufficient disk space is available. The installer will automatically create an esm-server subfolder within the selected destination folder. Press Enter.
  9. 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. Press Enter.
  10. 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. Press Enter.
  11. 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. Press Enter.
  12. 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. If you want to use default ports, Press Enter four times to accept recommended ports.
  13. 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. Continue by pressing Enter.
  14. The installation process will begin. This will take less than a minute to complete.

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 open http://esmserver:18080/esm/. Replacing esmserver for either the hostname or IP address of the machine where you installed the Server.
  2. The application will load and you will be presented with a login dialog. Enter the credentials used in step 13 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 open http://esmserver:18080/esm/. Replacing esmserver for either the hostname or IP address of the machine where you installed the Server.
  2. The application will load and you will be presented with a login dialog. Enter the credentials used in step 13 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://esmserver:18080/esm/. Replacing esmserver for either the hostname or IP address of the machine where you installed the Server.
  2. The application will load and you will be presented with a login dialog. Enter the credentials used in step 13 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