Installation

Voraussetzungen

Auf einem Windows-System ab Vista und Server 2008 sind die grundlegenden Vor­aus­setzungen für den Betrieb von VB-Office gegeben.

Für die jeweils benutzte Datenbank-Anbindung sollten alle Treiber und Komponenten in aktueller stabiler Version vorliegen und installiert sein.

Versionsnummern

VB-Office verwendet zwei unterschiedliche Versionsnummern für die Programm- und Daten­bankversion.

Die Programmversion hat den Aufbau 3.60.26.920. Hierbei ist 920 die Build-Nummer, die mit jeder erstellten Programmversion hochgezählt wird. Die Zahl 26 ist der tech­ni­sche Stand – sie wird bei umfangreichen Erweiterungen oder Verbes­se­run­gen hoch­gezählt.

Die Datenbankversion hat einen ähnlichen Aufbau 3.60.16.4, wird aber unabhängig von der Programmversion gezählt. In diesem Beispiel ist 16 der Stand und 4 die Ände­rungs­nummer.

Die Datenbank­version, für die das Programm erstellt wurde, ist aus den Release Notes bzw. aus der Textdatei Datenbankversion_*.txt im Setup-Paket ersichtlich.

Bei der letzten Stelle, der Änderungsnummer, sind die Programme aufwärts­kom­pa­ti­bel: Ein Programm, dass für 3.60.16.4 erstellt wurde, arbeitet auch mit einer Daten­bank der Version 3.60.16.7, allerdings nicht mit einer in Version 3.60.16.2.

Diese Aufwärtskompatibilität hat den Vorteil, dass man im Falle der Gleichheit des Stan­des das Datenbank-Update bereits einspielen kann, ohne dass man direkt auf allen Clients die Programme aktualisieren muss. Außerdem ist dadurch ein Down­grade auf eine frühere Programmversion ohne Zurück­setzen der Datenbank möglich, sofern der aktuelle Datenbank-Stand von dieser Version unterstützt wird.

Das Setup-Paket

Das Setup wird normalerweise als ZIP-Datei mit einem Namen ausgeliefert, der die Programmversion beinhaltet, also z.B. VBOffice_3.60.26.920.zip. Dieses Paket wird gleichermaßen für die Erst-Installation wie auch für Aktualisierungen verwen­det.

In dem Paket befinden sich die folgenden Dateien:

• vbo36setup.exe – das Installationsprogramm
• Release_Notes.pdf – die Hinweise zur Version
• Installation.pdf – diese Installationsanleitung
• VBODBUpdate.exe – das Datenbank-Update-Programm
• VBODBConfig.exe – das Datenbank-Konfigurations-Programm
• VBOProtocolViewer.exe – das Programm zur Anzeige des Datenbankprotokolls
• Programmversion_3.60.26.920.txt – diese Datei beinhaltet die Programmversion im Dateinamen und nochmals als Textinhalt.
• Datenbankversion_3.60.16.4.txt – diese Datei beinhaltet die Datenbankversion im Dateinamen und nochmals als Textinhalt.

Die versionsabhängigen Dateinamen der Textdateien können bei jeder Auslieferung unter­schiedlich sein.

Das Programm VBODBConfig.exe benötigt man für die allererste Installation von VB-Office. Mit ihm legt man die Verbindungsparameter zur Datenbank fest und spei­chert diese auf dem System. Die Verteilung dieser Informationen kann dann durch das Installationsprogramm erfolgen.

Das Installationsprogramm

VB-Office wird über ein Standard-Installationsprogramm auf dem Client-Rechner in­stalliert. Dieses Programm wird aus dem Explorer per Doppelklick bzw. über die Kom­man­do­zeile aufgerufen. Für die Installation werden lokale Administrator-Rechte benötigt, die das Installationsprogramm, falls erforder­lich, mit einem sog. UAC-Prompt einfordert.

Danach führt ein Assistent durch die Installation.

Willkommen-Seite

