This section describes how to install Session Monitor for a new system.

1. Log in to the OCSM server as a root or root privileged user.
2. Run this command to verify that Oracle Linux 8 has been installed:
   cat /etc/oracle-release
3. For partitioning, see the section Creating a Separate Partition for Data and MySQL Storage in the Session Monitor Release 5.1 Installation Guide.
4. Rename all the repos under the directory /etc/yum.repos.d/

   mv /etc/yum.repos.d/oracle-linux-ol8.repo /etc/yum.repos.d/oracle-linux-ol8.repo_bkp
   mv /etc/yum.repos.d/uek-ol8.repo /etc/yum.repos.d/uek-ol8.repo_bkp
   mv /etc/yum.repos.d/virt-ol8.repo /etc/yum.repos.d/virt-ol8.repo_bkp

5. Create the /etc/yum.repos.d/ocsm.repo with the following content:

   [OCSM]
   name=OCSM dependencies
   baseurl=ftp://<REPO_SERVER_IP>/pub/ocsm/
   gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-oracle
   gpgcheck=0
   enabled=1
   proxy=_none_

6. Run this command to clean-up the repo:
   yum clean all
7. Run this command to verify the repolist:

   yum repolist

   # yum repolist
   
   repo id  repo name
   OCSM     OCSM dependencies
   

8. Install the MySQL rpms using the following command:

   yum install mysql-commercial-*

9. Copy the following RPMs from the Repo server to the OCSM server in a temporary directory, such as /tmp/dependency/, and install the RPM files on the OCSM server in this order:
   1. rpm -ivh python39-setuptools-wheel-50.3.2-4.module+el8.5.0+20364+c7fe1181.noarch.rpm
   2. rpm -ivh python39-pip-wheel-20.2.4-7.module+el8.6.0+20625+ee813db2.noarch.rpm
   3. rpm -ivh python39-libs-3.9.13-2.module+el8.7.0+20879+a85b87b0.x86_64.rpm
   4. rpm -ivh python39-3.9.13-2.module+el8.7.0+20879+a85b87b0.x86_64.rpm
   5. rpm -ivh python39-pip-20.2.4-7.module+el8.6.0+20625+ee813db2.noarch.rpm
   6. rpm -ivh python39-pyyaml-5.4.1-1.module+el8.5.0+20364+c7fe1181.x86_64.rpm
10. Download the following protobuf package from https://pypi.org/project/protobuf/3.20.3/#files to a temporary directory, such as /tmp/dependency/ of the OCSM Server:

    protobuf-3.20.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl

11. Download the following MySQL Connector package from MOS to the same temporary directory used above. such as /tmp/dependency/ directory of OCSM Server:

    MySQL Connector 8.0.32 Package: p34984522_800_Linux-x86-64.zip
    ( Patch 34984522: MySQL Connector/Python 8.0.32 WHL for portable Linux x86 (64bit) Python 3.9 )

    Note:

    The OCSM dependencies used here are based on MySQL Connector 8.0.32 version since we are using MySQL 8.0.32 version. If there are any additional dependencies required, please take that as well.
12. Run this command to set Python alternatives to python3.9:

    update-alternatives --config python3
    update-alternatives --config python 
    

    Note:

    After the OCSM upgrade, while installing any new packages using yum, some packages will install Python 3.6 as a dependency. As a result, Python alternatives will be getting changed. This can cause unexpected problems in the OCSM functionality. So, it is mandatory to verify that Python is pointing to Python 39. Run the commands listed above after installing every package using yum.

    Note:

    When prompted, select the number corresponding to python3.9 option and press the Enter key on the keyboard.
13. Run the following commands to install MySQL Connector from the temporary directory, such as /tmp/dependency/:

    cd /tmp/dependency/
    yum install unzip
    unzip p34984522_800_Linux-x86-64.zip
    pip3 install mysql_connector_python-8.0.32-1commercial-cp39-cp39-manylinux1_x86_64.whl --no-index --find-links=/tmp/dependency/

    Note:

    In the pip3 command used above, the option "--find-links" points to the directory where the dependencies required for the MySQL Connector whl file is present. Here, protobuf package is a dependency for MySQL Connector and is present in the temporary directory, such as /tmp/dependency/ as mentioned in the previous steps.
14. Run this command to install OCSM:

    yum install ocsm

    For adjusting the firewall access, see the section Tasks to be Performed after RPM Installation in the Session Monitor Release 5.1 Installation Guide.