Skip Navigation
  1. BlackBerry Docs
  2. CylanceHYBRID
  3. CylanceHYBRID Administration Guide
  4. Installing the agents that communicate with CylanceHYBRID
  5. Installing agents on Linux devices
  6. Install the CylanceOPTICS agent on the Linux device

Install the
CylanceOPTICS
 agent on the
Linux
 device

Complete the following steps if the
CylancePROTECT Desktop
 agent is already installed on the
Linux
 device and the device is already communicating with the
CylanceHYBRID
 application.
  • Verify that you are running
    CylanceHYBRID
     version 2.0 or later.
  • Verify that the
    CylancePROTECT Desktop
     agent is installed and properly communicating with
    CylanceHYBRID
     before you install the
    CylanceOPTICS
     agent on the device.
  • Use the most recent versions of the
    CylancePROTECT Desktop
     agent, and the
    CylanceOPTICS
     agent if you will also install
    CylanceOPTICS
    . For more information, see the compatibility information for the
    Cylance Endpoint Security
     desktop agents. 
  1. Download the
    CylanceOPTICS
     setup file to the
    Linux
     device. You can either sign in to the
    Cylance Endpoint Security
     management console from the device, or transfer the installation file from an external source (like a USB flash drive) to the device. You can also use a group policy or other software-management system to deploy the
    CylanceOPTICS
     installer.
  2. Configure
    CylanceHYBRID
     as the proxy server for
    CylanceOPTICS
    . On each
    CylanceOPTICS
     endpoint, run the following commands as root or using a root shell:
    Task
    CLI command
    Make the cyoptics.service.d directory
    mkdir /etc/systemd/system/cyoptics.service.d
    Add the CylanceHYBRID instance to the proxy.conf file
    echo "[Service]" > /etc/systemd/system/cyoptics.service.d/proxy.conf
    echo "Environment=http_proxy=http://<cylancehybrid.domain.local>:8888" >> /etc/systemd/system/cyoptics.service.d/proxy.conf
    echo "Environment=https_proxy=http://<cylancehybrid.domain.local>:8888" >> /etc/systemd/system/cyoptics.service.d/proxy.conf
  3. Use the following command to verify the contents of the file:
    cat /etc/systemd/system/cyoptics.service.d/proxy.conf
    The following is a sample output for that command: 
         [Service]
     Environment=http_proxy=http://cylancehybrid.domain.local:8888
     Environment=https_proxy=http://cylancehybrid.domain.local:8888
  4. If you make changes to the proxy.conf file after you install
    CylanceOPTICS
    , you must restart the cyoptics service for the changes to take effect. Run the following commands as root:
    1. systemctl stop cyoptics
    2. systemctl daemon-reload
    3. systemctl start cyoptics
  5. Perform one of the following tasks:
    Task
    Steps
    Use the GUI.
    1. Double-click the
      CylanceOPTICS
       installer. No other parameters or configuration are required.
    2. Click
      Continue
      .
    3. Click
      Close
       when the installation is complete.
    Use the terminal commands.
    Make sure that your version of
    Linux
     meets the requirements for
    CylanceOPTICS
    . See Requirements: CylanceOPTICS.
    Do one of the following:
    • On RHEL/
      CentOS
      , SUSE, or
      Amazon
      Linux
       2, open a terminal window and run the following command:
      yum install CylanceOPTICS-<version>.rpm
      , where <
      version
      > is the version of the .rpm file.
    • On
      Ubuntu
      , run the following command:
      dpkg -i cylance-optics_<version>_amd64.deb
      , where <
      version
      > is the version of the .deb file.
For additional information and troubleshooting suggestions, see Troubleshooting.