MASCH CM Studio Installation auf Apple MAC OS/X Server ab Version 10.6.x

Transkript

1 Einführung Diese Dokumentation schafft Ihnen einen detaillierten Überblick zur Installation von unter Mac OS/X Folgende Systemvoraussetzungen sind für den Betrieb von erforderlich: Apache ab Version 2.2.x Zend Server Community Edition basierend auf PHP für MAX OS/X MySQL 5.0.x SMTP fähigen Mail-Server, der für das Weiterleiten von Benachrichtigungen verwandt werden darf. Das MAC OS/X Server-Betriebssystem in der Version 10.6 wird mit folgenden vorinstallierten Systemkomponenten durch Apple ausgeliefert: Apache PHP MySQL Mail-Server FTP-Server Die vorinstallierten Softwaremodule können innerhalb die graphischen Oberfläche über das Tool Server Admin weitestgehend äußerst benutzerfreundlich verwaltet werden. Falls die Möglichkeiten des Server Admin nicht ausreichen, muss man auf die Konsole zurückgreifen. wird mit kompiliertem Quellcodes ausgeliefert um somit eine performante Ausführung der Anwendung zu garantieren. Da PHP in der Version noch im Experimentalzustand und damit ausschließlich im Open-Source Verfahren von Zend Technologies behandelt wird, steht hier zur Zeit kein Zend Optimizer zur Verarbeitung des kompilierten Quellcodes zur Verfügung. Aus diesem Grund ist es für den Einsatz von erforderlich den Zend Server in der kostenlosen Community Edition (auch Zend Server CE genannt) basierend auf PHP für MAC OS/X zu installieren. Der Zend Server CE beinhaltet alle erforderliche PHP-Extensions und den Optimizer (GuardLoader), der in der Lage ist, die kompilierten Quellcodes auszuführen. Falls der vom MAC OS/X vorinstallierte Apache-Server nicht für andere Anwendungen bereits verwendet wird, kann man diesen deaktivieren und den Apache-Server, der mit dem Zend Server CE mitgeliefert wird, auf dem Default WEB-Port 80 laufen lassen. Falls Sie den vom MAC OS/X 10.6 vorinstallierten Apache-Server jedoch bereits für andere Anwendungen verwendet wird, dann muss der vom Zend Server CE mitinstallierte Apache auf einen alternativen Kommunikations-Port umgestellt werden. Seite 1/22

2 Der Zend Server CE installiert ebenfalls einen eigenen MySQL Server. Dieser MySQL Server muss unmittelbar nach der Installation des Zend Server CE deaktiviert werden, damit der vom MAC OS/X 10.6 vorinstallierte MySQL Server fehlerfrei weiterarbeiten kann. Theoretisch kann man auch den MySQL Server aus der Zend Server Community Edition verwenden. Wir empfehlen dies aber nicht, da dieser MySQL Server per Default für Debugzwecke voreingestellt ist und daher eine umfangreiche und zeitraubende Anpassung der Konfigurationsparameter erforderlich wären. Installationsschritte Bitte führen Sie alle Installationsschritte, die im folgenden beschrieben sind unter Verwendung des Benutzers root aus. Wenn Sie das Passwort von root nicht manuell verändert haben ist es identisch mit dem Ihres Administrators auf dem Server. Alle Konfigurationsdateien, wie z.bsp. die PHP- und MySQL Konfigurationsdateien haben den Benutzer root als Besitzer und können folgerichtig nur von root geändert werden. Schritt 1: Herunterladen der erforderlichen Software und Installations-Tools mucommander Der mucommander ist ein Dateimanager und Texteditor, der es Ihnen erlaubt, die Systemdateien komfortabel zu editieren. Falls die Installation dieses Editors nicht gewünscht ist, kann man die Systemdateien selbstverständlich auch über den Konsole-Editor VI oder jegliches andere ASCII-Editor- Tool, dass Sie bereits verwenden, anpassen. Website: Direkter Download-Link: Zend Server Community Edition basierend auf PHP für MAC OS/X Der Zend Server CE bildet die für notwendige WEB-Server Umgebung. Website: Direkter Download-Link: Installation Guide: Seite 2/22

3 Mit Ihrer Lizenzbestätigung haben Sie den Link zum Download Ihrer ESD-Lizenz von MASCH CM Studio erhalten. Die Zip Datei müssen Sie vor der Installation vollständig auf den Server herunterladen. Schritt 2: Stoppen und Vorbereiten der auf dem MAC OS/X Server vorinstallierten Apache- und MySQL-Serveranwendungen Stoppen des Apache-Servers Gehen Sie in den Server Admin und wählen Sie den Eintrag Web aus. Hier können Sie mit dem Button Stop Web am unteren Bildschirmrand den Apache-Server stoppen. Seite 3/22

