Installationshandbuch Linux

Transcription

MASCH CM Studio 2013
Installation auf einem Linux Server
(am Beispiel von Suse Linux Enterprise Server 11.1)
Für den schnellen Einstieg!
© Copyright 2006 - 2013:
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.
© 2007 - 2013 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а
195005 Санкт-Петербург, Россия
Seite 2/15
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 11.1.
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
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 KommandoBefehle unterscheiden können.
Seite 4/15
2. PHP 5.2.x
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
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
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“ :
Bitte ändern Sie diesen auf „200M“.
„post_max_size“
„max_execution_time“
Bitte ändern Sie den Wert auf „2000“ (Sekunden).
„max_input_time“
Bitte ändern Sie den Wert auf „2000“ (Sekunden).
„memory_limit“
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
Seite 6/15
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-OnlineFormular unter http://www.masch.com/gourl.php?ulang=de&url=support_form.
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 http://downloads.zend.com/optimizer/3.3.9/ZendOptimizer-3.3.9-linuxglibc23-i386.tar.gz
o
Wenn Sie eine 64-Bit Version des Linux-Servers installiert haben, dann verwenden Sie
bitte folgendes Kommando:
# wget http://downloads.zend.com/optimizer/3.3.9/ZendOptimizer-3.3.9-linuxglibc23-x86_64.tar.gz
5. Entpacken Sie nun den Download-File:
o
o
32-Bit Version: # tar -xzf ZendOptimizer-3.3.9-linux-glibc23-i386.tar.gz
64 bit Version: # tar -xzf ZendOptimizer-3.3.9-linux-glibc23-x86_64.tar.gz
Seite 7/15
6. Wechseln Sie nun in das Optimizer-Verzeichnis:
o
o
32-Bit Version: # cd ZendOptimizer-3.3.9-linux-glibc23-i386
64-Bit Version: # cd ZendOptimizer-3.3.9-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
Seite 8/15
5. MySQL Datenbank Server
Eine MySQL Datenbank ist erforderlich um die Daten der CM Studio Anwendung zu speichern.
Danach muss der MySQL Server gestartet bzw. neu gestartet werden. Das können Sie im TerminalModus 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
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
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
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
Seite 11/15
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:
http://localhost/check.php
Falls Sie die Installation von einem anderen Arbeitsplatz nun ausführen wollen, starten Sie den
Browser und verwenden Sie den folgenden Befehl:
http://{SERVER-IP-ADRESSE}/check.php
Falls Sie einen anderen Port verwenden, dann modifizieren Sie den Befehl wie folgt:
http://localhost:XX/check.php
Sie sollten folgende Ergebnisse erhalten:
Seite 12/15
Nun, starten Sie die Datei ‚installer.php‘:
http://localhost/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.
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.
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
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
$DMS_HOST = "http://{enter your host in check_for_new.php}/";
auf
$DMS_HOST = "http://<Ihr Host>/";
bzw.
$DMS_HOST = "http://<Ihr 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
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
verlassen. Es kommt die Bestätigung.
um die Änderungen zu speichern und den Editor zu
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

Installationshandbuch Linux

Transcription

Similar documents

Jurawelt - Urteile von AGs in Strafsachen

PROTEIN