Dieser Artikel beschreibt das Installieren und Konfigurieren eines SQL-Express-Servers für mySORBA.Workspace mit MIS und SQL-Datenbank.
Hinweis
Für ein funktionierendes mySORBA.Workspace mit MIS muss der mySORBA-Webservice vom mySORBA.Workspace Client erreichbar sein.
Auch wenn die Verbindung direkt zum SQL-Server stattfindet, macht der Client als erstes eine Anfrage an den mySORBA-Webservice um zu erfahren, wie der SQL-Server lautet (und ob es überhaupt einen gibt).
Inhaltsverzeichnis
SQL-Express Server und Management Studio installieren
SQL-Express Server konfigurieren
mySORBA-Server Benutzer hinterlegen, damit mySORBA sich mit dem SQL-Express-Server verbinden kann
Meldungen / Fehlermeldungen die auftreten können (Troubleshooting)
MIS in mySORBA verwenden (mit / ohne SQL-Server) – MIS (anderer Help Center Artikel)
SQL-Express Server installieren
Das MIS läuft mit einem SQL-Express Server von Microsoft, welcher kostenlos runtergeladen werden kann.
SQL-Express 2022
Suchbegriff Google: "SQL Server 2022 Express" -> beim anklicken sollte man auf der Zielseite irgendwo den unten abgebildeten Bereich finden. Sonst einen anderen Sucheintrag wählen...
Mindestvoraussetzung ist Version 2012:
Suchbegriff Google: "microsoft sql express 2012 management studio"
Als nächstes den Setup SQL-Express (z. B. SQL2019-SSEI-Expr.exe) mit Administrator-Berechtigungen starten.
Nach dem Entpacken startet sich das "SQL Server Installation Center"
Nun muss noch das "Management Studio" installiert werden.
Im bereits offenen SQL Server Installation Center: Install SQL Server Management Tools
"SSMS-Setup-DEU.exe" als Administrator starten
Danach wurde der SQL-Express-Server und Management Studio installiert und ist bereit zum konfigurieren.
SQL-Express Server konfigurieren
"SQL Server Configuration Manager" starten -> Start / Microsoft SQL Server 2019 / SQL Server Configuration Manager
- Reiter "SQL Server Network Configuration" erweitern und "Protocols for <gewählter Name>" anklicken.
-
Named Pipes und TCP/IP auf Enabled setzen (rechte Maustaste).
Hinweis bedeutet, dass man den SQL-Service neu starten muss, bevor die Änderungen übernommen werden.
- Unter "SQL Server Services" den "SQL Server Browser" auf Startmodus "Automatisch / Automatic" setzen, wenn er nicht bereits ist.
- "SQL Server" neustarten und "SQL Server Browser" starten.
Nun ist der SQL-Express Server für mySORBA MIS grundsätzlich bereit.
Jetzt muss noch ein Benutzer mit entsprechenden Rechten hinzugefügt werden.
Firewall konfigurieren
Standardmässig läuft der SQL-Server über TCP Port 1433 und UDP 1434.
Eventuell auch noch die sqlbrowser.exe zu den Ausnahmen hinzufügen.
SQL-Benutzer (mySORBA-Server Benutzer) hinterlegen, damit mySORBA sich mit dem SQL-Express-Server verbinden kann
Das mySORBA Benötigt in jedem Fall einen hinterlegten SQL-Benutzer, egal ob man sich innerhalb oder ausserhalb des Firmennetzwerkes befindet.
Aus performance-Gründen wechselt das mySORBA nach der Kontaktaufnahme mit dem SQL-Benutzer automatisch auf den Windows-Benutzer, wenn vom System erkannt wird, dass dieser Zugriff auf den SQL-Server hat:
Aus diesem Grund, muss für die Verwendung vom mySORBA-Workspace mit MIS innerhalb vom Firmennetzwerk gearbeitet wird, die Zugreifenden Windows-Benutzer ebenfalls auf dem SQL-Server für den Zugriff (erstellen und bearbeiten von Datenbanken / Tabellen) eingerichtet werden.
Der SQL-Benutzer wird verwendet, wenn der Windows-Benutzer keinen Zugriff auf den SQL-Server hat.
Das kann sein, wenn zum Beispiel der Client nicht im Netzwerk ist, oder der SQL-Server nicht auf dem mySORBA-Server liegt.
Mit der Einstellung "AllowDirectSQL=0" kann eingestellt werden, dass die Anwendung immer und ausschliesslich mit dem SQL-Benutzer stattfindet, dies ist aber um einiges langsamer und funktioniert mit grossen SORBA-Domänen erst ab 21.1.193 reibungsloser.
In erster Linie versucht der Client sich direkt zu verbinden. Zuerst über den SQL-Benutzer für die Server-Kontaktaufnahme und dann mit dem Windows-Benutzer, wenn das nicht geht, versucht er es über den mySORBA-Webservice.
Um den SQL-Benutzer zu erstellen gehen Sie wie folgt vor:
Dazu den "SQL Server Configuration Manager" schliessen und das "SQL Server Management Studio" (Start -> Microsoft SQL Server 2019 -> SQL Server Management Studio) starten.
Unter Login ist "sa" und unter "Password" muss das in der Installation angegebene Passwort benutzt werden.
Windows Authentifikation ist hier möglich wenn der Benutzer nicht bei der Installation herausgelöscht wurde.
Unter "Security -> Logins -> rechte Maustaste -> New Login..." einen neuen Benutzer hinzufügen.
Login name: z. B. SORBA_MIS
->SQL Server authentication setzen
->Eventuell Haken bei "Enforce password policy" entfernen
Achtung
Der mySORBA Server kann maximal 20 Zeichen im Passwort verwenden!
Hinweis
Wir benötigen einen "lokalen" Benutzer, das heisst keinen Windows-Login-Benutzer.
Der Lokale Benutzer hat NIE ein \ vor der Bezeichnung!
Beispiel: SORBA\vmadmin -> geht nicht!
SORBA_MIS -> geht!
Der SQL-Express-Server ist nun komplett für MIS mySORBA bereit!
Für den mySORBA-Server benötigen wir:
- Benutzer -> hier "SORBA_MIS"
- Passwort -> vom erstellen von "SORBA_MIS"
- <HOSTNAME>\<NAMED INSTANCE> -> hier MS05\MUSTERNAME
für die mySORBA-Konfiguration siehe Helpcenter-Artikel: MIS in mySORBA verwenden (mit / ohne SQL-Server)
Meldungen / Fehlermeldungen die auftreten können (Troubleshooting)
SORBA Workspace - Error: 28
Netzwerkbezogener oder Instanz spezifischer Fehler beim Herstellen einer Verbindung mit SQL Server. Der Server wurde nicht gefunden, oder auf ihn kann nicht zugegriffen werden. Überprüfen Sie, ob der Instanzname richtig ist und ob SQL Server Remoteverbindungen zulässt. (provider: SQL Network Interfaces, error: 28 - Der Server unterstützt nicht das angeforderte Protokoll.
Diese Meldung kommt wenn in der SQL Server Konfiguration (SQL Server Configuration Manager) das TCP/IP Protokoll nicht aktiviert wurde:
Nach dem Aktivieren muss der SQL Server Dienst neu gestartet werden.
SORBA Reportquick - SQL logic error ... kpidata
SQL logic error or missing database no such table: kpidata
Diese Meldung kommt, wenn die Datenbank "KPIData.dbf" nicht vorhanden ist.
Um diese zu generieren / aktualisieren im ProjekQuick auf "Extras / Neu berechnen" klicken (Einstellung Managerzahlen muss aktiv sein).
Diese Meldung kommt, wenn die SQL Authentifizierung ausgeschaltet ist, oder der SQL-Benutzer schon gar nicht existiert (SQL-Benutzer (mySORBA-Server Benutzer) hinterlegen, damit mySORBA sich mit dem SQL-Express-Server verbinden kann).
Im SQL Management Studio einen Rechtsklick auf den Server machen und Properties wählen:
Folgende Einstellung setzen:
Zum Schluss noch den SQL Server mit Rechtsklick - Restart neu starten:
SORBA Workspace
Login failed for user 'XY'. Reason: The password of the account has expired.
Das Passwort vom verwendeten SQL-Benutzer muss geändert werden, weil es gemäss der SQL-Server-Richtlinie abgelaufen ist. Es muss auf dem SQL-Server angepasst werden, oder der SQL-Benutzer kann so angepasst werden, dass es nicht mehr geändert werden muss.
Sollte das Passwort geändert werden, dann dieses unbedingt auf dem mySORBA Server nachtragen (Option mit SQL-Server).
SORBA Workspace
Login failed for user 'XY'. Reason: The password of the account must be changed.
Das Passwort vom verwendeten SQL-Benutzer muss geändert werden. Oder so auf dem SQL-Server angepasst werden, dass es nicht mehr geändert werden muss.
Sollte das Passwort geändert werden, dann dieses unbedingt auf dem mySORBA Server nachtragen (Option mit SQL-Server).
SORBA Workspace - Error: 0
Netzwerkbezogener oder instanzspezifischer Fehler beim Herstellen einer Verbindung mit SQL Server. Der Server wurde nicht gefunden, oder auf ihn kann nicht zugegriffen werden. Überprüfen Sie, ob der Instanzname richtig ist und ob SQL Server Remoteverbindungen zuläss. (provider: TCP Provider, error: 0 - Der Wartevorgang wurde abgebrochen.)
Diese Meldung kommt in den meisten Fällen, wenn die Verbindung wegen zum Beispiel der Firewall geblockt wird.
Hier prüfen, was passiert, wenn die Firewall deaktiviert wird.
Wenn es an der Firewall liegt, dann den verwendeten Port zu den Ausnahmen hinzufügen.
SORBA Workspace - Error: 26
A network-related or instance-specific error occured while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server ist configured to allow remote connections. (provider: SQL Network Interfaces, error: 26 - Error Locating Server/Instance Specified)
- Diese Meldung kommt in den meisten Fällen, wenn die Verbindung wegen zum Beispiel der Firewall geblockt wird.
Hier prüfen, was passiert, wenn die Firewall deaktiviert wird.
Wenn es an der Firewall liegt, dann den verwendeten Port zu den Ausnahmen hinzufügen.
TCP Standardport wäre 1433 und UDP 1434. - Oder der SQL Server Browser Dienst läuft nicht / ist deaktiviert
Der angegebene Host ist unbekannt
Diese Meldung erscheint, wenn der mySORBA-Webservice vom aktuellen Gerät aus nicht erreichbar ist.
Dies muss er sein, um erörtern zu können, ob man einen SQL-Server verwendet und wie der lautet.
Überprüfen:
- mit mySORBA-Login angemeldet?
- Ist der eingetragene "DomainWebHttpServer" gemäss der dbenv.ini (Installationsverzeichnis mySORBA) erreichbar (Pingtest http://xxxxx/sorbatest/ )?
-> Wenn nicht korrigieren, eventuell den Server in der mySORBA-Konfiguration korrigieren.
dblibVbNet hat ein Problem festgestellt (Der angegebene Host ist unbekannt)
Diese Meldung erscheint, wenn der mySORBA-Webservice vom aktuellen Gerät aus nicht erreichbar ist.
Dies muss er sein, um erörtern zu können, ob man einen SQL-Server verwendet und wie der lautet.
Überprüfen:
- mit mySORBA-Login angemeldet?
- Ist der eingetragene "DomainWebHttpServer" gemäss der dbenv.ini (Installationsverzeichnis mySORBA) erreichbar (Pingtest http://xxxxx/sorbatest/ )?
-> Wenn nicht korrigieren, eventuell den Server in der mySORBA-Konfiguration korrigieren.