Sensor Actions

The System > Sensor Actions screen enables you to view and monitor actions performed on the sensor, such as a sensor installation, upgrade or uninstall.

Note

This screen is available on demand from version 23.2.4 and supports Windows sensors only. This screen is not yet generally available. Contact Support to enable this screen.

Overview

From the Sensor Actions screen, you can view all essential actions performed on the sensor, and information about each action.

The following information is available about each action:

Column name	Description
Action Status	The status of the action: Unknown, Completed, Failed.
Action Type	The type of sensor action that was performed: Upgrade, Installation, Uninstall.
Machine Name	The name of the machine on which the sensor was installed, upgraded or uninstalled.
Error	The error that was retrieved during sensor installation or upgrade.
Error Message	The error message, which describes the cause of the installation or upgrade failure. There may be more than one failure. See the ‘Errors’ section below for a list of error messages.
Internal IP Address	The internal IP address of the machine.
Initiated At	The time and date on which the action was initiated.
Version at start	The installed sensor version prior to the sensor action.
Version at end	The installed sensor version following the sensor action.

On this screen, you can:

• Add or remove columns. Column sort is not yet available.

• Search for sensor actions by machine name or internal IP address.

• Filter the results according to the Action Type, Action Status, and Error.

Important

If an installation or upgrade is successful, the status is reflected in the Sensor Actions screen. When an uninstall action is successful, the success status is not reflected in the screen, as the sensor was already removed and no longer communicating with the server. The Sensor Actions screen still displays an error when an uninstall fails.

Note

gRPC communication must be enabled for full information to be displayed on this screen. If gRPC communication is disabled, only actions reported from the Detection server are displayed (partial information). Installation actions will not be displayed. Contact Support regarding enabling gRPC communication.

Errors

In case of installation or upgrade failure, the Sensor Actions screen displays errors from different sources:

• From the sensor: These errors represent failures during installation.

• From the Detection server: These errors represent failures from the validations performed before a package is sent to the sensors.

The table below lists the available errors:

Note

The error messages displayed in the Sensor Actions screen are more elaborate than the messages described below. For example, for “Failure reason unknown”, the following error message is displayed: “Failure reason unknown: Failed to verify uninstall code or file. Uninstall is denied.”

Error	Error Code	Error Message
FAILURE_REASON_UNKNOWN	0	Failure reason unknown
FAILED_TO_VERIFY_CERTIFICATE	1	Failed to verify bundle’s certification.
NEWER_INSTALLED	2	Downgrade is not supported, installation version is x.x.x.x and installed version is Y.Y.Y.Y.
OS_NOT_SUPPORTED	3	OS not supported
ARCH_MISMATCH	4	One of the following: A 32-bit installation cannot be installed on a 64-bit Windows machine. A 64-bit installation cannot be installed on a 32-bit Windows machine.
ALREADY_UPDATED	5	Already updated
MISSING_PACKAGE_FROM_FILE_SYSTEM	6	Missing package from file system
MSI_FILE_CORRUPTED	7	MSI file corrupted
TIMEOUT	8	Timeout
FAILED_TO_SHUT_DOWN_SELF_PROTECT	9	Failed to shut down self protect
SERVICE_PACK_IS_INSUFFICIENT	10	Insufficient service pack - required {n}, found: {n-?}.
BUILD_NUMBER_IS_INSUFFICIENT	11	Insufficient build number - required {n}, found: {n-?}.
DENY_REPAIR	15	This installation does not support the Repair action.
SAME_VERSION_INSTALLED	16	Cannot install the same version of a new build.
PACKAGE_FAILED	18	Package failed
BUNDLE_FAILED_TO_EXECUTE	19	Bundle failed to execute
BUNDLE_FAILED_TO_APPLY	20	Bundle failed to apply
UNINSTALL_IS_DENIED	21	Uninstall is denied
BAD_UNINSTALL_PASSWORD	22	Failed to verify uninstall password.
BAD_OSV_FILE	23	Failed to verify OSV file.