Vertec On-Premises installieren

Übersicht

• Server-Installation von Vertec
• Client-Zugriffe auf Vertec
• Vertec mit einer Softwareverteilung auf die Clients installieren
• Die verschiedenen Dateien im Überblick
• Starten von Vertec

Die Installation auf dem Server-Rechner umfasst das Vertec Verzeichnis mit allen benötigten Programm- und Datenfiles sowie die Datenbank-Server Applikation (Firebird), falls Sie diese einsetzen wollen.

Auf den Clients kann der Zugriff via Cloud App oder Web App erfolgen. Dafür ist keine Client-Installation notwendig, der Zugang wird über das App Portal eingerichtet.

Soll die Vertec Desktop App auch auf gewissen Client-Rechnern verwendet werden, wird dort eine Vertec Client-Installation vorgenommen. Diese umfasst die Installation der Addins (Explorer Addin und ProCall Addin) und erstellt die Verknüpfungen zu den Programmfiles auf dem Server.

Falls Sie anstatt der mitgelieferten Open-Source Datenbank Firebird den Microsoft SQL Server verwenden wollen, wählen Sie die Option Microsoft SQL Server.

In diesem Fall muss vorgängig die Vertec Datenbank manuell aufgesetzt werden. Bitte beachten Sie den Abschnitt Aufsetzen einer Vertec Datenbank auf SQL Server im Artikel über den Microsoft SQL Server. Danach führen Sie die Server-Installation von Vertec durch.

Die Vertec Server-Installation erfolgt lokal auf dem Server. Starten Sie das zum Download verfügbare Installationsprogramm, zu dem Sie einen Link erhalten haben und folgen Sie den Anweisungen des Programms.

Als Nächstes werden Sie nach dem gewünschten Installationspfad für Vertec gefragt.

Falls auf einem Client die Vertec Desktop App eingesetzt werden muss, muss das Vertec Installationsverzeichnis im Netzwerk freigegeben werden, damit die entsprechenden Client Rechner Zugriff auf die Programmfiles haben. Werden auf den Clients ausschliesslich Vertec Cloud App und Vertec Web App verwendet, ist dies nicht nötig.

Wählen Sie dann die Komponenten aus, die Sie installieren wollen. Falls Sie anstatt der mitgelieferten Open-Source Datenbank Firebird den Microsoft SQL Server verwenden wollen, wählen Sie die Option Microsoft SQL Server.

Die Vertec Lizenzvereinbarungen, die als nächstes eingeblendet werden, müssen Sie bestätigen, um mit dem Setup fortfahren zu können.

Bei Auswahl von Firebird als Datenbank-Server werden Sie nun nach dem Pfad für die Firebird Installation gefragt. Am besten übernehmen Sie den Vorschlag im Installationsdialog. Weiter wird der Firebird Open-Source Lizenzvertrag angezeigt, den Sie bestätigen müssen.

Als Nächstes werden Sie nach den Login Informationen für den Datenbank Server gefragt. Geben Sie dort ein von Ihnen definiertes Passwort ein, welches als Master Passwort für die Datenbank verwendet wird.

Aus Sicherheitsgründen ist es empfehlenswert, ein eigenes Passwort anzugeben (nur mit diesem Passwort ist später ein Zugriff auf die Datenbank möglich). Falls Sie keine Änderungen an der Vorgabe vornehmen, wird ein von Vertec AG festgelegtes Standard-Passwort verwendet.

Falls Sie das Datenbank-Passwort zu einem späteren Zeitpunkt ändern, müssen Sie das neue Passwort verschlüsselt in Ihrer Konfigurationsdatei Vertec.ini eintragen. Die Verschlüsselung erfolgt via Kundenportal, siehe Artikel Bedienung Kundenportal.

Sie werden nach den Login Informationen für den Datenbank Server gefragt. Geben Sie dort bitte Login Name und Passwort für die vorgängig erstellte Datenbank auf dem MS SQL Server ein.

Führen Sie die Installation zu Ende durch, entfernen Sie aber das Häkchen bei Vertec ausführen (Datenbank Initialisierung).

Starten Sie daraufhin die Vertec Desktop App mit dem Parameter /DC.

Im folgenden Fenster sollten unter Zieldatenbank bereits die Konfigurationsangaben stehen, welche Sie während des Installationsprozesses in die Konfigurationsdatei Vertec.ini geschrieben haben. Wählen Sie von den Checkboxen die Option Schema erstellen aus.

