Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
start:beta [2024/07/07 13:01] – Harald Schmidstart:beta [2024/07/09 04:22] (aktuell) – Harald Schmid
Zeile 1: Zeile 1:
 ====== Betatest ====== ====== Betatest ======
  
-  - Herunterladen der Installationsdateien +===== Vorbemerkungen =====
-    - is_main_setup.exe +
-    - is_bpl_setup.exe +
-    - oder in einer Zip-Datei: is_setup.zip +
-  - ggf. Entpacken der beiden Installationspakete +
-  - 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 +
-  - 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 ;-)) +
-  - Danach kann man die Datei insights.exe aufrufen+
  
 +  * 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.
  
-Beim ersten Start des Programms landet man im Modul für die Einstellungen, in dem man die Verbindungsparameter konfigurieren kann:+===== Schwerpunkte des Betatests =====
  
-Soll die Verbindung zum A5-Datenbank-Server über einen SSH-Tunnel hergestell werden, empfiehlt sich, diesen SSH-Parameter zuerst zu konfigurieren.+Folgende Punkte sind in dieser ersten Testphase besonders wichtig:
  
-===== Konfiguration der SSH-Einstellungen =====+  - 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]].
  
-{{:start:pasted:20240707-125129.png}}+===== Vorbereitungen zum Testen von Insights =====
  
-Klicken Sie auf den Toolbutton "Verbindung hinzufügen"+  - 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.
  
-{{:start:pasted:20240707-125333.png}} 
  
-und wählen die SSH-Verbindungseinstellungen aus.+Beim ersten Start des Programms landet man im Modul für die Einstellungen, in dem man die Verbindungsparameter konfigurieren kann/muss.
  
-{{:start:pasted:20240707-125544.png}}+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]]
  
-Füllen Sie die entsprechenden Parameter aus und klicken anschließend auf den Speichern-Button. Bitte beachten Sie, dass Sie nur den Dateinamen der Schlüssel-Datei angeben, die Sie vorher in das "insights\keys"-Verzeichnis kopiert haben, ohne die Dateiendung .key bzw. .ppk.+===== 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 ===== ===== Konfiguration der Datenbank-Einstellungen =====
Zeile 35: Zeile 48:
 Jetzt müssen noch die Parameter für den Datenbankzugriff konfiguriert werden. Jetzt müssen noch die Parameter für den Datenbankzugriff konfiguriert werden.
  
-Klicken Sie erneut auf "Verbindung hinzufügen" (siehe oben) und wählen nun die Datenbankeinstellungen aus.+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...