Das mySORBA unterscheidet grundsätzlich zwischen 3 Installationen:
- Server (Terminalserver und / oder Server von angehängten Clients).
- Client (Benötigen einen mySORBA-Server um Lauffähig zu sein).
- Einzelplatz (Ein Arbeitsplatz inkl. SorbaDaten)
Neu ab mySORBA 2023
Ab mySORBA.Workspace 2023 werden keine SystemPrerequisites mehr benötigt.
Bei einem Update auf 23.1 werden diese automatisch entfernt.
Microsoft .Net Framework 4.8 ist ab mySORBA 2023 Voraussetzung.
Dieses wird durch das Windows Update ausgeliefert.
Des weiteren unterscheidet man Neuinstallation, Update und Upgrade (von Workspace auf mySORBA)
Bei einem Upgrade spielen die bereits vorhandenen Daten (und Ordnerfreigaben) und Konfiguration vom Webservice eine grosse Rolle.
Systemvoraussetzungen für die Installation / Update
Allgemeine Hardware- und Softwarevoraussetzungen mySORBA
Einstellungen für die Firewall und den Antivirus
mySORBA - Firewall Einstellungen (welche Prozesse / exe und Adressen)
Neuinstallation
Server Neuinstallation
Auswahl mySORBA_Server_Setup Für diese Installation ist das mySORBA_Server_Setup auszuführen.
Das Server Setup hat das Icon "blauer Würfel mit weissem Hintergrund".
Installation Server Setup
Für die Installation von einem mySORBA Server ist ein "mySORBA-Benutzer" mit Administratoren Berechtigungen notwendig.
Wenn noch keiner existiert, muss dieser über den SORBA-Aussendienstmitarbeiter erstellt werden.
Führen Sie den Setup mit einem Windows-System-Administrator-Benutzer aus!
Zudem deaktivieren Sie aktive Antiviren-Software für die Dauer der Installation.
Info
Installationsinformationen an SORBA senden, wenn diese Checkbox aktiviert ist, werden automatisch die Log-Informationen an SORBA gesandt.
Im Bedarfsfall kann der Support so schneller helfen.
SORBA Datenbank Server - Diese Option installiert den Datenbankserver mit allen benötigten Services.
Terminalserver-Client - Diese Option installiert einen "speziellen" Terminalserver-Client von einem Server.
Das Verzeichnis muss für den Windows-Benutzer vom mySORBA-Datenbank und Webservice zum zugreifen und bearbeiten vollumfänglich erlaubt sein und er muss sich auf dem selben Rechner befinden.
Es darf ein UNC-Pfad oder "normaler" Pfad verwendet werden.
Sollte sich der Pfad nicht auf demselben Rechner bestimmen, muss nach der Installation auf den mySORBA Diensten (Datenbank, Controller und Webservice) der Benutzer eingetragen werden.
Dokumente über mySORBA.Drive - Das SorbaDrive wird aktiviert. In diesem Fall müssen alle bestehenden Freigaben auf die SorbaDaten entfernt und eventuell neu gesetzt werden.
Ein direkter Zugriff auf die SorbaDaten über den Windows-Explorer muss entsprechend gesperrt werden. Siehe dazu die Anleitung im Helpcenter betreffend SorbaDrive.
Tipp
Beim Setzen der Option "Dokumente über mySORBA.Drive" versucht der Setup automatisch den Lokalen Pfad zu setzen. Sollte das fehlschlagen, muss der Pfad manuell zugewiesen werden.
Tipp
Wenn Sie einen lokalen Pfad für die Sorbadaten verwenden und das mySORBA.Drive nicht aktiv ist, werden Sie untenstehende Warnung erhalten.
Dies ist für Terminalserver-Installationen kein Problem, sollten aber mySORBA Clients angehängt werden, ist hier ein UNC-Pfad zu verwenden.
DblibServer Port (mySORBA Workspace) - Unter diesem Port läuft der mySORBA Datenbankserver.
DblibWebService Port (Mobile-Apps) - Unter diesem Port läuft der mySORBA Webservice, welcher auch die herkömmlichen Mobile-Apps (z. B. Rapport App) bedient.
Achtung
Dieser Port muss auch für mySORBA Workspace Clients erreichbar sein, bestimmte Funktionen im mySORBA Workspace verwenden den mySORBA Webservice!
Datenbankdefinitionen aktualisieren - Option angehakt: Nach der Installation werden alle Datenbankdefinitionen der SORBA-Domänen aktualisiert. Dies ist empfohlen, da es zum Beispiel die Auswertungen beschleunigt.
Benutzername + Kennwort: mySORBA Benutzer mit Administrator-Berechtigung.
Sollten die angegebenen Adressen sich unterscheiden, wie hier im Beispiel, ist es sehr wichtig, die mySORBA Konfiguration zu überprüfen!
Ansonsten ist es im ungünstigsten Fall nicht mehr möglich sich am mySORBA Workspace anzumelden.
Ja - Die mySORBA Server Konfiguration wird mit dem aktuellen Server überschrieben.
Im vorliegenden Fall wäre das von alt "http://10.10.6.52:8080" auf neu "http://vm-lg-setDem1:8080". Danach würden auch die Mobile App's, wenn sie ein mySORBA Login verwenden, auf die neue Adresse zugreifen.
Hinweis: Die mySORBA Konfiguration wird erst nach Abschluss der Installation überschrieben.
Nein - Die mySORBA Server Konfiguration wird so belassen.
Abbrechen - Der Vorgang wird abgebrochen und der mySORBA Benutzer kann neu eingegeben werden.
Fuhrpark-Verknüpfung auf Desktop erstellen
Diese Option erstellt eine spezielle Verknüpfung, welche dann lediglich den Fuhrpark startet.
Es wird empfohlen den Server nach einer Neuinstallation neu zu starten.
Client Neuinstallation
1. Auswahl Setup
Für diese Installation ist das Client Setup auszuführen.
Der Client Setup erkennt man am Icon "weisser Würfel mit blauem Hintergrund".
2. Installation mySORBA Client Setup
Für die Installation von einem mySORBA Client ist ein "mySORBA-Benutzer" mit Administratoren Berechtigungen notwendig.
Wenn noch keiner existiert, muss dieser über den SORBA-Aussendienstmitarbeiter erstellt werden.
Deaktivieren Sie aktive Antiviren-Software für die Dauer der Installation.
Info
Installationsinformationen an SORBA senden, wenn diese Checkbox aktiviert ist, werden automatisch die Log-Informationen an SORBA gesandt.
Im Bedarfsfall kann der Support so schneller helfen.
Tipp
Auf dem Client kann nicht eingestellt werden ob das SorbaDrive aktiv ist oder nicht.
Diese Einstellung kommt vom mySORBA Server.
Benutzername + Kennwort: mySORBA Benutzer mit Administrator-Berechtigung.
Hinweis für Server-Techniker
Verwenden Sie einen mySORBA Benutzer welcher der Firma zugeordnet ist, damit die korrekte Konfiguration übernommen wird.
Mit "Installieren" wird der Client effektiv installiert.
Danach wurde der mySORBA Client fertig installiert.
Einzelplatz Neuinstallation
1. Auswahl Setup
Für diese Installation ist das Einzelplatz Setup auszuführen.
Den Einzelplatz Setup erkennt man am Icon "weisser Würfel mit blauem Hintergrund" mit Produktname "mySORBA Workspace Einzelplatz".
2. Installation Einzelplatz Setup
Für die Installation von einem mySORBA Einzelarbeitsplatz ist ein "mySORBA-Benutzer" mit Administratoren Berechtigungen notwendig.
Wenn noch keiner existiert, muss dieser über den SORBA-Aussendienstmitarbeiter erstellt werden.
Deaktivieren Sie aktive Antiviren-Software für die Dauer der Installation.
Das Verzeichnis muss für den Windows-Benutzer vom mySORBA-Datenbank und Webservice zum zugreifen und bearbeiten vollumfänglich erlaubt sein und muss sich auf demselben Rechner befinden.
Es darf ein UNC-Pfad oder "normaler" Pfad verwendet werden.
Dokumente über mySORBA.Drive - Das SorbaDrive wird aktiviert. In diesem Fall müssen alle bestehenden Freigaben auf die SorbaDaten entfernt und eventuell neu gesetzt werden.
Ein direkter Zugriff auf die SorbaDaten über den Windows-Explorer muss entsprechend gesperrt werden. Siehe dazu die Anleitung im Helpcenter betreffend SorbaDrive.
Tipp
Beim Setzen der Option "Dokumente über mySORBA.Drive" versucht der Setup automatisch den Lokalen Pfad zu setzen. Sollte das fehlschlagen, muss der Pfad manuell zugewiesen werden.
Datenbankdefinitionen aktualisieren - Option angehakt: Nach der Installation werden alle Datenbankdefinitionen der SORBA-Domänen aktualisiert. Dies ist empfohlen, da es zum Beispiel die Auswertungen beschleunigt.
Die in der Sorba Datenbank hinterlegte Server-Konfiguration wird bei einem Einzelarbeitsplatz weder überschieben noch "gelesen".
Nach der Installation empfiehlt sich ein Neustart, da zum Beispiel der SorbaDrive-Treiber installiert werden musste.
Update
mySORBA Server Updaten
mySORBA Client Updaten
Der mySORBA Client kann sich selbstständig updaten.
Das heisst, bei jedem Programmstart wird geprüft ob auf dem Server dieselbe Version verwendet wird.
Ab mySORBA.Workspace Version 22.1
- Einmalig beim Wechsel von einer Version vor 22.1 (zum Beispiel 21.3) auf 22.1 muss der Client-Setup von Hand im Portal heruntergeladen und installiert werden.
- Bei einem Update von 22.1 auf eine neuere Version von 22.1 oder 22.2 usw... prüft der Client automatisch was für eine Version auf dem Server installiert ist und bezieht den Client Setup.
Der Updater bezieht automatisch die Setup-Datei und führt sie aus.
Der Anwender benötigt hierfür keine speziellen Windows-Benutzerrechte, auch bei "grösseren" Versionswechsel.
- Sobald der mySORBA.Workspace Server aktualisiert wurde und man den Client startet, erscheint eine Meldung:
- Danach wird das Client-Setup heruntergeladen
- ...und automatisch installiert
- Sobald das Update durchgeführt wurde erscheint die Erfolgsmeldung und das mySORBA kann wie gewohnt gestartet werden.
Vorgehen Bis mySORBA.Workspace Version 21.3
Bei einem möglichen Update, bezieht der Client selbstständig die nötigen Komponenten und installiert diese:
Wichtige Hinweise
- Ein "kleineres" Update kann ohne Windows-Administratoren-Berechtigungen ausgeführt werden.
- Für grössere Updates (Versionssprünge, z. B. von 21.1 auf 21.2, oder wenn sich die mySORBA Prerequisites geändert haben) sind zwingend Windows-Administratoren-Berechtigungen nötig um das Update vollständig ausführen zu können.
- Eventuell ist ein PC Neustart notwendig, dass alle Funktionalitäten zur Verfügung stehen.
Alternativ den Client-Setup ausführen
Man kann aber auch einfach den Client-Installer darüber installieren.
mySORBA Einzelplatz Update
Der Einzelplatz kann automatisch, per Menüfunktion oder von Hand über das Setup upgedatet werden.
Das Update über die "Setup_Einzelplatz.exe" ist selbsterklärend und kann einfach "durchgeklickt" werden. Dies benötigt aber ein aktuelles Setup.
Deaktivieren Sie aktive Antiviren-Software für die Dauer der Installation.
Möchte man die Updates jeweils von Hand auf eigenes Verlangen hin prüfen und installieren, kann dies über die "Programm-Verwaltung -> SORBA Installation -> Nach neuer Programmversion suchen" erledigt werden (Eventuell muss in den "Einstellungen Programmversionssuche" das "Automatische Suchen" deaktiviert werden, um keine Meldungen zu erhalten).
Möchte man automatisch bei einer neu verfügbaren Version benachrichtigt werden, oder möchte man sogar eine automatische Installation von Updates, kann dies dementsprechend aktiviert werden.
Diese Einstellungen befinden sich unter:
"Programm-Verwaltung -> SORBA Installation -> Einstellungen Programmversionssuche".
QUIET-Installation / Update
QUIET / SILENT NEU-Installationen und Updates sind nur für Clients und Terminalserver-Clients vorgesehen.
Den mySORBA-Database-Server Setup muss man über das Installationsprogramm durchführen.
- Update vom mySORBA.Workspace Terminalserver Client und mySORBA.Workspace Client
Argumente: mySORBA_Client_Setup.exe /qn - Neuinstallation vom mySORBA.Workspace Client:
Beispiel für eine Neuinstallation:
mySORBA_Client_Setup.exe /qn MYSORBA_USERNAME="<MYSORBA-ADMINISTRATOR>" MYSORBA_PASSWORD="<MYSORBA-ADMINISTRATORPASSWORT>" APPDIR="<Laufwerk>:\<ZIELVERZEICHNIS>" SORBAPORT="<GEMÄSS KONFIGURATION>" - Neuinstallation vom mySORBA.Workspace Terminalserver Client
Beispiel für eine Neuinstallation:
mySORBA_Server_Setup.exe /QUIET /norestart MYSORBA_USERNAME="<MYSORBA-ADMINISTRATOR>" MYSORBA_PASSWORD="MYSORBA-ADMINISTRATORPASSWORT>" APPDIR="<Laufwerk>:\<ZIELVERZEICHNIS>" DBLIBSRVCURL=<http://SORBADBSERVER>:<PORT GEMÄSS KONFIGURATION> SERVERTYPE=TSServer SORBAPORT="<GEMÄSS KONFIGURATION>"
Argumente für die Installation (Setup.exe)
- /L*V <PFAD> - Spezielles Setuplog erstellen
- /QUIET - Für Silent-Update -> Benötigt Installation von mySORBA Prerequisites im Vorfeld.
- /norestart - Kein Neustart nach der Installation (in Kombination mit QUIET)
- /qn -> Kombination für /QUIET und /norestart
- appdir="C:\Sorba\" - Für Neuinstallationen, in dieses Verzeichnis soll die Installation getätigt werden.
- MYSORBA_USERNAME="<mySORBA-Benutzername>"
- MYSORBA_PASSWORD="<mySORBA-Passwort>"
- SORBAPORT=<Port unter dem der dblibsrv64.exe - Dienst auf dem DBServer läuft>
- FUHRPARKSHORTCUTONDESKTOP=checked
Zusätzliche mySORBA Programme die mitgeliefert werden
mySORBAUpdater (updater.exe)
Ab mySORBA.Workspace 22.1 wird auf den Clients der Dienst "mySORBAUpdater - Updater Support Service" (updater.exe) installiert.
Dieser ist solange kein Update ausgeführt wird abgeschaltet.
Sobald ein Update ausgeführt werden muss, startet sich dieser Dienst automatisch und führt das Update als Systemprozess aus.
Der Grosse Vorteil besteht darin, dass die mySORBA.Workspace Clients ohne spezielle Windows-Benutzerrechte aktualisiert werden kann.
Bei Versionen vor 22.1 ist es mit dem alten Updater hier zu Schwierigkeiten gekommen.
Hinweis
Das neue Updateprozedere funktioniert erst ab Updates von 22.1 auf neuer, da dies ein neues Programm ist.
Macht man das Client-Update von Versionen vor 22.1 (zum Beispiel 21.3) auf 22.1 (oder neuer) muss man zwingend das Client-Setup beziehen und von Hand ausführen.
mySORBA Wartungsdienst
Dieser Dienst kontrolliert und aktualisiert täglich die Kundenanpassungen auf dem mySORBA-Server und mySORBA-Client. Auf dem mySORBA-Server stellt er zusätzlich sicher, dass die für das Programm erforderlichen Services laufen.
Der mySORBA Wartungsdienst wird unter den Windows Diensten automatisch installiert.
Das dazugehörige Programm befindet sich im <mySORBA Installationsverzeichnis>\SMS\SMSClientService.exe.
Fuhrpark
Als letzter Punkt vom mySORBA-Setup-Assistent kann die Option "Fuhrpark-Verknüpfung auf Desktop erstellen" angewählt werden.
Die Applikation selber wird in jedem Fall mitgeliefert, sie muss aber speziell gestartet werden, diese Option macht eine entsprechende Verknüpfung automatisch.
NotificationClient (ab 24.1)
Der NotificationClient (NotificationClient.exe) ist ein Kommunikationsprogramm um Nachrichten an den Anwender vom mySORBA.Workspace zu senden.
Die EXE wird für jeden mySORBA.Workspace-Prozess mit den mySORBA-Anmeldedaten erstellt (bei mehreren Domänen mit demselben Benutzer bleibt es bei einer Session).
Tipps zur Problemlösung
Sollte das Client-Update / die Client-Neuinstallation fehlschlagen, kann man sich diesen Help Center Artikel zur Hilfe nehmen: mySORBA Client Installation / Update schlägt fehl - Installation bereinigen - Anleitung