documentation cmdbuild : ready2use

DOCUMENTATION CMDBUILD : READY2USE
http://www.cmdbuild.org/en/
http://www.cmdbuild.org/en/prodotti/ready2use
CMDBuild est une entreprise italienne de softwares basé sur le management de base de données.
Son logiciel, CMDBUILD, est une application web (protocole HTTP) qui transmet en interface web
des graphiques et des possibilités de modifications sur ces bases de façon simple et intuitive.
Son optimisation, appelé CMDBUILD : READY2USE, permet d'installer cette application en ayant
déjà la plupart des composants graphique et rangements nécessaires à l'utilisation quasi-instantané
du produit tout en suivant les Best-practices ITIL.
CONFIGURATION
J'ai commencé à installer Ready2use sur un serveur de prototypage LVM de 12Go, avec 4Go de
mémoire vive et 2coeurs de processeur.
L'OS (en interface minimale) sera une UBUNTU Trusty 14.04 LTS en 64Bits.
PRÉREQUIS
Cette application Web demande plusieurs prérequis pour fonctionner.
PostGreSQL 9.3 :
PostgreSQL est un système de gestion de base de données. Il s'appuie sur les modèles relationnels
mais apporte des extensions. Cela permet de qualifier PostgreSQL de système de gestion de base de
données "relationnel-objet" (ORDBMS), Il supporte aussi le SQL.
JDK 1.6 :
le JDK (Java Development Kit) Désigne un ensemble de bibliothèques logicielles de base du
langage de programmation Java, ainsi que les outils avec lesquels le code Java peut être compilé,
destiné à la machine virtuelle JAVA.
TomCat 6.0 :
Tomcat est un serveur d'applications Java. Il est intégralement écrit en Java et les applications qu'il
est capable d'exécuter (nommées applications web) doivent être développées en Java. Son rôle est
donc de retransmettre les applications web sur une page HTML.

Les prérequis optionnels :
Alfresco 3.4 :
Alfresco est une application de gestion électronique des documents (GED ou en anglais DMS pour
Document Management System) qui consiste à organiser et gérer des informations et des
documents électroniques au sein d'une organisation.
Alfresco participe ainsi aux processus de collaboration et d'échange d'informations.
OCS inventory :
OCS Inventory (Open Computer and Software Inventory) est une application permettant de réaliser
un inventaire sur la configuration matérielle des machines du réseau et sur les logiciels qui y sont
installés et de visualiser ces informations grâce à une interface web.
Liferay Portal 6.0 :
Liferay est un portail open source de gestion de contenu, fait pour un environnement JAVA,
exploitable sur un serveur d'application tel que JEE ou TomCat et qui s'interface avec plusieurs base
de données différentes notamment Oracle, SQL server et PostGreSQL.
PostGIS 2.0 :
PostGIS est une extension du SGBD PostgreSQL, qui active la manipulation d'informations
géographiques sous forme de géométries (points, lignes, polygones), Il permet à PostgreSQL d'être
un SGBD spatial (SGBDs) pour pouvoir être utilisé par les systèmes d'informations géographiques.
INSTALLATION
Après avoir fait les configurations basique de votre machine (update, upgrade) puis via
'etc/network/interfaces' configurer l'accès à internet, accès en local, résolutions de noms.
PostGreSQL : PostgreSQL est déjà implanté dans les dépôts de LTS 14.04, il suffit de l'appeler via
une simple commande apt-get suivi de sa version.
test@ready2use:~$ sudo apt-get install postgresql-9.3
Il en va de même pour TomCat 7.0 :
test@ready2use:~$ sudo apt-get install tomcat7

CONFIGURATION DE CMDBUILD
Pour bien paramétrer CMDbuild, nous devons lui renseigner un nombre d'information conséquents ;
Pour bien débuter ce long paramétrage, nous commencerons par copier le zip « cmdbuild » vers le
serveur, et l'insérer dans /webapps de TomCat.
La configuration et la création d'un utilisateur dans PostGreSQL
Vérifiez que le paquet « postgresql-contrib 9.3 » est bien situé dans … ; il se pourrait que cela créer
des erreurs. Si il n'y est pas, téléchargez-le.
Connectez vous avec l'utilisateur de base, « postgres », en utilisant la commande :
test@Ready2use:~$ sudo su postgres
puis rentrer dans sa base de données :
postgres@Ready2use:~$ sudo psql postgres
sudo psql « nomduser »
postgres=#
Commencer par attribuer un mot de passe à cet utilisateur. Nous utiliserons « postgres » à titre
d'exemple.
postgres=# ALTER USER postgres PASSWORD 'postgres';
sortez de la base postgres
postgres-#\q
A chaque instant, n'hésitez pas à aller vérifier les logs d'erreur de vos manipulations dans les fichiers
« catalina.out » (mieux vaut le lancer dans un terminal additionnel) via :
test@ready2use:~$ sudo tailf /var/log/tomcat7/...
Sur TomCat, on commencera par vérifier si le serveur d'application est bien installé. Pour cela, il
faudra aller sur « http://votre.adresse.IP:8080 »
Si une page comme celle-ci s'affiche, alors vous pourrez continuer la configuration de votre serveur.
Sinon, vérifiez la bonne installation de votre paquet TomCat.

