HolaCMS 3 (In Development)

HolaCMS 3 wird die Basis für die neue Holarse-Webseite.

Export-Tool

Das Export-Tool ermöglicht das Extrahieren der bestehenden Artikel, News, Kommentare und Forenbeiträge aus dem Drupal-Holarse. Es benötigt eine Installation der MySQL-Datenbank und den dazugehörigen Dump (die alte Datenbank ist latin1).

Das Export-Tool liegt unter /tools/HolarseExport/ und ist in Java geschrieben. Es benötigt eine lokale MySQL-Installation mit der Holarse-Datenbank. Es exportiert automatisch alles nach /tmp/export/.

Import

Den Import der Dateien kann man über die REST-API durchführen. Es gibt zwei Scripte, die alle Export-Dateien automatisch an den Dummy-User übertragen. Sie liegen in /doc/import/ und erwarten die zu importierenden Daten in /tmp/export/.

Webapp

Anforderungen

• Java 21
• Docker, docker-compose
• Apache Maven 3.x
• Containerisiert: Apache Tomcat 10, Apache Artemis, PostgreSQL 16

Container-Deployment

Zuerst die Volumes für Postgres und AMQ anlegen

docker volume create website_my_pgdata
docker volume create amq_journal_data
docker volume create storage_data

dann am Holarse Container-Repository anmelden

git login git.holarse.de

Jetzt noch die Datenbank initial befüllen mit dem Script

./tools/scripts/setup_db_sql.sh

und die Containerbande starten mit

docker-compose -f doc/docker-compose.yml up

Kompilieren

Die installierbare WAR-Datei erhält man durch das Bauen mit

mvn clean package

im Hauptverzeichnis, wo sich auch die pom.xml befindet. Beim ersten Durchlaufen werden die gesamten Abhängigkeiten von Maven aufgelöst und heruntergeladen.

Ist Tomcat so konfiguriert, dass das ROOT-Verzeichnis auf das Target-Verzeichnis zeigt, dann sollte die Webseite bereits unter http://localhost:8080 angezeigt werden. Sonst kann man die Datei /target/holarseweb.war über die Tomcat-Manager-Konsole installieren.

Apache Artemis Message-Queue

Die Message-Queue ist unter http://localhost:8161 erreichbar.

Datenbank

Die Datenbank ist unter http://localhost:5432 erreichbar.

Mails

Der Mailcatcher ist unter http://localhost:8025 erreichbar.

S3-Storage

Die Storage-Console (minio) ist unter http://localhost:9001 erreichbar.

Webseite

Die Webseite ist unter http://localhost:8080/holarseweb/ erreichbar.

Manuelles Deployment

Die Datenbank per Distro-Repo einbinden oder von dem Postgresql-bereitgestelltem Repository. Die Anleitungen finden sich in /doc/db/.

Die Benutzer müssen vorab angelegt werden. Zudem ist in der postgresql.conf noch die Authentifizierung von md5 (Standard) auf

password_encryption = scram-sha-256

zu ändern.

Dann kann die Datenbank und der Benutzer manuell auf dem Datenbank-Server via

su - postgres
createrole holarse
createdb -O holarse holarse

angelegt werden.

Die Datenbankscripte können, wie oben schon genannt, über das Script tools/scripts/setup_db_sql.sh eingefügt werden.

Login

Zuerst einen Benutzer über die Oberfläche registrieren und diesen dann per SQL zum Admin erheben:

tools/scripts/make_user_admin.sh DEINBENUTZERNAME

Ende

Willkommen im HolaCMS 3-Testsystem!