Installationsanleitung. Apparo Fast Edit. Version 3.0.7

Transkript

1 Installationsanleitung Apparo Fast Edit Für QlikView / Single Version / 33

2 1 Vor der Installation Hardware-Anforderungen Unterstützte Betriebssysteme Unterstützte QlikView Versionen Unterstützte virtuelle Umgebungen Unterstützte Security-Systeme Überblick der Installationsschritte 5 2 Vorbereitung Erstellen des Datenbank-Users für das Apparo repository 7 3 Installation Lizenzbeschreibung Festlegen des Zielverzeichnisses Kopieren der Dateien Ende der Installation 11 4 Konfiguration Architecture Application server QlikView File system paths Web security system security system Repository License key 22 5 Vorbereitung der QlikView Umgebung Installation der QlikView Erweiterungen für den QlikView Server Den Apparo Designer starten 26 6 Installation der Mandanten 27 7 Configuration Manager via command line 30 8 Import/Export von Definitionen via command line Import von Definitionen Export von Definitionen 32 9 Support 33 1 Vor der Installation Die Installation von Apparo Fast Edit benötigt etwa 15 Minuten, wenn ihr System vorbereitet ist. Bitte beachten Sie folgende Punkte: 2 / 33

3 1.1 Hardware-Anforderungen Dateisystem ca. 800 MB Hauptspeicher ca MB 1.2 Unterstützte Betriebssysteme Windows (64 Bit) 1.3 Unterstützte QlikView Versionen QlikView 11 Server und Desktop QlikView 12 Server und Desktop 1.4 Unterstützte virtuelle Umgebungen VMware ESX, ESXi VMware Player 1.5 Unterstützte Security-Systeme Es werden alle von QlikView eingesetzten Security-Systeme unterstützt, da Apparo Fast Edit auf QlikView aufbaut und keine eigenes Security-System verwendet. 3 / 33

4 Apparo Fast Edit muss mit einem lokalen Windows-Administrator Account installiert werden. QlikView muss bereits installiert und lauffähig sein. Es wird ein QlikView-Login benötigt, der Mitglied der Gruppe QlikView Management API ist. 4 / 33

5 1.6 Überblick der Installationsschritte Vorbereitung Erstellen des Datenbank-Users für das Apparo repository Installation Ausführen der Setup-Datei Konfiguration des Apparo application server Einsatz des Apparo Configuration Managers für die Konfiguration Bereitstellung des Dokuments für den Apparo Designer Installation der Mandanten Installation der unterstützten Sprachen im Apparo Designer 5 / 33

6 2 Vorbereitung Vorbereitung Erstellen des Datenbank-Users für das Apparo repository Installation Ausführen der Setup-Datei Konfiguration des Apparo application server Einsatz des Apparo Configuration Managers für die Konfiguration Bereitstellung des Dokuments für den Apparo Designer Installation der Mandanten Installation der unterstützten Sprachen im Apparo Designer 6 / 33

7 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 IBM DB/2 LUW MS SQL Server Interne Datenbank (Apache Derby, für Test- und Entwicklungssysteme geeignet) Wenn Sie die interne Datenbank nicht einsetzen wollen, dann muss der Datenbank-User bereits vor der Installation/Konfiguration angelegt sein. Sie finden eine ausführlichere Beschreibung im Dokument Installation creating database repository. Notwendige Rechte des Datenbank-Users: Der Datenbank-User muss Datenbanktabellen anlegen können Ein Login muss möglich sein Siehe Dokument Installation creating database repository 7 / 33

8 3 Installation Vorbereitung Erstellen des Datenbank-Users für das Apparo repository Installation Ausführen der Setup-Datei Konfiguration des Apparo application server Einsatz des Apparo Configuration Managers für die Konfiguration Bereitstellung des Dokuments für den Apparo Designer Installation der Mandanten Installation der unterstützten Sprachen im Apparo Designer 8 / 33

9 Sie starten mit der eigentlichen Installation, indem Sie diese Datei öffnen: FastEdit _yyy_win64_tomcat_qlikview_single.exe Bestätigen Sie den Installationsstart durch Klick auf Next. 3.1 Lizenzbeschreibung Lesen Sie den Lizenztext und bestätigen Sie mit Next. 9 / 33

10 3.2 Festlegen des Zielverzeichnisses Im angegebenen Dateiverzeichnis wird Apparo Fast Edit anschließend installiert. Drücken Sie Next. 10 / 33

11 3.3 Kopieren der Dateien Nachdem die Dateien installiert wurden, erfolgt die Konfiguration mit dem Apparo Configuration Manager. 3.4 Ende der Installation Drücken Sie Finish" und anschließend öffnet sich der Apparo Configuration Manager. 11 / 33

12 4 Konfiguration Vorbereitung Erstellen des Datenbank-Users für das Apparo repository Installation Ausführen der Setup-Datei Konfiguration des Apparo application server Einsatz des Apparo Configuration Managers für die Konfiguration Bereitstellung des Dokuments für den Apparo Designer Installation der Mandanten Installation der unterstützten Sprachen im Apparo Designer 12 / 33

13 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. 13 / 33

14 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: Apparo Fast Edit (Build nnn) was successfully started at :37: / 33