Das Passwort muss im dafür vorgesehenen Feld eingegeben werden.

Starten Sie den Vorgang. Im Textfeld wird das Protokoll der Erzeugung der Tabellen angezeigt. Falls während des Vorgangs Fehlermeldungen erscheinen, notieren Sie sich diese und nehmen Sie mit Ihrem Vertec Betreuer Kontakt auf.

Wenn alle Aktionen abgelaufen sind, können Sie das Programm mit dem Button Schliessen beenden.

Wird Vertec auf einem Server installiert, muss der Cloud Server Port freigegeben werden.

Falls auf irgendeinem Client oder auf dem Server selbst die Vertec Desktop App eingesetzt werden muss, müssen zusätzlich der Standard Firebird Port 3050 (TCP) sowie der Notif Port freigeschaltet werden.

Die Information, was auf welchen Ports läuft, finden Sie im Vertec.ini Konfigurationsfile. Dieses befindet sich im Vertec Installationsverzeichnis.

Die Cloud App, die Web App, die Phone App und die Outlook App sind Cloud Clients. Hier läuft die Business-Logik auf dem Server, die Oberfläche wird ebenfalls auf dem Server aufbereitet und die Cloud Clients stellen diese nur dar und empfangen den User-Input. Für die Bereitstellung - intern oder via Internet - ist der Vertec Cloud Server zuständig. Die Informationen dazu finden Sie im Artikel Cloud Server: Bereitstellung und Sicherheit.

Sobald der Cloud Server erreichbar ist, erscheint über die Server URL das App Portal für Cloud Clients.

• Die Cloud App kann über das App Portal eingerichtet werden.
• Der Aufruf der Web App erfolgt per Knopfdruck über das App Portal bzw. über die entsprechende URL (Server URL + /webapp/)
• Die Phone App steht im App Store und auf Google Play zum Download zur Verfügung. Die entsprechenden Links finden sich ebenfalls auf dem App Portal.
• Die Outlook App wird in zwei Editionen bereitgestellt: die Windows Edition, in der die Outlook App im lokalen Windows Client von Outlook läuft und die Web Edition, in der die Outlook App im Office 365 installiert wird. Beide Versionen sind auf dem App Portal zu finden.

Hinweis: Die Anzeige des App Portals kann ab Version 6.6.0.7 mithilfe der Einstellung Portal Page im Vertec.ini-File optional deaktiviert werden. Die verschiedenen Apps greifen von den Clients dann wie folgt auf Vertec zu:

• Die Cloud App wird via Cloud Installer auf dem Client installiert.
• Die Web App ist via Server URL + /webapp/ erreichbar.
• Die Phone App steht im App Store und auf Google Play zum Download zur Verfügung.
• Die Outlook App Windows Edition wird via Outlook Installer auf dem Client installiert.
• Die Outlook App Web Edition wird gemäss Beschreibung Installation der Outlook App Web Edition eingerichtet. Das Manifest ist über via Server URL + /outlookapp/manifest erreichbar.

In folgenden Fällen ist es notwendig, auf einem Client die Desktop App einzusetzen:

• Verwendung einer Schnittstelle, welche nicht cloudfähig ist
• Es muss lokaler Python Code innerhalb von Vertec ausgeführt werden können

In diesem Fall muss ein Desktop App Setup auf dem lokalen Computer durchgeführt werden:

Während der Server-Installation von Vertec wird im Unterverzeichnis Desktop App Setup auf dem Server eine Kopie des Setup.exe Programms abgelegt.

Zum Durchführen einer Client-Installation der Desktop App muss vom Client-Rechner der Zugriff auf das gesamte Installationsverzeichnis von Vertec auf dem Server gewährleistet sein. Richten Sie dazu eine Netzwerk-Freigabe des Vertec Installationsverzeichnisses ein. Ausserdem müssen für die Installation lokale Admin-Rechte vorhanden sein.

Öffnen Sie vom Client Rechner aus das Installationsverzeichnis von Vertec auf dem Server. Starten Sie aus dem Unterordner Desktop App Setup das Setup.exe Programm.

Für das Zielverzeichnis auf dem Client Rechner akzeptieren Sie am besten den Vorschlag des Setup Programms (C:\Programme\Vertec). Nach Abschluss des Setup-Programms sollte die Vertec Desktop App einsatzbereit sein. Das Programm kann nun über die im Start-Menü installierten Verknüpfungen gestartet werden.

Der Desktop App Setup

