Installation der benötigten Dienste unter Windows
Um das Backend zu installieren, sind folgende Downloads nötig:
Erlang https://www.erlang.org/downloads (Windows Installer; aktuell in der Version 25.3)
Java 1.8 oder neuer wird für den Betrieb von Solr benötigt. Der Betrieb von solr ist dabei sowohl mit der Open JDK als auch mit Oracle getestet worden (Link, Stand 21.02.2024):
.Net Framework 4.8 https://dotnet.microsoft.com/download/dotnet-framework/net48 (Runtime)
Solr https://solr.apache.org/downloads.html (solr-8.Minor-Versionsnummer.zip)
Nssm (latest release)
Postgres (Windows x86-64)
PG Admin (Neuste Version)
RabbitMQ (Direct Downloads)
Achten Sie darauf, dass die installierten Versionen von RabbitMQ und Erlang miteinander kompatibel sind. Eine Übersicht erhalten Sie auf folgender Seite:
Step1: Installiere Erlang, Java und .Net
Zunächst installierst du bitte Erlang, Java und das .Net Framework. Hier kannst du die Standardeinstellungen verwenden, welche dir der Installer vorschlägt.
Nach der Installation von Java musst du sicherstellen, dass die JAVA_HOME Variable gesetzt ist. Sie muss auf das JRE- und nicht auf das unterliegende bin-Verzeichnis gesetzt werden bspw. wie im nächsten Screenshot.
Führe bitte nach der Installation dieser drei Komponenten einen Neustart deines Systems durch.
Step2: Installiere Solr
Jetzt nimmst du die Zip-Datei, welche du dir von Solr heruntergeladen hast und verschiebst sie an den Ort, an welchem du Solr installiert haben möchtest. Entpacke die Zip-Datei.
Entpacke nun die Zip-Datei von nssm an einem Ort, wo du es installiert haben möchtest.
Öffne ein Terminal und führe den unten stehenden Befehl aus:
"Pfad zur nssm.exe im win64 Verzeichnis der Installation" install Name_des_Win_service
Bei mir würde dieser Befehl so aussehen:
"C:\Program Files\nssm-2.24\win64\nssm" install solr
Jetzt sollte ein Fenster erscheinen, in diesem trägst du im Path ein, wo deine solr.comd liegt. Das Startup directory verweist auf das bin Verzeichnis deiner Solr Installation.
Zudem musst du unter Arguments “start -f -p Portnummer” eintragen. Der Standardport, welcher von den Actiwareservices für die Solr genutzt wird, ist 30004.
Drücke nun auf Install Service.
Deine Solr ist jetzt als Windows Service registriert und du kannst fortfahren.
Überprüfe, ob in den Diensten der Service läuft, sonst starte diesen.
Jetzt musst du einen Core in Solr anlegen:
Hierfür musst du im bin Ordner deiner Solr-Installation ein Terminal öffnen.
Führe hier den folgenden Befehl aus:
solr.cmd create_core -c reports
Du solltest in deinem Terminal eine Meldung bekommen, die “Created new core ‘reports’” lautet.
Step3: Installation von Postgres und PG Admin
Postgres
Führe den Installer aus, den du von Postgres heruntergeladen hast.
Während der Installation musst du ein Passwort für den Administrator (postgres) vergeben.
Merke dir dieses gut!
Zum Abschluss der Installation kannst du noch Tools installieren, wenn du dies möchtest. Im nächsten Schritt installierst du PG-Admin. Dies ist ein Tool, welches dir hilft deine Datenbanken zu verwalten oder dir die Daten in deinen Datenbanken anzusehen.
PG-Admin
Führe den PG-Admin Installer aus und folge den Anweisungen, welche dieser dir gibt.
Den Befehl zum Erstellen eines Nutzers gibst du in PG Admin ein. Hierfür führst du einen Rechtsklick auf eine Datenbank aus. Hier wählst du Query Tool aus.
Im sich öffnenden Fenster kannst du den SQL-Befehl zur Erstellung eines Nutzers ausführen.
Alternativ kann man über den Bereich ‘Login/Group Roles’ über Create ebenfalls in einen Dialog gelangen, der dann einen neuen Nutzer anlegt. Beachte hierbei, dass über den Reiter ‘Priviliges’ alle Rechte aktiviert sind.
Step 4 Installieren der RabbitMQ und Setzen des Users
RabbitMQ
Vor der Installation der RabbitMQ setzen wir die Umgebungsvariable RABBITMQ_BASE auf das Verzeichnis, in welchem die Datenbank und Logs später erstellt werden sollen.
Hierfür benutzen wir den folgenden Konsolenbefehl:
also beispielsweise:
Führe den Installer aus, welchen du heruntergeladen hast. Folge den Anweisungen des Installers.
Nach Abschluss des Installers, öffne ein weiteres Konsolenfenster und navigiere wieder mit “cd “Pfad““ zum Ort, an welchem du RabbitMQ installiert hast. Gehe nun mit
in den Ordner sbin.
Wir müssen jetzt den Nutzer hinzufügen, welcher später für die ACTIWARE Services verwendet wird.
Ich nutze in diesem Beispiel den User “rabbit”, um ihn hinzuzufügen, benutze ich den Befehl:
per rabbitmqctl.bat add_user "rabbit" "password"
kann der User direkt mit Passwort gesetzt werden.
Du wirst dazu aufgefordert, ein Passwort einzugeben. Merke dir dieses gut, da du es in den Installern der ACTIWARE Services benötigst.
Nun musst du noch die Berechtigungen des Nutzers einrichten. Hierzu führst du folgenden Befehl aus:
Zusätzlich musst du noch das Plugin Web Stomp aktivieren. Dieses Plugin ermöglicht RabbitMQ die Nutzung eines WebSockets auf Port 15674.
Hierfür musst du lediglich in der Konsole den folgenden Befehl ausführen, während du dich im sbin Verzeichnis deiner Installation befindest.
Wenn du überprüfen möchtest, ob dies erfolgreich war, dann kannst du zusätzlich den folgenden Befehl ausführen.
Die Zeile, in der das Web Stomp Plugin aufgeführt wird, sollte so aussehen:
Jetzt kann dein Benutzer die Messagequeue benutzen.
Troubleshooting
Step 5: ACTIWARE Services installieren
Führe jetzt die Installer der ACTIWARE Services aus und folge den Anweisungen. Nutze für den Datenbanknutzer entweder den Nutzer “postgres” mit deinem selbst vergebenen Passwort oder deinen selbst erstellten Nutzer.
Für RabbitMQ gibst du immer deinen erstellten Nutzer mit seinem Passwort an.
Hintergrund dieser Anleitung ist, dass es insbesondere bei der Installation auf Datacenter bei der Installation durch einen Installer Probleme mit der Komponente Erlang gegeben hat.
Weitere Informationen zur Problembehebung vor und nach der Installation finden Sie unter