Diese Seite wird ggf. nicht angezeigt, wenn VB-Office bereits installiert ist und eine Aktualisierung installiert wird.

Bestätigung der Lizenzvereinbarungen

Zielordner wählen

Startmenü-Eintrag benennen

Sonstige Einstellungen vornehmen

Installation bestätigen und starten

Fortschrittsanzeige während der Installation

Fertigmeldung

Aktualisierungen

Neuere Versionen des Programms lassen sich einfach über eine bestehende Instal­la­tion installieren, ohne dass man diese vorher Deinstallieren muss.

Bei einer solchen Aktualisierung werden immer die Werte der letzten Installation vor­geschla­gen und nicht die Standardwerte, die weiter oben zu sehen waren.

Zusätzliche Dateien

VB-Office unterstützt das Kopieren von Bibliotheken und Verbindungsparametern während der Installation, sofern diese Dateien in demselben Verzeichnis abgelegt sind wie das Installationsprogramm selbst.

Die dabei unterstützten Dateien sind:

• Die Datenbank-Verbindungsparameter VBOffice.dbi und
• die Datenbank-Bibliotheksdateien (siehe dazu jeweils die separaten Dokumente „VB-Office Datenbank“ für Oracle bzw. MySQL).

Erster Programmstart

Datenbankverbindung

Vor dem ersten Programmstart müssen die Informationen zur Datenbankverbin­dung auf dem Zielrechner vorhanden sein, so dass VB-Office sich mit der Netzwerk-Daten­bank verbinden kann.

Manuelle Konfiguration

Man erstellt die Konfiguration der Datenbank-Verbindungsparameter mit dem Programm VBODBConfig.exe, das im Setup-Paket enthal­ten ist.

Dieses Programm wird bei der Installation auch im Programmverzeichnis abgelegt.

Die Details zur Konfiguration der unterschiedlichen unterstützten Datenbanken sind jeweils in den separaten Dokumenten „VB-Office Datenbank“ für Oracle, SQL-Server bzw. MySQL beschrieben.

Nach Beendigung mit OK speichert das Programm die Datenbank-Verbindungs­para­meter in der Datei VBOffice.dbi im Arbeitsverzeichnis, standard­mäßig C:\ProgramData\­creaTeam\VB Office.

Automatische Verteilung der Konfiguration

Hat man die o.g. Konfigurationsdatei VBOffice.dbi einmalig erstellt und gelten die Parameter darin auch für alle anderen Client-Computer, dann kann man diese Datei nun in das Verzeichnis des Installationsprogramms vbo36setup*.exe kopieren.

Lizenzeingabe

Beim Start überprüft VB-Office das Vorhandensein des Lizenzschlüssels in der Daten­bank. Ist dieser nicht eingetragen, dann wird er beim Programmstart erfragt:

Beantwortet man diese Frage mit Ja, dann muss der Lizenzschlüssel über die Zwi­schen­ablage an das Programm übergeben werden:

Öffnen Sie dazu die Lizenzdatei Lizenzschlüssel_<NAME>.txt, die Sie von uns er­halten haben, mit einem Text­edi­tor wie z.B. Notepad, markieren den gesamten Text und kopieren Sie ihn in die Zwischen­ablage. Drücken Sie dann in VB-Office den Knopf Einfügen.

Es werden die in der Lizenz enthaltenen Infor­ma­tio­nen angezeigt:

Abschließend wird durch Betätigung des Knopfes Installieren der Lizenzschlüssel in der Datenbank abgelegt.

Datenbank-Aktualisierung

Manche neuen Programmversionen bringen auch Änderungen an der Datenbank­struk­tur mit sich. VB-Office kann diese Änderungen selbst vor­nehmen bzw. ein Skript erzeugen, das dann an die für die Datenbank zuständige Stelle zum Einspielen übermittelt werden kann.

Die genaue Prozedur ist in den separaten Dokumenten „VB-Office Datenbank“ für Oracle, SQL-Server bzw. MySQL beschrieben.