4 Stoppen des MySQL-Servers Gehen Sie in den Server Admin und finden Sie den Eintrag MySQL und verfahren Sie über den Button Stop MySQL analog wie zuvor beim Stoppen des Apache-Servers. Falls Sie den MySQL schon für eine Anwendung verwenden, kennen Sie auch sicherlich das Kennwort von dem Benutzer root des MySQL-Servers (Bitte beachten Sie, dieser root -User auf dem MySQL Server ist nicht identisch mit dem Apple OS/X System-Account root ). Falls Sie das Kennwort noch nicht verwendet haben, jetzt ist die Zeit, es festzulegen. Das Kennwort kann nur im gestoppten Zustand des MySQL- Servers festgelegt werden. Dafür betätigen Sie die Taste Set MySQL root Password. Bitte starten Sie nach Definition des Kennwortes den MySQL nicht noch einmal, solange die Installation des Zend Server CE nicht abgeschlossen wurde und solange Sie den MySQL-Server, der mit der Zend Server CE Installation mitgeliefert wird, nicht ebenfalls deaktiviert wurde. Seite 4/22

5 Schritt 3: Installation der Software mucommander Die Software wird als DMG ausgeliefert. Nach dem Download klicken Sie bitte auf die DMG-Datei und folgen Sie den Installationsanweisungen. Nach Abschluss dieser Installation, kann die Anwendung vom Folder Applications oder im deutschen Programme gestartet werden. Seite 5/22

6 Zend Server Community Edition basierend auf PHP für MAC OS/X Die Software wird ebenfalls als DMG-Datei ausgeliefert. Nach dem Download klicken Sie bitte auf die DMG-Datei und folgen Sie den Installationsanweisungen. Während der Installation werden keine Parameter konfiguriert. Die Konfigurationseinstellungen müssen im Anschluss an die installation manuell eingestellt werden. Seite 6/22

7 Nach der Installation finden Sie ein ICON ZendServer im Ordner Programme. Dieses Icon/Link ruft die WEB-basierende Verwaltungskonsole auf. Beim ersten Aufruf müssen Sie den Lizenzbestimmungen von Zend Technologies zustimmen und das Kennwort für den Zend Server Administrator festlegen. Nach dem Einloggen gelangen Sie in den folgenden Dialog: Seite 7/22

8 Gehen Sie nun bitte zu Configure Zend Server Components und aktivieren Sie den Zend Guard Loader durch die Option Turn On. Danach betätigen Sie die Taste Restart PHP um sowohl den Apache Server als auch die PHP-Installation neu zu starten. Nun müssen einige PHP-Konfigurationsparameter angepasst werden. Der Konfigurationsmanager des Zend Server CE ermöglicht es Ihnen in benutzerfreundlicher Art dies durchzuführen, anstatt die Datei php.ini direkt manuell anzupassen. Dafür wechseln Sie zu dem Aktenreiter Directives. Seite 8/22

9 Folgende Parameter müssen angepasst werden: upload_max_filesize post_max_size max_execution_time max_input_time memory_limit mysql.default_socket Geben Sie den Text upload_max_filesize in das Suchfeld ein. Der Parameter wird gefunden und sein zugehöriger Wert wird angezeigt. Der aktuelle Wert ist 2M. Bitte ändern Sie diesen auf 200M und sagen Sie Save Changes. Geben Sie den Text post_max_size in das Suchfeld ein. Der Parameter wird gefunden und sein zugehöriger Wert wird angezeigt. Der aktuelle Wert ist 8M. Bitte ändern Sie diesen auf 200M und sagen Sie Save Changes. Geben Sie den Text max_execution_time in das Suchfeld ein. Der Parameter wird gefunden und sein zugehöriger Wert wird angezeigt. Der aktuelle Wert ist 30 Sekunden. Bitte ändern Sie den Wert auf 2000 Sekunden und sagen Sie Save Changes. Geben Sie den Text max_input_time in das Suchfeld ein. Der Parameter wird gefunden sein zugehöriger Wert wird angezeigt. Der aktuelle Wert ist 60 Sekunden. Bitte ändern Sie den Wert auf 2000 Sekunden und sagen Sie Save Changes. Seite 9/22

