Oracle Cloud Infrastructure Documentation

Download and Set Up Cloud Protect Fleet Agent (SQLcl)

Use these steps to download the RPM required to install the Cloud Protect Fleet Agent (SQLcl) on the target database server.

  1. Go to the Oracle yum site to download the latest RPM required to install SQLcl. For example: sqlcl-linux-26.2.0-3.el8.x86_64.rpm.

    Note

    Note:

    The Oracle yum site offers two types of RPMs for installing SQLcl: noarch RPM and Oracle Linux x86_64 RPM. For example:

    • noarch RPM: sqlcl-26.2.0-3.el8.noarch.rpm

    • Oracle Linux x86_64 RPM: sqlcl-linux-26.2.0-3.el8.x86_64.rpm

    Oracle recommends that you choose the latest Oracle Linux x86_64 RPM because x86_64 RPM packages include a compatible version of Oracle Java SE Development Kit (JDK). If you choose a noarch RPM, then you must manually install the JDK version that is compatible with SQLcl.

You must complete the following steps on each compute node.

  1. Set the environment variable RPM_SQLCL_INSTALL_AS_ORACLE to true and then install the RPM on each compute node.

    Setting RPM_SQLCL_INSTALL_AS_ORACLE to true allows the RPM installation to add the Oracle software owner user (oracle) to the sql-scheduler group so that the scheduled backup tasks are run as the oracle user.

    root@computenode# export RPM_SQLCL_INSTALL_AS_ORACLE=true
root@computenode# rpm -Uvh <SQLcl RPM>

    For example:

    root@computenode# export RPM_SQLCL_INSTALL_AS_ORACLE=true
root@computenode# rpm -Uvh sqlcl-linux-25.3.0-1.el8.x86_64.rpm
    Verifying...                          ################################# [100%]
Preparing...                          ################################# [100%]
Updating / installing...
1:sqlcl-linux-25.3.0-1.el8         ################################# [100%]

  2. Enable the scheduler to start on system start up, as shown in this example.

    root@computenode# systemctl enable sql-scheduler
    Synchronizing state of sql-scheduler.service with SysV service script with /usr/lib/systemd/systemd-sysv-install.
  Executing: /usr/lib/systemd/systemd-sysv-install enable sql-scheduler
  Created symlink /etc/systemd/system/multi-user.target.wants/sql-scheduler.service → /etc/systemd/system/sql-scheduler.service.
  Created symlink /etc/systemd/system/graphical.target.wants/sql-scheduler.service → /etc/systemd/system/sql-scheduler.service.

  3. Start the scheduler.

    root@computenode# systemctl start sql-scheduler

  4. Check the status of the scheduler, as shown in this example.

    [root@nshqaw20adm05 ~]# systemctl status sql-scheduler
    sql-scheduler.service - SQLcl scheduler services
Loaded: loaded (/etc/systemd/system/sql-scheduler.service; enabled; vendor preset: disabled)
Active: active (running) since Mon 2025-10-06 00:25:33 EDT;

  5. Set the SQLcl binary for the Oracle software owner user (oracle).

    Add the SQLcl binary location in the PATH environment variable, as shown below.

    export PATH=/opt/oracle/sqlcl/bin:$PATH

Related Topics