Zum Hauptinhalt gehen

Aufbau von BlueMind

Der Quellcode von BlueMind wird von einem Continuous Integration Server kompiliert und die erzeugten Binärdateien können von unserer Website in Form von Installationsprogrammen heruntergeladen werden, die den Prozess so einfach wie möglich machen. Es ist jedoch möglich, BlueMind manuell zu kompilieren, indem Sie die folgenden Anweisungen befolgen.

Voraussetzungen

Die Kompilierung muss mit Java 21 erfolgen.

Abruf und Aufbau des Codes

Der Code von BlueMind wird unter https://gitlab.bluemind.net/bluemind-public/bluemind veröffentlicht. Dies ist eine Kopie unserer internen Codebasis, die wie folgt organisiert ist:

  • Masterbranche: Hauptentwicklung
  • Zweige release/X.Y: Basis für die zukünftige Version X.Y.Z (z.B. release/4.1 für 4.1.3)
  • Die neuesten Releases sind als Tags auf den Release-Zweigen vorhanden.

Um den Code abzurufen und zu erstellen (hier für den Zweig release/4.1) :

git clone --depth 1 --branch release/4.9 https://gitlab.bluemind.net/bluemind-public/bluemind.git
cd bluemind
mvn clean install -Dmaven.test.skip=true

Alle BlueMind-Binärdateien werden in Ihrem lokalen maven-Repository installiert.

Abhängigkeiten

Die BlueMind-Pakete sind abhängig von bm-cyrus und bm-nginx.

bm-nginx

git clone https://forge.blue-mind.net/stash/scm/bm/bm-nginx.git
cd bm-nginx
./ci/build_nginx.sh

Umgebung

Es reicht nicht aus, die Pakete auf einem Server zu installieren, der die Voraussetzungen erfüllt, um eine funktionierende BlueMind-Installation zu haben. Die folgenden Schritte werden automatisch von dem Paket bm-installwizard durchgeführt, das in den Installationsprogrammen enthalten ist.

Konfigurationsdatei bm.ini

Die Datei /etc/bm/bm.ini muss mit dem folgenden Inhalt erstellt werden (je nach Ihrer Konfiguration anzupassen):

[global]
external-url = your-domain.com
external-protocol = https
host = <YOUR SERVER IP>
dbtype = PGSQL
db = bj
user = bj
password = "bj"

Postgresql-Datenbank

Die folgenden Anweisungen beziehen sich auf postgresql 9.4 und sollten entsprechend Ihrer DBMS-Version angepasst werden.

Wir bieten Ihnen eine Konfiguration an, die Sie an Ihre Bedürfnisse anpassen können, die in /etc/postgresql/9.4/main/ abgelegt werden soll, um die vorhandenen Dateien zu ersetzen:

-->pg_hba.conf

-->postgresql.conf

Die Datei postgresql.conf muss bearbeitet werden, um den Wert der Option max_connections festzulegen: Der empfohlene Wert lautet: <NB CORES> * 10 + 10

Die Datenbank der kompilierten Version kann unter folgender Adresse abgerufen werden: http://pkg.blue-mind.net/db/

Die folgenden Befehle verwenden das Beispiel der Version 3.0.23 und müssen entsprechend Ihrer Postgresql-Konfiguration angepasst werden:

sudo -u postgres psql
create user bj with password 'bj';
create database bj;
grant all privileges on database bj to bj;
\q
sudo -u postgres psql bj < 3.0.23.sql

Host-Informationen in Basis einfügen :

sudo -u postgres psql
insert into host (host_domain_id, host_timeupdate, host_timecreate, host_name, host_ip) values (1, now(), now(), 'bluemind', '<ip_hote>');
insert into hosttag (tag_id, host_id) values ((SELECT id from systemtag where name='bm/core'), 1);
\q

Starten Sie BlueMind neu:

bmctl restart

Abschließend empfehlen wir Ihnen, den Wert kernel.shmmax=300000 in die Datei /etc/sysctl.conf zu setzen.

Konfiguration von nginx

Die Dateien bm-webmail und bm-client-access (Verzeichnis /etc/nginx/sites-available) müssen bearbeitet werden, um ${externalUrl} durch die externe Server-URL zu ersetzen (wie auch in bm.ini angegeben), und dann nach /etc/nginx/sites-enabled kopiert oder verknüpft werden.

Starten Sie dann einfach Ihren Server neu, um Ihre neue BlueMind Installation zu nutzen!