Diese Dokumentation bezieht sich auf PhraseExpress v16 beta. Die Dokumentation für die Produktionsversion 15 ist hier verfügbar

Installation

Dieser Abschnitt beschreibt die Verwendung von PhraseExpress mit einem Microsoft SQL-Server.

Systemvoraussetzungen

Eine typische Installation umfasst folgende Komponenten/Anforderungen:
  • Windows Server PC mit Microsoft SQL Server 2012-2019, Express Edition oder Verbindung zu einem Azure oder Amazon AWS SQL Server.
  • "PhraseExpress SQL Client Manager" zur Einrichtung der Datenbanken und zur Benutzer- und Lizenzverwaltung. Die Installationsdatei beinhaltet die optionale Installation des kostenlosen Microsoft SQL Server Express Edition.
  • Regulärer PhraseExpress Client auf allen Windows- und/oder Mac-Arbeitsplätzen.
  • "Microsoft Native SQL Client" auf allen Rechnern. Dieser ist in der Installation des PhraseExpress Clients und des PhraseExpress SQL Client Managers enthalten. Alternativ wird der ODBC 17 Treiber unterstützt.
  • "View Definition" Rechte für die "Master" SQL-Datenbank.

SQL Client Manager Installation

Wir empfehlen die Videoanleitung, die sie schrittweise durch die Installation führt:

Videoanleitung

So installieren Sie den PhraseExpress SQL Client Manager:
  1. Installieren Sie den "PhraseExpress SQL Client Manager". Zwecks zuverlässig-direkter Kommunikation zum SQL Server empfehlen wir die Installation auf dem Server-/Zentralrechner.
  2. Die Installationsroutine bietet Ihnen die Installation eines vorkonfigurierten Microsoft SQL Servers in der kostenlosen Express Edition an. Falls Sie noch keinen SQL Server verwenden, ist dies ausdrücklich empfohlen, da ein SQL Server erforderlich ist. Falls Sie einen bestehenden SQL Server mit PhraseExpress verwenden möchten, beachten Sie unbedingt die Konfigurationshinweise im folgenden Kapitel.
  3. Beim ersten Start des SQL Client Managers erscheint ein Einrichtungsassistent zur Erstellung der SQL Textbaustein- und Lizenzdatenbank. Folgen Sie den Anweisungen auf dem Bildschirm.
  4. Registrieren gegebenenfalls vorhandene Lizenzschlüssel im Register "Lizenzschlüssel" des SQL Client Managers. Ohne Lizenzschlüssel können Sie PhraseExpress unverbindlich mit allen Funktionen testen.

Installieren und starten Sie den regulären PhraseExpress Client auf den Arbeitsplätzen. Sofern der PhraseExpress SQL Client Manager läuft, sollten sich die Clients automatisch mit dem SQL Server verbinden können.

Sollte der SQL Server trotz Auswahl der Option nicht installiert werden, stellen Sie in im Windows Programm "Windows Features" sicher, dass das ".NET Framework" installiert ist.

Konfiguration eines vorhandenen SQL Servers

Falls Sie einen bestehenden Microsoft SQL Server für PhraseExpress nutzen möchten, ist möglicherweise eine Konfiguration erforderlich:

  1. Damit der PhraseExpress SQL Client Manager den Microsoft SQL Server ohne manuelle Konfiguration findet (alternativ müssen Sie den Instanznamen des SQL Servers kennen), starten Sie den "Microsoft SQL Server Configuration Manager" und stellen Sie dort im Bereich "SQL Serverdienste" sicher, dass der "SQL Server Browser" Dienst läuft:



    Falls der Dienst nicht läuft, klicken Sie mit der rechten Maustaste auf den Eintrag und starten Sie den Dienst.
  2. Im gleichen "Microsoft SQL Configuration Manager" muss unter "Client Protokolle" das TCP/IP Protokoll aktiviert sein:



    und



    und



    Falls deaktiviert, aktivieren Sie das Protokoll jeweils mittels Rechtsklick auf den Eintrag und Wahl des Befehls "Aktivieren" (bzw "Enable").
  3. Der TCP Port sollte nicht dynamisch wechseln (bei Verwendung von PhraseExpress für Mac zwingend erforderlich). Wir empfehlen die Einstellung auf einen statischen Port, zum Beispiel Standardport 1433. Dies können Sie ebenfalls im "Microsoft SQL Configuration Manager" konfigurieren:



    WICHTIG: Eine "0" (Null) deaktiviert "TCP Dynamic Ports" nicht! Das Feld muss leer sein, damit der TCP Port statisch ist! Weitere Infos finden Sie in der Microsoft SQL Configuration Manager Dokumentation.
  4. Die Firewall muss eingehende Verbindungen über den gewählten TCP Port zulassen. Hier sehen Sie beispielsweise die Konfiguration in der Windows Firewall:

  5. Sofern der "Windows-Authentifizierungsmodus" eingestellt ist, definieren Sie im "Microsoft SQL Server Management Studio" für das SQL Administratorkonto "sa" ein Passwort und aktivieren Sie das Konto. Fügen Sie im PhraseExpress SQL Client Manager im Register "Benutzer" die Anwender hinzu, die Zugriff auf PhraseExpress SQL Datenbanken erhalten sollen.

  6. Bei Verwendung von PhraseExpress Mac Clients stellen Sie im "Microsoft SQL Server Management Studio" (kostenloser Download) sicher, dass die Authentifizierung in den SQL Server Eigenschaften auf "SQL Server und Windows-Authentifizierungsmodus" eingestellt ist (Anleitung):



    und anschließend:

Der SQL-Serverdienst muss neu gestartet werden, damit die Konfigurationsänderung wirksam wird.

