Configuring the Agent

Each Configuration Management Point and Management Server has its own agent configuration. The agent configuration defines how the agent connects to the Management Server and the intervals for running the agent service.

Important

Agent configurations are inherited from the parent by default:

• A new Management Point inherits the configuration from the agent template.
• A new Management Server inherits the configuration from its parent Management Point.

Open the agent configuration

In System Administration, right-click the Configuration Management Point or Management Server, and select Configure agent…. To change the template that new Management Points inherit, right-click a Configuration Management Point and select Configure agent template….

The configuration has the tabs Client configuration, Service configuration, and Dependent services.

Client configuration

Element	Description
Management Server	Management Server in which the client will communicate with.
FQDN	The Fully Qualified Domain Name of the Management Server
CapaInstaller Root folder	The root folder for CapaInstaller, typically %ProgramFiles%\CapaInstaller.
User Client folder	Location for the user agent. NTFS Security will be applied for interactive users on the specified folder.
User Client log folder	Location for the logs files for the user agent. NTFS Security will be applied for interactive users on the specified folder.
Client log folder	Location for the logs files for the agent. Logs for installed packages also reside here.
Enable Front-end service for agent communication	Makes the agent communicate through the Front-end service on the Management Server. This setting can’t be reverted once it’s enabled. You can only enable it when unique UUID agent recognition is turned on in Tools → Options → System Administration → Agent Recognition, and when a Front-end service is installed on the Management Server. On a Configuration Management Point, all its Management Servers must have a Front-end service.
Info Center language	The language of CapaInstaller InfoCenter. Choose Use input language to follow the user’s regional settings, Use Windows language to follow the Windows display language, or a specific language: English, Danish, German, Norwegian, Swedish, French, Spanish, Finnish, or Dutch. For most users, Use input language is the best choice. If the language isn’t supported, InfoCenter uses English.
Enable Management Portal integration	If you have a CMS Management Portal you can enable this property to provide an extra menu item in InfoCenter. Clicking this menu item will launch a web browser and attempt to show the Management Portal detail view for this UNIT. The Management Portal URL: ‘http://<server>/ManagementPortal/landingpage/index?token=%mptoken%’ The ‘<server>’ must be substitute with the Dns name of the IIS server. The infocenter will replace the %mptoken% with a token generated for this session. The URL isn’t validated, so make sure the variable is in the right place.
Use balloon messages	Balloon messages are Messenger like popup message that rises from the system tray giving both messages and questions requiring input from the user. Removing the check will cause ordinary message boxes to be displayed.
Use graphical buttons	When checked, the InfoCenter balloon message will display images corresponding to ordinary buttons. When not checked, ordinary buttons as OK and Cancel buttons will be displayed. Note. This checkbox has no effect if “Use balloon messages” is unchecked.
Automatically run user agent after startup	Automatically run the user agent when the CapaInstaller InfoCenter starts.
Prevent the user from closing InfoCenter	Prevent users from closing the info center by disabling the Exit menu.
Hide system tray icon	Hides the CapaInstaller InfoCenter system tray icon. Will only be displayed when a message is displayed.

Service configuration

Element	Description
Service type	Select Local System account or This account. If the computers and the Management Server are within the same domain, we recommend using Local System as the Agent service account. If the computers and the Management Server are in a different domain, in a workgroup, use a named account. If the user is a non-domain user, the user will be created as a local user. The same user will be created on the Management Server and granted rights to the share. It is crucial that the username and password are the same on both the agent computer and the Management Server in order to make use of pre-cached credentials.
Interval: Agent	Minutes between each scheduled agent run. The default is 240 minutes (4 hours).
Interval: Health check	Minutes between each health check run. The default is 240 minutes (4 hours).

Dependent services

Element	Description
Dependent services	Windows services that must be running before the agent service runs the agent. Move services from Available services to Dependent services with Add ->. The dependent services aren’t Windows service dependencies of the agent service. The agent service starts and waits for these services to start before it runs the agent.