15 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. 15 / 33

16 4.2 Application server Hier finden Sie die Einstellungen für den Application server. 16 / 33

17 4.3 QlikView Einstelllungen für die parallel installierte QlikView-Umgebung. Der Login-User muß Mitglieder der Gruppe QlikView Management API sein. 17 / 33

18 4.4 File system paths Hier definieren Sie die Dateiverzeichnisse für die Mandanten, Skripte und Java-Klassen für Werteüberprüfungen. 18 / 33

19 4.5 Web security system Hier können Sie optional die notwendige Sicherheitsgruppe festlegen, um den Apparo Designer mit Vollzugriff öffnen zu können. Nur Anwender, die Mitglied in dieser Gruppe sind, können später den Apparo Designer öffnen und haben dabei Vollzugriff, können neue Mandanten erstellen usw. Wenn kein Gruppenname eingetragen ist, können alle Anwender den Apparo Designer mit Vollzugriff öffnen. 19 / 33

20 4.6 security system Hier können Sie optional Active Directory auswählen, dass im Fall von Business Cases des Typs Excel Import verwendet wird. 20 / 33

21 4.7 Repository Alle Definitionen für das Apparo repository: 21 / 33

22 4.8 License key Hier ist der Platz für den Lizenzschlüssel: -kontakt: 22 / 33

23 5 Vorbereitung der QlikView Umgebung Vorbereitung Erstellen des Datenbank-Users für das Apparo repository Installation Ausführen der Setup-Datei Konfiguration des Apparo application server Einsatz des Apparo Configuration Managers für die Konfiguration Installation der Apparo QlikView Erweiterungen Installation der Mandanten Installation der unterstützten Sprachen im Apparo Designer 23 / 33

24 Speichern der Apparo QlikView Erweiterung in QlikView Server & QlikView Desktop: Öffnen Sie den Windows Explorer und navigieren Sie zum Verzeichnis [APPARO_HOME]\FastEdit\QlikViewExtension Doppelklicken Sie die Datei QlikViewExtension.qar Jett sollten Sie die sehen: Anschließend: Doppelklicken Sie die Datei ApparoDesignerButton.qar 24 / 33

25 5.1 Installation der QlikView Erweiterungen für den QlikView Server Kopieren Sie die beiden Ordner Apparo und ApparoDesignerButton von [APPARO_HOME]\FastEdit\QlikViewExtension nach %ProgramData%\QlikTech\QlikViewServer\Extensions\Objects Window 2003: C:\Documents and Settings\All Users\Application Data\QlikTech\QlikViewServer\Extensions\Objects Windows 2008/2012: C:\ProgramData\QlikTech\QlikViewServer\Extensions\Objects Wenn Sie keinen Ordner "Extensions" oder "Objects" sehen, dann müssen Sie zunächst diese Ordner manuell erstellen. 25 / 33

26 5.2 Apparo Designer starten Um den Apparo Designer zu starten, öffnen Sie den QlikView Client und öffnen ein Dokument. Jetzt können Sie die Apparo-Erweiterung Apparo Designer Button in das Dokumen schieben und anschließend diesen Button drücken: Wenn Sie diesen Button, sehen Sie ein neues Fenster wie folgt: 26 / 33

27 6 Installation der Mandanten Vorbereitung Erstellen des Datenbank-Users für das Apparo repository Installation Ausführen der Setup-Datei Konfiguration des Apparo application server Einsatz des Apparo Configuration Managers für die Konfiguration Installation der Apparo QlikView Erweiterungen Installation der Mandanten Installation der unterstützten Sprachen im Apparo Designer 27 / 33

28 Bitte lesen Sie jetzt das Dokument Configuration Guide, um einen Mandanten erstellen zu können. 28 / 33

29 Die Installation & Konfiguration ist damit erfolgreich abgeschlossen. Lesen Sie die Dokumente First Steps - Training manual 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. 29 / 33

30 7 Configuration Manager via command line Es ist möglich, den Einsatz vom Configuration Manager zu automatisieren. Die vollständige Konfiguration ist in der Datei configuration.xml gespeichert. Sie können diese Datei im Verzeichnis [APPARO_HOME]/FastEdit/cm finden. [APPARO_HOME]/FastEdit/cm/cmc.sh parameter1 parameter2 Parametername -?,--help -deploy true/false -start true/false Funktionalität Hilfstext Deploy Einstellungen Start Apparo Fast Edit (wenn kein Apparo gateway) 30 / 33

31 8 Import/Export von Definitionen via command line 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 Wichtig: Zu diesem Zeitpunkt muss Apparo Fast Edit gestartet sein! 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 Alle Import-Aktivitäten sind im Verzeichnis log unter afeimport.log gespeichert. Beispiel: afe-import.bat f \etc\definition.xml -clientid Sales 31 / 33

32 8.2 Export von Definitionen Das Exportprogram ist im Verzeichnis export gespeichert: [APPARO_HOME]\FastEdit\export 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 Alle Export-Aktivitäten sind im Verzeichnis log unter afeexport.log gespeichert. Beispiel: afe-export.bat f \etc\definition.xml -clientid DemoClient 32 / 33

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