Eine lokale Datenbank wird ohne Rückfrage immer aktua­li­siert.

Varianten

Das Setup wird in drei Varianten ausgeliefert: Standard, Test und Dev (Entwicklung). Alle drei können in unterschiedlichen Versionen auf dem­sel­ben Rechner installiert und jeweils mit unterschiedlichen Datenbanken verbunden sein.

Die beiden nicht standardmäßigen Varianten verwenden jeweils ein anderes Instal­la­tionsverzeichnis, andere Schlüssel in der Windows-Registry sowie andere Arbeits­ver­zeich­nisse unterhalb von C:\ProgramData\creaTeam.

In dem speziellen VB-Office-Installationspaketen Test und Dev gibt es immer zusätz­lich die Datei SETTINGS.APP. Auch schreiben die speziellen Installationsprogramme die iden­tische Datei in das Installationsverzeichnis.

Laufzeitumgebung

Wenn man eine der zu VB-Office gehörenden Programmdateien starten, so benö­ti­gen diese zunächst fünf einfache Informationen für den Betrieb: das Programm­ver­zeich­nis, das Arbeitsverzeichnis, den globalen und benutzerspezifischen Registry-Schlüssel und die Datenbankverbindung.

• Das Programmverzeichnis ist immer das Verzeichnis, in dem die EXE-Datei gespeichert ist und aus dem sie gestartet wird.
• Das Arbeitsverzeichnis ist ein Verzeichnis unterhalb von C:\ProgramData\­creaTeam, standardmäßig C:\ProgramData\creaTeam\VB Office.
• Ist im Programmverzeichnis die Datei SETTINGS.APP vorhanden, dann wird statt­des­sen deren Inhalt zur Ermittlung verwendet, nämlich mit C:\ProgramData\­creaTeam\<erste Zeile aus SETTINGS.APP>.
  Steht z.B. in der ersten Zeile dieser Datei der Text „VB Office DEV“, dann ist das Arbeitsverzeichnis C:\ProgramData\creaTeam\VB Office DEV.
• Der globale Registry-Schlüssel ist standardmäßig HKEY_LOCAL_MACHINE\­SOFT­WARE\WOW6432Node\­creaTeam\VB Office. Ist im Programmverzeichnis die Datei SETTINGS.APP vorhanden, dann gilt auch hier die Ersetzungsregel für den letzten Teil des Schlüssels.
• Der benutzerspezifische Registry-Schlüssel ist standardmäßig HKEY_CURRENT_­USER\­SOFTWARE\­creaTeam\VB Office. Ist im Programmverzeichnis die Datei SETTINGS.APP vorhanden, dann gilt auch hier die Ersetzungsregel für den letzten Teil des Schlüssels.
• Die Programme ermitteln die Parameter für die Datenbankverbindung in der folgenden Reihen­folge:
  1. Liegt im Programmverzeichnis die Datei VBOffice.dbi, dann wird die Zeile „Datenbank=“ aus dieser Datei verwendet.
  2. Liegt im Arbeitsverzeichnis die Datei VBOffice.dbi, dann wird die Zeile „Datenbank=“ aus dieser Datei verwendet. Dies ist der Standard.
  3. Steht im globalen Registry-Schlüssel der Wert Datenbank, dann wird dessen Inhalt verwendet.
  4. Steht im benutzerspezifischen Registry-Schlüssel der Wert Datenbank, dann wird dessen Inhalt verwendet.
  5. Gibt es eine 32-Bit ODBC-Datenquelle namens VBOffice, dann werden deren Einstellungen verwendet.
     Diese Punkte werden von 1 bis 5 in dieser Reihenfolge geprüft. Es wird die erste Kon­figuration verwendet, die gefunden wird. Die Prüfung der Punkte 3-5 existiert nur noch aus Kompatibilitätsgründen für Bestandskunden und wird in der nächsten Zeit deaktiviert werden.

Downgrade

