Installation - Apparo.solutions
Werbung
Installationsanleitung Apparo Fast Edit MS Windows / SAP BusinessObjects Web Intelligence Version 3.0 1 2 3 4 Vor der Installation ____________________________________________________ 4 1.1 Hardware-Anforderungen _____________________________________________ 4 1.2 Unterstützte Betriebssysteme __________________________________________ 4 1.3 Unterstützte SAP BusinessObjects Versionen _______________________________ 4 1.4 Unterstützte virtuelle Umgebungen ______________________________________ 4 1.5 Unterstützte Security-Systeme__________________________________________ 4 1.6 Architektur ________________________________________________________ 5 1.7 Überblick der Installationsschritte _______________________________________ 7 Vorbereitung _________________________________________________________ 8 2.1 Erstellen des Datenbank-Users für das Apparo Repository _____________________ 9 2.2 Portalordner für Apparo Designer Eintrag ________________________________ 10 2.3 Shared Secret ______________________________ Fehler! Textmarke nicht definiert. 2.4 Anpassungen an einem Reverse Proxy Server______________________________ 11 Installation__________________________________________________________ 12 3.1 Lizenzbeschreibung _________________________________________________ 13 3.2 Auswahl der Zielarchitektur___________________________________________ 14 3.3 Festlegen des Starteintrages und des Zielverzeichnisses ______________________ 15 3.4 Kopieren der Dateien________________________________________________ 16 3.5 Ende der Installation ________________________________________________ 16 Konfiguration________________________________________________________ 17 4.1 Architecture ______________________________________________________ 20 4.2 Application server __________________________________________________ 20 4.3 SAP BusinessObjects ________________________________________________ 21 4.4 File system paths___________________________________________________ 21 4.5 Security__________________________________________________________ 22 4.6 Repository________________________________________________________ 22 4.7 License key _______________________________________________________ 23 4.8 eMail ___________________________________________________________ 24 4.9 Samples _________________________________________________________ 25 5 Erstellen des Apparo Designer Eintrages für das SAP BusinessObjects Portal _____ 26 6 Installation der Sprachen ______________________________________________ 29 7 Einsatz von Sybase ASE / IQ / Anywhere als Datenquelle _____________________ 32 7.1 8 Verwendung des passenden Sybase IQ Treibers ____________________________ 32 Konfiguration der Client Internet-Browser_______ Fehler! Textmarke nicht definiert. 2 / 35 9 10 Automatisierte Konfiguration___________________________________________ 33 Support ___________________________________________________________ 33 3 / 35 1 Vor der Installation Die Installation von Apparo Fast Edit benötigt etwa 30 Minuten, wenn ihr System vorbereitet ist. Bitte beachten Sie folgende Punkte: 1.1 Hardware-Anforderungen 1.2 Dateisystem ca. 500 MB Hauptspeicher ca. 700 MB (bei 64 Bit: ca. 1000 MB) Unterstützte Betriebssysteme 1.3 Unterstützte SAP BusinessObjects Versionen 1.4 SAP BusinessObjects Enterprise 4.0/4.1 Unterstützte virtuelle Umgebungen 1.5 Windows 2012 (64 Bit) Windows 2008 R2 (64 Bit) Windows 2008 (64 Bit) Windows 2003 (64 Bit) VMware ESX, ESXi VMware Server Unterstützte Security-Systeme Es werden alle von SAP BusinessObjects eingesetzten Security-Systeme unterstützt, da Apparo Fast Edit auf SAP BusinessObjects aufbaut. Apparo Fast Edit muss mit einem lokalen Windows-Administrator Account installiert werden. SAP BusinessObjects muss bereits installiert und lauffähig sein. 4 / 35 1.6 Architektur Folgende Architekturen sind möglich: Single Instance Die bereits installierte SAP BusinessObjects-Umgebung ist komplett auf einem Host installiert und das Apparo Fast Edit System soll ebenfalls auf diesem Host installiert werden. Single Instance ist ebenfalls für den Test- und Entwicklungsbetrieb geeignet. Dieses Dokument beschreibt die Installation für eine single instance-Architektur. Multi Instance Die bereits installierte SAP BusinessObjects-Umgebung ist auf mehreren Hosts installiert oder das Apparo Fast Edit System soll teilweise auf einem anderen Host installiert werden. Multi Instance eignet sich für höhere Performance und Verfügbarkeit. Wenn Sie sich für eine multi instance-Architektur entscheiden, so ist das aktuelle Installationsdokument nicht geeignet. Verwenden Sie in diesem Fall das Installation cluster – Dokument. 5 / 35 Sie finden ein ausführlicheres Architekturdokument im Setup-File. Die Single-Instance Architektur hat folgenden Aufbau: Client Client Client Apparo Gateway (Apache Webserver) und Apparo Application Server (Apache Tomcat) Apparo Repository 6 / 35 1.7 Überblick der Installationsschritte Vorbereitung Optional: Erstellen des Datenbank-Users für das Apparo Repository Ermittlung des SAP BusinessObjects Portal Ordners für den Apparo Designer-Eintrag Installation Ausführen der Setup-Datei Konfiguration des Apparo Gateways und des Apparo Application Servers Das Apparo Gateway ist die Schnittstelle zwischen den Internet-Browser der Anwender und des Apparo Application Server Der Apparo Application Server führt die eigentlichen Arbeiten aus. Für die Konfiguration wird der Apparo Configuration Manager eingesetzt. Erstellen des Apparo Designer Eintrages in Portal von SAP BusinessObjects Damit wird der Eintrag für den Apparo Designer definiert. Installation der Sprachen Installation der unterstützten Sprachen im Apparo Designer 7 / 35 2 Vorbereitung Vorbereitung Optional: Erstellen des Datenbank-Users für das Apparo Repository Ermittlung des SAP BusinessObjects Portal Ordners für den Apparo Designer-Eintrag Installation Ausführen der Setup-Datei Konfiguration des Apparo Gateways und des Apparo Application Servers Das Apparo Gateway ist die Schnittstelle zwischen den Internet-Browser der Anwender und des Apparo Application Server Der Apparo Application Server führt die eigentlichen Arbeiten aus. Für die Konfiguration wird der Apparo Configuration Manager eingesetzt. Erstellen des Apparo Designer Eintrages in Portal von SAP BusinessObjects Damit wird der Eintrag für den Apparo Designer definiert. Installation der Sprachen Installation der unterstützten Sprachen im Apparo Designer 8 / 35 2.1 Erstellen des Datenbank-Users für das Apparo Repository Apparo Fast Edit benötigt ein Datenbank-Repository, in dem Ihre Definitionen zentral gespeichert werden. Folgende Datenbanken werden unterstützt: Oracle 10g-12c IBM DB2 9-10.5 MS SQL Server 2005-2014 Interne Datenbank (für Test- und Entwicklungssysteme geeignet) Der Datenbank-User muss bereits vor der Installation/Konfiguration angelegt sein, falls Sie nicht die „interne Datenbank“ für das Apparo Repository verwenden wollen. Sie finden eine ausführlichere Beschreibung im Dokument “Installation – creating database user“. Notwendige Rechte des Datenbank-Users: Der Datenbank-User muss Datenbanktabellen anlegen können Ein Login muss möglich sein 9 / 35 2.2 Portalordner für Apparo Designer Eintrag Erstellen Sie jetzt einen neuen Ordner (Folder) in SAP InfoView bzw. BI Launch Pad. In diesem Ordner wird später der neue Eintrag „Apparo Designer“ angelegt: 10 / 35 2.3 Anpassungen an einem Reverse Proxy Server Wenn das SAP BusinessObjects System durch ein Reverse Proxy Server erreichbar ist, so muss das virtuelle Verzeichnis /apparo/, zum Beispiel http://servername/apparo, freigeschaltet werden. D.h. der Administrator für diesen Server muss diese Einstellungen anpassen. Falls die Einstellungen des Reverse Proxys nicht geändert werden, dann ist Apparo Fast Edit nicht funktionsfähig. 11 / 35 3 Installation Vorbereitung Optional: Erstellen des Datenbank-Users für das Apparo Repository Ermittlung des SAP BusinessObjects Portal Ordners für den Apparo Designer-Eintrag Installation Ausführen der Setup-Datei Konfiguration des Apparo Gateways und des Apparo Application Servers Das Apparo Gateway ist die Schnittstelle zwischen den Internet-Browser der Anwender und des Apparo Application Server Der Apparo Application Server führt die eigentlichen Arbeiten aus. Für die Konfiguration wird der Apparo Configuration Manager eingesetzt. Erstellen des Apparo Designer Eintrages in Portal von SAP BusinessObjects Damit wird der Eintrag für den Apparo Designer definiert. Installation der Sprachen Installation der unterstützten Sprachen im Apparo Designer 12 / 35 Sie starten mit der eigentlichen Installation, indem Sie diese Datei öffnen: FastEdit3.x.x.x.yyy_win64_tomcat_sapbo.exe Bestätigen Sie den Installationsstart durch Klick auf „Next“. 3.1 Lizenzbeschreibung Lesen Sie den Lizenztext und bestätigen Sie mit „Next“. 13 / 35 3.2 Auswahl der Zielarchitektur Bitte wählen Sie die Zielarchitektur Single Instance aus und drücken Sie „Next>“. 14 / 35 3.3 Festlegen des Starteintrages und des Zielverzeichnisses Der Standardname für den Eintrag im Startmenü ist „Apparo“. Anschließend bitte „Next“ drücken. Im angegebenen Dateiverzeichnis wird Apparo Fast Edit anschließend installiert. Drücken Sie “Install”. 15 / 35 3.4 Kopieren der Dateien Nun werden die notwendigen Dateien kopiert. Nachdem die Dateien installiert wurden, erfolgt die Konfiguration mit dem Apparo Configuration Manager. 3.5 Ende der Installation Drücken Sie „Finish" und anschließend öffnet sich der Apparo Configuration Manager. 16 / 35 4 Konfiguration Vorbereitung Optional: Erstellen des Datenbank-Users für das Apparo Repository Ermittlung des SAP BusinessObjects Portal Ordners für den Apparo Designer-Eintrag Installation Ausführen der Setup-Datei Konfiguration des Apparo Gateways und des Apparo Application Servers Das Apparo Gateway ist die Schnittstelle zwischen den Internet-Browser der Anwender und des Apparo Application Server Der Apparo Application Server führt die eigentlichen Arbeiten aus. Für die Konfiguration wird der Apparo Configuration Manager eingesetzt. Erstellen des Apparo Designer Eintrages in Portal von SAP BusinessObjects Damit wird der Eintrag für den Apparo Designer definiert. Installation der Sprachen Installation der unterstützten Sprachen im Apparo Designer 17 / 35 Mit dem Apparo Configuration Manager können Sie jederzeit Apparo Fast Edit konfigurieren, um z.B. den Datenbank-User für das Apparo Repository zu ändern oder um das Verzeichnis für Skripte anzupassen usw. Die Einstellungen sind in mehrere Kapitel gruppiert (siehe linke Seite). Jede Einstellung hat eine ausführliche Beschreibung (gelber Block) Nachdem Sie alle Einstellungen definiert haben, können Sie mit Klick auf „Test Configuration“ die Einstellungen überprüfen lassen und mit „Start Fast Edit“ den Application Server starten. 18 / 35 Vorgehensweise: Definieren Sie alle Einstellungen Drücken Sie zum Test aller Einstellungen die Schaltfläche „Test Configuration“ Drücken Sie zum Start des Application Servers die Schaltfläche „Start Fast Edit“ Die Logdatei des Application Servers sehen Sie mit „Show Log“ Bei Erfolg sollten Sie folgenden Eintrag in der Log-Datei sehen: 2009-11-07 02:37:41,831 INFO com.apparo.kfe.listeners.KfeServletContextListener ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + Apparo Fast Edit 3.0.x (Build nnn) was successfully started at 07.11.2015 02:37:41 + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Die Konfiguration von Apparo Fast Edit wird in die Datei configuration.xml im Verzeichnis [APPARO_HOME]\FastEdit\cm gespeichert. Falls Sie ein Parallelsystem mit ähnlicher Konfiguration planen, so können Sie nach der Installation diese Datei vom 1. System in das Zielsystem kopieren. Wenn Sie anschließend den Configuration Manager neu starten, so werden diese Einstellungen automatisch übernommen. Test des Apparo Application Servers ohne Apparo Gateway: Mit http://<applicationserver:<Communication port>/apparo/pages/apptest.xhtml Beispiel: http://server1:9800/apparo/pages/apptest.xhtml Mit diesem Aufruf können Sie testen, ob der Apparo Application Server erfolgreich gestartet wurde. 19 / 35 4.1 Architecture In diesem Kapitel des Configuration Managers finden Sie die vorher ausgewählte Apparo Fast Edit Architektur incl. Beschreibung. Diese Einstellung ist nicht änderbar. 4.2 Application server Hier finden Sie die Einstellungen für den Application server (Apache Tomcat). 20 / 35 4.3 SAP BusinessObjects Einstelllungen für die parallel installierte SAP BusinessObjects-Umgebung. 4.4 File system paths Hier definieren Sie die Dateiverzeichnisse für die Skripte und Java-Klassen für Werteüberprüfungen. 21 / 35 4.5 Security Hier können Sie optional die notwendige Sicherheitsgruppe festlegen, um den Apparo Designer öffnen zu können. Nur Anwender, die Mitglied in dieser Gruppe sind, können später den Apparo Designer öffnen und neue Business Cases erstellen. Wenn kein Gruppenname eingetragen ist (Standardeinstellung), können alle Anwender den Apparo Designer öffnen. 4.6 Repository Alle Definitionen für das Apparo Repository: -s 22 / 35 4.7 License key Hier ist der Platz für den Lizenzschlüssel: 23 / 35 4.8 eMail Settings für den Einsatz von eMails. Dieser eMail-Server wird von Apparo Fast Edit verwendet, wenn automatisch eMails verschickt werden sollen. Diese Einstellungen sind optional. 24 / 35 4.9 Samples Samples sind vordefinierte Datenbanktabellen mit Inhalt und dazu passenden Business Cases. Die Sample-Tabellen werden bei Bedarf automatisch von Apparo Fast Edit installiert. Folgende Datenbanken werden unterstützt: Oracle IBM DB2 MS SQL Server Die Business Case Definitionen finden Sie unter: [APPARO_HOME]\FastEdit\samples\samples.xm l Diese Business Cases demonstrieren viele Features von Apparo Fast Edit. Sie benötigen für die Installation einen Datenbankuser mit den notwendigen Berechtigungen (create table). Im Apparo Designer können Sie anschließend eine neue Datenbankverbindung SAMPLES definieren, die auf diese Tabellen zurückgreift. Achtung: Der Schema-Name ist fest auf „fesamples“ festgelegt. 25 / 35 5 Erstellen des Apparo Designer Eintrages für das SAP BusinessObjects Portal Vorbereitung Optional: Erstellen des Datenbank-Users für das Apparo Repository Ermittlung des SAP BusinessObjects Portal Ordners für den Apparo Designer-Eintrag Installation Ausführen der Setup-Datei Konfiguration des Apparo Gateways und des Apparo Application Servers Das Apparo Gateway ist die Schnittstelle zwischen den Internet-Browser der Anwender und des Apparo Application Server Der Apparo Application Server führt die eigentlichen Arbeiten aus. Für die Konfiguration wird der Apparo Configuration Manager eingesetzt. Erstellen des Apparo Designer Eintrages in Portal von SAP BusinessObjects Damit wird der Eintrag für den Apparo Designer definiert. Installation der Sprachen Installation der unterstützten Sprachen im Apparo Designer 26 / 35 Mit dem Apparo Designerkönnen Sie neue Business Cases, Datenbankverbindungen usw. definieren. Der Apparo Designerwird mittels einem Eintrag im Portal von SAP BusinessObjects gestartet. Dieser Eintrag muss jetzt manuell erstellt werden. Öffnen Sie dafür das Start-Menü, wählen Sie den Eintrag„Apparo“ (bzw. den Namen, den Sie vorher bei der Installation verwendet haben) und wählen Sie den Eintrag “Designer Link” Nun sollten Sie folgende Textdatei sehen: Kopieren Sie jetzt die komplette URL-Zeile. Anschließend müssen Sie sich in das SAP BusinessObjects-System einloggen und in das InfoView-Verzeichnis wechseln, das Sie im Apparo Configuration Manager angegeben haben. Erstellen Sie jetzt in diesem Ordner einen neuen Hyperlink-Eintrag: 27 / 35 Starten Sie nun den Apparo Designer, indem Sie den neu erstellten Eintrag auswählen. Folgendes Fenster öffnet sich: 28 / 35 6 Installation der Sprachen Vorbereitung Optional: Erstellen des Datenbank-Users für das Apparo Repository Ermittlung des SAP BusinessObjects Portal Ordners für den Apparo Designer-Eintrag Installation Ausführen der Setup-Datei Konfiguration des Apparo Gateways und des Apparo Application Servers Das Apparo Gateway ist die Schnittstelle zwischen den Internet-Browser der Anwender und des Apparo Application Server Der Apparo Application Server führt die eigentlichen Arbeiten aus. Für die Konfiguration wird der Apparo Configuration Manager eingesetzt. Erstellen des Apparo Designer Eintrages in Portal von SAP BusinessObjects Damit wird der Eintrag für den Apparo Designer definiert. Installation der Sprachen Installation der unterstützten Sprachen im Apparo Designer 29 / 35 Nun müssen die Sprachen installiert werden, die von Apparo Fast Edit unterstützt werden sollen. Die Anwender können später dann diese Sprachen in den Business Cases verwenden. Drücken Sie „Browse“ und wählen Sie das Dateiverzeichnis mit den Sprachdateien in [APPARO_HOME]\FastEdit\languages und wählen z.B. die Datei „English.xml“. Falls Sie zu diesem Zeitpunkt keinen Zugriff auf das Dateiverzeichnis des Servers haben, so können Sie auch auf der Clientseite die komplette Dokumentation incl. Sprachdateien installieren. Dafür finden Sie in der Apparo-Downloadarea ein Dokumentations -Setup. 30 / 35 Die Installation & Konfiguration ist damit erfolgreich abgeschlossen. Lesen Sie die Dokumente “Training Guide” für den Einstieg. Sie finden alle Dokumente serverseitig unter Windows-Start Button (unten links) \ Alle Programme \Apparo \ Documentation Im Benutzerhandbuch wird die Bedienung von Apparo Fast Edit ausführlich beschrieben. Die komplette Dokumentation kann auch clientseitig unter Windows installiert werden. Das dazu notwendige Setup finden Sie in der Download Area: http://download.apparo.info 31 / 35 7 Einsatz von Sybase ASE / IQ / Anywhere als Datenquelle Falls Sybase als Datenquelle verwendet werden soll, so muß für den Einsatz des Sybase ASE/IQ/Anywhere JDBC Treibers zusätzlich die MASTER-Datenbank konfiguriert werden. Sie finden die original Sybase Dateien in [APPARO_HOME]\etc\Sybase_JDBC\jConnect-7 _0\sp Abhängig von der eingesetzten Datenbankversion muß das jeweilige Script für die MASTER-DB ausgeführt werden: 7.1 sql_server.sql – installs stored procedures on Adaptive Server earlier than version 12.0. sql_server12.sql – installs stored procedures on Adaptive Server 12.0.x. sql_server12.5.sql – installs stored procedures on Adaptive Server 12.5.x. sql_server15.0.sql – installs stored procedures on Adaptive Server 15.0.x through 15.5.x. sql_server15.7.sql – installs stored procedures on Adaptive Server 15.7 or later. sql_asa.sql – installs stored procedures on SQL Anywhere 9.x. sql_asa10.sql – installs stored procedures on SQL Anywhere 10.x. sql_asa11.sql – installs stored procedures on SQL Anywhere 11.x. sql_asa11.sql – installs stored procedures on SQL Anywhere 12.x. Verwendung des passenden Sybase IQ Treibers Für die Auswahl des passenden Treibers gibt es jetzt in afe.properties in cm\input diesen Eintrag: # Sybase JDBC driver - version 6 or version 7 can be used. # Jconnect 6: For Sybase IQ version less or equals than 15.2 jdbc.sybase.driver=com.sybase.jdbc3.jdbc.SybDriver # Sybase JDBC driver Jconnect 7: For Sybase IQ version 15.4 and higher #jdbc.sybase.driver=com.sybase.jdbc4.jdbc.SybDriver Abhängig welchen Driver man verwendet, muss er aktiviert bzw. der nicht verwendete mit # am Zeilenanfang auskommentiert werden. Zum Schluss im Configuration Manager „Start Fast Edit“ drücken. 32 / 35 8 Automatisierte Konfiguration Sie können Mandanten (inklusive Sprachen, Ordner, Business Cases, Verbindungen, and DB-Meldungen), Business Cases, Ordner und Verbindungen mittels Skript im- und exportieren. 8.1 Import von Definitionen Das Importprogram ist im Verzeichnis “export” gespeichert: [APPARO_HOME]\FastEdit\export Verwenden Sie: afe-import.bat Beim Aufruf ohne Argumente erhalten Sie die folgende Hilfe: -afeUrl <URL> URL der Apparo Installation zu der importiert werden soll. Beispiel: http://localhost:18000/KFE. If you Fehlt die Angabe wird automatisch die Installation dieses Servers verwendet. -clientId <CLIENT_ID> ID des Mandanten zu dem die zu importierende Definition gehört (BCs, Verbindungen, Ordner) -f <FILE> Dateiname und Pfad in dem die Definition gespeichert ist -h Zeigt die Hilfe an -importSecurity <true|false> Wenn false, dann werden die Sicherheitsgruppen nicht mit importiert. -overwriteBc <true|false> Wenn true, dann werden existierende Business Cases mit identischen IDs überschrieben. -overwriteClient <true|false> Wenn true, dann werden gleichnamige vorhandene Mandanten überschrieben. -overwriteConnection <true|false> Wenn true, dann werden gleichnamige vorhandene Verbindungen überschrieben -p <PASSWORD> Das Paswort des Logins. Pflichtangabe in gesicherten NichtBI Umgebungen -u <USERNAME> Der Username des Logins. Pflichtangabe in gesicherten NichtBI Umgebungen Alle Import-Aktivitäten sind im Verzeichnis log unter afeimport.log gespeichert. Beispiel: afe-import.bat –f \etc\definition.xml 8.2 –u aferep –p aferep Export von Definitionen Das Exportprogram ist im Verzeichnis “export” gespeichert: [APPARO_HOME]\FastEdit\export 33 / 35 Verwenden Sie: afe-export.bat Beim Aufruf ohne Argumente erhalten Sie die folgende Hilfe: -afeUrl <URL> URL der Apparo Installation von der exportiert werden soll. Beispiel: http://localhost:18000/KFE. If you Fehlt die Angabe wird automatisch die Installation dieses Servers verwendet. -bcid <BUSINESS_CASE_ID> ID des zu exportierenden Business Cases -clientId <CLIENT_ID> ID des zu exportierenden Mandanten oder Mandant zu dem die zu exportierende Definition gehört (BCs, Verbindungen, Ordner) -dbc <CONN_NAME> Name der zu exportierenden DB-Verbindung -emailc <CONN_NAME> Name der zu exportierenden E-Mailverbindung -f <FILEPATH> Dateiname und Pfad in dem die Definition gespeichert wird -folderPath <PATH> Pfad des zu exportierenden BC-Ordners. Beispiel: /Ordner/Unterordner -h Zeigt die Hilfe an -p <PASSWORD> Das Paswort des Logins. Pflichtangabe in gesicherten NichtBI Umgebungen -u <USERNAME> Der Username des Logins. Pflichtangabe in gesicherten NichtBI Umgebungen Alle Export-Aktivitäten sind im Verzeichnis log unter afeexport.log gespeichert. Beispiel: Afe-export.bat –f \etc\definition.xml -clientId DemoClient 34 / 35 9 Support Falls Sie Unterstützung benötigen, schreiben Sie bitte eine eMail an: [email protected] 35 / 35
