Technische Dokumentation Installation / Anpassung

Transkript

1 Technische Dokumentation Installation Anpassung Version 2.0 Stand

2 Inhaltsverzeichnis Copyright...3 Umgebung...4 Zu installierende Komponente...4 Datenbank...5 Beispiel: Oracle unter Debian...5 Anlegen von Tablespaces und dem Schema-Admin...8 Import- und Export-Pfad der Datenbank...9 Application Server (J2EE)...10 Sun JavaTM Application Server GlassFish...11 Realm...11 JDBC-Treiber...12 Einstellung der sprachabhängigen Formatierung...13 JDBC Connection Pool...14 JDBC Resource...15 Web GUI Installation...16 Verzeichnisdienst...17 OpenLDAP...17 Active Directory...17 Novell edirectory...17 Direkter Aufruf über Urls...18 Dienstleistungsklassen...19 Lizenz...20 Index...21

3 Copyright Copyright PrimeScale AG. All rights reserved. PrimeCMDB und PrimeScale sind eingetragene Marken der: PrimeScale AG Unternehmensberatung Benno-Strauß-Straße Fürth Deutschland Oracle ist eine eingetragene Marke der Oracle Corporation. Sun Java TM System Application Server ist eine eingetragene Marke der Sun Corporation. Microsoft Active Directory ist eine eingetragene Marke der Microsoft Corporation. Novell edirectory ist eine eingetragene Marke der Novell Corporation. Debian, Glassfish, Nagios, OpenLDAP sind Open Source System unter der GPL. Es wird darauf hingewiesen, dass die in der Dokumentation verwendeten Soft- und Hardwarebezeichnungen, sowie Markennamen und Produktbezeichnungen der jeweiligen Firmen im Allgemeinen warenzeichen-, marken-, oder patentrechtlichem Schutz unterliegen. Seite 3 von 22 Technische Dokumentation PrimeScale AG 2010

4 Umgebung Die PrimeCMDB ist als Multi-Tier Applikation entwickelt worden, die eine Trennung von Darstellung, Business-Logik und Datenhaltung realisiert: Oracle RDBMS PLSQL JDBC Application Server J2EE 1.5 HTTP(S) Web-Client Für den Betrieb der PrimeCMDB werden folgende Komponenten gebraucht: Datenbank: Oracle RDBMS >= 9i XE, Standard oder Enterprise Edition Application Server: J2EE 1.5 compliant: Sun JavaTM Application Server 9 GlassFish Verzeichnisdienst für die Authentifizierung: OpenLDAP, Microsoft Active Directory, edirectory Zu installierende Komponente PrimeCMDB.war Web-Gui der PrimeCMDB, benötigt J2EE Application Server, Glassfish oder Sun Enterprise Applicationserver in der jeweils aktuellen Version. Seite 4 von 22 Technische Dokumentation PrimeScale AG 2010