Sollte eine neue Version von VB-Office einen gravierenden Fehler haben, so kann man eine ältere Version einfach wie ein Upgrade installieren – sämtliche Dateien werden durch die alten Versionen ersetzt.

Deinstallation

Aufruf

Die Deinstallation erfolgt aus der Windows-Systemsteuerung heraus. Bis einschließ­lich Windows XP / Server 2003 hieß der Punkt „Software“, ab Vista / Server 2008 hieß er „Programme und Funktionen“ und seit Windows 8 heißt er „Apps & Features“.

Entfernte Dateien

Bei der Deinstallation werden alle in den gewählten Zielordner ko­pierten Dateien ge­löscht und der Zielordner selbst anschließend ebenfalls, sofern es leer ist.

Können irgendwelche Dateien bei der Deinstallation nicht entfernt werden, weil sie in Gebrauch bzw. vom System gesperrt sind, werden beim nächsten Neustart ent­fernt.

Der Inhalt des Arbeitsverzeichnisses (Vorgabe: C:\ProgramData\creaTeam\­VB Office, wird aus Sicherheitsgründen bei der Deinstallation nicht gelöscht und muss bei Bedarf von Hand gelöscht werden.

Automatisierter Aufruf

Silent-Setup

Das Installationsprogramm unterstützt ein Silent-Setup über die Parameter

vbo36setup.exe /VERYSILENT /SUPPRESSMSGBOXES [/NORESTART]

Kommandozeilen-Optionen des Installationsprogramms

Mit den folgenden Kommandozeilen-Optionen kann das Installationsprogramm beim Aufruf gesteuert werden:

/SILENT

Der Assistent und das Hintergrund-Fenster werden nicht angezeigt, das Setup startet ohne Button-Klick automatisch und beendet sich auch ebenso von selbst wieder. Alle anderen Meldungen und Hinweise werden jedoch wie ge­wohnt angezeigt.

/VERYSILENT

Zusätzlich zu /SILENT wird auch das Fortschrittsfenster nicht ange­zeigt. Außerdem wird das System, falls nötig und der Parameter /NORESTART nicht angegeben wurde, automatisch im Anschluss an die Installation neu gestartet.

/SUPPRESSMSGBOXES

Funktioniert nur in Kombination mit /VERYSILENT oder /SILENT und unterdrückt Hinweise und beantwortet die meisten Rückfragen selbsttätig: Dateien werden möglichst nicht überschrieben, „erneut versuchen“ wird nicht angeboten und in den meisten anderen Situationen wird die Frage automatisch mit „Ja“ beantwortet.

/NORESTART

Das Installationsprogramm versucht nicht, das System neu zu starten (auch wenn dies nötig wäre).

/RESTARTEXITCODE=code

Gibt einen speziellen Rückgabewert an, den das Installations­programm zurückliefern soll, falls ein System-Neustart nötig ist.

/DIR="x:\verzeichnis"

Überschreibt die Vorgabe für den Zielordner. Es muss ein absoluter Pfad inkl. Laufwerk angegeben werden.

/GROUP="gruppe"

Überschreibt die Vorgabe für den Namen des Startmenü-Ordners des Installationsassistenten).

/MERGETASKS="optionen"

Überschreibt die Vorgabe für die angegebenen Optionen. Es handelt sich um eine mit komma­separierte Liste der Punkte: desktopicon\common, desktopicon\user und quicklaunchicon. Wird einem der Punkte ein Ausrufezeichen vorangestellt, dann ist es abgewählt. Nicht angegebene Optionen behalten ihren Wert.

/TASKS="optionen"

Wie /MERGETASKS, aber nicht angegebene Optionen werden deaktiviert. Es werden also nur die explizit so angegebenen Optionen aktiviert, alle anderen werden deaktiviert.

Rückgabewerte des Installationsprogramms

0: Die Installation ist erfolgreich bis zum Ende durchgelaufen.

1: Das Installationsprogramm konnte nicht initialisiert werden.

