Installing the AEB Service Agent (IT admins)

The installer for the launcher needs to be installed once with administrator rights.

This option is available only if you have administrator rights for your computer. If not, please consult your system administrator. The AEB Service Agent is digitally signed with the AEB certificate. Your IT department can check and approve the origin of this component for security purposes at any time.

Technical background information

The AEB Service Agent, in its installed version, consists of two parts:

• Launcher: The launcher is installed under C:\Program Files (x86)\AEB\ServiceAgent. Its runtime task is to correctly launch the Agent with the forwarded data.
• Agent: The agent is the actual “connection software” that establishes an https connection to the AEB Engine with the data it receives in order to report the local printers to the AEB Engine and then accept print jobs for each user.

How it works

• The installer uses the registry key Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Classes\aebserviceagentv1 to associate the launcher with the protocol type aebserviceagentv1//, which is called through the web interface. The launcher receives an SSO (single sign-on token), which is then forwarded to the agent. The launcher re-downloads the agent the first time the launcher is started or after an update.
• The agent is downloaded from the server once and again during the typically quarterly updates (in addition to the regular startup) and is stored by default under %AppData%\Roaming\AEB\ServiceAgent. This requires write access. If this is not allowed because you’re writing under C:/ (as in Citrix environments), you can define another path with an environment variable AEB_SERVICEAGENT_FOLDER.

Write access on this path is absolutely essential.

Technical notes on installation

• Requirements:
• The installation requires local administrator rights. Begin by implementing the defined system configuration: Implementing the system configuration for the AEB Service Agent
• All users must have routine access to C:\Program Files (x86)\AEB\ServiceAgent for the launcher to start automatically. Make sure there are no conflicts with antivirus programs.
• All users must have routine access to C:\Users\XXX\AppData\Roaming for the agent to start automatically. Make sure there are no conflicts with antivirus programs.
• The MSI installation file can be run on the user instances through an installation repository.

Notes for Citrix environments or environments without write access to C:/: If you are not able or allowed to write under C:/ (as in Citrix environments), you can define another path with an environment variable AEB_SERVICEAGENT_FOLDER. This only controls the path of the agent (typically %AppData%\Roaming\AEB\ServiceAgent) but not that of the launcher (C:\Program Files (x86)\AEB\ServiceAgent). Write access to this directory for every user is absolutely essential.

Proceed as follows to install the AEB Service Agent:

You can check the system configuration: See Checking the system configuration for the AEB Service Agent