5 Datenbank Als Datenbank für die PrimeCMDB ist die Oracle RDBMS in der Version 9i 10g 11g notwendig. Die freie Version Oracle Express Edition wird im Rahmen ihrer Limitierungen ebenfalls unterstützt. Bei der Installation von Oracle RDBMS sei hier auf die entsprechende Dokumentation von Oracle ( verwiesen. Als Zeichensatz der Instanz ist UTF-8 (Unicode) Voraussetzung. Bei entsprechender Nutzung sollten der MAX_OPEN_CURSORS Parameter auf einen höheren Wert (z.b. 3000) eingestellt werden, da auch u.a. der Application Server Verbindungen cached. Beispiel: Oracle unter Debian Die Debian Distribution wird, obwohl im Serverumfeld sehr beliebt und verbreitet, von Oracle nicht offiziell für die Standard- und Enterprise-Version als Linux-Plattform unterstützt. Mit nachfolgend beschriebenen Anpassungen funktionieren Installation und Betrieb nach unserer Erfahrung dennoch reibungslos. Wir weisen jedoch ausdrücklich darauf hin, dass Oracle als Hersteller dazu keinen Support bietet. Eine Gewährleistung seitens PrimeScale ist ausgeschlossen. Ausgehend von einem Debian 5.0 (Lenny) Grundsystem werden folgende Pakete zusätzlich benötig: ssh build-essentials lesstif2-dev rpm alien libaio1 libdb3 apt-get install ssh build-essential rpm lesstif2-dev alien libaio1... Das Package libdb3 ist in der Debian 5.0 Distribution nicht enthalten und muss von einer älteren Version bezogen und mit dpkg i installiert werden Danach sind folgende symbolischen Links anzulegen: ln -s usrbinawk binawk ln -s usrbinrpm binrpm ln -s liblibgcc_s.so.1 liblibgcc_s.so ln -s usrbinbasename binbasename Seite 5 von 22 Technische Dokumentation PrimeScale AG 2010

6 Anlegen von usergroup: groupadd oinstall groupadd dba groupadd nobody useradd -g oinstall -G dba,nobody -d homeoracle -s binbash oracle passwd oracle mkdir homeoracle chown -R oracle:oinstall homeoracle chmod -R 775 homeoracle mkdir optoracle chown -R oracle:oinstall optoracle chmod -R 775 optoracle Einträge in der Datei etcsysctl.conf: kernel.shmall = kernel.shmmax = # bei 512 MB RAM (habler Speicher) kernel.shmmni = 4096 kernel.sem = fs.file-max = Danach mit sbinsysctl -p übernehmen. in die.bashrc bzw.profile von user oracle folgende Einträge setzen: # Oracle Environmaent export ORACLE_BASE=optoracle export ORACLE_SID=CMDB export ORACLE_HOME=optoracle Seite 6 von 22 Technische Dokumentation PrimeScale AG 2010

7 export PATH=$PATH:$ORACLE_HOMEbin export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOMElib Als user oracle die Installation starten:.runinstaller ignoresysprereqs Zwei Warnungen zu rpm können ignoriert werden, ansonsten verläuft die Installation wie in der Dokumentation von Oracle beschrieben. In der Datei etcoratab die Instanz von :N auf :Y setzen Seite 7 von 22 Technische Dokumentation PrimeScale AG 2010

8 Anlegen von Tablespaces und dem Schema-Admin Einrichten von 2 Tablespaces mit den Namen: PRIMECMDB (>= 500MB, dynamisch wachsend empfohlen) und PRIMECMDB_IDX (>= 300MB, dynamisch wachsend empfohlen) Im Tablespace PRIMECMDB_IDX werden alle Indexes abgelegt, so dass man durch die Verteilung auf andere physikalische Datenträger den Zugriff auch für sehr große Systeme skalieren kann. Zudem wird ein Admins-User für das Schema benötigt. Nachfolgend ein Beispiel- Script zum Anlegen: CREATE TABLESPACE "PRIMECMDB" LOGGING DATAFILE 'optoracleoradatacmdbprimecmdb.dbf' size 500M REUSE EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; CREATE TABLESPACE "PRIMECMDB_IDX" LOGGING DATAFILE 'optoracleoradatacmdbprimecmdb_idx.dbf' size 300M REUSE EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; CREATE USER CMADMIN IDENTIFIED BY ps DEFAULT TABLESPACE PRIMECMDB QUOTA UNLIMITED ON PRIMECMDB QUOTA UNLIMITED ON PRIMECMDB_IDX GRANT CONNECT TO CMADMIN WITH ADMIN OPTION GRANT CREATE TABLE TO CMADMIN GRANT CREATE VIEW TO CMADMIN GRANT CREATE PROCEDURE TO CMADMIN GRANT CREATE TRIGGER TO CMADMIN GRANT CREATE SEQUENCE TO CMADMIN GRANT CREATE TYPE TO CMADMIN GRANT CREATE INDEXTYPE TO CMADMIN GRANT CREATE ROLE TO CMADMIN GRANT SCHEDULER_ADMIN TO CMADMIN GRANT EXECUTE ON UTL_FILE TO CMADMIN GRANT EXECUTE ON UTL_SMTP TO CMADMIN GRANT EXECUTE ON UTL_TCP TO CMADMIN GRANT SELECT ON SYS.DUAL TO CMADMIN WITH GRANT OPTION GRANT SELECT ON DBA_ROLE_PRIVS TO CMADMIN ALTER USER CMADMIN DEFAULT ROLE ALL Seite 8 von 22 Technische Dokumentation PrimeScale AG 2010

9 Import- und Export-Pfad der Datenbank Einige Automaten der PrimeCMDB verwendet die Dateischnittstelle von Oracle. Damit diese funktioniert, muss im spfile von oracle folgender Eintrag exemplarisch erfolgen: utl_file='dataprimecmdb','dataprimecmdbimport','dataprimecmdbexport' Da der Parameter nicht dynamisch ist, muss die Datenbank danach neu gestartet werden. Oracle benötigt für jedes Verzeichnis, auch Unterverzeichnisse, diesen Eintrag, wenn darauf Leseundoder Schreib-Operationen erfolgen sollen. Natürlich sollte der Oracle User oder zumindest seine Gruppe die ensprechende Berechtigung im Filesystem haben. Seite 9 von 22 Technische Dokumentation PrimeScale AG 2010

10 Application Server (J2EE) Derzeit sind die Installationen unter folgenden Application Servern ausgetestet: Sun Java TM Application Server 9.x GlassFish V2 ( Empfohlen wird der Einsatz von Sun Java TM Application Server respektive GlassFish (Open Source und Basis des Sun Servers), da diese im Gegensatz zu anderen Java Application Servern derzeit eine vollständige J2EE 1.5 Implementation haben, die in aktuellen Versionen der PrimeCMDB benötigt wird. Zudem wird hiermit die Basis für unser zukünftig integriertes Identity Management gelegt. Seite 10 von 22 Technische Dokumentation PrimeScale AG 2010

11 Sun Java TM Application Server GlassFish Der Application Server übernimmt die Session-Verwaltung, die Authentifizierung an einem LDAP- Server (JAASRealm) und den Zugang zur Datenbank (JDBC). Realm Für die Authentifizierung an Active Directory wird dazu ein eigenes von PrimeScale entwickelter und optimierter "Custom Realm" installiert. Dies geschieht in folgenden Schritten. 1. Die jar-datei PSRealm.jar in das Verzeichnis <appserver-installationpath>domainsdomain1libclasses kopieren. 2. Die Datei <appserver-installationpath>domainsdomain1configlogin.conf um folgenden Eintrag ergänzen: PSRealm { }; eu.primescale.psrealm.psrealmloginmodule required; 3. In der Application Server Management Console im Bereich JVM-SettingsPath Settings unter Classpath Suffix den Eintrag ${com.sun.aas.instanceroot}libclassespsrealm.jar vornehmen. 4. Den Application Server neu starten. Seite 11 von 22 Technische Dokumentation PrimeScale AG 2010

12 5. Den Realm mit Parametern gemäß folgendem Beispiel einrichten: Dabei ist darauf zu achten, dass die Werte für den Realm (CMDBRealm), den Claas Name (eu.primescale.psrealm.psrealm) und den Parameter jaas-context (PSRealm) notwendig und in gleicher Schreibweise eingetragen werden müssen. Der Parameter uid-name legt den LDAP-Schlüssel für die Auswahl des Users fest (normalerweise: uid, unter MS Active Directory: samaccountname). JDBC-Treiber Der Oracle JDBC-Treiber (ojdbc5.jar) muss in das Verzeichnis <appserver-installationpath>libext des Application Servers kopiert werden. (domain) Danach sind folgende Anpassungen im Application Server mittels Admin Console notwendig: Seite 12 von 22 Technische Dokumentation PrimeScale AG 2010

13 Einstellung der sprachabhängigen Formatierung Um die richtigen Währungssymbole und Zahlenformate unabhängig vom Betriebssystem darzustellen, müssen im Applikationserver folgende Einstellungen vorgenommen werden: Seite 13 von 22 Technische Dokumentation PrimeScale AG 2010

14 JDBC Connection Pool Für die Datenbankkommunikation wird zunächst ein JDBC-Connection Pool angelegt: Nachfolgend die Konfigurationsdaten: Seite 14 von 22 Technische Dokumentation PrimeScale AG 2010

15 JDBC Resource Für den Programmzugriff wird dann die JDBC-Ressource definiert: Seite 15 von 22 Technische Dokumentation PrimeScale AG 2010

16 Web GUI Installation Die WAR-Datei PrimeCMDB.war wird über die Sun JavaTM Application ServerGlassFish Admin Console "installiert": Der "Context Root" von PrimeCMDB.war sollte dabei auf PrimeCMDB stehen und der "Context Root" von PrimeCMDB-Attachements.war auf PrimeCMDB-Attachements. Die CMDB wird über den Server-URL aufgerufen, z.b. : oder mit SSL-Verschlüsselung (Zertifikat notwendig): Seite 16 von 22 Technische Dokumentation PrimeScale AG 2010

17 Verzeichnisdienst Derzeit kann für die Authorisierung der Anwender des Web-Clients jeder beliebige LDAP-Dienst hergenommen werden. Z.B. MS Active Directory, Novell edirectory, Sun Directory und OpenLDAP. OpenLDAP Eine Authentifizierung gegen OpenLDAP funktioniert problemlos mit entsprechender Einstellung des Glassfish Sun Java TM Application Server. Es wird zusätzlich der User (primecmdb) benötigt. Dieser User muss nur für rein lesende Operationen (Directory Browsing) angelegt werden und braucht außer dem Recht sich anmelden und browsen zu dürfen keine weiteren speziellen Rechte. Active Directory Für die Anmeldung und den Abgleich mit Active Directory wird ein User (primecmdb) benötigt. Dieser User muss nur für rein lesende Operation (Directory Browsing) angelegt werden und braucht außer dem Recht sich anmelden und browsen zu dürfen keine weiteren speziellen Rechte. Wird eine schreibende Kopplung in das Active Directory eingerichtet, so muss die Kennung mit enstsprechenden Rechten (Directory Admin) ausgestattet werden. Aus Gründen der Sicherheit empfiehlt sich eine verschlüsselte Verbindung zwischen dem Server der installierten PrimeCMDB-Server und dem Active Directory. Novell edirectory Für die Anmeldung gegen Novell edirectory wird ein User (primecmdb) benötigt. Dieser User muss nur für rein lesende Operation (Directory Browsing) angelegt werden und braucht außer dem Recht sich anmelden und browsen zu dürfen keine weiteren speziellen Rechte. Seite 17 von 22 Technische Dokumentation PrimeScale AG 2010

18 Direkter Aufruf über Urls Tickets und Projekte können auch direkt über Urls aufgerufen werden. Die Authentifizierung kann damit alledings nicht umgangen werden. Beispiel: bzw. Seite 18 von 22 Technische Dokumentation PrimeScale AG 2010

19 Dienstleistungsklassen Dienstleistungsklassen sind für die Abrechnung vorgegeben. Während der Name (SERVICECATEGORY) verändert werden kann, muss die ID als Bezug fest eingestellt bleiben. Die Erweiterung von Dienstleistungsklassen kann aufgrund ihrer komplexen Kausalität nur durch Programmierung (PLSQL Package: pkclearing) erfolgen. ID DIENSTLEISTUNGSKLASSE 1 Aufträge 2 Komponentenklasse 3 TK-Klasse 4 Applikation 5 Projekt 6 Kennungen 7 Projekt-LW 8 Gruppen-LW 9 Home-LW Seite 19 von 22 Technische Dokumentation PrimeScale AG 2010

20 Lizenz Die PrimeCMDB und alle mitgelieferten Komponenten sind, sofern nicht explizit ausgeschlossen, unter GPL V3 lizensiert. Seite 20 von 22 Technische Dokumentation PrimeScale AG 2010

21 Index A Active Directory...4, 17 Anlegen von Tablespace...8 Application Server Management Console...11 C Connection Pool...14 Context Root...16 D Datenbank...5 Debian...5 G GlassFish...4, 10, 11 J J2EE...10 JDBC...11, 12, 14, 15 JVM...11, 13 L LDAP...17 M Microsoft Active Directory...4, 17 N Nagios...3 Novell edirectory...17 O Oracle...4, 5, 6, 7, 9, 12 P Parameter...9, 18 PrimeCMDB...4, 9, 10, 16, 17 PrimeCMDB.war...16 S Sun JavaTM Application Server...4, 10 T Tablespace...8 Tablespaces...8 V Verzeichnisdienst...4 W Seite 21 von 22 Technische Dokumentation PrimeScale AG 2010

22 WAR-Datei...16 Seite 22 von 22 Technische Dokumentation PrimeScale AG 2010