Referenzplattform Installationen Einspeisemanagement (EISMAN) 1.0.9-1

Dieser Artikel wird akutell überarbeitet und enthält u. U. keinen konsistenten Stand oder vollständige Inhalte.

Im Folgenden wird beschrieben, welche Schritte für die Installation der Einspeisemanagement (EISMAN)-Software auf die Referenzplattform mit der URL demo.openkonsequenz.de notwendig sind.

Die Installationsanleitung basiert auf den Annahmen:

• Betriebssystem: Ubuntu 16.04 LTS (Server)
• Anmeldung als: root (über PuTTY)
• PuTTY: installiert (Client)
• OpenSSH: installiert (Server)
• nano: installiert (Server)
• tar: installiert (Server)
• Internetverbindung: Server & Client
• pgAdmin III: installiert (Client)
• EISMAN: als war-Archive gepackt (Server z.B. home-Verzeichnis)

Installationsschritte:

neuen root-Nutzer anlegen und "root" sperren

• neuen root-Nutzer hinzufügen:
  adduser <<username>>
• neuen root-Nutzer zu Gruppe "sudo" hinzufügen:
  adduser <<username>> sudo
• "root" aus Sicherheitsgründen sperren:
  sudo passwd -l root

unzip installieren

• Paketverwaltung aktualisieren:
  apt-get update
• unzip installieren:
  apt-get install unzip

Bestätigung => "J"

Apache 2.0 installieren & konfigurieren

   Status prüfen:
     service apache2 status
     
   Installation (falls notwendig):
     apt-get update
     apt-get install apache2
     Bestätigung => "J"
     
   Status prüfen:
     service apache2 status
     
     im Browser die IP des Servers eingeben => Apache-Startseite
     
   Umleitung (Proxy) einrichten
     apt-get update
     apt-get install libapache2-mod-proxy-html
     
     a2enmod proxy
     a2enmod proxy_html
     a2enmod proxy_http 
     
     cd /etc/apache2/sites-available
     cp 000-default.conf demo.openkonsequenz.de.conf
     nano demo.openkonsequenz.de.conf

       <VirtualHost *:80>
         ServerName demo.openkonsequenz.de
         ProxyPreserveHost on
         ProxyPass / http://localhost:8080/
       </VirtualHost>

     speichern Strg + O
     Beenden Strg + X

     a2dissite 000-default.conf
     a2ensite demo.openkonsequenz.de.conf
     

PostgreSQL 9.5 installieren & konfigurieren

   Status prüfen:
     service postgresql status
     
   Installation (falls notwendig):
     apt-get install postgresql postgresql-contrib
     Bestätigung => "J"
     
   Status prüfen:
     service postgresql status
     
   Benutzer "postgres" aktivieren
       sudo -u postgres psql postgres
         psql (9.5.3)
         Type "help" for help.
         
         postgres=# \password postgres
         Enter new password: postgres
         Enter it again: postgres
         postgres=# \q

   Berechtigungen für Zugriff von außen einrichten (später wieder deaktiveren!!!)
     cd /etc/postgresql/9.5/main
     
     nano pg_hba.conf
     
     am Ende anfügen:
       hostssl  all             postgres        0.0.0.0/0               md5
           
       speichern Strg + O
       Beenden Strg + X
       
     nano postgresql.conf
       ändern:
       #listen_addresses = 'localhost'  =>  listen_addresses = '*'
       
       speichern Strg + O
       Beenden Strg + X
       
     Postgres durchstarten
       systemctl restart postgresql.service

   Datenbank einrichten
     - über pgAdminIII Verbindung zum Server herstellen
     - Nutzer openK einrichten
     - Testdaten einspielen
     
     

