2 Installing Session Monitor

This chapter describes how to install Oracle Communications Session Monitor.

Before installing Session Monitor, read the following:

Session Monitor Installation Options

You can install Session Monitor using either the ISO installer or the Red Hat Package Manager (RPM):

Installing Session Monitor Using the ISO Installer

The ISO installer installs Oracle Linux operating system and Session Monitor applications and components.

Installing Session Monitor using the ISO installer requires a server with no operating system. The Session Monitor installer erases any existing files on the primary and secondary disk on which Session Monitor is installed. Back up any important files on the disk before proceeding with the installation. For more information on preparing the Session Monitor ISO installation media, see "Preparing Session Monitor Installation Media".

This section describes installing Session Monitor installation using the ISO installer.

To install Session Monitor with the ISO installer:

  1. Download the Session Monitor ISO installer by doing the following:

    1. Download the software pack for your operating system from the Oracle software delivery web site.

    2. Download the Session Monitor ISO image and follow the instructions in "Preparing Session Monitor Installation Media" in a local computer.

  2. Insert the DVD or attach the USB flash drive and restart the server that will host Session Monitor.

    Ensure that the server boots from the installation media. This is usually done using a one-time boot option.

    The Session Monitor installer Boot Menu screen appears.

  3. Start the installation process by pressing Enter.

    The installer verifies whether the hardware passes the minimum system requirements for Session Monitor.

  4. The OCSM Installer - Network Configuration screen appears containing a list of supported network interfaces together with their hardware addresses (MAC).

    If the minimum system requirements are not met, the installation stops and a dialogue box providing the reason for failure appears. For example, see the following message:

    Problems were found:

    • * Found only 1 CPU threads instead of at least 8.

    • * Found only 1.95 GB system memory instead of at least 7 GB.

  5. From the Network device list, select the network interface you require for accessing the Session Monitor web interface and click OK.

  6. From the Network type list, select the following setting that is appropriate for your network and :

    • To automatically configure the network port IP address with the dynamic host configuration protocol (DHCP), select dhcp.

    • To manually configure the network port IP address, select static.

  7. Click OK.

    When prompted, enter the IP address, netmask, and default gateway values of your network.

    The OCSM Installer - Disk Configuration screen appears.

  8. From the Primary disk list, select the primary disk or disk array on which to install Session Monitor and click OK.

    The OCSM Installer - Software Installation screen appears.

  9. (Optional) The Session Monitor operating system and database are installed on the primary disk of the server that hosts the mediation engine. If your server has more than one disk, you will receive a prompt to choose to either keep all your data on one disk or store your data on a secondary disk. To store your data on a secondary disk, click Yes.

    Note:

    The default size for the primary disk is between 70 GB and 2 TB. If you require a larger disk array for data storage, configure it as a secondary disk.

  10. In the Enter a password for the root user field, enter the root user password and click OK.

  11. In the Confirm the root user password field, re-enter the root user password and click OK.

    The installer prepares the disks, sets up the system, and updates the firmware required for the hardware components.

    Important:

    Do not power off the system during this process, as this may leave components in an unusable state.

    The OCSM Installer - Finished screen appears.

    The installer prompts you to remove the Session Monitor flash drive installation media.

  12. Press Enter and remove the installation media.

  13. Verify that the installation is successful by restarting the system from the primary hard disk that you chose in step 8.

    • If the installation is successful, a console appears, displaying the Session Monitor secure URL.

    • If unsuccessful, check the /var/log/ocsm/pld-installer.log file.

See "Session Monitor Post-Installation Tasks" for the post-installation configuration steps.

Installing Session Monitor Using the RPM

You can choose to install Session Monitor using the RPM if you would like to set up the machine with the Oracle Linux operating system or if the machine on which you will install Session Monitor is already running Oracle Linux.

This section describes installing the Session Monitor using RPM.

