Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: Content imported from a Scroll Translations translation file.

...

Sv translation
languageen

Introduction

BlueMind source code is compiled by a continuous integration server, and binary installers are downloadable from our site to make the process as simple as possible. However, it is possible to compile BlueMind manually by following the instructions below.

Prerequisites

BlueMind must be build with Java 8

Volet

On this page:

Sommaire

Fetching and building code

BlueMind code is published here: https://forge.bluemind.net/stash/projects/BM/repos/bluemind-public. It is a public copy of our internal repository which follows the following guidelines:

  • master branch: main development
  • dev/X branches: base branches for future X.Y.Z release (for instance dev/4 for BlueMind 4.1.3)
  • release/X branches: code for BlueMind released versions. The tip of those branches is static: they are effectively used as tags.

To fetch and build the code:

Bloc de code
git clone --depth 1 --branch dev/4 https://forge.bluemind.net/stash/scm/bm/bluemind-public.git
cd bluemind-public
mvn clean install -Dmaven.test.skip=true

All BlueMind binary artifacts will be installed in your local maven repository.

Dependancies

bm-cyrus


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

bm-nginx

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


Environment

Installing packages on a server that meets the prerequisites is not enough to to have a working BlueMind installation. The following steps must additionally be performed (convenience bm-installwizard package included in the installers does just this).

bm.ini configuration file

The file /etc/bm/bm.ini must be created with the following content (to be tuned to your configuration):

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

Postgresql database

The following instructions are related to postgresql 9.5, to be tuned to your DBMS version.

We propose a configuration that you can adapt to your needs. Replace the following files in /etc/postgresql/9.5/main/:

View file
namepg_hba.conf
height250
View file
namepostgresql.conf
height250

The postgresql.conf file must be edited to set the value of max_connections option. The recommended value being: <NB CORES> * 10 + 10

The database corresponding to the builder version may be downloaded at the following address: http://pkg.blue-mind.net/db/

The following commands use the example of the 3.0.29 release, and should be adjusted depending on your postgresql configuration:

Bloc de code
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

Insert host information in database :

Bloc de code
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

Restart BlueMind :

Bloc de code
bmctl restart

Finally, we recommend that you set the value kernel.shmmax=300000 in /etc/sysctl.conf.

nginx configuration

The bm-webmail and bm-client-access files (in /etc/nginx/sites-available folder) must be edited to replace all  "${externalUrl}" occurences with the server external URL (as specified in bm.ini), then symlinked to /etc/nginx/sites-enabled.

Then just restart your nginx server to enjoy your new BlueMind system!

Sv translation
languagede

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.

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):

Bloc de code
git clone --depth 1 --branch release/4.1 https://forge.bluemind.net/stash/scm/bm/bluemind-public.git
cd bluemind-public
mvn -P full 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

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

bm-nginx

Bloc de code
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):

Bloc de code
[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:

View file
namepg_hba.conf
height250
View file
namepostgresql.conf
height250

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

Die der gebauten 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:

Bloc de code
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:

Bloc de code
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:

Bloc de code
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!