Historique de la page
Sv translation | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||
Le code source de BlueMind est compilé par un serveur d'intégration continue, et les binaires produits sont téléchargeables sur notre site sous forme d'installeurs qui rendent le processus aussi simple que possible. Il est toutefois envisageable de compiler BlueMind manuellement en suivant les instructions suivantes. Pas à pas pour la version master (à partir de BlueMind 3.5)Pré-requis : une distribution de type debian, java 8 et maven. Le build a été très largement simplifié à partir de BlueMind 3.5 grâce à l'utilisation de tycho :
Tous les artifacts binaires BlueMind sont installés dans votre repository local maven. Pas à pas pour la version 3Le build nécessite l'enchaînement de nombreux scripts ad hoc. Nous fournissons une procédure simplifiée à partir d'une image docker, que vous pouvez adapter selon vos besoins. Pré-requis : une distribution linux avec docker >= 1.6.2 et les deux fichiers suivants.
Dans votre répertoire de travail, positionnez Dockerfile à la racine et le script bluemind-build.sh dans un nouveau dossier "build". Exécutez ensuite les commandes suivantes pour construire le tag release-3.0.23 (à remplacer par la référence git de votre choix du repository
Les paquets deb nécessaires à une installation vierge de BlueMind sont alors disponibles dans le dossier build/bluemind/build_artifacts/. DépendancesLes paquets BlueMind dépendent de bm-cyrus et bm-nginx. bm-cyrus
bm-nginx
EnvironnementIl ne suffit pas d'installer les paquets sur un serveur répondant aux pré-requis pour disposer d'une installation BlueMind fonctionnelle. Les étapes suivantes sont réalisées automatiquement par le paquet bm-installwizard inclus dans les installeurs. Fichier de configuration bm.iniLe fichier /etc/bm/bm.ini doit être créé avec le contenu suivant (à adapter selon votre configuration) :
Base de données postgresqlLes instructions suivantes portent sur postgresql 9.4, à adapter selon votre version du SGBD. Nous vous proposons une configuration que vous pouvez adapter à vos besoins, à déposer dans /etc/postgresql/9.4/main/ en remplacement des fichiers existants :
Le fichier postgresql.conf doit être édité afin de poisitionner la valeur de l'option max_connections : la valeur recommandée étant : <NB CORES> * 10 + 10 La base de données correspondant à la version buildée peut être récupérée à l'adresse suivante : http://pkg.blue-mind.net/db/ Les commandes suivantes utilisent l'exemple de la version 3.0.23, et doivent être adaptées selon votre configuration de postgresql :
Insérer en base les informations de l'hôte :
Redémarrer BlueMind :
Pour finir, nous vous conseillons de positionner la valeur kernel.shmmax=300000 dans le fichier /etc/sysctl.conf. Configuration de nginxLes fichiers bm-webmail et bm-client-access (dossier /etc/nginx/sites-available) doivent être édités pour remplacer "${externalUrl}" par l'URL externe du serveur (telle que spécifiée également dans bm.ini), puis copiés ou liés dans /etc/nginx/sites-enabled. Il suffit ensuite de redémarrer votre serveur pour profiter de votre nouvelle installation BlueMind ! |
Sv translation | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
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. Step by step process for master version (from BlueMind 3.5)Prerequisite: a debian/ubuntu recent distribution, java 8, maven The build was greatly simplified from BlueMind 3.5 thanks to maven/ tycho:
BlueMind binary artifacts will then be available in your local maven repository. Distribution packages (that can be listed with the command 'find ~ / .m2 / repository / -name "* .deb"') can be used to manually perform a clean installation. Step by step process for version 3.0The build requires several steps using ad hoc scripts. We provide a simplified procedure making user of a docker image, which you can adapt to your needs. Prerequisite : a recent linux distribution with docker >= 1.6.2 and the two following files:
In your working directory, store Dockerfile to to your root directory and store bluemind-build.sh script in a new "build" folder. Then run the following commands to build the 3.0.29 release-tag (this is an example to be replaced by the git reference of your choice in our repository http://git.blue-mind.net/gitlist/bluemind/):
Deb packages needed for a fresh BlueMind installation are then available in the build/bluemind/build_artifacts/ folder. Dependanciesbm-cyrus
bm-nginx
EnvironmentInstalling 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 fileThe file /etc/bm/bm.ini must be created with the following content (to be tuned to your configuration):
Postgresql databaseThe 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/:
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:
Insert host information in database :
Restart BlueMind :
Finally, we recommend that you set the value kernel.shmmax=300000 in /etc/sysctl.conf. nginx configurationThe bm-webmail and bm-client-access files (in /etc/nginx/sites-available folder) must be edited to replace all " Then just restart your nginx server to enjoy your new BlueMind system! |