Installing Session Monitor for the First Time using the Configured Repo Server

This section describes how to install OCSM for the first time.

  1. Log in to the OCSM server as root or root privileged user.
  2. Rename all Repos under /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
    	mv /etc/yum.repos.d/oracle-epel-ol8.repo /etc/yum.repos.d/oracle-epel-ol8.repo_bkp
  3. Create /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_
  4. Clean up the repo by running the following command:
    yum clean all
  5. Verify the repolist by running the following command:
    # yum repolist
    repo id repo name
    OCSM OCSM dependencies
  6. Copy the following from the Repo server to the Session Monitor server in temporary directory, such as /tmp/dependency/ and install those RPMs on Session Monitor server in this order.
    yum install perl-IO-Socket-SSL-2.066-4.module+el8.6.0+20623+f0897f98.noarch.rpm
    perl-Mozilla-CA-20160104-7.0.1.module+el8.3.0+21136+b437fca9.noarch.rpm
    perl-Net-SSLeay-1.88-2.module+el8.6.0+20623+f0897f98.x86_64.rpm
  7. Install the MySQL 8.0.39 rpms using following command:
    yum install mysql-commercial-*
  8. Copy the following RPMs from the repo Server to the OCSM Server in a temporary directory, such as /tmp/dependency/ and install the RPMs on OCSM Server in this order:
    1.rpm -ivh python39-setuptools-wheel-50.3.2-5.module+el8.10.0+90269+2fa22b99.noarch.rpm
    2. rpm -ivh python39-pip-wheel-20.2.4-9.module+el8.10.0+90269+2fa22b99.noarch.rpm
    3. rpm -ivh python39-libs-3.9.19-1.module+el8.10.0+90341+71ca88f4.x86_64.rpm
    4. rpm -ivh python39-3.9.19-1.module+el8.10.0+90341+71ca88f4.x86_64.rpm
    5. rpm -ivh python39-pip-20.2.4-9.module+el8.10.0+90269+2fa22b99.noarch.rpm
    6. rpm -ivh python39-pyyaml-5.4.1-1.module+el8.9.0+90016+9c2d6573.x86_64.rpm
  9. Download the following protobuf package from https://pypi.org/project/protobuf/3.20.3/#files to a temporary directory, such as /tmp/dependency/ directory of OCSM Server:
    protobuf-3.20.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl
  10. Download the following MySQL Connector package from MOS to the same temporary directory used in Step 8, such as /tmp/dependency/ directory of the OCSM Server.
    MySQL Connector 8.0.33 Package: p35301971_800_Linux-x86-64.zip
    ( Patch 35301971: MySQL Connector/Python 8.0.33 WHL for portable Linux x86 (64bit) Python 3.9 )
    

    Note:

    Please use the MySQL Connector 8.0.33 for offline installation. The SM dependencies used here are based on MySQL 8.0.39, installing a different version of MySQL may require dependency changes
  11. Set python alternatives to python3.9 by running the following commands:
    update-alternatives --config python3
    update-alternatives --config python

    Caution:

    When prompted, select the number corresponding to python3.9 option and press the Enter key.

    Note:

    After the OCSM Installation, while installing any new packages using yum, some packages will install Python 3.6 as a dependency. As a result Python alternatives will get changed. This can cause unexpected problems in the OCSM functionality. So it is mandatory for you to verify that Python is pointing to python 39 after every package installation using yum by running the above two commands.
  12. From the temporary directory, such as /tmp/dependency/, run the following commands to install MySQL Connector:
    cd /tmp/dependency/
    yum install unzip
    unzip p35301971_800_Linux-x86-64.zip
    pip3 install mysql_connector_python-8.0.33-1commercial-cp39-cp39-manylinux1_x86_64.whl --no-index --find-links=/tmp/dependency/
  13. Install OCSM by running the following command:
    yum -y install ocsm

    Note:

    For information on post-RPM installation tasks such as Disabling Firewall, Enabling SELinux, refer to the section Installing Session Monitor Using the RPM.
    OCSM Installation is now complete.