2: Der Anwender hat die Installation abgebrochen, bevor sie eigentlich losging (z.B. schon auf dem Startbildschirm).

3: Es ist ein fataler Fehler zwischen den Installationsphasen aufgetreten. Dies sollte nicht passieren, es sei denn, dem System gehen der Speicher oder die Windows-Ressourcen aus.

4: Es ist ein fataler Fehler während der Installation aufgetreten.

5: Der Anwender hat die Installation abgebrochen, nachdem sie angelaufen war.

Kommandozeilen-Optionen des Deinstallationsprogramms

Das Deinstallationsprogramm unins000.exe wird während der Installation im Zielverzeichnis abgelegt, zusammen mit der entsprechenden Datendatei unins000.dat.

Die oben beschriebenen Kommandozeilen-Optionen /SILENT, /VERYSILENT, /SUPPRESS­MSGBOXES und /NORESTART können auch genutzt werden, um das De­instal­lationsprogramm zu steuern.

Technisches

Digitale Signatur

Sowohl das Installationsprogramm als auch alle installierten Programme und Bib­liotheken, die von der Firma creaTeam Software stammen, sind digital signiert. Das Code-Signing-Zertifikat wurde von der Firma Sectigo ausgestellt (https://sectigo.com/), das verwendete Root-Zertifikat sollte auf Computern mit aktuellem Windows-Betriebssystem vorhanden sein.

Der Fingerabdruck der Signatur (SHA-1) ist:

cf 35 8e 63 1d 6b 37 fb fb eb 96 92 83 d1 48 61 f2 d1 77 ca

Installierte Dateien

Das Installationsprogramm installiert die folgenden Dateien auf dem Zielcomputer:

Programmverzeichnis

• VBOffice.exe
• VBODBConfig.exe
• SETTINGS.APP
• Release_Notes.pdf
• Hunspellx86.dll
• dict-de_DE-frami.oxt
• gdiplus.dll
• oci.dll, ora*.dll
• libmysql.dll
• libcrypto-1_1.dll
• libssl-1_1.dll
• tiff_to_pdf.dll
• unins000.dat
• unins000.exe
• wp_type1ttf.dll
• wpdecodejp.dll
• wPDF300W.dll
• wPDFViewPlus03.dll

Systemverzeichnis (Windows\System32)

• asycfilt.dll
• atl.dll
• comcat.dll
• oleaut32.dll
• olepro32.dll
• stdole2.tlb

Schriftarten-Verzeichnis (Windows\Fonts)

• pcprak.ttf

Arbeitsverzeichnis (ProgramData\creaTeam\VB Office)

• NLS\VBOffice.trf
• VBOffice.dbi

Eingebettete Installationsprogramme

• ShFolder.exe: Installationsprogramm für die Microsoft-Bibliothek ShFolder.dll (http://www.microsoft.com/download/en/details.aspx?id=21762). Wird nicht ausge­führt, wenn diese Bibliothek bereits in Version 5.50.4027.300 oder höher vorliegt.
• 50comupd.exe: Installationsprogramm für die Microsoft-Common-Controls (siehe http://www.microsoft.com/download/en/details.aspx?id=15416). Wird nicht ausge­führt, wenn diese Bibliothek bereits in Version 5.80 oder höher vorliegt.

Uninstall-Informationen

Die von VB-Office benutzte Schlüssel für die Deinstallation ist

{E0824337-2725-408D-B256-46890CBE53AA}\_is1

Man findet die Informationen in der Windows-Registry unter

HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{E0824337-2725-408D-B256-46890CBE53AA}\_is1

bzw. bei 64-Bit-Systemen unter

HKLM\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{E0824337-2725-408D-B256-46890CBE53AA}\_is1

Abweichend dazu sind die Schlüssel für die speziellen Varianten:

Test: {FBA87935-6B3A-408A-92F4-0CF8F5D3CFB1}\_is1
Dev: {8D428B4D-AE61-429D-A652-FCDBD145E61F}\_is1