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
   
   

   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.

   • Oracle Linux 8: SQLcl on Oracle Linux 8 (x86-64)
   • Oracle Linux 9: SQLcl on Oracle Linux 9 (x86-64)

You must complete the following steps on each compute node.

2. 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%]

3. 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.

4. Start the scheduler.

   root@computenode# systemctl start sql-scheduler

5. 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;

6. 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