update

Active license required

Description

Updates your rl-secure installation to a new version (if available).

Use this command to check for available updates and install them at your convenience.

The self-update feature

Using the update command is entirely optional because rl-secure has the self-update feature. If an update is available, it will be automatically installed the next time you scan a package or run a sync.

If a new version is available, but you want to keep using your current rl-secure version, do not run rl-secure scan or rl-secure sync until you're ready to update.

To access and retrieve updates, you must have a valid, activated rl-secure license. Your license contains credentials for the ReversingLabs cloud services that provide updates to rl-secure.

After the updates are successfully applied, you should use the sync command to re-scan your packages with the new version.

Your data collected by ReversingLabs

To ensure compatibility with the available update versions, ReversingLabs is gathering a limited set of data about your system, jointly referred to as telemetry. For details, review the list of all collected information.

Usage

rl-secure update [<options>]

Options

Option	Description
-h, --help	Display usage information and exit.
--check-only	Check for new updates without downloading or applying them.

Return codes

After executing the update command, you can check the status of your license by using the command appropriate for your system. If the license does not exist or has not been provided, the command will return the following code: 10.

Examples

Check for updates and install them

This example requests information about new rl-secure versions from the ReversingLabs cloud services.

If there are any available updates, they are displayed in the output.

Input

rl-secure update --check-only

Output

New rl-secure version available for download
    rl-secure 1.6.0.38 (2024-02-15)

Note the updates are not automatically installed when the --check-only option is used.

To install the updates, you would need to run the command again without the option.

Input

rl-secure update

Output

Downloading [=>                     ] 7% [00m:00s] 14136054/192674768 
Downloading [===========>           ] 58% [00m:03s] 113963766/192674768 
Downloading [=======================] 100% [00m:05s] 192674768/192674768 bytes
Update successful!

After updating rl-secure, confirm that the new version is correctly installed.

Input

rl-secure --version

Output

ReversingLabs Spectra Assure CLI (Preview)
    rl-secure 1.6.0.38
    rl-engine 5.0.0.38