Wenden Sie sich an Ihren IT-Administrator, bevor Sie Änderungen an der Konfiguration des SQL-Servers vornehmen.

Windows Clients Installation

  1. Starten Sie den "PhraseExpress SQL Client Manager" und lassen sie diesen im Hintergrund laufen. Dieser wird später den Clients "wie ein Leuchtturm" die SQL Serververbindungsdaten senden.
  2. Installieren Sie den PhraseExpress Client auf allen Arbeitsplatzrechnern. Lassen Sie dabei die Installationsoption "SQL Serverunterstützung" angekreuzt!
  3. Damit sich die Clients automatisch mit dem SQL Server verbinden können, aktivieren Sie in den PhraseExpress Client Einstellungen » Netzwerk die Option "Automatische Serversuche".

Nach Programmstart der PhraseExpress Clients rufen diese über UDP Port 1047 im lokalen Netzwerk nach dem PhraseExpress SQL Client Managers, der über UDP Port 1036 mit den Verbindungsdaten zur SQL Datenbank antwortet. Daraufhin wechseln die Clients automatisch von der lokalen Textbausteindatei zur SQL Textbausteindatenbank.

Die Suche findet über UDP statt, dass ausschließlich auf das lokale Netzwerk beschränkt ist. Es werden keine Verbindungsdaten in das Internet übertragen.

Falls der PhraseExpress Client zum Beispiel aufgrund Netzwerkbeschränkungen kein UDP empfangen kann:

  • Klicken Sie im Register "Datenbank" des PhraseExpress SQL Client Managers auf "Client Verbindungsdatei erstellen". Die auf dem Desktop generierte Verbindungsdatei "config.xml" beinhaltet die Verbindungsdaten zur SQL Datenbank.

    Ziehen Sie diese Konfigurationsdatei in die Textbaustein-Baumansicht des PhraseExpress Client Hauptprogrammfenster.Oder beenden
  • Sie den PhraseExpress Client, kopieren Sie Konfigurationsdatei "config.xml" in das Client Programmverzeichnis ("%PROGRAMFILES(x86)%\PhraseExpress") oder Anwendungsdatenverzeichnis ("%PROGRAMDATA%\PhraseExpress\") des Clients und starten Sie den Client erneut.
  • Alternativ wählen Sie im Hauptprogrammfenster des Clients den Befehl Datei » Öffnen » SQL Textbausteindatenbank und laden Sie dort die Verbindungsdatei oder geben Sie den Pfad zur SQL Textbausteindatenbank an, wie im PhraseExpress SQL Client Manager im Register "Datenbank" zu sehen.

Mac Clients Installation

  1. Installieren Sie den gewöhnlichen PhraseExpress Client auf allen Macs.
  2. Stellen Sie sicher, dass in den macOS Systemeinstellungen » Freigaben » Optionen » Dateien und Ordner über SMB freigeben" aktiviert ist, damit der Mac den Windows Serverrechner über dessen Windows Rechnernamen finden kann (siehe auch macOS Hilfe).
  3. Wählen Sie im Hauptprogrammfenster des Mac PhraseExpress Clients den Befehl Datei » Öffnen » Mit SQL Server verbinden
  4. Geben Sie die SQL Datenbank Verbindungsdaten ein, wie im SQL Client Manager im Register "Datenbank" angezeigt.

    Alternativ ziehen Sie die Verbindungssdatei in die Textbaustein-Baumansicht des Client Hauptprogrammfensters.

Aktualisierung

Videoanleitung

Um eine bestehende PhraseExpress Installation auf eine neue Version zu aktualisieren:
  1. Erstellen Sie eine Datensicherung Ihrer aktuellen SQL Textbausteindatenbank.
  2. Aktualisieren Sie die PhraseExpress Clients auf allen Rechnern auf die neue Version.
  3. Aktualisieren Sie den PhraseExpress SQL Client Manager. Dieser aktualisiert gegebenenfalls das SQL Textbausteindatenbankformat.
  4. Sofern die Wartung Ihrer Lizenzen abgelaufen sein sollten, ersetzen Sie die im SQL Client Manager die aktuell registrierten Lizenzschlüssel mit mit den neuen Lizenzschlüssels.

Bitte beachten Sie, dass sich einzelne Funktionen zwischen Hauptversionen ändern können. Vor allem größere Versionssprünge erfordern gegebenenfalls Anpassungen von Makroprogrammierungen.

Bei der Aktualisierung entsteht eine kurze Ausfallzeit, da alle Clients aktualisiert werden müssen und das Format der SQL Datenbank aktualisiert werden muss.

Datenumzug auf SQL Server

Um Textbausteine von einem PhraseExpress Server oder einer Einzelplatzversion umzuziehen:
  1. Laden Sie im PhraseExpress Client Programmfenster die Textbausteine, die Sie auf den SQL Server übertragen möchten.
  2. Erstellen Sie mit dem Befehl Datei » Öffnen » mit SQL Server verbinden einen neuen SQL Server Textbausteinzweig.
  3. Verschieben Sie mit der Maus per "Drag & Drop" die gewünschten Textbausteine in den neu erstellten SQL Textbaustein-Zweig.
  4. Entladen Sie die lokale Textbausteindatei.

Fertig! Ab sofort sind die Textbausteine inklusive der Ordnerstruktur und Zugriffsrechteeinstellungen auf dem SQL Server gespeichert und werden zukünftig von dort geladen.

Wenn Leserechtebeschränkungen auf Textbausteinordner bestehen, starten Sie den PhraseExpress Client unter einem Windows Benutzerkonto, der Leserechte auf alle Textbausteine einräumen. Ansonsten werden nicht alle Textbausteine übernommen, sondern nur die, auf die sie zugreifen dürfen.

Inhaltsverzeichnis


Inhaltsverzeichnis