Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Current »



Citrix XenApp / Terminal Server

Terminal servers are designed for an average workload and rely on the applications to release their resources as quickly as possible when the RDP session is disconnected. Since the client also serves as a server for the add-ins, it would remain in memory with normal configuration and prevent the session from being completely terminated.

NOTE
The following options also work on a "desktop" PC, but the option is more useful for Citrix or terminal server deployments.


Option: ShutdownOnDisconnect

By setting ShutdownOnDisconnect in the "primedocs.exe.config"-file the client will be shutdown automatically as soon as it receives the Session Disconnect from the terminal server. This setting can be adjusted via a parameter in the Setup.

<configuration>
  [...]
  <appSettings>
    [...]
    <!-- Allows to configure primedocs to shutdown 
          when a disconnect happens (such as disconnecting from an RDP Session) -->
    <add key="ShutdownOnDisconnect" value="true" />
    [...]
  </appSettings>
  [...]
</configuration>

Option: TrySyncOnLogOff

By setting TrySyncOnLogOff in the "primedocs.exe.config" file the client tries to synchronize the last state to the server before the Session Logoff. This can be useful if the cache is not stored permanently, for example, and if data loss is to be avoided.

WARNING
If the user does not log out correctly or exits primedocs early, data loss may occur despite the setting.

This setting can be adjusted via a parameter in the Setup.

<configuration>
  [...]
  <appSettings>
    [...]
    <!-- Before a Windows Session logoff the client can try to sync its latest changes to the server. A user might "kill" the application, so this is "Best Effort" and might not work depending on the user action. -->
    <add key="TrySyncOnLogOff" value="true" />
    [...]
  </appSettings>
  [...]
</configuration>

primedocs Cache

In a Load Balanced terminal server environment, it must be ensured that each primedocs client has exclusive access to the cache. This can be ensured by properly deploying the cache folder. Optionally, the primedocs client can be excluded from Active State monitoring in the terminal server.


Settings for Outlook

Outlook's security model assumes by default that up-to-date antivirus software is installed. However, in Terminal Server or Citrix environments, Outlook cannot retrieve this status. This results in the user having to constantly confirm primedocs access to the Outlook address book.

To suppress these messages, the following settings must be made either via Registry/GPP or via GPO:

Via Registry/GPP

[HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\outlook\security]

"PromptOOMAddressBookAccess"=dword:00000002
"PromptOOMAddressInformationAccess"=dword:00000002
"AdminSecurityMode"=dword:00000003

TIP
The version 16.0 works for Outlook 2016, Outlook 2019 and Outlook 365. For Outlook 2013 it is the version 15.0.

Via GPO

Administrative Vorlagen (Benutzer)\Microsoft Outlook 2016\Sicherheit\Sicherheitsformulareinstellungen
Outlook-Sicherheitsmodus - Wert 3 (Outlook-Sicherheitsgruppenrichtlinie verwenden)
Administrative Vorlagen (Benutzer)\Microsoft Outlook 2016\Sicherheit\Sicherheitsformulareinstellungen\Programmatische Sicherheit
Eingabeaufforderung für Outlook-Objektmodell beim Zugriff auf ein Adressbuch konfigurieren - Wert 2 (Automatisch genehmigen)
Administrative Vorlagen (Benutzer)\Microsoft Outlook 2016\Sicherheit\Sicherheitsformulareinstellungen\Programmatische Sicherheit
Eingabeaufforderung für Outlook-Objektmodell beim Lesen von Adressinformationen konfigurieren - Wert 2 (Automatisch genehmigen)

Further Outlook configuration options are described here.


Citrix XenApp and Terminal Server

For more information, see the following articles:

Registry example: Citrix

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI
Value Name:LogoffCheckSysModules
Type:REG_SZ
String:primedocs.exe

Microsoft Terminal Server

For more information, see the following articles:

Registry example: Terminal Server

HKEY_LOCAL_MACHINE \SYSTEM\CurrentControlSet\Control\Terminal Server\Sysprocs
Value name: primedocs.exe
Data type: REG_DWORD 
Base: Hex

CAUTION
The terminal server must be restarted after the setting.

  • No labels