Pour cette procédure, il faut au préalable stopper le service tomcat7
test@Ready2use:~$ sudo service tomcat7 stop
Allez dans le repertoire de JDBC, un connecteur qui fera le lien entre la base TomCat (Apache) et la
base de donnée SQL (postgreSQL).
Allez sur le site jdbc.posgresql pour trouver le paquet correspondant à votre version.
Il faudra ensuite le copier dans le répertoire courant de TomCat :
test@ready2use:~$ sudo cp postgresql-9.3-1104.jdbc4.jar
/usr/share/tomcat7/lib/
Ensuite, copier le .war d'installation de CMDbuild et de shark dans les répertoires de TomCat :
test@Ready2use:~$ sudo cp cmdbuild-2.3.4.war
/var/lib/tomcat6/webapps/
test@Ready2use:~$ sudo cp cmdbuild-shark-server-2.3.4.war
/var/lib/tomcat6/webapps/
Puis redémarrer votre serveur d'application pour que tomcat y créer les nouveaux répertoires
test@Ready2use:~$ sudo service tomcat7 start
Puis y insérer JDBC dans le répertoire /WEB-INF/lib crée par tomcat
test@Ready2use:~$ sudo cp postgresql-9.1-901.jdbc4.jar
/var/lib/tomcat7/webapps/cmdbuild-2.3.4/WEB-INF/lib/
test@Ready2use:~$ sudo cp postgresql-9.1-901.jdbc4.jar
/var/lib/tomcat7/webapps/cmdbuild-shark-server-2.3.4/WEB-INF/lib/
Une fois ceci fait, créer dans TomCat un utilisateur qui aura le rôle de « super utilisateur » dans
l'interface web :
vi /etc/tomcat7/tomcat-users.xml
Nous l’appelerons « tomcat »
<tomcat-users>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<role rolename="admin-gui"/>
<user username="tomcat" password="tomcat" roles="manager-gui
,manager-jmx,manager-script,manager-status,admin-gui"/>
</tomcat-users>
Qui vous permettra de vérifier la fonctionnalité de l'interface d'administration de TomCat (écoute
sur le port 8080):
exemple : 192.168.123.1:8080/manager.xml
Il se peut que Tomcat mette énormément de temps à redémarrer (une moyenne de plus de
100 000ms est problématique), pour éviter ce problème, positionnez-vous dans /etc/default
puis avec un éditeur, ouvrez le fichier tomcat.xmx et insérez à la fin de la ligne JAVA_OPTS:

- > java.security.egd=file:/dev/./urandom
Ensuite, il faudra s'assurer que JBDC est bien lancé en tant qu'utilisateur tomcat7, utilisateur spécial
TomCat du serveur :
test@Ready2use:~$ chown tomcat7:tomcat7/var/lib/tomcat6/webapps/
cmdbuild-2.3.4/WEB-INF/lib/ postgresql-9.3-1104.Jbdc.jar
test@Ready2use:~$ chown tomcat7:tomcat7/var/lib/tomcat6/webapps/
cmdbuild-shark-server-2.3.4/WEB-INF/lib/ postgresql-9.3-
1104.Jbdc.jar
Vérifiez que le paquet « tomcat-util-7.0.52.jar » est bien présent dans /usr/share/java ; il se pourrait
que cela créer des erreurs. Si il ne l'est pas, téléchargez le.
Une fois ceci fait, vous devriez être capable de lancer le serveur web de cmdbuild.
Rendez-vous sur la page d'aministration de TomCat et cliquer sur « Démarrer »à la ligne de
l'application cmdbuild.
Le démarrage peut prendre un certain temps. Pour vous assurer de ne pas attendre pour rien,
installer le paquet « htop » sur votre serveur pour vérifier l'état de vos ressources, et vérifier vos
sorties « catalina.out » et « cmdbuild.log ».
Après avoir patienter 5mn au maximum, vous devriez voir que la ligne alloué à CMDbuild a changé
de statut.
Suite à cette manipulation, vous pourriez devoir accéder à la fenêtre de connexion :
« http://votre.adresse.IP:8080/cmdbuild-2.3.4 »