Ein vorkonfiguriertes TopLogic kann auf einem Ubuntu-Linux-System direkt als Debian-Paket installiert werden.

Auswahl des Rechners

Das Debian-Paket ist für die Verwendung in einer dedizierten VM optimiert: Zusätzlich zur Anwendung an sich werden auch die benötigte Datenbank sowie der WebServer installiert, falls diese nicht bereits installiert sind. Anschließend werden deren Konfigurationen für die Anwendung angepasst und die Anwendung direkt gestartet. Diese läuft bis sie explizit beendet wird. Wird der Server neu gestartet, wird auch die Anwendung automatisch mit gestartet.

Wichtig: Das Paket passt die Konfiguration der Datenbank und des WebServers an, damit diese von der TopLogic Anwendung direkt verwendet werden können. Daher ist das Debian Paket nicht für die Installation auf Systemen geeignet, die bereits anderweitig verwendet werden. Es sollte also insbesondere nicht auf dem eigenen Rechner oder existierenden Servern installiert werden. Es eignet sich gut für eine virtuelle Umgebung auf dem eigenen Rechner oder in einer Cloud.

Importieren des TopLogic-Repository-Schlüssels

Herunterladen und Einbinden des TopLogic-Signaturschlüssels:

curl -sL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x955a22ff7750f043ea48e580b44eb751b8a3726c" | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/toplogic.gpg >/dev/null

Einbinden des TopLogic-Repositories

Einbinden des TopLogic-Debian-Repositories in die Paketquellen des Systems:

sudo add-apt-repository -y "deb https://dev.top-logic.com/nexus/repository/toplogic-deb/ toplogic main"

Nach erfolgreichem Einbinden des Repositories, muss eine Aktualisierung der Paketquellen angestoßen werden:

sudo apt update

Installieren von TopLogic

Starten der Installation von einer vorkonfigurierten leeren TopLogic-Instanz:

sudo apt install tl-process

Das Paket richtet automatisch eine MariaDB-Datenbank, einen Tomcat-Applikationscontainer und einen Apache-Webserver auf dem System ein und installiert TopLogic so, dass die Weboberfläche direkt (am Standardport 80) über HTTP aufgerufen werden kann.

​Log-in in die Anwendung

Nach erfolgreicher Installation ist ein Log-in in die TopLogic-Weboberfläche über http://<mein-rechner-name>/ möglich. Es wurde automatisch ein sicheres Initial-Passwort vergeben und am Ende des Startvorgangs in das Anwendungslog geschrieben. Es kann mit dem folgenden Befehl nachgeschlagen werden (bis Version 7.6.0 war das Initial-Passwort fix vorgegeben als root1234):

grep -n3 " Initial password " /var/log/tomcat9/catalina.out

Die Ausgabe könnte wie folgt aussehen:

966-[2023-10-25 13:58:47] [info] *****************************************************
967-[2023-10-25 13:58:47] [info] ***                                               ***
968:[2023-10-25 13:58:47] [info] ***  Initial password for 'root': 702d104d-4f...  ***
969-[2023-10-25 13:58:47] [info] ***                                               ***
970-[2023-10-25 13:58:47] [info] *****************************************************

An dieser Stelle kann jetzt mit dem TopLogic-Tutorial begonnen werden. Die Anwendung wird im Hintergrund weiterlaufen, bis der Server heruntergefahren wird. Beim nächsten Start wird sie automatisch mit gestartet.

Updates

Die Anwendung wird von apt automatisch aktualisiert wenn es Updates gibt, genau so wie alle anderen per apt installierten Pakete.

Starten und Stoppen der Anwendung

Die Anwendung verwendet Tomcat als Webserver, dieser kann wie folgt gestoppt und gestartet werden:

sudo systemctl stop tomcat9.service
sudo systemctl start tomcat9.service

Per default wird der Tomcat nach einem Systemneustart automatisch gestartet.
Dieses Verhalten kann mit den folgenden Befehlen ein- und ausgeschaltet werden:

sudo systemctl enable tomcat9.service
sudo systemctl disable tomcat9.service

Eine Information zu dem aktuellen Status des Tomcat-Dienstes kann wie folgt erlangt werden:

sudo systemctl status tomcat9.service

Deinstallation von TopLogic

Über das folgende Kommando kann das TopLogic Paket deinstalliert werden:

sudo apt remove tl-process

Dabei bleiben die Konfigurationsdateien erhalten und können nach erneuter Installation weiter genutzt werden.

​Betrieb im Internet - Absicherung per SSL Zertifikat

Soll die Anwendung öffentlich am Internet betrieben werden, ist empfohlen, ein HTTPS-Zertifikat zu installieren, so dass eine gesicherte Verbindung über HTTPS möglich ist.
Eine einfache und kostenlose Möglichkeit hierfür ist die Verwendung von CertBot.
Hierzu ist ein öffentlicher Domainname nötig und es müssen die folgenden Pakete installiert werden:​

sudo apt install certbot python3-certbot-apache

Anschließend wird die Konfiguration umbenannt um den Domainnamen wiederzuspiegel:

sudo mv /etc/apache2/sites-enabled/bpe.conf /etc/apache2/sites-enabled/{example.com}.conf

Zuletzt wird das Zertifikat mit diesem Kommando abgefragt:

sudo certbot --apache

​