10 Geben Sie den Text memory_limit in das Suchfeld ein. Der Parameter wird gefunden sein zugehöriger Wert wird angezeigt. Der aktuelle Wert ist 128M. Bitte ändern Sie diesen auf 512M und sagen Sie Save Changes. Geben Sie den Text mysql.default_socket in das Suchfeld ein. Der Parameter wird gefunden sein zugehöriger Wert wird angezeigt. Der aktuelle Wert ist: /usr/local/zend/mysql/tmp/mysql.sock Dies ist für den Fall, wenn der mitgelieferte MySQL-Server des Zend Server CE verwandt wird. Da wir den vom MAC OS/X Server vorinstallierten MySQL-Server verwenden, müssen wir diesen Wert auf ändern. Dann sagen Sie Save Changes. /var/mysql/mysql.sock Danach betätigen Sie die Taste Restart PHP um den Apache-Server sowie die PHP-Installation neu zu starten. Stoppen und Deaktivieren des vom Zend Server CE mitgelieferten MySQL-Server Nun kann und muss der vom Zend Server CE mitgelieferte MySQL Server gestoppt werden. Dafür müssen Sie einen Stop-Script, das mit dem Zend Server CE ausgeliefert wird, in der Termial-Konsole ausführen. Bitte gehen Sie in die Konsole und verwenden Sie als Login den root User des MAC OS/X Serverbetriebssystems. Seite 10/22

11 Bitte führen Sie den folgenden Script aus: /usr/local/zend/mysql/bin/mysql.server stop Anpassen der Apache Konfigurationsdatei Der vom Zend Server CE mitgelieferte Apache-Server läuft default-mäßig auf folgenden Ports: Administrationskonsole: Port Website: Port Die Konfigurationsdatei des Apache-Servers befindet sich hier: /usr/local/zend/apache2/conf/httpd.conf Bevor Sie diese Datei anpassen, müssen Sie für sich eine wichtige Frage beantworten. Wird der Apache vom MAC OS/X Server verwendet? Brauche ich ihn? Wenn JA, dann müssen Sie sich für die Anwendung für einen abweichenden Port entscheiden, da der Standard-Port 80 bereits vom Apache-Server des MAC OS/X Server verwendet wird. Sagen wir, wir nehmen den Port 81. Seite 11/22

12 Folgende Einträge müssen angepasst werden: Alter Wert Listen #ServerName Neuer Wert Listen 81 ServerName localhost:81 Wenn NEIN, dann können Sie den Port 80 für die Installation des s verwenden. Alter Wert Listen #ServerName Neuer Wert Listen 80 ServerName localhost:80 Die Konfigurationsdatei können Sie auf zwei Arten anpassen: Im Terminal über VI Editor In der Graphischen Oberfläche über den oben beschriebenen mucommander. Anpassung über den mucommander Gehen Sie zu der Datei /usr/local/zend/apache2/conf/httpd.conf Markieren Sie die Datei httpd.conf und verwenden Sie die F4-Taste auf Ihrer Tastatur. Über F4 können Sie jede ASCII-Konfigurationsdatei öffnen und editieren. Finden Sie die Stellen, wo die oben angegebenen Anpassungen gemacht werden sollen, und nehmen Sie diese vor. Dann sagen Sie File Save. Seite 12/22

13 Anpassung über den Terminal-Editor VI Bitte gehen Sie in die Konsole mit dem root Benutzer rein und führen Sie diesen Befehl aus. vi /usr/local/zend/apache2/conf/httpd.conf. Die Konfigurationsdatei wird geöffnet. Mit der Pfeiltaste gehen Sie runter bis zu der Zeile Listen Positionieren Sie den Cursor an Anfang der Portnummer: Drucken Sie die Taste x um das aktuelle Zeichen unter dem Cursor zu löschen. Wiederholen Sie dies, bis die Nummer komplett gelöscht ist. Seite 13/22

14 Drucken Sie die Taste i um in den Einfügemodus zu gehen. Geben Sie die Nummer 80 oder eine andere Nummer, falls der Port anders sein soll. Dann drücken Sie die Taste ESC und den Einfügemodus zu verlassen. Mit der Pfeiltaste bewegen Sie den Cursor nach unten bis zu der Zeile #ServerName Positionieren Sie den Cursor an den Anfang der Zeile. Das Symbol # bedeutet, dass diese Zeile auskommentiert und damit nicht aktiv ist. Löschen Sie das Symbol # und den Text mit der Taste x. Drucken Sie die Taste i um in den Einfügemodus zu wechseln. Geben Sie als Servername Seite 14/22

15 ServerName localhost:80 Anstatt 80 verwenden Sie eine alternative Port-Nummer, falls nicht der Port 80 verwendet werden soll. Falls Sie den Hostnamen oder die IP Adresse des Servers kennen, können Sie diese anstatt localhost direkt angeben. Dann drücken Sie die Taste ESC und den Einfügemodus zu verlassen. Geben Sie den Befehl: :wq um die Änderungen zu speichern und den Editor zu verlassen. w steht für write (schreiben) und q für quit (verlassen). Seite 15/22

