Installation Manual DOKUMENT: TYP: Installation Manual Manual ERSTELLT VON: nova ratio AG Universitätsstraße 3 56070 Koblenz Deutschland VERSION: 11.x STAND: 11. Dezember 2017
Inhaltsverzeichnis 1 Vorwort...1 2 Installation...2 2.1 Voraussetzung...2 2.2 Parameterabfrage...3 2.3 Ablauf der Installation...5 3 Deinstallation...11 Copyright 2017 nova ratio AG Inhaltsverzeichnis Installation Manual
1 Vorwort Die nova ratio AG ist der Hersteller der IT Informationsplattform erunbook. erunbook ist ein eingetragenes Markenzeichen der nova ratio AG. Die Nutzung der erunbook Software, der darauf basierenden Lösungen und aller sich darauf beziehenden Dokumente ist durch eine Lizenzvereinbarung mit der nova ratio AG reglementiert. Das vorliegende Dokument beschreibt die Installation des erunbook Servers. nova ratio AG Universitätsstraße 3 D-56070 Koblenz Deutschland Telefon: +49 261 20 16 58 1 0 Fax: +49 261 20 16 58 1 19 Mail: info@nova-ratio.de Web: www.nova-ratio.de Copyright 2017 nova ratio AG Seite 1 Installation Manual
2 Installation 2.1 Voraussetzung Detaillierte Systemvoraussetzungen sind im Dokument Requirement Manual beschrieben. Die Installation der erunbook Software auf dem erunbook Server erfolgt mit dem Installationsprogramm setup.sh in dem erunbook Build-Verzeichnis. Achtung: Der Aufruf des Installationsprogramms erfordert die root Berechtigungen auf der Betriebssystemebene. Das Installationsprogramm prüft die Plattform und den verfügbaren Plattenplatz für die Installation und erfragt die notwendigen Parameter für die Installation. Im Anschluss an diese Abfragen werden diese Informationen am Bildschirm ausgegeben. Erst nach einer Bestätigung durch den Anwender wird mit der Installation der Software begonnen. Achtung: Für die Installation der erunbook Software auf dem erunbook Server werden ca. 2 GB Plattenplatz im Dateisystem benötigt. In dieser Angabe ist die Größe des produktiven Datenbankmanagementsystems für das erunbook System nicht enthalten. Nach dem Kopieren der Software in das gewählte Produktverzeichnis (Standard ist /opt/erunbook) werden die Start- und Stoproutinen des Betriebssystems für die erunbook Software erzeugt und die erunbook Software gestartet. Nach Abschluss des Installationsprogramms werden alle weiteren Aktivitäten mit dem Webbrowser über die Administrationsumgebung der eadmin Instanz durchgeführt. Copyright 2017 nova ratio AG Seite 2 Installation Manual
2.2 Parameterabfrage Die folgenden Parameter und Einstellungen werden vom Installationsprogramm für den erunbook Server abgefragt: Parameter Bedeutung Standardeinstellung Wertebereich Target directory Verzeichnis für die Produkt Installation /opt/erunbook <pathname> Hostname Name des erunbook Servers `hostname` <hostname> IP address IP Adresse des erunbook Servers Primary IP address <XXX.XXX.XXX.XXX> Domainname DNS Domainname `domainname` <domain> Owner group of erunbook files Name der Gruppe, dem die erunbook Dateien gehören sollen users <groupname> Owner of erunbook files Name des Benutzers, dem die erunbook Dateien gehören sollen erunbook <username> erunbook communication port number Web server port number (encrypted) mysql server port number Port, auf dem der erunbook Server auf Antworten von den erunbook Agenten wartet Port, auf dem der Webserver für das erunbook System läuft Port, über den mit der mysql Datenbank kommuniziert wird 9617 <portnumber> 9443 <portnumber> 3307 <portnumber> Install eadmin instance Erstellung einer Administrationsumgebung des erunbook Servers als Instanz eadmin Ja [y n] erunbook Agent Version erunbook Agent port number Bit-Version des erunbook Agenten auswählen, der installiert wird (32- oder 64-Bit) Port, über den mit dem erunbook Agenten kommuniziert wird 64-Bit [32 64] 9616 <portnumber> Copyright 2017 nova ratio AG Seite 3 Installation Manual
Parameter Bedeutung Standardeinstellung Wertebereich Restrict server IP Used mail server IP des/der Server(s), von dem/denen der erunbook Agent Scanaufträge erhalten darf Mail Server für den Versand von Mailnachrichten * <XXX.XXX.XXX.XXX> 127.0.0.1 <hostname> or <XXX.XXX.XXX.XXX> Used mail sender Benutzername, von dem Mails verschickt werden erunbook@<domain> <username>@<domainname> Copyright 2017 nova ratio AG Seite 4 Installation Manual
2.3 Ablauf der Installation Das Programm befindet sich im Build-Verzeichnis. Sein Aufruf lautet:./setup.sh Im ersten Teil erfragt das Installationsprogramm die notwendigen Installationsparameter. In der Regel können dabei die vom Installationsprogramm gemachten Vorschläge durch die Eingabe von Return übernommen werden: ============================================================================== erunbook: install Server including Agent ============================================================================== erunbook: Please enter target directory [<directory>] (default=/opt/erunbook): erunbook: Please enter hostname [<hostname>] (default= ko-pc-112): erunbook: Please enter ip address of host ko-pc-112 (default=192.168.178.19): erunbook: Please enter domainname [<domainname>] (default=nova-ratio.de): erunbook: Please enter owner group of erunbook-files [<group>] (default=users): erunbook: Please enter owner of erunbook-files [<user>] (default=erunbook): erunbook: Enter port number to be used by cserver [<CSERVERPORT>] (default=9617): erunbook: Enter port number to be used by web server [<HTTPSPORT>] (default=9443): erunbook: Enter port number to be used by mysql server [<MYSQLPORT>] (default=3307): erunbook: Install eadmin instance? [y n] (default=y): erunbook: Please enter Agent version you want to use [32 64 <Bit>] (default=64): erunbook: Please enter agent port (default=9616): erunbook: Please enter Server ip addresses for restrict access (default=*): erunbook: Enter mailserver to be used by erunbook [<mailserver>] (default=127.0.0.1): erunbook: Enter mailsender to be used by erunbook [<mailsender>] (default=erunbook@nova-ratio.de): Copyright 2017 nova ratio AG Seite 5 Installation Manual
Nach Abfrage dieser Parameter erscheint ein Übersichtsbildschirm: summary ======= Type...: server Targetdirectory...: /opt/erunbook User...: erunbook Group...: users Host...: ko-pc-112 (IP: 192.168.178.19) Domain...: nova-ratio.de Server-Port...: 9617 Webserver-Port...: 9080 Webserver-Secure...: 9443 DB-Port...: 3307 Install eadmin...: y Agent bit-version...: 64 Bit Agent-Port...: 9616 Restrict access...: * mailserver...: 127.0.0.1 mailsender...: erunbook@nova-ratio.de.de Do you want to continue [y n] (default=y): Erst nach einer Bestätigung dieses Übersichtsbildschirms beginnt die Installation der erunbook Dateien auf dem erunbook Server. Wenn im Rahmen der Parameterabfrage die Erstellung einer Administrationsumgebung des erunbook Servers als Instanz eadmin gewünscht wurde, wird diese nach der Installation eingerichtet: erunbook: Installation on operating system Linux: starting working on: /var/tmp/build.649/linux/software/additional/httpd.tar.gz working on: /var/tmp/build.649/linux/software/additional/mysqlserver.tar.gz working on: /var/tmp/build.649/linux/software/additional/openldap.tar.gz working on: /var/tmp/build.649/linux/software/mandatory.tar.gz working on: /var/tmp/build.649/linux/pro.tar.gz working on: /var/tmp/build.649/linux/agent.tar erunbook: Installation on operating system Linux: files copied erunbook: Configuring: starting erunbook: Configuring: finished erunbook: Configuration of erunbook processes: starting erunbook: Configuration of erunbook processes: finished erunbook: Setting owner and file access rights: starting erunbook: Setting owner and file access rights: finished erunbook: init DB: starting erunbook: init DB: finished Copyright 2017 nova ratio AG Seite 6 Installation Manual
erunbook: Starting processes: starting erunbook: database started erunbook: webserver started erunbook: Starting processes: finished erunbook: Configuring: starting erunbook: Creating startup file: starting erunbook: Creating startup file: finished erunbook: cleaning up and restart... erunbook communication daemon stopped... Shutting down service mysql Während der Installation der Administrationsumgebung erscheinen einige Hinweise und im Anschluss daran die Abfragen für das SSL Zertifikat für den Webbrowser des erunbook Servers: Do you want to specify parameters for SSL certificate generation? [y n] (default=n): Bei Bestätigung der Default Einstellung (n) wird ein SSL Zertifikat mit den folgenden Angaben erstellt: writing RSA key Signature ok subject=/c=de/st=rheinland-pfalz/l=hundsdorf/o=nova ratio AG/OU=eRunbook/CN=ko-pc-10.nova-ratio.de/emailAddress=support@nova-ratio.de Getting Private key Mit der Auswahl y ist es möglich die Parameter einzugeben, die für das Erstellen des SSL Zertifikats benötigt werden. HINWEIS: Bei der Eingabeaufforderung für Common Name (e.g. YOUR name) erwartet die Installationsroutine den Namen des Rechners, auf dem die Software installiert wird. erunbook: Please generate a new ssl certificat for your server writing RSA key You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter '.', the field will be left blank. ----- Copyright 2017 nova ratio AG Seite 7 Installation Manual
Country Name (2 letter code) [AU]:DE State or Province Name (full name) [Some-State]:Germany Locality Name (eg, city) []:Hundsdorf Organization Name (eg, company) [Internet Widgits Pty Ltd]:nova ratio AG Organizational Unit Name (eg, section) []:erunbook Common Name (eg, YOUR name) []:ko-pc-112 Email Address []: Please enter the following 'extra' attributes to be sent with your certificate request A challenge password []: An optional company name []: Signature ok subject=/c=de/st=germany/l=hundsdorf/o=nova ratio AG/OU=eRunbook/CN=ko-pc-112 Getting Private key Nach der Generierung des Zertifikats werden alle Prozesse des erunbook Servers gestartet und die Administrationsumgebung des erunbook Servers als eadmin Instanz erstellt. Starting service erunbook Starting service erunbookagent Starting service MySQL erunbook_admin.pl: instance 'eadmin' does not exist erunbook communication daemon started... erunbook: Creating eadmin instance erunbook: eadmin instance created erunbook: Please enter the URL https://ko-pc-112.nova-ratio.de:9443/eadmin in your webbrowser to start instanz: eadmin erunbook: Please use account 'erunadmin' with password 'go4it' for administration tasks Zum Abschluss der Installation erscheint der Hinweis, dass jetzt im Webbrowser die erunbook Administrationsumgebung aufgerufen werden kann, in der alle weiteren Arbeitsschritte durchgeführt werden: URL: https://<servername>:9443/eadmin User: erunadmin Password: go4it Copyright 2017 nova ratio AG Seite 8 Installation Manual
Die Anmeldung im Webbrowser kann je nach erstelltem Zertifikat des Webservers einige Meldungen beinhalten, welche abhängig von Webbrowser und Netzwerkkonfiguration zu beantworten sind: Achtung: Das im Rahmen der erunbook Installation erstellte Zertifikat ist von keiner Zertifizierungsstelle herausgegeben, die die Webbrowser kennen. Der Anwender muss daher das Zertifikat zumindest temporär akzeptieren. Nachdem das Zertifikat akzeptiert wurde, folgt die Aufforderung zur Anmeldung des Webbrowsers. Dieses Fenster kann je nach eingesetztem Webbrowser unterschiedlich aussehen: Copyright 2017 nova ratio AG Seite 9 Installation Manual
Als Benutzername und Passwort sind die folgenden Angaben zu benutzen: User: erunadmin Passwort: go4it Nach der Anmeldung erscheint der Startbildschirm der erunbook Administrationsumgebung. Das Passwort des Benutzers erunadmin sollte nach der Installation geändert werden: Durch das Klicken auf den Benutzernamen oben rechts, wird ein Fenster geöffnet, das den Benutzer erunadmin beschreibt. Zum Ändern des Passwortes muss das Formular Password Editor ausgewählt werden. Hier kann das neue Passwort eingetragen und gespeichert werden. Nach dem Ändern ist eine erneute Anmeldung mit dem neuen Passwort nötig. Alle weiteren Funktionen und der allgemeine Umgang mit der eadmin Instanz werden in dem Dokument eadmin Manual beschrieben. Copyright 2017 nova ratio AG Seite 10 Installation Manual
3 Deinstallation Die Deinstallation der erunbook Serversoftware erfordert lediglich folgende Löschaktivitäten: 1. Löschen des Installationsverzeichnisses, standardmäßig /opt/erunbook, inklusive aller Unterverzeichnisse 2. Löschen des erunbook-start-/stopp-skriptes erunbook im Verzeichnis /etc/init.d 3. Löschen der Verlinkungen S99eRunbook und K01eRunbook aus den entsprechenden Runleveln, beispielsweise Verzeichnis /etc/init.d/rc2.d oder /etc/init.d/rc5.d Sollten die zugehörigen Daten in der standardmäßig mitgelieferten Datenbankinstallation gespeichert worden sein, wurden diese inklusive der zugehörigen DB-Installation durch Löschen des Installationsverzeichnisse entfernt. Wurde eine Datenbank "remote" angebunden, müssen die zugehörigen Tabellen/Instanzen separat gelöscht werden. Copyright 2017 nova ratio AG Seite 11 Installation Manual
nova ratio AG Universitätsstraße 3 D-56070 Koblenz Deutschland Telefon: +49 261 20 16 58 1 0 Fax: +49 261 20 16 58 1 19 Mail: info@nova-ratio.de Web: www.nova-ratio.de Copyright 2017 nova ratio AG Seite 12 Installation Manual