Beim Desktop App Setup werden alle benötigten Files auf den Client Rechner kopiert und dort installiert.

Dies hat folgende Vorteile:

• Relativ kurze Ladezeit durch die lokale Installation
• Wenig Probleme mit Sicherheitsfunktionen in Windows, welche Executables von ausserhalb des eigenen Computers blockieren oder als verdächtig taxieren
• Der Client kann auch aus dem LAN rausgenommen werden und die Vertec Desktop App remote über VPN verwendet werden (wird der Client nur über VPN betrieben, ist die Latenz im Netzwerk entscheidend. Siehe dazu den Artikel Performance im Netz).

Vertec Desktop App

Bei einer lokalen Client-Installation (die Programmdateien befinden sich auf dem Client Rechner) mittels Software-Verteilung müssen folgende Schritte durchgeführt werden:

• Kopie aller auf dem Server vorhandenen Files, ausser:
  • Vertec.CloudServer.exe
  • Vertec.Session.exe
  • Vertec.CloudInstaller.exe
  • Ordner Desktop App Setup
  • Ordner DB

• Auf den Clients wird .NET ab Version 4.8 benötigt, damit die Oberfläche dargestellt werden kann. Es muss sichergestellt sein, dass die entsprechende .NET Version auf den Clients installiert ist.
• Registrierung des Vertec COM Servers durch Aufstarten von Vertec.Desktop.exe als Administrator mit dem Parameter /regserver /silent.
• Soll das Explorer oder das ProCall Addin auf dem Client verwendet werden, müssen diese lokal registriert werden. Doppelklicken Sie dafür vom Client aus die entsprechenden Batch-Dateien (.bat) im Unterordner Addins in Ihrem Vertec Installationsverzeichnis. Bitte beachten Sie, dass Sie dazu über ein freigegebenes Laufwerk und nicht über UNC auf den Server zugreifen, da die Batch-Files sonst nicht funktionieren.
  • Bei einem Update des Explorer Addins beachten Sie bitte den Abschnitt Update Explorer Addin im Artikel über die Vertec Addins.
  • CefSharp Ordner
  • Microsoft Visual C++ 2015 Library (64 Bit). Installation mit lokalen Admin-Rechten via Redist Unterordner.
• Soll der Protocol Handler auf dem Client funktionieren (zum Kopieren und Versenden von URLs aus Vertec), muss er mit lokalen Admin-Rechten aufgerufen werden mit dem Parameter Vertec.ProtocolHandler.exe /install.
  Der Protocol Handler ruft den zuletzt gestarteten Windows Client auf, also Desktop App oder Cloud App.
  Mit /uninstall kann der Protocol Handler wieder deinstalliert werden, dann kennt Windows das vertec: Protokoll nicht mehr.

Vertec Cloud App

Soll die Cloud App lokal installiert werden mit einer Softwareverteilung und nicht via Cloud Installer der Einstiegsseite, dann geschieht das wie folgt:

1. Folgende Files müssen lokal abgelegt werden:

• Vertec.Cloud.exe
• Vertec.CloudInstaller.exe (mehr Informationen zum Cloud Installer finden Sie hier)
• Vertec.ini
• Vertec.ProtocolHandler.exe
• VertecReport.dotm
• Unterordner Addins, falls gewünscht
• Ordner CefSharp
• Die Microsoft Visual C++ Library (64 Bit). Installation als Administrator via Redist Unterordner.
• Auf den Clients wird .NET ab Version 4.8 benötigt, damit die Oberfläche dargestellt werden kann. Es muss sichergestellt sein, dass die entsprechende .NET Version auf den Clients installiert ist.

2. Führen Sie danach die COM-Registrierung als Administrator durch: Vertec.Cloud.exe /regserver /silent
3. Führen Sie die Protocol-Handler-Registrierung als Administrator durch: Vertec.ProtocolHandler.exe /install
4. Führen Sie die Installation der Addins als Administrator durch, falls Sie welche verwenden möchten. Hierzu können Sie die entsprechenden Batch-Dateien (.bat) aus dem Ordner Addins verwenden.

Nach dem Setup startet die Vertec Desktop App das erste Mal mit leerer Datenbank. Diese Version ist noch nicht lizenziert. Es erscheint der Initialisierungs-Assistent.

Nach abgeschlossener Installation können Sie die gewünschte Vertec App starten. Der Benutzername für die erste Anmeldung lautet Administrator und das Passwort VertecGo1.