MASCH CM Studio Installation auf einem Linux Server. Für den schnellen Einstieg! (am Beispiel von Suse Linux Enterprise Server 11.

Transkript

1 (am Beispiel von Suse Linux Enterprise Server 11.1) Für den schnellen Einstieg!

2 Copyright : OOO MASCH Russland Software & Consulting Services St. Petersburg 4. Auflage 2013 Dieses Dokument wurde vor der Freigabe des Produkts erstellt. Es kann daher nicht garantiert werden, dass alle hier enthaltenen Details dem endgültig ausgelieferten Produkt genau entsprechen. Die in diesem Dokument enthaltenen Informationen stellen die behandelten Themen aus der Sicht von OOO MASCH Russland zum Zeitpunkt der Veröffentlichung dar. Da OOO MASCH Russland auf sich ändernde Marktanforderungen reagieren muss, stellt dies keine Verpflichtung seitens OOO MASCH Russland dar, und OOO MASCH Russland kann die Richtigkeit der hier dargelegten Informationen nach dem Zeitpunkt der Veröffentlichung nicht garantieren. Die Informationen beziehen sich auf das Produkt zum Zeitpunkt des Drucks dieses Dokuments und sollten nur für Planungszwecke verwendet werden. Diese Informationen können jederzeit ohne vorherige Ankündigung geändert werden. Dieses Dokument dient nur zu Informationszwecken. OOO MASCH RUSSLAND SCHLIESST FÜR DIESES DOKUMENT JEDE GEWÄHRLEISTUNG AUS, SEI SIE AUSDRÜCKLICH ODER KONKLUDENT OOO MASCH Russland Software & Consulting Services. Alle Rechte vorbehalten. Die in diesem Dokument aufgeführten Namen bestehender Firmen und Produkte sind möglicherweise Marken der jeweiligen Eigentümer. ООО "МАШ Руссланд - программное обеспечение и консалтинговые услуги" Измайловский проспект 22а Санкт-Петербург, Россия Seite 2/15

3 Einführung Diese Dokumentation verschafft Ihnen einen detaillierten Überblick zur Installation CM Studio 2012 auf einem Linux Server am Beispiel von SuSE Linux Enterprise Server von Folgende Systemvoraussetzungen sind für den Betrieb von CM Studio 2012 erforderlich: Apache ab Version 2.2.x PHP 5.2.x (Version 5.3.x ist ungeeignet wegen fehlendem Zend Optimizer) MySQL 5.0.x SMTP fähigen Mail-Server, der das Weiterleiten von Benachrichtigungen durchführen kann. Alle hier genannten Pakete sind in der Regel in jedem Linux Distributiv enthalten und können entweder bereits während der Installation oder zu einem späteren Zeitpunkt über die Option Software installieren ausgewählt werden. Seite 3/15

4 Installation der erforderlichen Software für MASCH CM Studio unter Linux Server-Betriebssystem 1. Apache WEB Server Bitte vergewissern Sie sich, dass folgende Komponenten auf Ihrem Linux-Server installiert sind. Falls diese bei Ihnen nicht ausgewählt sind, klicken Sie diese bitte an und schließen die Auswahl mit Übernehmen ab. Nach erfolgreicher Installation der hier gezeigten Komponenten muss der Apache WEB Server gestartet bzw. neu gestartet werden. Dazu wechseln Sie bitte in den Terminal-Modus um die entsprechenden Start-Kommandos auszuführen. Bitte melden Sie sich als root -User im Terminal an. Dies können Sie mit folgendem Kommando erreichen: # su root passwort # {jetzt geben Sie das passwort ein} Achtung! Das hier gezeigte # stellt den Kommando-Prompt des Terminals dar und gehört nicht zu Ihrer Eingabe! Folgende Befehle zum Starten bzw. Anhalten des Apache Web-Servers stehen Ihnen zur Verfügung: /usr/sbin/apache2ctl stop /usr/sbin/apache2ctl start /usr/sbin/apache2ctl restart Bitte beachten Sie, dass sich in anderen Linux Versionen sowohl die Pfade als auch die Kommando- Befehle unterscheiden können. Seite 4/15

5 2. PHP 5.2.x Bitte vergewissern Sie sich, dass folgende Komponenten auf Ihrem Linux-Server installiert sind. Falls diese bei Ihnen nicht ausgewählt sind, klicken Sie diese bitte an und schließen die Auswahl mit Übernehmen ab. Bitte beachten Sie, dass Sie die Version 5.2.x von PHP verwenden müssen. Unter der Version PHO 5.3.x ist die CM Studio Anwendung nicht ohne spezielle Unterstützung des MASCH Supports lauffähig, da es keinen ZEND Optimizer für diese Version gibt, der out-of-the-box in eine beliebige Apache/PHP Konstellation installiert und integriert werden kann. Wenn die oben gezeigten Software-Komponenten erfolgreich installiert sind, müssen Sie noch einige PHP-Konfigurationsparameter anpassen. Dafür ist es erforderlich die Config-Datei PHP.INI mit einem Text-Editor zu öffnen und die entsprechenden Änderungen vor zu nehmen. Das können Sie einfach durch den folgenden Terminal-Befehl erledigen: vi /etc/php5/apache2/php.ini Bitte beachten Sie, dass sich in anderen Linux Versionen sowohl die Pfade als auch die Kommando- Befehle unterscheiden können. Die Datei wird im VI Editor aufgemacht. Drücken Sie bitte die Taste i um in den Einfügemodus zu aktivieren. Im Einfügemodus können Sie die erforderlichen Änderungen vornehmen. Wenn Sie fertig sind, drücken Sie die Esc -Taste um den Einfügemodus zu beenden. Mit dem Befehl :wq schreiben Sie die Änderungen in die Datei und verlassen den VI-Editor. Seite 5/15

6 Folgende Parameter müssen von Ihnen angepasst werden: upload_max_filesize post_max_size max_execution_time max_input_time memory_limit mysql.default_socket upload_max_filesize : post_max_size max_execution_time max_input_time memory_limit Bitte ändern Sie diesen auf 200M. Bitte ändern Sie diesen auf 200M. Bitte ändern Sie den Wert auf 2000 (Sekunden). Bitte ändern Sie den Wert auf 2000 (Sekunden). Bitte ändern Sie diesen auf 512M. Danach muss der Apache WEB Server gestartet bzw. neu gestartet werden. Das können Sie ebenfalls im Terminal durchführen. Bitte melden Sie sich als wieder als root -User im Terminal an, wenn Sie nicht bereits angemeldet sind. Folgende Befehle stehen Ihnen zur Verfügung: /usr/sbin/apache2ctl stop /usr/sbin/apache2ctl start /usr/sbin/apache2ctl restart Bitte beachten Sie, dass sich in anderen Linux Versionen sowohl die Pfade als auch die Kommando- Befehle unterscheiden können. Seite 6/15

7 3. PHP ZEND Optimizer Der ZEND Optimzer ist erforderlich, um die verschlüsselten Dateien der CM Studio Anwendung laufen zu lassen. Der ZEND Optimzer wird nicht standardmäßig mit einem Linux OS ausgeliefert und muss gesondert heruntergeladen und installiert werden. MASCH empfiehlt den Einsatz von PHP 5.2.x unter Linux, da die CM Studio Anwendungen als compilierte und verschlüsselter Code ausgeliefert werden. Dies macht den Einsatz des ZEND Optimizer für PHP notwendig. Der ZEND Optimizer für PHP 5.3.x ist nicht in vollem Umfang für alle Linux Derivate verfügbar und supportet somit nicht die notwendige Technologieplattform für die CM Studio Anwendungen unter PHP 5.3.x. Wenn es Ihnen nicht möglich ist, PHP 5.2.x auf Ihrem Server in Betrieb zu nehmen, dann nehmen Sie bitte Kontakt mit unserem Support auf, damit wir gemeinsam mit Ihnen eine entsprechende Installations-Umsetzung durchführen können Verwenden Sie hierzu bitte unser Support-Online- Formular unter Falls Sie über eine PHP 5.2.x Installation verfügen, werden wir Ihnen hier am Beispiel des genannten SuSE Linux Enterprise Servers in der Version 11.1 die Installation des ZEND Optimizer erläutern. Bei anderen Linux Varianten können die Pfade und die Namen der Config-Dateien abweichen. 1. Beginnen Sie damit, das Sie in Ihrem Linux den 'Terminal'-modus starten 2. Sie befinden sich am Prompt (#) des Terminals, Bitte achten Sie darauf, dass Sie sich als 'root'-user im Terminal befinden! Wenn Sie nicht als 'root'user eingeloggt sind, loggen Sie sich mit dem Befehle: # su root und dem zugehörigen Passwort entsprechend ein! 3. Wechseln Sie mit folgendem Befehl in das Temp-Verzeichnis: # cd /tmp 4. Nunn müssen Sie den ZEND Optimizer herunterladen: o Wenn Sie eine 32-Bit Version des Linux-Servers installiert haben, dann verwenden Sie bitte folgendes Kommando: # wget o Wenn Sie eine 64-Bit Version des Linux-Servers installiert haben, dann verwenden Sie bitte folgendes Kommando: # wget 5. Entpacken Sie nun den Download-File: o 32-Bit Version: # tar -xzf ZendOptimizer linux-glibc23-i386.tar.gz o 64 bit Version: # tar -xzf ZendOptimizer linux-glibc23-x86_64.tar.gz Seite 7/15

8 6. Wechseln Sie nun in das Optimizer-Verzeichnis: o 32-Bit Version: # cd ZendOptimizer linux-glibc23-i386 o 64-Bit Version: # cd ZendOptimizer linux-glibc23-x86_64 7. Nun legen Sie bitte die benötigen Zielverzeichnisse an: 1. # mkdir /usr/local/zend 2. # mkdir /usr/local/zend/lib 8. Kopieren Sie die SO-Datei des ZEND Optimizers: # cp -rfv data/5_2_x_comp/zendoptimizer.so /usr/local/zend/lib 9. Auf den ZEND Optimizer müssen Sie nun in der Config-Datei PHP.INI einen Verweis definieren. Dazu nutzen Sie die VI-Editor: # vi /etc/php5/apache2/php.ini 10. Tragen Sie an das Ende der PHP.INI datei foglenden Eintrag ein: [Zend] zend_extension=/usr/local/zend/lib/zendoptimizer.so 11. Abschließend starten Sie den Apache Web-Server neu mit folgendem Kommando: # /usr/sbin/apache2ctl restart Bitte beachten Sie, dass sich in anderen Linux Versionen sowohl die Pfade als auch die Kommando- Befehle unterscheiden können. Seite 8/15

9 5. MySQL Datenbank Server Eine MySQL Datenbank ist erforderlich um die Daten der CM Studio Anwendung zu speichern. Bitte vergewissern Sie sich, dass folgende Komponenten auf Ihrem Linux-Server installiert sind. Falls diese bei Ihnen nicht ausgewählt sind, klicken Sie diese bitte an und schließen die Auswahl mit Übernehmen ab. Danach muss der MySQL Server gestartet bzw. neu gestartet werden. Das können Sie im Terminal- Modus durchführen. Bitte melden Sie sich als root#-user im Terminal an, wenn Sie nicht bereits angemeldet sind. Folgende Befehle stehen Ihnen zur Verfügung: /etc/init.d/mysql stop /etc/init.d/mysql start /etc/init.d/mysql restart Bitte beachten Sie, dass sich in anderen Linux Versionen sowohl die Pfade als auch die Kommando- Befehle unterscheiden können. Nun, wenn der MySQL Server gestartet ist, muss das Kennwort für den MySQL root Benutzer festgelegt werden. Per Default, hat der MySQL root Benutzer kein Kennwort, und dieser Zustand ist für PHP-Anwendungen aus Sicherheitsgründen nicht akzeptabel. Seite 9/15

10 Verwenden Sie bitte das Terminal und führen Sie die unten aufgeführten Kommandos durch: (Sie können die notwendigen Ergebnisse aus den aufgeführten Screen-Shots ersehen) 1. mysql -u root 2. use mysql 3. update user set password=password('ihr Passwort') where user='root'; 4. flush privileges; 5. exit Bitte überprüfen Sie nun, ob die Passwort-Änderung erfolgreich angenommen wurde, in dem Sie sich nun mit dem folgenden Kommando anmelden können: mysql -u root -p Wenn der MySQL Server Sie nun nach dem vorgewählten Passwort fragt und dieses nach Eingabe erfolgreich annimmt, können Sie die Überprüfung mit "exit" abschließen. Seite 10/15

11 6. Installation von MASCH CM Studio 2012 Bitte klicken Sie mit der rechten Maustaste auf das heruntergeladene ZIP Archiv mit der Bezeichnung: cmstudio_xxxxxxx_linux_xxxx.zip und verwenden Sie die im Linux Betriebssystem integrierte Entpack-Funktion von ZIP-Dateien: Der Inhalt des ZIP-Archivs wird in ein gleichnamiges Verzeichnis entpackt. Dieses Installationsverzeichnis enthält die Anleitungen sowie die Anwendungs- und Konfigurationsdateien. Bitte lesen Sie die Installationsanleitung aufmerksam durch. Die Anwendungsdateien check.php installer.php cmstudio_setup.zip müssen in das Dokumentenverzeichnis des WEB-Servers kopiert werden. Da dieses Dokumentenverzeichnis im Systembereich des Apache-Web-Servers liegt, können Sie dies nicht mit dem Standard-Dateimanager Ihres Linux-Servers durchführen. Dafür verwenden Sie wiederum den Terminal-Modus und den dort zu verwendenden Copy-Befehl. Das Dokumentenverzeichnis des Apache-Servers liegt an folgender Position: /srv/www/htdocs Bitte beachten Sie, dass sich in anderen Linux Versionen sowohl die Pfade als auch die Kommando- Befehle unterscheiden können. Seite 11/15

12 Die notwendigen Copy Befehle lauten: cp /<pfad>/cmstudio_xxxxxxx_linux_xxx/check.php /srv/www/htdocs cp /<pfad>/ cmstudio_xxxxxxx_linux_xxx/installer.php /srv/www/htdocs cp /<pfad>/ cmstudio_xxxxxxx_linux_xxx/cmstudio_setup.zip /srv/www/htdocs Nun haben Sie alle Vorbereitungen abgeschlossen und wir können zur eigentlichen Installation von MASCH CM Studio 2012 ü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. Mit dieser Vorgehensweise erreichen wir, dass auf die entpackten Dateien der Apache-Prozess-User als Besitzer übertragen wird 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: Sie sollten folgende Ergebnisse erhalten: Seite 12/15

13 Nun, starten Sie die Datei installer.php : Sie erhalten die Fehlermeldung: Der Installer hat keine Schreibberechtigungen auf das Zielverzeichnis der Anwendung: /srv/www/htdocs Bitte geben Sie die Schreibrechte dem Benutzer des WEB Servers auf dieses Verzeichnis. 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 wwwrun. Der Benutzer wwwrun muss Schreibrechte auf das Verzeichnis erhalten. Der einfachste Wege dies zu erledigen, ist der folgende Befehl: chmod 0777 /srv/www/htdocs Führen Sie diesen in der Konsole wie oben beschrieben aus erlaubt vollen Zugriff für alle. Bitte wenden Sie sich an Ihren System-Administrator, der die Berechtigungen gemäß der Sicherheitspolitik Ihres Servers präzise einstellen kann. Bitte beachten Sie, dass bei anderen Linux Betriebssystemen der Apache Benutzer abweichend von unserem Beispiel benannt sein kann. Laden Sie danach die Installer-Datei neu. Die Fehlermeldung sollte dann nicht mehr auftreten und die Installation kann ungehindert fortgeführt werden. Folgen Sie den Anweisungen innerhalb der CM Studio-Installation, nähere Informationen zu der allgemeinen Installation finden Sie in der beigefügten CM Studio Installationsanleitung. Seite 13/15

14 9. Einstellung des Überwachungsjob (nur bei CM Studio.E-ARCHIVE und CM Studio.DMS-SERVER notwendig) Der CM Studio Server beinhaltet in einigen vertikalen Produktversionen ein Überwachungsscript, mit dem externe Quellen wie FTP-Server oder File-Server überwacht und dort abgelegte Dokumente dann vom CM Studio Server in das jeweilige Archiv importiert werden können. Das Script besteht aus zwei Dateien /srv/www/htdocs/modules/dms-archives/check_for_new.php /srv/www/htdocs/modules/dms-archives/check_for_new.sh Diese müssen auf Ihre individuelle Installation angepasst werden. Öffnen Sie die Datei check_for_new.php im VI Editor mit dem folgenden Befehl: vi /srv/www/htdocs/modules/dms-archives/check_for_new.php Gehen Sie genau so vor, wie oben bei der Apache Konfigurationsdatei beschrieben ist. Ändern Sie die Zeile auf bzw. $DMS_HOST = " your host in check_for_new.php}/"; $DMS_HOST = " Host>/"; $DMS_HOST = " Host>:81/"; Falls der Port vom StandardWebport 80 abweicht, verwenden Sie zum Beispiel Port 81. Danach speichern Sie die Änderungen. Öffnen Sie die Datei check_for_new.sh im VI Editor mit folgendem Befehl: vi /srv/www/htdocs/modules/dms-archives/check_for_new.sh Löschen Sie den alten Inhalt und tragen Sie die Zeile ein: php -c /etc/php5/apache2 -f /srv/www/htdocs/modules/dms-archives/check_for_new.php > /srv/www/htdocs/modules/dms-archives/logs/`date +%H.%M.%S`.log Dann speichern Sie die Änderungen. Seite 14/15

15 Das Überwachungsscript soll periodisch alle X Minuten ausgeführt werden. Für diese Zwecke empfehlen wir den eingebauten CRON Scheduler. Der CRON Scheduler kann nur über die Konsole gesteuert werden. In diesem Zusammenhang müssen wir Sie auf einen wichtigen Security-Aspekt hinweisen. Wie oben bereits erwähnt, läuft der Apache-Prozess unter dem Benutzer wwwrun. Damit die Dokumente, die von externen Quellen ins Archiv importiert werden und für den Apache-Prozess schreibbar sind, muss der Benutzer wwwrun als Besitzer der Dokumente eingetragen sein. Dies ist dann möglich, wenn das Überwachungsscript auch unter dem Benutzer wwwrun ausgeführt wird. Das Script check_for_new.sh darf nicht per Default ausgeführt werden. Man muss also dem Benutzer wwwrun die Ausführungsrechte vergeben. Der einfachste Weg dies zu erledigen ist, die Ausführung des folgenden Befehls: chmod 0777 /srv/www/htdocs/modules/dms-archives/check_for_new.sh 0777 erlaubt vollen Zugriff für alle. Bitte wenden Sie sich an Ihren System-Administrator, der die Berechtigungen gemäß der Sicherheitspolitik Ihres Servers präzise einstellen kann. Dieser Befehl muss in der Konsole ausgeführt werden. Danach kann das Script check_for_new.sh in dem Scheduler CRON als JOB eingetragen werden. Dafür geben Sie den folgenden Befehl in der Konsole ein: crontab -u wwwrun -e Es öffnet sich der VI Editor mit einer leeren Konfigurations-Datei. Wechseln Sie in den Einfügemodus und tragen Sie die Zeile ein: */1 * * * * /srv/www/htdocs/modules/dms-archives/check_for_new.sh */1 bedeutet einen Überwachungszyklus von einer Minute. 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. Es kommt die Bestätigung. Nun ist MASCH CM Studio 2012 vollständig betriebsbereit. Greifen Sie auf die Online Hilfe zu, um sich mit dem System vertraut zu machen. Seite 15/15