Java JDK 8u92 installieren & konfigurieren

    Status prüfen:
       java -version
       
    Installation (falls notwendig):
     cd /opt
     mkdir java
     cd java
     
     Download:
     wget --no-check-certificate --no-cookies --header "Cookie: oraclelicense=accept-securebackup-cookie"  http://download.oracle.com/otn-pub/java/jdk/8u92-b14/jdk-8u92-linux-x64.tar.gz
     
     Entpacken:
     tar -xf jdk-8u92-linux-x64.tar.gz
     
     Owner ändern:
     chown -R root:root jdk1.8.0_92/

     Alternativen-System einrichten:
     update-alternatives --install "/usr/bin/java" "java" "/opt/java/jdk1.8.0_92/bin/java" 1
     update-alternatives --install "/usr/bin/javac" "javac" "/opt/java/jdk1.8.0_92/bin/javac" 1
     update-alternatives --install "/usr/bin/javaws" "javaws" "/opt/java/jdk1.8.0_92/bin/javaws" 1
     update-alternatives --install "/usr/bin/jar" "jar" "/opt/java/jdk1.8.0_92/bin/jar" 1
     
     Alternativen-System konfigurieren:
     update-alternatives --set "java" "/opt/java/jdk1.8.0_92/bin/java"
     update-alternatives --set "javac" "/opt/java/jdk1.8.0_92/bin/javac"
     update-alternatives --set "javaws" "/opt/java/jdk1.8.0_92/bin/javaws"
     update-alternatives --set "jar" "/opt/java/jdk1.8.0_92/bin/jar"  
     
   Status prüfen:
     java -version
       
       java version "1.8.0_92"
       Java(TM) SE Runtime Environment (build 1.8.0_92-b14)
       Java HotSpot(TM) 64-Bit Server VM (build 25.92-b14, mixed mode)
       
   JAVA_HOME einrichten:
     nano /etc/profile => export JAVA_HOME="/opt/java/jdk1.8.0_92" am Ende einfügen
     speichern Strg + O
     Beenden Strg + X
     
     Neuladen: 
     source /etc/profile
     
     Prüfen:  
     echo $JAVA_HOME  
     => /opt/Oracle_Java/jdk1.8.0_92
       

Tomcat 8 installieren & konfigurieren

     cd /opt
     mkdir tomcat
     cd tomcat
     
     download:
     wget http://mirror.serversupportforum.de/apache/tomcat/tomcat-8/v8.0.36/bin/apache-tomcat-8.0.36.tar.gz
     
     entpacken:
     tar -xf apache-tomcat-8.0.36.tar.gz     
     
     Owner ändern:
     chown -R root:root apache-tomcat-8.0.36/
     
     Service einrichten:
     nano /etc/systemd/system/tomcat.service
     
     
         [Unit]
         Description=Apache Tomcat Web Application Container
         After=network.target
         
         [Service]
         Type=forking
         
         Environment=JAVA_HOME=/opt/java/jdk1.8.0_92/
         Environment=CATALINA_PID=/opt/tomcat/apache-tomcat-8.0.36/temp/tomcat.pid
         Environment=CATALINA_HOME=/opt/tomcat/apache-tomcat-8.0.36/
         Environment=CATALINA_BASE=/opt/tomcat/apache-tomcat-8.0.36/
         Environment='CATALINA_OPTS=-Xms256M -Xmx512M -server -XX:+UseParallelGC'
         Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom'
         
         ExecStart=/opt/tomcat/apache-tomcat-8.0.36/bin/startup.sh
         ExecStop=/opt/tomcat/apache-tomcat-8.0.36/bin/shutdown.sh
         
         User=root
         Group=root
         RestartSec=10
         Restart=always
         
         [Install]
         WantedBy=multi-user.target

     speichern Strg + O
     Beenden Strg + X
     
     Berechtigung ändern:
     chmod -R 755 tomcat.service
     
     Dienst aktivieren
     systemctl daemon-reload
     
     Dienst starten
     systemctl start tomcat.service

     Status testen
     systemctl status tomcat.service
     
     im Browser die IP des Servers (+ ":8080") eingeben => Tomcat-Startseite
     
     künftig automatisch starten
     systemctl enable tomcat.service