To install Session Monitor using an RPM:

  1. Change the edition of MySQL by doing the following:

    1. Go to the Oracle Software Delivery web site:

      https://edelivery.oracle.com/

    2. Read and accept the license agreement and export restrictions and click Continue.

    3. Download the latest Enterprise edition of MySQL in version 5.5 series.

    4. Un-install the Community edition of MySQL by running the following command:

      yum remove -y mysql-community-common

    5. Install the Enterprise edition of MySQL by running the following command:

      yum install -y mysql-commercial*.rpm

    6. Install the yum utils by running the following command:

      yum -y install yum-utils

    7. Enable the latest Oracle Linux 7 add-on's by running the following command:

      yum-config-manager --enable ol7_latest ol7_optional_latest

  2. If you have a running Oracle Linux 7 (DPDK) probe with an Oracle Communications Session Monitor version prior to 3.4.0, uninstall Session Monitor by running the following command:

    yum remove ocsm

  3. Verify that the system hosting the mediation engine is connected to the Internet.

  4. Log on to the Mediation Engine server as the root user.

  5. Verify that Oracle Linux 7 is installed by running the following command:

    cat /etc/oracle-release

  6. Download the Session Monitor software by doing the following:

    1. Create a temporary directory (temp_dir) on the system that hosts the mediation engine.

    2. Download the software pack for your operating system from the Oracle software delivery web site.

    3. Download the Session Monitor installation software RPM ZIP file to temp_dir.

    4. Unzip the Session Monitor installation software RPM ZIP file.

  7. Install the Session Monitor RPM file by running the following command:

    yum install ocsm-rnx86_64.rpm

    where:

    • rn is the current Session Monitor release number.

    For example, ocsm-3.4.0.0.0.x86_64.rpm.

  8. Verify the installation by doing the following:

    1. Navigate to /var/log/ocsm file.

    2. Verify whether the following log file exists:

      ocsm_installed_*.log

  9. Adjust the firewalld to access the Session Monitor applications by doing the following:

    1. Allow firewalld to access the HTTPS service (port 443) by running the following command:

      firewall-cmd --permanent --zone=public --add-service=https

    2. (Optional) If you are planning to configure the system as a mediation engine, allow the firewalld to access the probe connection by doing the following:

      • For SBC (embedded) probes:

        firewall-cmd --permanent --zone=public --add-port=4739/tcp 
firewall-cmd --permanent --zone=public --add-port=4740/tcp

      • For standalone probes:

        firewall-cmd --permanent --zone=public --add-port=4741/tcp 
firewall-cmd --permanent --zone=public --add-port=4742/tcp

    3. Reload the configuration by running the following command:

      firewall-cmd --reload

    Note:

    If you are planning to enable additional services, see the discussion about network security in Oracle Communications Session Monitor Security Guide for a complete list of services and their respective ports.

  10. Disable SELinux by running the following command:

    setenforce 0
sed -i -e "s/^SELINUX=.*/SELINUX=disabled/" /etc/selinux/config

See "Session Monitor Post-Installation Tasks" for the post-installation configuration steps.

Session Monitor Post-Installation Tasks

This section provides instructions for the post-installation tasks for Session Monitor.

Before starting the post-installation tasks, verify that Session Monitor installation tasks are completed and all components are installed. See "Installing Session Monitor Using the ISO Installer" or "Installing Session Monitor Using the RPM".

About the Platform Setup Application

The Platform Setup Application guides you through the Session Monitor configuration steps, including configuring the machine type, capture settings, and simple mail transfer protocol (SMTP) settings as follows:

  1. The menu on the right shows your progress during configuration.

  2. The Machine Type page sets which licensed Session Monitor applications are installed. In the Server Certificate page, you can upload your signed certificate for secure HTTPS connections.

  3. Subsequent sections configure the Session Monitor server for your network. These steps are optional.

    Except for Machine Type and Extensions, you can review and change settings at any time by visiting the Platform Setup Application at https://ip_address/setup/, where ip_address is the IP address of the server that hosts a Session Monitor application. This URL is valid for any Session Monitor server.

  4. In the final step, each selected Session Monitor application is installed.

    After a successful installation, the log in page appears for each of your licensed Session Monitor application.

Platform Setup Application Initial Log In

All the Session Monitor application interfaces are accessed through encrypted HTTPS connections. At the initial login, your web browser may not recognize the server and displays the This Connection is Untrusted warning message. Click Confirm Security Exception to proceed.

For information about how to protect connections to the system and avoid the untrusted certificate warning in the future, see Oracle Communications Session Monitor Security Guide.

This section describes how to configure Session Monitor using the Platform Setup Application.

