Difference between revisions of "Installationsanleitung eSciDoc imeji CoNE"

Revision as of 14:00, 17 June 2012

eSciDoc 1.2 und imeji Installations Tutorial Video vom Zuse Internet Archive der FU: http://www.zib.de/zuse/video

eSciDoc / JBOSS Security[edit]

Tuturial / Help - SecureJBoss4.2
https://www.escidoc.org/wiki/SecureJBoss4.2

JBoss behind an Apache Webserver
https://www.escidoc.org/wiki/JBossBehindWebserver

UsingMod_proxyWithJBoss
http://community.jboss.org/wiki/UsingModproxyWithJBoss

Apache Module mod_proxy
https://httpd.apache.org/docs/2.2/mod/mod_proxy.html

Securing the JMX Console and Web Console (HTTP)
http://community.jboss.org/wiki/SecureTheJmxConsole

General Info - Introduction - hosting applications with JBoss Application Server
http://chiralsoftware.com/linux-system-administration/jboss-server-deployment.seam

Security Warning for eSciDoc Infrastructure version 1.3 and 1.4
Because of an JBoss issue the JMX console is only secured for GET and POST requests although authenticated access is configured. An attacker could trigger arbitrary actions in the operating system.
Please secure your JMX console like described at https://access.redhat.com/kb/docs/DOC-30741
If you do not use the console for administrative purpose, you can alternatively disable the JMX console.

eSciDoc 1.4 auf Scientific Linux 64bit[edit]

Java Development Kit (JDK) von Sun installieren[edit]

Es wird das JDK von Java Sun empfohlen.
Benötigt wird die aktuelle Version aus Java 6 (jdk-6u<version>-linux-x64.bin).
<version> meint die aktuelle Versionsnummer z.B. 33
Ein Downloadlink findet sich bei escidoc unter: https://www.escidoc.org/JSPWiki/en/InstallJavaForRelease1.4

Das heruntergeladene .bin-File lässt sich mit der Kommandozweile wie folgt installieren:

   su
   sh jdk-6u<version>-linux-x64.bin

und allem zustimmen.
Anschließend den Ordner an einen geeigneteren Ort kopieren. Hierfür kann man sich z.B. einen Ordner im "home" Verzeichnis anlegen. Wir wählen als Beispiel den Ordner "location": /home/<username>/location (hier soll später auch escidoc installiert werden).

Als nächstes sollte die Umgebungsvariable für das JDK konfiguriert werden:
Einen Editor starten

   vim .bashrc (/home/<username>/.bashrc)

dann folgendes ans Ende der .bashrc kopieren:

   # JAVA (JDK,JRE)
   export JAVA_HOME='/home/<username>/location/jdk1.6.0_<version>'
   PATH=.:$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$PATH

Speichern und schließen (:wq)
Danach müssen alle Kommandozeilen geschlossen werden, um die Einstellung zu übernehmen.

Die richtige Konfiguration kann mittels Java-Befehl getestet werden.
Dazu öffnet man eine Kommandozeile und trägt folgenden Befehl ein:

   java -version

Es sollte nun z.B. folgendes ausgegeben werden:

   java version "1.6.0_33" Java(TM) SE Runtime Environment (build 1.6.0_33-b03)
   Java HotSpot(TM) 64-Bit Server VM (build 20.8-b03, mixed mode)

Falls der Befehl java -version das OpenJDK zurückgibt, muss das OpenJDK auf Java-Sun umgestellt werden.
Dies kann mit folgendem Befehl vorgenommen werden:

   update-alternatives --config java

Danach sollte java -version die eigens installierte Java-Version zurückgeben.

JAVA ist installiert :)

PostgreSQL installieren[edit]

Es wird Version 8.4 oder höher benötigt: https://www.escidoc.org/JSPWiki/en/InstallPostgreSQLForRelease1.4
Unter Scientific Linux kann PostgreSQL mit YUM installiert werden. Es werden der PostgreSQL Server und Contrib benötigt.
(contrib wurde bei eSciDoc 1.2 benötigt - wir installieren es um eventuellen Problemen vorzubeugen.)

PostgeSQL + Server + Contrib installieren:

   su
   yum install postgresql postgresql-server postgresql-contrib

PostgreSQL-DB initialisieren:

   service postgresql initdb

Die Konfigurationsdatei postgresql.conf editieren:

   vim /var/lib/pgsql/data/postgresql.conf
   #port = 5432 -> port = 5432 (kommentar weg)

Und speichern.

Die Konfigurationsdatei pg_hba.conf editieren:

   vim /var/lib/pgsql/data/pg_hba.conf

Nach den einführenden Kommentaren sollte die Datei wie folgt aussehen:

