Installing Agents Manually
This topic describes the deployment of InTrust agents with native methods on supported platforms. For details about transparent automatic deployment, see Getting Started with InTrust; for details about batch deployment on InTrust sites, see the Deployment Guide.
We need to follow below steps for Manual Upgrade of Agent
-
Do not select “Establish connection with InTrust Server” during Agent MSI Installation.
-
After Agent upgrade, register server from the agent machine, by running the register command without password:
-
for Microsoft Windows computers - adcscm.nt_intel -add ServerName Port
-
for Unix computers - ./adcscm -add ServerName Port
It is recommended to uninstall all the old version of servers and agents for using the latest version to ensure successful authentication and communication between agents/servers.
-
Do not select “Establish connection with InTrust Server” during Agent MSI Installation.
-
After latest Agent installation, register server from the agent machine, by running the register command without password:
-
for Microsoft Windows computers- adcscm.nt_intel-add ServerName Port
-
for Unix computers- ./adcscm-add ServerName Port
-
-
Microsoft Windows Computers
Agents should be deployed manually under the following (or similar) circumstances:
- The InTrust server and the processed computers are connected by unreliable and slow links. Agent installation fails when the packet drop rate is higher than 5%.
- The processed computers are behind a firewall.
To install an agent manually, run the ADC_AGENT.*.*.*.*.msi installation package from the DVD\Agent folder on the InTrust DVD on the target computer.
|
|
Note: If turned on, User Access Control (UAC) may prevent installation package from running properly. To avoid possible problems, the installation package should be run in an elevated context (use the Run as Administrator command). |
If the DVD is unavailable, complete the following steps:
- Log on to the target computer using a local administrator account.
- Copy all files in the <InTrust_Server_installation_folder>\Server\ADC\Agent\winnt_x86\redist folder on the InTrust server to a local folder on the target computer. The agent will be installed to this folder.
- In the command prompt on the target computer,
cdto this folder and run the following command:adcscm.nt_intel -install
The agent starts automatically after installation is complete.
To uninstall the agent, use the Add/Remove Programs facility. However, if the agent was installed through the command prompt, run the following command on the target computer:adcscm.nt_intel -uninstall
|
|
Note: Installing an agent does not make it usable by the server, but only prepares it (unpacks installation files, starts services, etc.). Please make sure that you establish a connection with the desired server (see Establishing a Connection with the Server). |
Linux Computers
|
|
Note: The agent is a 32-bit application. If you have a 64-bit system, make sure that 32-bit compatibility libraries are installed. The required packages are glibc.i686 and libuuid.i686. Debian and Ubuntu require libc6:i386 and libuuid1:i386. On Red Hat Enterprise Linux 8 and Oracle Linux 8, the libnsl.i686 library must also be installed. The way to enable support for the 32-bit architecture on Linux varies from distribution to distribution. For example, in Ubuntu this can be achieved with the following commands (as root): dpkg --add-architecture i386 apt-get update Finally, to install the libraries, you can use the following: apt-get install libc6:i386 libuuid1:i386 Refer to your distribution's documentation if you need details. |
Agents must always be deployed manually on Linux computers. To install an agent, complete the following steps:
- Log in to the target computer under the root account. If you log in via telnet, log in using a normal account and then use the su command.
- Copy the adcscm_package.linux_intel.sh installation script to a local folder on the target computer. If you use a protocol with text and binary modes for copying (for example, FTP), make sure the mode is set to binary before the copying starts.
-
Start the script:
./adcscm_package.linux_intel.shYou will be prompted to supply the path to the installation directory.
After the installation, the agent will be started automatically.
Make sure that you have enough disk space for the event cache, which is located in /var/InTrust by default. You can change the location by editing the agent.ini file located in the directory where you install the agent. If you want to make agent configuration changes, you must complete them before you establish a connection with the InTrust server.
|
|
Notes:
|
Uninstalling the Agent
To uninstall the agent, run the following script from the agent's working directory:
./Uninstall.sh
Installing Agents Using Group Policy
You can automate the installation of agents using Group Policy settings. InTrust is shipped with a Windows Installer file containing the agent package.
To automatically install agents on specific computers, take the following steps:
- Copy the agent package from the Agent folder in the InTrust distribution to a share available to all those computers.
- In the Active Directory Users and Computers MMC snap-in, create an OU that includes all of the required computers and add a Group Policy object for this OU.
- Using the Group Policy Object Editor MMC snap-in, in Computer Settings, assign the agent package to the Group Policy object you added earlier.
- To make InTrust process these computers with agents, make sure the computers are included in InTrust sites.