16 Danach kehren Sie in die Konsole zurück. Sie erhalten keine Bestätigung, dass die Änderungen gespeichert wurden. Das ist prinzipiell in Ordnung, da der VI-Editor keine Bestätigungsmeldungen vorgesehen hat. Neustart des Apache-Servers Der mit dem Zend Server CE mitgelieferte Apache-Server muss nun unter Verwendung der zugehörigen Scripts wie folgt neu gestartet werden: /usr/local/zend/apache2/bin/apachectl stop /usr/local/zend/apache2/bin/apachectl start Seite 16/22

17 Bitte wechseln Sie wiederum in die Konsole, verwenden Sie für das Login den root Benutzer und führen Sie die oben genannten Scripts aus. Seite 17/22

18 Installation von Bitte klicken Sie mit der rechten Maustaste auf das heruntergeladene ZIP Archiv mit der Bezeichnung Cmstudio_ce_2012_macintosh.zip und verwenden Sie die Option Öffnen mit - Archiv Utility. Der Inhalt des ZIP-Archivs wird in ein gleichnamiges Verzeichnis entpackt. Dieses installatins Verzeichnis enthält die Anleitungen sowie die Anwendungs- und Koinfigurationsdateien. Bitte lesen Sie die Installationsanleitung. Die Anwendungsdateien check.php installer.php cmstudio_setup.zip müssen in das Dokumentenverzeichnis des WEB Servers kopiert werden. Da dieses Dokumentenverzeichnis im Systembereich liegt, können Sie dies nicht mit dem StandardDateimanager Ihres Mac-Servers durchführen. Dafür verwenden Sie wiederum entweder den oben beschriebenen mucommander oder im Terminal-Modues den Copy-Befehl. Das Dokumentenverzeichnis des Apache-Servers liegt an folgender Position: /usr/local/zend/apache2/htdocs Seite 18/22

19 So lauten die notwendigen Copy Befehle: cp /<pfad>/cmstudio_ce_2012_macintosh/check.php /usr/local/zend/apache2/htdocs cp /<pfad>/cmstudio_ce_2012_macintosh/installer.php /usr/local/zend/apache2/htdocs cp /<pfad>/cmstudio_ce_2012_macintosh/cmstudio_setup.zip /usr/local/zend/apache2/htdocs Löschen Sie die bestehende Datei index.html mit dem Befehl rm /usr/local/zend/apache2/htdocs/index.html Seite 19/22

20 Im mucommander soll man einfach das Quell- und das Zielverzeichnis in zwei Panels aufmachen und über den Copy Befehl (F5) die Dateien vom Quell- in das Zielverzeichnis kopieren. Nun haben Sie alle Vorbereitungen abgeschlossen und wir können zur eigentlichen Installation des übergehen. Die Datei check.php dient zur Überprüfung der allgemeinen Voraussetzungen. Die Datei installer.php dient zum Entpacken der Anwendungsdateien, die sich in der Datei cmstudio_setup.zip befinden. Dabei erreichen wir, dass die entpackten Dateien den Apache-ProzessUser als Besitzer erhalten und somit keine Probleme mit den Zugriffsrechten zu erwarten sind. Starten Sie den Browser auf Ihrem Server und verwenden Sie den folgenden Befehl: Falls Sie die Installation von einem anderen Arbeitsplatz nun ausführen wollen, starten Sie den Browser und verwenden Sie den folgenden Befehl: Falls Sie einen anderen Port verwenden, dann modifizieren Sie den Befehl wie folgt: Seite 20/22

21 Sie sollten folgendes Ergebnisse erhalten: Nun, starten Sie den installer.php. Sie bekommen die Meldung Der Installer hat keine Schreibberechtigungen auf das Zielverzeichnis der Anwendung: /usr/local/zend/apache2/htdocs Bitte geben Sie die Schreibrechte dem Benutzer des WEB Servers auf dieses Verzeichnis Seite 21/22

22 Dies muss aus folgendem Grund erfolgen: Der Besitzer des Verzeichnis htdocs, ist der root User. Der Apache WEB Server läuft aber unter dem Benutzer daemon. Der Benutzer daemon muss Schreibrechte auf das Verzeichnis erhalten. Der einfachste Wege dies zu erledigen, ist der folgende Befehl: chmod 0777 /usr/local/zend/apache2/htdocs Führen Sie diesen in der Konsole aus. Laden Sie danach die Installer-Datei neu. Die Meldung sollte dann verschwinden und die Installation kann ungehindert weiter fortgeführt werden. Folgen Sie den Anweisungen innerhalb der MASCH CM Studio -Installation, nähere Informationen zu der allgemeinen Installation finden Sie in der beigefügten Installationsanleitung. Seite 22/22