P'X5 Sales Solution Update Server Benutzerhandbuch Version 9.1
Copyright Copyright 2015 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: +41 44 445 95 95 Fax: +41 44 445 95 96 Website: www.perspectix.com E-Mail: info@perspectix.com
INHALT Update und Knowledge Base Server installieren 1 Checkliste: Update und Knowledge Base Server 3 Update und Knowledge Base Server migrieren 5
Update und Knowledge Base Server installieren Systemanforderungen (Vorabinstallation durch den Kunden) VMware Server oder VMware ESX. Gemeinsames Einspielen des von Perspectix gelieferten VMware-Images (eventuell via Remote-Desktop) und dabei Setzung der DNS- und Netzwerkeinstellungen. Zugriffsmöglichkeit auf das VMware-Image (d.h. den Update Server) aus der Domain.perspectix.com als root via SSH. Hardwareanforderungen (Bereitstellung durch den Kunden) Mindestens 1 GHz Intel Prozessor. Mindestens 512 MB Speicher für das VMware-Image (d.h. den Update Server). Mindestens 20 GB Harddisk-Kapazität (für Release-Historie). Der Disk muss für das VMware Image expandierbar sein. Internetanschluss für SSH-Zugriff (siehe oben); als Update Server schneller Upload ins Internet (mehrfache parallele Zugriffe von allen Clients für Updates). Backup der Datenplatte. Anforderungen an die IT-Umgebung des Systems (Installation durch den Kunden) Zugriff auf den Update Server via SSH als root bzw. sudo-benutzer und für die P'X5 Autoren- User aus der Domain.perspectix.com. Achtung: Beachten Sie die Firewall-Einstellungen. Zugriff auf den Update Server via HTTP und HTTPS für Updates und Erstellung der Releases. Achtung: Beachten Sie die Firewall-/DNS-Einstellungen. So richten Sie ein VMware Update Server Image ein 1. Laden Sie die von Perspectix gelieferte Appliance in ESX. 2. Starten Sie die Appliance in ESX. In der Server-Konsole wird nach IP / hostname gefragt. 3. Füllen Sie die "Checkliste: Update Server" aus. 4. Loggen Sie sich auf die Maschine per SSH (oder Konsole) ein (U: pxadmin P:.pxadmin). 5. Geben Sie den Befehl sudo s root (Passwort:.pxadmin) ein und gehen Sie sehr vorsichtig vor. 6. Erstellen Sie die gewünschten CVS Benutzer: a. Geben Sie den Befehl adduser cvs-username in die Konsole ein. b. Füllen Sie die Angaben aus und lassen Sie die Benutzer die gewüschten Passwörter eintippen. c. Geben Sie den Befehl addgroup USERNAME cvs in die Konsole ein, um den Benutzer zur Gruppe cvs dazuzufügen. 7. Erstellen Sie ein neues Repository in Eclipse mit den entsprechenden Benutzer- und Hostnamen. 1
8. Checken Sie mit Eclipse das neue Projekt ein. 9. Passen Sie den Update Server an: a. Geben Sie den Befehl cd /srv/px_update/server/customer/includes nano config.php in die Konsole ein. b. Bearbeiten Sie die Konfigurationsdatei. Stellen Sie sicher dass die Variable $cvs_module="prj" mit dem gewählten CVS-Modulnamen (z.b. PRJ) initialisiert wird. c. Drücken Sie STRG+X um den Editor zu speichern und zu schliessen. 10. Setzen sie das Passwort für den Zugriff auf die Verwaltungsoberfläche des Update Servers: a. Geben Sie den befehl htpasswd a /srv/px_update_server/includes/htpasswd USERNAME in die Konsole ein. b. Geben Sie das Passwort ein. 11. Testen Sie den Update Server: a. Setzen Sie in Eclipse ein CVS-Tag auf das Projekt (RELEASE_0.0.1_init). b. Öffnen Sie die Webseite http://hostname/updates/admin. c. Geben Sie den in Schritt 10 definierten Benutzernamen und das Passwort ein. d. Erstellen Sie ein erstes Full Release für alle Benutzergruppen. 2
Checkliste: Update und Knowledge Base Server 1. Systemvoraussetzungen des VMware-Servers überprüfen a. VMware-Serversystem ist aufgesetzt und bereit: VMware-Server VMware-ESX b. VMware-Server IP-Adresse oder Hostname: c. Perspectix erhält Zugriff auf die VMware-Konsole: Ja (IP:, Login:, Passwort: ) Nein 2. Hardwarevoraussetzungen des VMware-Servers überprüfen a. Mindestens 1 GHz Intel Prozessor: Ja. Prozessortyp: b. Mindestens 512 MB Speicher für das VMware-Image: Ja. Speicher: MByte c. Mindestens 20 GB Harddisk-Kapazität (für Release-Historie): Ja. Harddisk-Kapazität: GByte Der Disk ist für das VMware-Image expandierbar eingerichtet Hinweis: Dies ist bei einem ESX-Server nicht möglich. In diesem Fall muss später immer manuell expandiert werden. d. Harddisk-Kapazität wird verfügbar gemacht via: Network-Share (Protokoll: ) VM-Disk Partition: Mount-Point: 3. VMware-Image einrichten a. Gemeinsames Einspielen des von Perspectix gelieferten VMware-Images: VMware-Image wurde erfolgreich eingespielt. Netzwerk wurde eingestellt. IP-Adresse: DNS-Server 1: DNS-Server 2: Gateway: Netzmaske: Sudo-Benutzer für Perspecitx wurde eingerichtet: 3
account name: password: Firewall wurde so eingestellt, dass Benutzer auch von ausserhalb des Firmennetzwerks auf den Update Server via HTTP/HTTPS zugreifen können. Firewall wurde so eingestellt, dass Perspectix auch von ausserhalb des Firmennetzwerks auf den Update Server via SSH zugreifen kann. 4. IT-Umgebung des Systems einrichten a. Zugriff auf Update Server via SSH: Wurde für oben genannten sudo-user eingerichtet auf dem Server. Wurde für oben genannten sudo-user eingerichtet in der Firewall. Wurde für die P'X5-Autoren-User eingerichtet auf dem Server. Wurde für die P'X5-Autoren-User eingerichtet in der Firewall. b. Zugriff auf Update Server via HTTP und HTTPS für Updates und Erstellung der Releases: Wurde eingerichtet in der Firewall für alle von überall. 5. System warten a. Backup der Daten: Ein Backup-System wurde eingerichtet. Kurzbeschreibung: Ein regelmässiger Backup-Prozess wurde angelegt. Häufigkeit vom Full Backup: Häufigkeit vom Incremental Backup: Welche Partitionen/Pfade werden im Backup berücksichtigt: Verantwortlicher beim Kunden für die Backups: Stellvertreter des Backupverantwortlichen: b. Pflege des Betriebssystems: Automatische Updates des Ubuntu Linux-Systems wurden durch Perspectix eingerichtet und initial geprüft. Verantwortlicher beim Kunden für die Wartung des Betriebssystems: 4
Update und Knowledge Base Server migrieren Voraussetzungen SSH-Zugang zum Update Server (eingehend). SSH-Zugang vom Update Server (ausgehend) zu old.updateserver.com. Alle Autoren müssen im Voraus benachrichtigt werden, dass es einen Wechsel des CVS-Servers geben wird und dass Sie alle Änderungen bis zu einer bestimmten Uhrzeit am Tag der Migration einchecken müssen. Sie müssen das Passwort für den sudo-benutzer 'pxadmin' auf dem Update Server kennen. So bereiten Sie die Migration vor 1. Loggen Sie sich am Update Server mit SSH und dem Benutzer 'pxadmin' ein. 2. Gehen Sie zu /srv und erstellen Sie eine Sicherungskopie des Ordners px5-cvsroot in dem Sie die folgenden tar-befehle ausführen: cd /srv sudo tar cvfz /tmp/px5-cvsroot.tar.gz px5-cvsroot 3. Löschen Sie den Inhalt des Verzeichnises px5-cvsroot mit dem folgenden Befehl: sudo rm -rf /srv/px5-cvsroot/* 4. Gehen Sie zum Ordner px5-cvsroot: cd /srv/px5-cvsroot 5. Synchronisieren Sie die CVS-Daten aus der alten CVS-Umgebung mit dem Befehl rsync: sudo rsync -av --rsh=ssh perspectix@hsappl02:/srv/px5-update-server/cvsroot/ /srv/px5-cvsroot/ Hinweis: Stellen Sie sicher, dass Sie your_username mit dem Benutzernamen auf old.updateserver.com ersetzen. 6. Die Synchronisation dauert eine Weile (z.b. 6 GB Daten brauchen länger als 3 Stunden). Eine Liste von synchronisierten Dateien erscheint in der Zwischenzeit. Hinweis: Während dieses Prozesses werden die Benutzer noch mit der alten CVS-Umgebung auf old.updateserver.com arbeiten (ein-/auschecken). Das heisst, dass am Ende der Synchronisation mit rsync die Kopie schon veraltet sein könnte. So synchronisieren Sie später vor dem eigentlichen Wechsel zum neuen Update Server Führen Sie die Schritte im Abschnitt "So bereiten Sie die Migration vor" nochmal durch: 1. Loggen Sie sich am neuen update3 Server mit 'pxadmin' (.pxadmin) oder mit 'perspectix' ein. 2. Gehen Sie zum Ordner /srv/px5-cvsroot. 3. Synchronisieren Sie: sudo rsync -av --rsh=ssh perspectix@hsappl02:/srv/px5-update-server/cvsroot/ /srv/px5-cvsroot/ Hinweis: Stellen Sie sicher, dass Sie die abschliessenden Schrägstriche eingeben. So schneiden Sie die Benutzer ab und schliessen die Übergabe ab 1. Stellen Sie sicher, dass alle eingecheckt sind und niemand die CVS-Repositories in der alten Umgebung verwendet. 5
2. Sagen Sie den Benutzern, dass Sie ungefähr eine Stunde brauchen, um die Übergabe abzuschliessen. 3. Führen Sie den Befehl rsync aus Schritt 5 im Abschnitt "So bereiten Sie die Migration vor" oben nochmal durch, um sicherzustellen, dass Sie wieder aktuell sind und dass die letzten Check-Ins übermittelt wurden. 4. Um sicherzustellen, dass niemand mit den alten Daten arbeitet, benennen Sie die Repositories in der alten CVS-Umgebung auf old.updateserver.com um oder sagen Sie dem Administrator er soll die alte CVS-Umgebung deaktivieren (nicht löschen). Sie könnten die Passwörter der Benutzer ändern oder sie vorläufig deaktivieren. So setzen Sie den CVS Server im Update Server auf Die Benutzer sind wahrscheinlich noch nicht auf dem Update Server aufgesetzt. 1. Erstellen Sie die notwendigen Benutzer (für P'X Benutzer gibt es ein generisches 'px' Benutzerkonto, aber einzelne Konten sind netter) mit useradd: sudo useradd -d /home/toni -g 502 -m -s /bin/bash [-u 1006] toni Hinweis: Stellen Sie sicher, dass Sie den Benutzer 'toni' mit den passenden Benutzernamen am Ende des Befehls und im Hauptverzeichnisteil nach dem -d ersetzen. Stellen Sie auch sicher, dass 1002 wirklich die Gruppen-ID ist in der der Benutzer 'px' ist. Um die Gruppen-ID zu prüfen, suchen Sie die Gruppe 'px' in der Datei /etc/groups. 2. Setzen Sie das Passwort für den Benutzer mit dem Befehl passwd: sudo passwd toni Hinweis: Stellen Sie sicher, dass Sie den Benutzernamen 'toni' mit den passenden Benutzernamen ersetzen. 3. Setzen Sie den Besitzer und die Gruppe des Ordners /srv/px5-cvsroot so, dass andere Benutzer Ihre Dateien ein- und auschecken können (dies funktioniert weil die Sticky-Bits bereits in den Daten, die von der Umgebung chroot übermittelt wurden, gesetzt sind): sudo chown -R px.px /srv/px5-cvsroot So sagen Sie den Benutzern wie sie Ihre Eigenschaften ändern sollen Sagen Sie den Benutzern bei Perspectix und beim Kunden wie Sie Ihre Referenz zu den CVS-Repositories ändern. Sagen Sie den Autoren beim Kunden, dass Sie die folgenden Schritte ausführen sollen: 1. Starten Sie die Authoring Workbench und öffnen Sie die Registerkarte CVS Repository Exploring. 2. Klicken Sie mit der rechten Maustaste in das Fenster CVS Repositories links und wählen Sie im Kontextmenü New > Repository Location. 3. Geben Sie die folgenden Daten ein: Host: the_new_update_server_hostname(fqdn) Repository Path: /srv/px5-cvsroot User: your_user_name (Benutzername des Autors) Password: 6
Setzen Sie Connection Type auf extssh. Wählen Sie das Kontrollkästchen Save Password, um das Passwort zu speichern. 4. Geben Sie das Passwort ein wenn Sie danach gefragt werden. 5. Öffnen Sie die Registerkarte VCML. 6. Klicken Sie mit der rechten Maustaste in Ihr Projekt-Repository (tun Sie das gleiche für jede Projekt-Repository, die auf Ihren Update Server übermittelt wurde) und wählen Sie im Kontextmenü Properties. 7. Wählen Sie im Pop-up-Fenster im Menü links CVS. 8. Klicken Sie auf Change Sharing und wählen Sie das Kontrolkästchen Show only compatible repository locations ab. 9. Wählen Sie die kürzlich erstellte neue Repository-Verbindung in der Liste und klicken Sie auf OK. 10. Bestätigen Sie die Änderung des Repository-Ortes wenn Sie danach gefragt werden. 11. Überprüfen Sie ob der Name des CVS-Servers, der in eckigen Klammern [] neben dem Projekt- Repository angezeigt wird, mit dem neuen Namen des Update Servers ersetzt wurde. 12. Testen Sie die Verbindung in dem Sie das Projekt synchronisieren. 7