Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

...

Citrix XenApp / Terminal Server

Terminal server sind für einen durchschnittlichen Workload ausgelegt und sind darauf angewiesen, dass die Applikationen ihre Ressourcen bei Trennung der RDP-Session möglichst schnell wieder freigeben. Da der Client gleichzeitig als Server für die AddIns dient, würde er mit normaler Konfiguration im Speicher verbleiben und verhindern, dass die Session komplett beendet werden kann.

...

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

Durch die Einstellung By setting ShutdownOnDisconnect in der the "primedocs.exe.config"-Datei wird der Client automatisch beendet, sobald er das Session Disconnect vom Terminalserver erhält. Diese Einstellung kann im Setup über einen Parameter eingestellt werdenfile 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.

Code Block
languagexml
<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

Durch die Einstellung By setting TrySyncOnLogOff in der the "primedocs.exe.config" -Datei versucht der Client vor dem Session Logoff den letzten Stand zum Server zu synchronisieren. Dies kann nützlich sein, wenn der Cache z. B. nicht dauerhaft gespeichert wird und Datenverlust vermieden werden sollfile 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

WARNING
Loggt der Benutzer sich nicht korrekt aus oder beendet primedocs frühzeitig, kann es trotz der Einstellung zu Datenverlust kommen.

...

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.

Code Block
languagexml
<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>

...

Option: UseLazyLoadingCache

The UseLazyLoadingCache setting in the "primedocs.exe.config" file puts the client in an alternative mode so that binary data from templates and snippets are only loaded when they are used. This option can be particularly useful in terminal server environments to enable a quick initial start.

Warning

WARNING
This option can cause delays when using a template or snippets for the first time. If the service is not available during this time, an error is displayed.

This setting can be adjusted in the Setup via a parameter. The advantages and disadvantages are explained in more detail here: Synchronization

...

primedocs Cache

Bei einer In a Load Balanced Terminalserver-Umgebung muss sichergestellt werden, dass jeder primedocs-Client exklusiven Zugriff auf den Cache hat. Das kann durch die richtige Bereitstellung des Cache-Ordners sichergestellt werden. Optional kann im Terminalserver der primedocs-Client von der Active State-Überwachung ausgeschlossen werden.

Einstellungen für Outlook

Outlooks Sicherheitsmodell geht standardmässig davon aus, dass eine aktuelle Antivirus-Software installiert ist. In Terminalserver oder Citrix Umgebungen kann Outlook jedoch diesen Status nicht abrufen. Das führt dazu, dass der Anwender ständig den Zugriff von primedocs auf das Outlook Adressbuch bestätigen muss.

Um diese Meldungen zu unterdrücken, müssen folgende Einstellungen entweder per Registry/GPP oder per GPO vorgenommen werden 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

Code Block
languagepowershell
[HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\outlook\security]

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

TIP
Die Version The version 16.0 funktioniert für works for Outlook 2016, Outlook 2019 und and Outlook 365. Für For Outlook 2013 ist es die Version it is the version 15.0.

...

Via GPO

Code Block
breakoutModewide
languagepowershell
Administrative Vorlagen (Benutzer)\Microsoft Outlook 2016\Sicherheit\Sicherheitsformulareinstellungen
Outlook-Sicherheitsmodus - Wert 3 (Outlook-Sicherheitsgruppenrichtlinie verwenden)

...

Code Block
breakoutModewide
languagepowershell
Administrative Vorlagen (Benutzer)\Microsoft Outlook 2016\Sicherheit\Sicherheitsformulareinstellungen\Programmatische Sicherheit
Eingabeaufforderung für Outlook-Objektmodell beim Lesen von Adressinformationen konfigurieren - Wert 2 (Automatisch genehmigen)

Weitere Outlook Konfigurationsmöglichkeiten sind hier beschriebenFurther Outlook configuration options are described here.

...

Citrix XenApp

...

and Terminal Server

For more information, see the following articles:

Registry

...

example: Citrix

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

...

Microsoft Terminal Server

Weitere Informationen finden Sie unter folgendem ArtikelFor more information, see the following articles:

Registry

...

example:

...

Terminal Server

Code Block
languagepowershell
HKEY_LOCAL_MACHINE \SYSTEM\CurrentControlSet\Control\Terminal Server\Sysprocs
Value name: primedocs.exe
Data type: REG_DWORD 
Base: Hex
Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFEBE6#FFFAE6

CAUTION
Der Terminalserver muss nach der Einstellung neu gestartet werdenThe terminal server must be restarted after the setting.