P'X5 Sales Solution. Betriebshandbuch Version 10.0

Transkript

1 P'X5 Sales Solution Betriebshandbuch Version 10.0

2 Copyright Copyright 2017 Perspectix AG. Alle Rechte vorbehalten. Die Weitergabe und Vervielfältigung dieser Publikation oder von Teilen daraus sind, zu welchem Zweck und in welcher Form auch immer, ohne die ausdrückliche schriftliche Genehmigung durch Perspectix AG nicht gestattet. In dieser Publikation enthaltene Informationen können ohne vorherige Ankündigung geändert werden. Perspectix übernimmt keinerlei Haftung oder Garantie für Fehler oder Unvollständigkeiten in dieser Publikation. P'X, P'X5 und die entsprechenden Logos sind registrierte Marken von Perspectix. Andere Firmen-, Produkt- und Dienstleistungsbezeichnungen können durch andere registriert sein. Perspectix AG Hardturmstrasse 253 CH-8005 Zürich Schweiz Tel: Fax: Website:

3 Betrieb und Instandhaltung Schema Die folgende Abbildung zeigt die Grundkomponenten der P'X5 Sales Solution Infrastruktur: 1. Die Authoring Workbench kann von der Authoring Workbench Homepage heruntergeladen werden. 2. Der Central Repository Server wird als herunterladbares.zip-archiv bereitgestellt, das aus einem Ordner besteht, der das Virtual-Disk-Image und einen.ovf Open Virtualization Format Virtual Machine Ordner enthält. 3. Der Update Server wird als VMware-Image bereitgestellt. 1

4 1. Installation Authoring Workbench Authoring Workbench installieren Central Repository Server Virtuelle Maschine importieren Virtuelle Maschine konfigurieren Datenspeicherung-Mount einrichten VMware-Disk-Image Laufwerksfreigabe via CIFS Laufwerksfreigabe via NFS Ports, die offen sein sollten Update Server Update Server installieren Checkliste: Update Server 2. Einrichtung Central Repository Server einrichten Server-Lizenz einrichten LDAP-Authentifizierung einrichten 3. Instandhaltung Starten/Stoppen der virtuellen Maschine: Um die virtuelle Maschine zu stoppen, geben Sie den folgenden Befehl in die Kommandozeilenkonsole ein: sudo shutdown -h now Benutzerverwaltung für den Central Repository Server Benutzerverwaltung für den Update Server (kontaktieren Sie Perspectix, um Benutzer hinzuzufügen oder zu entfernen) P'X5-Pakete aktualisieren Betriebssystemkomponenten aktualisieren Datensicherung: Sichern Sie den Ordner, den Sie im Feld File Store Path definiert haben. 2

5 Speicherplatz erweitern 4. Systemschnittstellen Authentifizierung Projekt- und Adressenaktualisierungs-Schnittstellen Systemdateiaktualisierungs-Schnittstellen Projektimport-Schnittstellen Sync Table-Schnittstelle 5. Datenbankinstandhaltung Daten werden in einer SQL-Datenbank (PostgreSQL) und in Dateien auf der Festplatte gespeichert. Es sind keine besonderen Datenbankinstandhaltungstätigkeiten erforderlich. Mit dem folgenden Kommando können Sie über die Kommandozeilenkonsole auf die Datenbank zugreifen: psql centralrepository Sie können auch Drittsysteme via ODBC an den Server anbinden. Die Daten sollten nicht direkt am Server geändert werden (im normalen Betrieb). Dafür gibt es Schnittstellen. Für Berichte sollten die folgenden Views verwendet werden (verwenden Sie \d table in der psql- Konsole, um die Felder zu sehen): view_project_global alle Projektdaten/-felder 3

