To install Deep Security Agent, you must download the agent installer and load packages
for the agent's protection modules into Deep Security Manager.
![]() |
WARNINGEven if you use a third party deployment system, you must import all installed Deep
Security Agent software into the Deep Security Manager's database. When a Deep Security
Agent is first activated, it only installs protection modules that are currently enabled
in the security policy. If you enable a new protection module later, Deep Security
Agent will try to download its plug-in from Deep Security Manager. If that software
is missing, the agent may not be able to install the protection module.
|
In this topic:
View agent software available for download
To view a complete list of software available for import into Deep Security Manager,
you can start from Deep Security Manager or you can start from the Help Center.
To start from Deep Security Manager:
-
In Deep Security Manager, go to Administration > Updates > Software > Download Center.
-
Optionally, organize the list of software by version or platform by selecting Version or Platform from the list at the top.
-
Optionally, search the software by entering a search string in the search box in the upper right.
To start from the Help Center:
-
In the Deep Security Help Center, click Software on the left. The Deep Security Software page appears.
-
Click the Major Releases (LTS) tab for long-term support releases, and Feature Releases (FR) tab for feature releases. For details, see Deep Security release strategy and life cycle policy.
View a list of imported agent software
To view a list of software that you have imported into Deep Security Manager:
-
In Deep Security Manager, go to Administration > Updates > Software > Local. All your imported software appears.
-
Optionally, organize the list of software by version or platform by selecting Version or Platform from the list at the top.
Import agent software
Even if you do not use Deep Security Manager to deploy agent updates, you must still
import the software into the Deep Security Manager. The following are the import methods:
Import agent software directly, from the Download Center
-
Make sure your Deep Security Manager computer has Internet access. If not, see instead Import agent software indirectly, from the Help Center.
-
In Deep Security Manager, go to Administration > Updates > Software > Download Center.
-
From the list at the top, select Platform.
-
Expand a platform to view the agents available for it.
-
Under the VERSION field, look for the version you want and click the import icon. Follow these guidelines:
-
You can select a long-term support (LTS) release or a feature release (FR). For details on LTS and FRs, see Deep Security release strategy and life cycle policy.
-
If you are trying to import a Solaris agent, see Solaris-version-to-agent-package mapping table for information on which agent to choose.
-
If you are trying to import an AIX agent, see AIX agent package naming format for the naming format, which is different depending on the agent version.
Deep Security Manager connects to the Internet to download the software from Trend Micro Download Center. The manager then checks the digital signature on the software package. When the manager has finished, a green check mark appears in the IMPORTED column for that agent. Software packages now appear on Administration > Updates > Software > Local.If a package cannot be imported, you can try importing it indirectly instead. -
Import agent software indirectly, from the Help Center
If your Deep Security Manager is air-gapped (not connected to the Internet), or if
a direct import did not work, you can try importing the agent software indirectly:
-
On a computer that has access to the Internet, go to the Deep Security Help Center.
-
On the left, click Software. The Deep Security Software page appears.
-
Download the software ZIP you want. For details on long-term support (LTS) releases and feature releases, see Deep Security release strategy and life cycle policy.
-
Move the software ZIP to the Deep Security Manager computer.
-
In Deep Security Manager, go to Administration > Updates > Software > Local.
-
In the main pane, click Import to import the ZIP file. The manager checks the digital signature on the ZIP file, and if it is valid, allows the import to proceed.
Import agent software updates automatically
You can have Deep Security Manager look for newer software on the Download Center
and import it to your local inventory automatically. Deep Security Manager only imports
updates to already-imported software.
An update is a build in which only the last set of numbers changes. For example, if
you already imported agent version 12.0.0.111, then the following versions would be
imported automatically because they are update builds of 12.0.0.111:
12.0.0.112
12.0.0.123
However, the following versions would not be imported automatically:
12.1.0.222
10.0.0.111
To have Deep Security Manager automatically import agent update builds to your local
inventory:
-
In Deep Security Manager, go to Administration > System Settings > Updates.
-
Select Automatically download updates to imported software.
-
Click Save.Note that setting imports the software to Deep Security Manager but does not automatically update your agent software. Continue with Upgrade Deep Security Agent.
Export the agent installer
You can download the agent installer from Deep Security Manager as follows:
-
In Deep Security Manager, go to Administration > Updates > Software > Local.
-
Select your agent from the list. If you have imported multiple versions of the same agent, the latest version of the software has a green check mark in the Is Latest column.If you are looking for a Solaris agent, see Solaris-version-to-agent-package mapping table for information on which agent to choose.
-
Click Export > Export Installer.The manager then checks the digital signature on the software package. If the signature is valid, the export proceeds.
-
Save the agent installer. If you are planning to install the agent manually, save it on the computer where you want to install Deep Security Agent.
To install Deep Security Agent, only use the exported agent installer (the
.msi
, .rpm
, .pkg
, .p5p
, or .bff
file depending on the platform) as opposed to the full agent ZIP package. If you
run the agent installer from the same folder that holds the other zipped agent components,
all protection modules will be installed, even if you have not enabled them on the
computer. This consumes extra disk space. For comparison, if you use the .msi
, .rpm
, .pkg
, .p5p
, or .bff
file, the agent will download and install protection modules only if your configuration
requires them.Installing an agent, activating it, and applying protection with a security policy
can be done using a command-line script. For more information, see Use a deployment script.
You can generate deployment scripts to automate the agent installation using the Deep
Security API. For more information, see Generate an agent deployment script.
Solaris-version-to-agent-package mapping table
If you are not sure which agent package to pick when importing and exporting the
agent, review the following mapping table.
Solaris-version-to-agent-package mapping table
If you're installing the agent on
|
Choose this agent package
|
Help Center option
|
Solaris 10 Updates 4-6 (64-bit, SPARC or x86)
|
Agent-Solaris_5.10_U5-xx.x.x-xxx.<sparc|.x86_64>.zip
|
Solaris_5.10_U5
|
Solaris 10 Updates 7-11 (64-bit, SPARC or x86)
|
Agent-Solaris_5.10_U7-xx.x.x-xxx.<sparc|.x86_64>.zip
|
Solaris_5.10_U7
|
Solaris 11.0 (1111)-11.3 (64-bit, SPARC or x86)
|
Agent-Solaris_5.11-xx.x.x-xxx.<sparc|.x86_64>.zip
|
Solaris_5.11
|
Solaris 11.4 (64-bit, SPARC or x86)
|
Agent-Solaris_5.11_U4-xx.x.x-xxx.<sparc|.x86_64>.zip
|
Solaris_5.11_U4
|
Note the following:
-
The Help Center option column shows you which option to select from the Agent list on the Help Center's 'Deep Security Software' page, if that is how you have chosen to obtain the package.
-
xx.x.x.xxx
is the build number of the agent. For example,12.0.0-682
-
<sparc|.x86_64>
is one ofsparc
or.x86_64
, depending on the Solaris processor.
AIX agent package naming format
The naming format is different depending on the agent version:
-
Deep Security Agent 12 for AIX:
Agent-AIX-<agent_release>-<agent_build>.powerpc.zip
. For example,Agent-AIX-12.0.0-1234.powerpc.zip
. -
Deep Security Agent 9.0 for AIX:
Agent-AIX_<AIX_version>-<agent_release>-<build>.powerpc.bff.gz.zip
. For example,Agent-AIX_5.3-9.0.0-5625.powerpc.bff.gz.zip
.
For details on which agent you need for the version of AIX you are using, see Deep Security Agent platforms.
Delete a software package from the Deep Security database
To save disk space, Deep Security Manager periodically removes unused packages from
the Deep Security database. To configure the maximum number of old packages kept,
go to System Settings > Storage.
![]() |
NoteDeep Security Virtual Appliance uses the same protection modules as Deep Security
Agent for 64-bit Red Hat Enterprise Linux. Therefore, if you have an activated Deep
Security Virtual Appliance and try to delete the 64-bit Red Hat Enterprise Linux Agent
software package from the database, an error message will notify you that the software
is in use.
|
There are two types of packages that can be deleted:
-
agent
-
kernel support
Deleting agent packages in single-tenancy mode
In single-tenancy mode, Deep Security automatically deletes agent packages (Agent-platform-version.zip)
that are not currently being used by agents. Alternatively, you can manually delete
unused agent packages. Only unused software packages can be deleted.
For the Windows and Linux agent packages, only the currently used package (whose version
is the same as the agent installer) cannot be deleted.
Deleting agent packages in multi-tenancy mode
In multi-tenancy mode, unused agent packages (Agent-platform-version.zip) are not
deleted automatically. For privacy reasons, Deep Security cannot determine if software
is currently in use by your tenants, even though you and your tenants share the same
software repository in the Deep Security database. As the primary tenant, Deep Security
does not prevent you from deleting software that is not currently running on any of
your own account's computers, but before deleting a software package, ensure that
no other tenants are using it.
Deleting kernel support packages
In both single and multi-tenancy mode, Deep Security automatically deletes unused
kernel support packages (KernelSupport-platform-version.zip). A kernel support package
can be deleted if both of these conditions are met:
-
No agent package has the same group identifier.
-
Another kernel support package has the same group identifier and a later build number.
You can also manually delete unused kernel support packages. For Linux kernel support
packages, only the latest one cannot be deleted.