Installationsanleitung. Apparo Fast Edit. Version 3.0

Transkript

1 Installationsanleitung Apparo Fast Edit MS Windows / SAP BusinessObjects Web Intelligence Version 3.0

2 1 Vor der Installation Hardware-Anforderungen Unterstützte Betriebssysteme Unterstützte SAP BusinessObjects Versionen Unterstützte virtuelle Umgebungen Unterstützte Security-Systeme Architektur Überblick der Installationsschritte 7 2 Vorbereitung Erstellen des Datenbank-Users für das Apparo Repository Portalordner für Apparo Designer Eintrag Shared Secret Fehler! Textmarke nicht definiert. 2.4 Anpassungen an einem Reverse Proxy Server 11 3 Installation Lizenzbeschreibung Auswahl der Zielarchitektur Festlegen des Starteintrages und des Zielverzeichnisses Kopieren der Dateien Ende der Installation 16 4 Konfiguration Architecture Application server SAP BusinessObjects File system paths Security Repository License key 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 Verwendung des passenden Sybase IQ Treibers 32 8 Konfiguration der Client Internet-Browser Fehler! Textmarke nicht definiert. 2 / 35

3 9 Automatisierte Konfiguration Support 33 3 / 35

4 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 Dateisystem ca. 500 MB Hauptspeicher ca. 700 MB (bei 64 Bit: ca MB) 1.2 Unterstützte Betriebssysteme Windows 2012 (64 Bit) Windows 2008 R2 (64 Bit) Windows 2008 (64 Bit) Windows 2003 (64 Bit) 1.3 Unterstützte SAP BusinessObjects Versionen SAP BusinessObjects Enterprise 4.0/ Unterstützte virtuelle Umgebungen VMware ESX, ESXi VMware Server 1.5 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

5 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

6 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

7 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

8 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

9 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 DB MS SQL Server 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

10 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

11 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 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

12 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

13 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

14 3.2 Auswahl der Zielarchitektur Bitte wählen Sie die Zielarchitektur Single Instance aus und drücken Sie Next>. 14 / 35

15 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

16 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

17 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

18 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

19 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: :37:41,831 INFO com.apparo.kfe.listeners.kfeservletcontextlistener Apparo Fast Edit 3.0.x (Build nnn) was successfully started at :37: 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 port>/apparo/pages/apptest.xhtml Beispiel: Mit diesem Aufruf können Sie testen, ob der Apparo Application Server erfolgreich gestartet wurde. 19 / 35

20 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

21 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

22 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

23 4.7 License key Hier ist der Platz für den Lizenzschlüssel: 23 / 35

24 4.8 Settings für den Einsatz von s. Dieser -server wird von Apparo Fast Edit verwendet, wenn automatisch s verschickt werden sollen. Diese Einstellungen sind optional. 24 / 35

25 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.xml 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

26 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

27 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

28 Starten Sie nun den Apparo Designer, indem Sie den neu erstellten Eintrag auswählen. Folgendes Fenster öffnet sich: 28 / 35

29 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

30 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

31 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: 31 / 35

32 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: sql_server.sql installs stored procedures on Adaptive Server earlier than version 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. 7.1 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

33 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: 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> -overwritebc <true false> -overwriteclient <true false> -overwriteconnection <true false> Wenn false, dann werden die Sicherheitsgruppen nicht mit importiert. Wenn true, dann werden existierende Business Cases mit identischen IDs überschrieben. Wenn true, dann werden gleichnamige vorhandene Mandanten überschrieben. Wenn true, dann werden gleichnamige vorhandene Verbindungen überschrieben -p <PASSWORD> Das Paswort des Logins. Pflichtangabe in gesicherten Nicht- BI Umgebungen -u <USERNAME> Der Username des Logins. Pflichtangabe in gesicherten Nicht- BI Umgebungen Alle Import-Aktivitäten sind im Verzeichnis log unter afeimport.log gespeichert. Beispiel: afe-import.bat f \etc\definition.xml u aferep p aferep 8.2 Export von Definitionen Das Exportprogram ist im Verzeichnis export gespeichert: [APPARO_HOME]\FastEdit\export 33 / 35

34 Verwenden Sie: afe-export.bat Beim Aufruf ohne Argumente erhalten Sie die folgende Hilfe: -afeurl <URL> -bcid <BUSINESS_CASE_ID> -clientid <CLIENT_ID> -dbc <CONN_NAME> - c <CONN_NAME> URL der Apparo Installation von der exportiert werden soll. Beispiel: If you Fehlt die Angabe wird automatisch die Installation dieses Servers verwendet. ID des zu exportierenden Business Cases ID des zu exportierenden Mandanten oder Mandant zu dem die zu exportierende Definition gehört (BCs, Verbindungen, Ordner) Name der zu exportierenden DB-Verbindung Name der zu exportierenden verbindung -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 Nicht- BI Umgebungen -u <USERNAME> Der Username des Logins. Pflichtangabe in gesicherten Nicht- BI 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

35 9 Support Falls Sie Unterstützung benötigen, schreiben Sie bitte eine an: 35 / 35