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

Installation

Dieser Abschnitt beschreibt, wie PhraseExpress für die Verwendung mit einem Microsoft SQL-Server installiert und konfiguriert wird.

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.
  • Regulärer PhraseExpress Client auf allen Windows- und/oder Mac-Arbeitsplätzen.
  • "Microsoft Native SQL Client" auf allen Rechnern. Dieser wird bei der Installation der PhraseExpress Clients und des PhraseExpress SQL Client Managers installiert.
  • "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 (gegebenenfalls im Hintergrund) laufen.
  2. Installieren Sie den PhraseExpress Client auf allen Arbeitsplatzrechnern. Lassen Sie dabei die Option "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

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

Empfohlener Ablauf:
  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.

Datenumzug auf SQL Server

So ziehen Sie Textbausteine von einem PhraseExpress Server oder einer Einzelplatzversion auf einen SQL Server um:

  1. Wichtig: Wenn Leserechtebeschränkungen vorgenommen wurden, starten Sie den PhraseExpress Client unter einem Windows Benutzerkonto, der Leserechte auf alle Textbausteine einräumt!
  2. Laden Sie im Programmfenster die bislang genutzte Textbausteindatei mit dem Befehl Datei » Öffnen » lokale Textbausteindatei.
  3. Erstellen Sie mit dem Befehl Datei » Öffnen » mit SQL Server verbinden einen neuen SQL Server Textbausteinzweig.
  4. Verschieben Sie mit der Maus alle Textbausteine in den neu erstellten SQL Textbaustein-Zweig. Die Konvertierung kann eine Weile dauern…
  5. Anschließend entfernen Sie den alten Textbausteindateizweig der lokalen Textbausteindatei.

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

Inhaltsverzeichnis


Inhaltsverzeichnis