6 Das Feld mit dem Präfix p_ wird für Projektdaten verwendet. Das Feld mit dem Präfix g_ ist für Gruppendaten des Projektes. Das Feld mit dem Präfix o_ ist für Besitzerdaten (Benutzer) des Projektes. Das Feld mit dem Präfix c_ ist für Clientdaten (Project Organizer), die für die Synchronisation mit dem Client verwendet werden. Alle anderen Felder ohne Präfix sind anpassbare Felder, die auf dem Server für diese Tabelle definiert sind. view_user_global alle Projektdaten/-felder Das Feld mit dem Präfix u_ wird für Benutzerdaten verwendet (wie in der Konsole definiert, überprüfen Sie den Tooltip im Web-GUI). Das Feld mit dem Präfix g_ ist für Gruppendaten, für die der Benutzer definiert wurde. Alle anderen Felder ohne Präfix sind anpassbare Felder, die am Server für diese Tabelle definiert sind. view_address_global alle Projektdaten/-felder Das Feld mit dem Präfix a_ wird für Adressdaten verwendet. Das Feld mit dem Präfix g_ ist für Gruppendaten, für welche die Adresse definiert wurde. Alle anderen Felder ohne Präfix sind anpassbare Felder, die am Server für diese Tabelle definiert sind. Klonen Sie die Serverdaten (zum Beispiel, Server "Produktion" zu Server "Test") Rufen Sie ein Skript auf, wie das folgende, das zusammen mit Perspectix angepasst werden muss: #!/bin/sh RHOST=cr-retail.perspectix.com # 1) On the new server do this sudo /etc/init.d/px5-jboss stop # 2) Mirror the files sudo rsync -ap --delete-before -z "cradmin@$rhost:/mnt/centralrep/*" /mnt/centralrep/. # 3) Clone the DB rm -f /tmp/cr-retail.sql* # Dump the DB ssh "postgres@$rhost" "cd /tmp;pg_dumpall --clean gzip" > /tmp/cr-retail.sql.gz gzip -d /tmp/cr-retail.sql.gz # Restore the db sudo su postgres -c 'psql -f /tmp/cr-retail.sql' # update the server url (to be checked) sudo su postgres -c echo "update tbl_groups set url=' psql centralrepository # 4) start the server sudo /etc/init.d/px5-jboss start Löschen Sie unbenutzte Pakete auf dem Update Server Im Laufe der Zeit wird sich der Server mit Diff-Aktualisierungspaketen füllen, die möglicherweise nicht mehr verwendet werden. Wenn Sie diese löschen/säubern wollen, können Sie einen Befehl, wie den folgenden, für Dateien, die nicht älter als 14 Tage sind, verwenden (erstellen Sie einen Snapshot oder führen Sie vorher eine Datensicherung durch): > cd /srv/px5-update-server/customer/www/downloads/patches > sudo find -mtime +14 -name 'patch_*-*.pxp' -exec rm {} \; Adressen und Sync-Tables 4

7 Über die P'X5-Schnittstellen können Sie den Inhalt von Adressen und Sync-Tables aktualisieren/ändern. Die Sync-Table- und Adressen-Schnittstelle sind für Diff-Aktualisierungen gedacht und die Diff- Verwaltung sollte dort passieren wo die Daten gepflegt werden. Hinweis: Stellen Sie sicher, dass die verwendeten Daten vom Anfang an ordnungsgemäss gepflegt werden (wenigstens im Produktionssystem) und dass nur die Daten verteilt werden, die auch wirklich nötig sind. Derzeit ist es möglich die Datensätze auf dem Server als gelöscht zu markieren (die Änderungen werden an die Clients weitergeleitet, wo sie dann physisch gelöscht werden). Es gibt drei Optionen: OPTION 1: Verwenden Sie die Schnittstelle mit der Spalte deleted (dies ist der empfohlene Ansatz). OPTION 2: Führen Sie diese Befehle auf der Kommandozeile des Central Repository Servers aus: Für die Sync-Table test: > update tbl_sync_data set deleted=now(),modified=now(),db_modified=now() where type=(select id from tbl_sync_type where type='test'); Für die Adressen: > update tbl_addresses set deleted=now(),modified=now(),db_modified=now(); Importieren Sie dann die "neuen" Daten über die Serverschnittstellen. OPTION 3: Löschen Sie die Datensätze physisch. Achtung: Das physische Löschen der Datensätze wird von Perspectix derzeit NICHT EMPFOHLEN und NICHT UNTERSTÜTZT. Wenn Sie das wirklich durchführen wollen, tun Sie es AUF EIGENE GEFAHR. Wenn Sie Datensätze wirklich AUF IHRE EIGENE GEFAHR physisch löschen wollen, können Sie die folgenden Befehle, einige Tage nachdem Sie die Datensätze als gelöscht markiert haben, ausführen: Für die Sync-Tables: > delete from tbl_sync_data where type=(select id from tbl_sync_type where type='test') and deleted > 'timestamp'; Für die Adressen: > delete from tbl_addresses where deleted > 'timestamp'; 6. Projektspezifisch Siehe Anhang (wenn verfügbar). 5