====== Betatest ======

===== Vorbemerkungen =====

  * Es handelt sich um eine Beta-Version. Die vorhandenen Buttons und Menüpunkte sollten funktionieren. ;-)
  * Es gibt in dieser ersten Start-Version von Insights keine Funktionen, die Daten in A5 ändern können.
  * Die Installationsroutinen legen nur ein Verzeichnis an und kopieren dorthin alle benötigten Dateien.
  * Damit der Uninstaller funktioniert, wird im Programm-Verzeichnis eine unins000.exe erstellt. Wenn man diese aufruft, wird das Programm (auch in der App-Verwaltung von Windows) deinstalliert. Da manche Daten manuell eingefügt werden (z.B. die Schlüsseldatei), wird dabei nicht das komplette Verzeichnis gelöscht. Dieses kann aber zur völligen Deinstallation dann einfach gelöscht werden.

===== Schwerpunkte des Betatests =====

Folgende Punkte sind in dieser ersten Testphase besonders wichtig:

  - Einrichten von Verbindungen
    - da ich ja zum Entwickeln und Testen nur eine bestimmte A5-Installation hatte, bin ich besonders gespannt, ob die Anbindung an die A5-Datenbank auch bei anderen A5-Instanzen wie vorgesehen klappt.
    - SSH-Verbindung - die Verbindung zum AWS-Server über den SSH-Tunnel: Klappt die Verbindung?
    - DB-Verbindung - die Verbindung zur A5-Datenbank, ggf. über den vorher eingerichteten SSH-Tunnel: Steht die Verbindung zur A5-Datenbank?
  - Die Module sollten Daten liefern. Vor allem Module wie die Übersicht über die DokGen-Dokumente oder die Datenquellen müssten auf jeder A5-Konfiguration die entsprechenden Einträge anzeigen. Sind (sinnvolle) Daten vorhanden?
  - In manchen Modulen gibt es über das Kontextmenü in den Tabellen einen Aufruf einer A5-Url. Klappt dieser A5-Aufruf?
  - Ich bin für jedes Melden eines Fehlers dankbar. Auch Bedienungs-Umständlichkeiten oder Verhalten, das anders ist, als erwartet, bitte ich gerne zu melden.
  - Auch über Ideen für Erweiterungen und Verbesserungen, evtl. auch schon für neue Module, freue ich mich. Gerne per Email, MSTeams oder [[start:modulideen|diese Seite]].

===== Vorbereitungen zum Testen von Insights =====

  - Herunterladen der 2 Installationsdateien
    - [[http://insights.hschmid-it.de/files/beta/is_main_setup.exe|is_main_setup.exe]]
    - [[http://insights.hschmid-it.de/files/beta/is_bpl_setup.exe|is_bpl_setup.exe]]
    - oder gepackt in einer Zip-Datei: [[http://insights.hschmid-it.de/files/beta/insights1beta-installer.zip|Insights1beta-Installer.zip]]
  - ggf. Entpacken der Zip-Datei
  - **zuerst**: is_main_setup.exe ausführen
    - Installationsverzeichnis auswählen
    - zweites Installationspaket is_bpl_setup.exe ausführen - dafür muss man das Installationsverzeichnis nicht erneut angeben
  - **Wichtig:** nun muss man, wenn die Verbindung zur A5-Datenbank über eine SSH-Verbindung hergestellt wird, die **Datei mit dem Private-Key** (z.B. priv_read.ppk) ins Unterverzeichnis "Keys" kopieren (dies wird noch komfortabler bis zum Release ;-))
  - Außerdem sollte man in der Ini-Datei (insights.ini) unter [academyFIVE] die Url für die angebundene A5-Instanz eingeben. Damit können dann an verschiedenen Stellen über das Kontextmenü die entsprechenden Seiten im A5 aufgerufen werden.
  - Danach kann man die Datei insights.exe aufrufen.


Beim ersten Start des Programms landet man im Modul für die Einstellungen, in dem man die Verbindungsparameter konfigurieren kann/muss.

Soll die Verbindung zum A5-Datenbank-Server über einen SSH-Tunnel hergestell werden, empfiehlt sich, diese SSH-Parameter zuerst zu konfigurieren. Siehe auch [[module:admin:main:settings|Admin: Einstellungen]]

===== Konfiguration der SSH-Einstellungen =====

Füllen Sie die entsprechenden Parameter aus und testen Sie ggf. die Einstellungen. Klicken Sie anschließend auf den Speichern-Button. Bitte beachten Sie, dass Sie nur den Dateinamen der Schlüssel-Datei angeben (nicht den ganzen Pfad), die Sie vorher in das "insights\keys"-Verzeichnis kopiert haben, **ohne die Dateiendung** .key bzw. .ppk.

===== Konfiguration der Datenbank-Einstellungen =====

Jetzt müssen noch die Parameter für den Datenbankzugriff konfiguriert werden.

Die Parameter ausfüllen und **ggf. nicht vergessen, die passende SSH-Verbindung auszuwählen**. Die Einstellungen wieder speichern. Auch hier empfiehlt es sich, die Einstellungen mit dem entsprechenden Button zu testen.

Nun sind die beiden nötigen Verbindungen eingerichtet und müssen noch aktiviert werden. Erst die SSH-Verbindung, danach die DB-Verbindung.

{{:start:pasted:20240707-130651.png}}

Sind dann beide Verbindungen aktiv, ist Insights einsatzbereit - und merkt sich die Einstellungen für die nächsten Starts.


{{counter}} Besucher...