Historique de la page
Sv translation | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||
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
Récupération et construction du codeLe code de BlueMind est publié dans https://forge.bluemind.net/stash/projects/BM/repos/bluemind-public. Il s'agit d'une copie de notre base de code interne, organisée de la façon suivante :
Pour récupérer et construire le code (ici pour la branche release/3.5.14) :
Tous les artifacts binaires BlueMind sont installés dans votre repository local maven. 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 | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
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/):
Fetching and building codeBlueMind 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:
To fetch and build the code:
All BlueMind binary artifacts will be installed in your local maven repository. 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! |