# Database administrative login by UNIX sockets
local   all         postgres                         ident


# TYPE  DATABASE    USER        CIDR-ADDRESS          METHOD

# "local" is for Unix domain socket connections only
local   all         all                               ident
# IPv4 local connections:
host    all         all         127.0.0.1/32          md5
# IPv6 local connections:
host    all         all         ::1/128               md5

Und speichern.
Das Ersetzen von "ident" durch "md5" ermöglicht die Anmeldung mit einem md5-Passwort.

PostgreSQL-DB starten:

   service postgresql start

und PostgreSQL testen:

   su postgres
   psql
   \l (listet alle bestehenden datenbanken)

Wenn gewünscht, dann gleich das Postgres-root-Passwort ändern:

   \password postgres
   dann passwort eintragen

PostgreSQL mit den gewünschten Optionen ist installiert :)

eSciDoc 1.4 installieren[edit]

Installer herunterladen (aktuell Release 1.4) von https://www.escidoc.org/JSPWiki/en/InstallationForRelease1.4

PostgreSQL sicherheitshalber neustarten:

   su
   service postgresql restart

Hinweis: eSciDoc NICHT als root installieren!
(Ein potentieller Einbrecher über den JBoss Application Server hätte sonst root-Rechte.)

Installer ausführen mit:

   java -jar escidoc-core-1.4.1-installer.jar

Als Sprache kann Deutsch (deu) ausgewählt werden.
OK
Weiter
Ja, ich stimme diesen Lizenzvereinbarungen zu.
Weiter
Installationsvoraussetzungen
Weiter
Neue eSciDoc-Infrastruktur installieren
Weiter
Rechnername: localhost
Portnummer: 8080
Weiter
PostgreSQL
Weiter
PostgreSQL-Datenbankverbindung
Die voreingestellten Werte beibehalten.
Weiter
postgres (root-Passwort)
Weiter
Datenbankbenutzer escidoc (ist der Nutzer für die neue Postgres-Datenbank)
Passwort eintragen
Weiter
fedoraAdmin (Admin für Fedora, und ein weiterer PostgreSQL Benutzer, wird hauptsächlich intern benötigt)
Passwort eintragen
emailAdress: email (für Fehlermeldungen, Feld darf nicht leer sein, muss aber keine Adresse enthalten)
Weiter
Verwende die JAVA_HOME Umgebungsvariable (vorgegebene Werte stimmen)
Weiter
Installationspfad: /home/<username>/location/escidoc
Weiter
Alles angehakt lassen
Weiter
sysadmin (Hat Zugang zu allen Resourcen und kann Benutzer mit deren Rechten verwalten)
Passwort eintragen
Weiter
inspector (read-only, für Infrastruktur-internes wie Indexierung)
Passwort eintragen
Weiter
depositor (erstellen neuer Resourcen innerhalb der Infrastruktur - User für das meiste des Tagesgeschäfts)
Passwort eintragen
Weiter
JBoss-Benutzername: (Passwortgeschützter Zugriff auf JMX-Console des JBoss-Application-Servers)
Passwort eintragen
Weiter
Keystore für https
Alle Felder frei lassen (kann auch später konfiguriert werden)
Weiter
ESciDoc wird nun installiert
Installationsfortschritt des Pakets: [Fertig]
Overall installation progress: 14/14
Weiter
Glückwunsch
Weiter
Die Installation wurde erfolgreich durchgeführt!
Ein Deinstallationsprogramm wurde in folgendem Dateipfad gespeichert: /home/<username>/location/escidoc/Uninstaller
Wenn gewünscht kann ein automatisches Installationsscript generiert werden.
Fertig

Hinweis:
Wenn ein fatal error auftritt, ist möglicherweise der Zugriff auf die PostgreSQL-DB nicht richtig konfiguriert. Die Einstellungen in der Konfigurationsdatei pg_hba.conf (/var/lib/pgsql/data/pg_hba.conf) sollten nocheinmal geprüft werden. Sind die Zugänge auf md5 gestellt? (siehe PostgreSQL installieren)

Fedora-Home Variable in der .bashrc setzen

   vim .bashrc (/home/<username>/.bashrc)

Folgendes ans Ende der .bashrc kopieren:

   # FEDORA
   export FEDORA_HOME='/home/<username>/location/escidoc/fedora'

Speichern und schließen (:wq) Danach Terminal neustarten

Hinweis für lokale Tests OHNE Sicherung der JMX-Console durch einen Apache-Server:
Wenn der Zugriff auf den JBoss erlaubt werden soll, muss der Port 8080 in IPTABLES eingetragen werden:

   iptables -I INPUT -m tcp -p tcp --dport 8080 -j ACCEPT

ESciDoc ist installiert :)