To configure Session Monitor:

  1. In a web browser, go to https://ip_address/setup.

    The Platform Setup Application Log in page appears.

  2. In the Username field, enter sysadmin and; in the Password field, enter oracle.

    The License Terms agreement page appears.

  3. Accept each Session Monitor application license terms agreement, by selecting the I agree to the license terms check box.

  4. Click Proceed.

    The Change Password dialog box appears.

    The Platform Setup Application page appears.

  5. Change the password by doing the following:

    1. In the Set password field, enter a new password.

      Note:

      The password must have at least 8 characters. The password must contain at least one uppercase character. The password must contain a number. The password must contain a special character (@, #, -, _, .).

    2. In the Repeat password field, re-enter the password used in the previous step, which verifies that the password value was entered correctly.

    3. Click Change.

  6. On the Machine Type Settings page, select the machine type on which to install your licensed Session Monitor applications and components:

    • To install an Operations Monitor probe, select Probe.

    • To install one or more of the Session Monitor applications belonging to the Mediation Engine machine type, select Mediation Engine and then select one or more of the following:

      • To install Oracle Communications Operations Monitor, select the Communications Operations Monitor check box.

      • To install Oracle Communications Control Plane Monitor, select the Control Plane Monitor check box.

      • To install an Operations Monitor embedded probe, select the Probe (embedded) check box.

      Only the checked items are included in the installation.

    • To install the Session Monitor applications belonging to the Aggregation Engine machine type, select Aggregation Engine and then select the Mediation Engine Connector check box.

    Note:

    You can select only one machine type for each installation process.

    Packet Inspector is not supported on the machine collocated with Operations Monitor or a Session Monitor probe with SIP/RTP sniffing for the calls and VQ analysis.

    Note:

    The products are machine-type specific and cannot be interchanged between machine types.

    For example, the Probe machine type requires a probe product, and the Mediation Engine machine type requires the Operations Monitor product.

  7. Click Continue.

    The machine type and application information appear in the status panel located on the right under the navigation list.

    The Configuration page appears.

  8. Configure the Session Monitor settings for the machine type you chose in step 5 in accordance with the terms of your license as follows:

    1. From the Capacity section in the Concurrent calls field, enter the number of concurrent calls printed on your license.

    2. If you have licensed RTP recording, select the RTP Recording check box.

    3. From the Capacity section in the Concurrent RTP streams field, enter the number of concurrent RTP streams printed on your license.

      Note:

      The number entered in the Concurrent RTP streams field can cause performance and stability issues if it is set higher than what your network hardware supports. Values above 20 are not recommended. Changes to the RTP recording setting take effect only after restarting the system.

    4. From the Extensions section, select all the product extensions you have licensed.

      Note:

      You cannot change the configured extensions after the installation. All Oracle Communications Session Monitor Enterprise users should select Media quality.

  9. Click Continue.

    The ME Connection List page appears.

  10. (Optional) If you selected Probe on the Machine Type Settings page, set which mediation engines are connected to the Operations Monitor probe.

    1. Click Add a new ME.

    2. In the TLS column, select No for Cleartext or Yes for TLS transmissions.

      The Operations Monitor Probe can transmit data to one or more mediation engines with either transport layer security (TLS) encryption, or with un-encrypted Cleartext. A mediation engine can connect to more than one Operations Monitor Probe or more than one Session Border Controller Probe. Add your list of mediation engines as follows:

    3. In the Port column, enter the port number of the mediation engine. For a Cleartext transmission enter 4741 and for TLS enter 4742.

    4. In the IP column, enter the IP address of the machine that hosts the mediation engine.

    5. In the Name column, enter a name for the mediation engine.

  11. Click Continue.

    The Trusted Certificate page appears.

  12. (Optional) By default, the mediation engine machine accepts only encrypted transmissions, (unless the mediation engine and probe are on the same machine); for Cleartext transmissions select the Accept insecure connections from remote probes check box.

  13. Click Continue.

    The Server Certificate page appears.

  14. All Session Monitor interfaces are accessed through encrypted (secure) HTTPS connections. Each Session Monitor machine uses a unique certificate to establish secure connections and to guarantee its authenticity and protect users' data.

    Do one of the following:

    • To use the self-signed certificate, click Continue.

    • To sign the server certificate with your organization's Public Key Infrastructure (PKI):

      1. Select Download request.

      2. Sign the certificate with the X.509 format.

      3. In the Upload signed certificate field, select Browse and locate the signed certificate file.

      4. Click Continue.

        The SMTP Configuration page appears.

  15. Session Monitor can send notifications and alerts directly to a user's email address. If you require notifications or alerts, select the Enable SMTP check box and fill in the relevant fields with your SMTP server details.

  16. Click Continue.

    The Capture Settings page appears.

  17. The Capture Settings page contains a list of configured network interfaces. Monitoring can be enabled and disabled. You should have configured network devices while installing Oracle Linux 7.

  18. Click Continue.

    The Data Retention page appears.

  19. Click Continue.

    The Install page appears.

  20. (Optional) Click Download Configuration, which downloads your configuration settings file in the default download location of your computer.

  21. Open the psa_conf.json configuration file and verify your settings.

  22. Click Install.

    The Did you select the right applications dialog box appears.

  23. Verify that you have chosen the correct Session Monitor applications and components for installation; after installation is complete, the selected applications and components cannot be changed.

    Click OK.

    The Platform Setup Application initiates the installation and reports its progress.

    The Installation Complete dialog box appears.

  24. Do one of the following:

    • To go back to the Platform Setup Application, click Back to Setup.

    • To go to a Session Monitor application dashboard, click Go to Application.

  25. The credentials for logging in to Session Monitor are:

    • For Platform Setup Application, user name is sysadmin and the password is the one you set up in step 5.

    • For Operations Monitor and Control Plane Monitor, user name is admin and the default password is oracle.