Datenbank Sync
Hier findest du eine Schritt für schritt Anleitung zu Einrichtung des Datenbank Sync Addons
Der Datenbank Sync
Was ist das Überhaupt?
Der Datenbank Sync von EmergencyOS steht dir aber der Lite Version als Addon zur Verfügung. Mit dem Datenabnk Sync, kannst du die Datenbank deines FiveM Servers mit EmergencyOS verknüpfen und alle Spielerdaten & Fahrzuege mit EmergencyOS Syncronisieren.
Was bringt dir das?
Personenabfrage
Der Datenbank Sync bietet viele Vorteile, dadurch sind alle Spieler auf deinem Server bereits in der Personenabfrage eingetragen und man muss nicht jede Person manuell anlegen, so kannst du direkt nach Namen suchen, desweiteren werden Werte wie die Telefonnummer, das Geburtsdatum und Geschlecht Syncronisiert.
Telefonabfrage
Desweiteren kannst du die Telefonabfrage App effektiver Nutzen da du dann automatisch jeden besietzer einer Telefonnummer finden kannst.
Fahrzeugregister
Desweiteren hat der Sync auch einen großen Vorteil, wenn du das Fahrzuegregsiter benutzt. Hier werden nähmlich automatisch alle Fahrzuege deines Servers geladen und müssen nicht manuell eingetragen werden, so können deine Staatsfraktionen Kennzeichenabfragen durchführen und können direkt den Besitzer des Fahrzuegs ermittleln.
Wie kann ich den Datenbak Sync nutzen?
Um den Datenbank Sync zu nutzen, musst du zuerst das Addon aktivieren. Logge dich dazu auf https://ancomox.com/login ein. Klicke dann auf Deine Produkte links in der Seitenleiste und klicke auf Einstellungen bei der EmergencyOS Instanz, bei welcher du den Sync aktivieren möchtest.
Nun bist du auf der Dasboard Seite für dein EmergencyOS, wähle hier im rechten Bereich das Addon Datenbank Sync und klicke auf Aktivieren, bestäte die AGBs und Buche das Addon für 2.99 Ancoins pro Monat.
Nun hast du das Datenbank Sync Addon erfolgreich aktiviert und kannst mit der Einrichtung fortfahren.
Die Einrichtung
Beachte, dass nur MySQL Datenbanken unterstützt werden
Datenbank konfigurieren
Bevor du mit der eigentlichen Einrichtung starten kannst muss du deine Datenbank so konfigurieren, dass sich unsere Server von außen mit deiner Datenbank verbinden können.
Die Einrichtung Unterscheidet sich zwischen Linux & Windows Servern, wir zeigen dir beide Varianten.
Windows Server
Um deine Datenbank auf einem Windows Server zu konfigurieren verbinde dich zunächst über eine Remote Desktop verbindung mit diesem.
Zuerst müssen wir überprüfen ob dein Server Zugriff auf unsere IP Addresse hat, öffne hierfür die Kommandozeile CMD (Appsuche > "CMD") und tippe folgenden Command ein ping 141.94.87.67
solltest zu eine Antwort erhalten, ist alles gut, solltest du eine Fehlermeldung erhalten, kontaktiere bitte deinen Hosting anbieter um unsere IP Adresse Whitelisten zu lassen oder ürberprüfe deien Firewall einstellungen.
Um deine MySql Datenbank auf Windows freizugeben musst du eigentlich nur den SQL Port in der, Windows Firewall freigeben. Gehe hierzu wie folgt vor: Schritt 1: Suche nach Firewall in der Windows Suche und wähle "Firewall & Netzwerkschutz"
Klicke jetzt auf "Erweiterte Einstellungen"
Jetzt solltest du diese Seite sehen, klicke hier rechts oben auf "Neue Regel"
Jetzt kannst du, die Portfreigabe Konfigurieren. Wähle unter Regeltyp "Port" und klicke dann af "Weiter", wähle jetzt TCP und gebe den Port 3306 ein
Bei manchnen Datenbank Konfigurationen kann es sein, dass die Datenbank auf einem anderen Port läuft, sollte dies der falls sein weißt du aber normalweweise sowiso was du tust.
Klicke bei Aktion & Profil auf Weiter, vergebe einen Namen (eg. MySQL Port) und klicke auf "Fertigstellen"
Jetzt hast du erfolgrich deine Datenbank freigegeben.
Um zu überprüfen, ob die Datenbank richtig Konfiguriert ist, besuche eine Seite wie https://portchecker.co/ und überprüfe, on der Port 3306 auf deiner IP Addresse geöffnet ist. Scrolle weiter zu "Datenbank Benutzer"
Linux (Debian 10) Server
Um deine Datenbank auf einem Linux Server zu konfigurieren verbinde dich zunächst über eine ssh Konsole mit diesem.
Zuerst müssen wir überprüfen ob dein Server Zugriff auf unsere IP Addresse hat, tippe folgenden Command in deine ssh Konsole ein ping 141.94.87.67
solltest zu eine Antwort erhalten, ist alles gut, solltest du eine Fehlermeldung erhalten, kontaktiere bitte deinen Hosting anbieter um unsere IP Adresse Whitelisten zu lassen oder ürberprüfe deien Firewall einstellungen.
Wenn unser Server erreichbar ist können wir mit der Einrichtubg fortfahren. Führe hierzu folgende Commands hintereinander aus.
Wenn du nicht als root Benutzer eingeloggt bist ist es bei machen commands nötig davor sudo zu schreiben
cd
nano /etc/mysql/my.cnf
Dies öffnet die my.cnf (mysql config Datei) im Linux eigenen Editor nano, in einigen fällen kann es sein, dass sich diese Datei an einer anderen stelle befindet, sollte aber zu finden sein: Du kannst die Datei auch über FTP suchen und mit von dort aus mit deinem Editor bearbeiten.
Nun sollte sich eine Datei geöffnet haben und deine consoel sollte ca. so aussehen:
Suche in diese Datei nach der Zeile in der bind-address
steht, falls ein # vor der Zeile steht, entferne dieses und setze bin address auf bind-address = 0.0.0.0
das sollte in der Datei dann so aussehen.
bind-address = 0.0.0.0
Jetzt musst du die Datei Speichern, drücke hierfür in nano editor zuerst STRG + X, dann wirst du gefragt ob du die Datei Speichern möchtest, bestätige dies mit Y und dann Enter.
Jetzt solltest du wieder in der gewohnten Konsole sein, jetzt musst du die Datenbank noch neustarten, mache dies mit folgendem Befehl
systemctl restart mysql.service
Solltest du hier eine Fehlermeldung erhalten, überprüfe die Datei nocheinmal. Ansonsten sollte die Datenbank jetzt Konfiguriert sein. Um zu überprüfen, ob die Datenbank richtig Konfiguriert ist, besuche eine Seite wie https://portchecker.co/ und überprüfe, on der Port 3306 auf deiner IP Addresse geöffnet ist.
In seltenen fällen kann es möglich sein das eine Firewall Konfiguration den Port 3306 blocked, was bei Linux Server aber nicht oft vorkommt. Sollte es nicht funtionieren und du bist dir sicher dass du alles andere richtig gemacht hast. führe diesen Command aus, um den Port in der Linux Fiewall (iptables) freizugeben:
iptables -A INPUT -p tcp --destination-port 3306 -j ACCEPT
Bei besonderen Konfigurationen, ist es möglich, dass die Datenbank nicht auf Port 3306 liegt, sollte das der fall sein, weißt du normalerweise eh was du tust.
Datenbank Benutzer
So, da wir nun unsere Datenbank Konfiguriert haben, müssen wir noch einen neuen Benutzer für EmergencyOS anlegen. Logge dich hierfür mit einem Account mit hohen Berechtigungen bei deinem phpmyadmin ein und befolge folgende schritte:
Schritt 1 Klicke auf das Home Symbol links oben und dann auf den reiter "Benutzerkonten" rechts oben.
Schritt 2 Klicke auf "Benutzerkonto hinzufügen"
Schritt 3
Jetzt kannst du die Daten für den neuen Benutzer anlegen, wäle einen Benutzernamen am besten emergencyos oder ähnliches. Jetzt bei Hostname wählst du "Dieser Host" und tippst die IP Addresse 141.94.87.67
ein. Um ein sicheres Passwort zu erhalten klicke auf "Generieren" und kopiere dir das Generierte Passwort für später.
Unten bei den Rechten reicht es die SELECT rechte freizugeben
Klicke jetzt unten auf OK
Jetzt hast du erfolgrich einen Benuteraccount erstellt, nun kannst du diesen Account mit EmergencyOS verbinden, wie das geht erfährst du im nächsten Schritt.
Datenbank mit EmergencyOS verbinden
Um den Datenbank Sync einzurichten musst du auf https://emergencyos.de/ welcheseln. logge dich dort nun mit deinen Admin Zugangsdaten, welche du beim Bestellen des Produkts erhalten hast ein. Wenn du dich erfolgrich eingeloggt hast befindest du dich auf dem EmergencyOS Desktop, klicke hier links unten auf das EmergencyOS Logo und öffne das Startmenu, klicke im Startmenu links unten auf das Zahnrad Icon um die Einstellungen zu öffnen.
Wähle in den Einstellungen nun den Punkt Datenbank Sync dort solltest du jetzt folgende Seite sehen. Klicke hier auf "Anlegen".
Jetzt solltest du nach deinen Datenbank Zugangsdaten gefragt werden, trage diese ein.
Eventuell angezeigte Fehler/Warnungen können ignoriert werden. Auch falls in den Eingabefeldern sich bereits Text befindet, diesen einfach zuerst löschen.
IP Addresse der Datenbank: Trage hier die IP Adresse des Servers ein auf dem die Datenbank läuft, falls du einen anderen Port als 3306 nutzt auch diesen, also zb. 194.176.82.105:0633
Datenbankname Trage hier den Namen der Datenbank ein in welcher deine Server Daten liegen, diesen findest du in phpmyadmin
Benutzername Bei Benutzername trägst du den Benutzernamen, welchen zu zuvor erstellt hast ein Passwort Hier trägst du das Passwort des Benutzers ein welches du zuvor erstellt und kopiert hast
Das sollte jetzt ungefär so aussehen, klicke auf "Weiter"
Nun kann es bis zu einer Minute dauern, bis du weitergeleitet wirst, wir stellen gerade die Verbindung zu deiner Datenbank her. Solltest du einen Fehler "Connection Timed Out" erhalten, überprüfe die Konfiguration deiner Datenbank, deine Eingegebene IP Addresse udn ob dein Server unseren Server erreichen kann wie oben beschrieben. Wenn du alles richtig gemacht hast, siehst du nun folgende Seite:
Wähle hier die Datenbank Tabelle aus in den deine user und die in der deine Fahrzeuge gespeichert sind. Das sollte bei einem Standart ESX Server so aussehen (users & owned_vehicles), klicke nun auf "Weiter"
Nun solltest du folgende Seite sehen:
Hier musst du alle korrekten Spalten für die users tabelle auswählen, diese bedeuten Folgendes
Zusammengesetzter Name?
Wähle das hier ab, wenn sich Name & Nachname in der selben Spalte befinden sollte, das ist aber im normalfall nicht der Fall.
Identifier
Wähle hier die Spalte aus in der der einzigartige Identifer des Spielers befindet (bei ESX identifier
)
Diese identifer wird auch bei dem API Addon verwendet um zb. eine Rechnung auszustellen oder den Job des Spielers zu erhalten.
Telefonnummer
Wähle hier die Spalte aus in der die Spalte aus in der sich die Telefonnummer des Spielers befindet. (Bei ESX ist es phone_number
)
Manche Handy Scripts speichern die Telefonnummer nicht direkt in einer Spalte sonden mit mehreren Daten in einem Feld, wir arbeiten bereits an einer Lösung für dieses Problem.
Vorname
Wähle hier die Spalte in der sich der Vorname des Spielers befindet (Bei ESX: firstname
)
Nachname
Wähle hier die Spalte in der sich der Namename des Spielers befindet (Bei ESX: lastname
)
Geschlecht
Wähle hier die Spalte aus in der das geschlecht des Speielers gespichert wird (Bei ESX sex
oder isMale
)
männlicher Geschlechtswert
Gebe hier ein was in der Geschlecht-Spalte als männlich angesehen wird (Bei ESX m
oder 1
, je nach Version). Beachte: Alle anderen Werte werden als Weblicher Spieler angelegt.
Die Konfiguration sollte jetzt ca. so aussehen (Beispiel für ESX 1.9.4):
Scrolle jetzt weiter nach unten um die weiteren Felder zu Konfigurieren
Gerburtsdatum
Wähle hier die Spalte in der sich das Geburtsdatum des Spielers befindet (Bei ESX: dateofbirth
)
Jetzt kommen wir zur Fahrzuegkonfiguration:
Unique ID
Hier musst du einen eindutigen Identifier für das Fahrzeug angeben, die gute Methode ist, einen weiteren Index in deiner Fahrzuegtabelle zu erstellen, welcher das Fahrzueg einzigarig macht, das machst du folegndermaßen:
1. Logge dich in phpmyadmin ein
2. Wähle deine Server Datenbank aus
3. Wähle die Fahrzeugtabelle aus
4. Klicke auf Struktur & Wähle "Spalte(n) hinzufügen", dort "Am Tabellenanfang" und klicke auf OK
4. Vergebe einen Namen (eg. id), wähle den Typ INT, die Länge 11, gebe Bei Index Unique and und wähle das Kästchen bei A_I (Wichtig!!) und klicke dann auf "Speichern"
Es kann sein dass du bei der Auswahl Index > Unique noch ein Fenster angezeigt bekommst in dem du einen Namen vergeben sollst
Nun hast du erfolgrich einen Unique Index Angelegt, jetzt sollte jedes Fahrzueg am Anfang eine Spalte mit dem namen id haben in der siche eine fortlaufende zahl befindet
Du könntest hier Theoretisch auch das Kennzeichen als Unique ID nehmen, da bestht aber das problem, wenn sich das Kennzeichen des Fahrzuegs ändert (durch ein Plate Chnage Script oä.), der Sync dieses nichtmehr erkennt und ein neues Anlegt und im schlimmsten fall fals zwei Fahrzuege das Kennzeichen "tauschen", falsche Daten angezeigt werden. Wie bereits gesagt, diese Methode ist nicht empfohlen.
Owner
Gebe hier die die Spalte an in der der Besitzer des Fahrzuegs deklariert ist, dies muss der selbe "identifer" wie oben bei der User Knonfiguration "identifer" um das Fahrzeug einem user zuordnen zu können. (Bei ESX owner
)
Kennzeichen
Sollte relativ saelbsterklärend sein, wähle hier die Spalte in der sich dass Kennzeichen des Fahrzuegs befindet (Bei ESX plate
)
Fahrzueugdaten
Wähle hier die Spalte in der die Fahrzuegdaten hinterlegt sind, meinstens ein Text mit ganz vielen Werten. (Bei ESX vehicle
)
Type
Wähle hier die Spalte in der der Fahrzueg Typ hinterlegt ist (Bei ESX type
)
Aktuell werden nur die Types car, boat & plane erkannt, wir arbeiten daran custom Types definieren zu können.
Die fertige Konfiguration sollte dann ca. so aussehen, klicke auf den "Weiter" Button
Jetzt kann es etwas dauern, wir fragen gerade testdaten ab. Nach einiger Zeit solltest du folgede Seite sehen:
Überpüfe hier ob die Spieler richtig erkannt werden (Es werden nur die ersten 5 Spieler angezeigt) Falls alles richtig ist, klicke auf Fertigstellen und schließe die Seite. Sollten die Spieler nicht richtig erkannt werden, klicke auf "Zurück" un überpüfe deine Eingaben.
Wir sind uns Bewusst, das der "Fertigstellen" Button keine Raktion Zeigt, bitte klicke diesden und schließe dann manuell die Seite. Wir arbeiten bereits daran.
Nun ist der Datenbank Syc fertig eingerichtetm du solltest nun in der "Personenregister" & "Fahrzeugreister" App deine Spieler und Fahrzuege finden: Wenn du jetzt erneut die Datenbank Sync einstellungen öffnest, solltest du diese Seite vorfinden.
Hier findest du deine Aktuell aktive Konfiguration und kannst verschienden Aktionen wie eine Neueinrichtung oder einen Mauellen Sync starten. Jetzt ist deine Datenbank Erfolgrich mit EmergencyOS Verbunden und wird von unserem System automatsich alle 20 Minuten Syncronisiert.
Last updated