OS commands for the Aurora Focus agent

The Aurora Focus agent installer supports the following OS commands.

Windows

Actions

Commands

Specify the installation directory.

INSTALLFOLDER=path

Specify the directory for the local Aurora Focus data store.

OPTICSROOTDATAFOLDER=path

Perform a silent installation with no user action required.

For the .exe package, use any of the following:
  • -q
  • -quiet
  • -s
  • -silent
For the .msi package, use either of the following:
  • /q
  • /quiet

Create an installation log file.

For the .exe package, use either of the following:
  • -l path_for_log
  • -log path_for_log
For the .msi package, use either of the following:
  • /l path_for_log
  • /log path_for_log

Disable proxy bypass for the Aurora Focus agent (.msi package only).

Use this option if you want the Aurora Focus agent to always use a specified proxy connection to the Aurora Focus cloud services. This is optional in most environments but required if you are using CylanceHYBRID.

Before you execute the installer with the command below, create the ProxyServer registry key on the device. See Configuring a proxy for the Aurora Protect Desktop and Aurora Focus agents. If you are using CylanceHYBRID, see the Windows setup instructions in the CylanceHYBRID Administration Guide and create the ProxyServer registry key with the required value for CylanceHYBRID.

After you create the ProxyServer registry key on the device, use the following command when installing the agent: HYBRID=True

The installer creates the DisableProxyBypass registry key on the device with the value set to True. For more information, see Proxy options for the Aurora Focus agent. If the command is set to False, the installer does not create the registry key.

Uninstall the Aurora Focus agent.

"CylanceOPTICS_program_directory\CyOpticsUninstaller.exe"

For example: "C:\Program Files\Cylance\Optics\CyOpticsUninstaller.exe"

To perform a silent uninstall that doesn't require user interaction, add the following commands: --use_cli -t v20

If you configured the Aurora Focus agent to require an uninstall password, add the following command: --password password

For example: "C:\Program Files\Cylance\Optics\CyOpticsUninstaller.exe" --use_cli -t v20 --password samplepass

macOS

Action

Commands

Install the Aurora Focus agent.

sudo installer -pkg CylanceOPTICS.pkg -target /

Install the Aurora Focus agent and create an installation log file.

sudo installer -verboseR -dumplog -pkg CylanceOPTICS.pkg -target /

Disable proxy bypass for the Aurora Focus agent

Use this option if you want the Aurora Focus agent to always use a specified proxy connection to the Aurora Focus cloud services. This is optional in most environments, but required if you are using CylanceHYBRID.

Before you install the Aurora Focus agent, follow the instructions in Aurora Endpoint Security conditions préalables pour le proxy to configure proxy bypass for macOS devices.

Start the Aurora Focus service.

sudo launchctl load /Library/LaunchDaemons/com.cylance.cyoptics_service.plist

Stop the Aurora Focus service.

sudo launchctl unload /Library/LaunchDaemons/com.cylance.cyoptics_service.plist

Uninstall the Aurora Focus agent.

sudo /Applications/Cylance/Optics/Uninstall\ CylanceOPTICS.app/Contents/MacOS/Uninstall\ CylanceOPTICS

Uninstall the Aurora Focus agent with no UI.

sudo /Applications/Cylance/Optics/Uninstall\ CylanceOPTICS.app/Contents/MacOS/Uninstall\ CylanceOPTICS --noui

If you want to use this command, additional actions are required on macOS 11.x devices. For more information, see the troubleshooting section in the Aurora Endpoint Security Administration content.

Linux

Action

Commands

Install the Aurora Focus agent on RHEL/CentOS, SUSE, or AmazonLinux 2.

yum install CylanceOPTICS-version.rpm, where version is the version of the .rpm file.

Install the Aurora Focus agent on Ubuntu.

dpkg -i cylance-optics_version_amd64.deb, where version is the version of the .deb file.

Start the Aurora Focus service.

systemctl start cyoptics.service

Stop the Aurora Focus service.

systemctl stop cyoptics.service

Uninstall the Aurora Focus agent on RHEL/CentOS, SUSE, or AmazonLinux 2.

rpm -e CylanceOPTICS

Uninstall the Aurora Focus agent on Ubuntu.

dpkg -P cylance-optics