Roll out Bitdefender agent

How the action installs a missing Bitdefender agent on Windows devices, which setting it has and when the step fails.

Use this action to make sure the Bitdefender agent (Bitdefender Endpoint Security Tools) is installed on a Windows device. If it is missing, octoja installs it from the GravityZone installation package of the company matched to the device's customer. The device must be online.

Prerequisites

Bitdefender is connected under Integrations, and the device's customer is matched to a GravityZone company — see Set up the Bitdefender integration.
The matched company has an endpoint agent installation package for Windows in GravityZone.
The device can download the installation package from Bitdefender over HTTPS.

Configuration fields

Field	Type	Required	Default	Description
Installation package	text	No	empty	Name of the GravityZone installation package. Leave it empty and octoja uses the matched company's endpoint agent package. If the company has several of these packages, you must enter a name. Variables are not supported.

If Bitdefender is not connected, the properties panel shows Bitdefender is not connected. Connect it under Integrations first.

Platform support

Platform	Supported
Windows	Yes
Linux	No
macOS	No

Outputs

Output	Description
`installed`	Installed: `true` when the Bitdefender agent is present on the device after the step.
`action`	Action: `installed` after a fresh install, `alreadyInstalled` when the agent was already there, `none` when the installation on the device failed.

If the step fails before it reaches the device, for example because octoja finds no suitable package, there are no outputs. You'll find the installer's progress messages in the step's standard and error output in Run history.

Result behaviour

octoja checks the integration, the customer match and the installation package on every run, before the step reaches the device. So these checks can fail even when the Bitdefender agent is already installed.

Situation	Result
The Bitdefender agent is already installed	Succeeded, `action` = `alreadyInstalled`. Nothing changes on the device.
The agent is missing and the installation works	Succeeded, `action` = `installed`. This also applies when the installer asks for a restart.
The installer reports an error	Failed. The error output shows the installer's exit code.
The installer finishes, but no Bitdefender service appears within 10 minutes	Failed.
The download and installation take longer than 45 minutes	The installation is stopped and the step does not succeed.
The device is not a Windows device	Failed: The Bitdefender agent supports Windows devices only.
Bitdefender is not connected	Failed: The Bitdefender integration is not connected.
The device has no customer, or the customer is not matched	Failed: The device's customer is not matched to a Bitdefender company.
Installation package is empty and the company has no endpoint agent package	Failed: No Bitdefender installation package was found for the matched company.
Installation package is empty and the company has several endpoint agent packages	Failed: The matched company has several installation packages — name one in the step.
GravityZone returns no Windows download link for the package	Failed: Bitdefender returned no Windows download link for the package.
The GravityZone API cannot be reached	Failed: The Bitdefender API could not be reached. This is usually temporary — just run the automation again.
The device is offline when the step starts	Device offline. Depending on If device is offline, the run ends with this status or the step is skipped.

The agent counts as installed as soon as one of the services EPSecurityService, EPProtectedService, EPIntegrationService or EPUpdateService exists, even if it is stopped. The step never restarts the device itself.

You can safely run the step again: if the agent is already there, octoja just reports it and installs nothing. The step does not check whether protection actually works afterwards. For that, also assign the Bitdefender Protection check.

Was this helpful?

Still need help? Ask the team