Zum Hauptinhalt springen

Aufbau von BlueMind

Der BlueMind-Quellcode wird von einem kontinuierlichen Integrationsserver 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 gestalten. Es ist aber auch möglich, BlueMind manuell zu kompilieren, indem Sie die folgenden Anweisungen befolgen.

Voraussetzung​

Die Kompilierung muss mit Java 8 durchgeführt werden.

Code-Abruf und -Konstruktion​

Der BlueMind-Code ist unter https://forge.bluemind.net/stash/projects/BM/repos/bluemind-public veröffentlicht. Dies ist eine Kopie unserer internen Codebasis, die wie folgt organisiert ist:

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

Den Code abrufen und aufbauen (hier für den Zweig Release/4.1):

git clone --depth 1 --branch release/4.1 https://forge.bluemind.net/stash/scm/bm/bluemind-public.git
cd bluemind-public
mvn clean install -Dmaven.test.skip=true

Alle binären Artefakte von BlueMind werden in Ihrem lokalen Maven-Repository installiert.

Abhängigkeiten​

BlueMind-Pakete hängen von bm-cyrus und bm-nginx ab.

bm-cyrus​

git clone https://forge.blue-mind.net/stash/scm/bm/bm-cyrus-imapd.git
cd bm-cyrus-imapd
./ci/build_cyrus.sh

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 Anforderungen erfüllt, um eine funktionierende BlueMind-Installation zu haben. Die folgenden Schritte werden automatisch von dem in den Installationsprogrammen enthaltenen Paket bm-installwizard durchgeführt.

Konfigurationsdatei bm.ini​

Die Datei /etc/bm/bm.ini muss mit folgendem Inhalt angelegt werden (entsprechend 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 müssen an Ihre Version des DBMS angepasst werden.

Wir schlagen eine Konfiguration vor, die Sie an Ihre Bedürfnisse anpassen können und die in /etc/postgresql/9.4/main/ zu hinterlegen ist, um die bestehenden 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 ist: <NB CORES> * 10 + 10

Die der kompilierten Version entsprechende Datenbank kann unter der folgenden 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

Fügen Sie Host-Informationen in die Datenbank ein:

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

BlueMind neu starten:

bmctl restart

Schließlich empfehlen wir Ihnen, in der Datei /etc/sysctl.conf den Wert kernel.shmmax=300000 zu setzen.

Nginx konfigurieren​

Die Dateien bm-webmail und bm-client-access (Ordner /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 und nutzen Sie Ihre neue BlueMind-Installation!

Letztes Update am