This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
wiki:epims4_1m1:developer:epimsdistrib [2009/09/18 11:04] 132.168.73.247 créée |
wiki:epims4_1m1:developer:epimsdistrib [2010/07/13 07:49] (current) 132.168.73.247 |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Distribution of ePims ====== | + | ====== Création d'une distribution d'ePims ====== |
+ | Les distributions d'ePims sont faites à partir de l'IDE Eclipse. | ||
- | Distribution of ePims is done from eclipse IDE. All ePims modules / projects should be present in workspace. To create a new ePims version, verify that all projects have a release version and are tagged on SVN. | + | ===== informations importantes avant d'effectuer une distribution ===== |
- | To be sure no specific environnement variables are set or no on-going developpment is in project, it is **strongly recommanded** to create a specific workspace for distribution creation. | + | * Tout les modules d'ePims doivent être présent dans le //workspace//. |
+ | * Vérifier la configuration d'ivy. Notamment que vous avez un fichier ivyconf.properties dans le //user home// de votre système d'exploitation. Ce fichier doit contenir les variables : | ||
+ | * //ivy.local.repository.path// : donne la racine du dossier contenant les librairies à importer et exporter (exemple : eP-CoL, eP-Plate). Essentiel pour les //target ivy// de //ant// : "resolve" et "publish") | ||
+ | * //ivy.distrib.dir// : donne la racine du dossier contenant les fichiers finaux de distribution (essentiel pour les //target ant// "publish.install"). Vous pouvez redéfinir en dur cette variable en changeant la //property// "install.dir" dans tout les fichiers build.xml. De base cette //property// est de la forme //${ivy.distrib.dir}/${organisation}/Install_ePims/${epims.version}//. | ||
+ | * Vérifiez que tout les modules présent sont les "copies" de **versions //release// et taggées dans SVN!** | ||
+ | * => Il est fortement recommandé de partir d'un //workspace// vide pour éviter d'inclure dans une distribution des développements en cours | ||
+ | * Vérifiez qu'aucune variable d'environnement n'est positionnée | ||
+ | * => Il est fortement recommandé de partir d'un //workspace// vide pour éviter d'avoir des variables d'environnements spécifiques à votre poste inclues dans la distribution | ||
+ | * Penser à faire un //refresh// des projets dans Eclipse après chaque //target// ant. En effet l'IDE ne le fait pas automatiquement et cela peut faire manquer des erreurs de //classpath// par exemple. | ||
- | ===== Standalone Modules ====== | + | ===== Liste des actions à effectuer pour créer un distribution ===== |
+ | - **eP-CoL** : Lancez la //target ant// "publish". | ||
+ | - **eP-Plate** : Lancez les //targets ant// "resolve" puis "publish". | ||
+ | - **eP-WebServices** : Lancez les //targets ant// "resolve" puis "dist". | ||
+ | - **eP-Web** : Lancez les //targets ant// "resolve" depuis build-ivy.xml puis "publish.install" depuis build.xml . | ||
+ | - **eP-Core** : Lancez les //targets ant// "resolve" puis "publish.install". | ||
+ | - **eP-Back** : Lancez les //targets ant// "resolve" puis "publish.install". | ||
+ | - **eP-TAF** : Lancez les //targets ant// "resolve" puis "publish_install". | ||
+ | - **eP-Admin** et **eP-POLE**: | ||
+ | - Allez dans le menu "Project"->"Clean". Sélectionner ces deux projets et faites "Ok". Les projets vont être nettoyer et reconstruit automatiquement. | ||
+ | - A la fin de cette reconstruction : | ||
+ | * Lancez les //target ant// "resolve" puis "set.version". | ||
+ | * Cliquez-droit sur la racine du projet **eP-Admin** et faites "Export"->"War file". | ||
+ | * Dans la partie //Web-module// mettez "eP-Admin", | ||
+ | * Dans la partie //Destination// mettez [Dossier du workspace]\[dossier eP-Admin]\eP-Admin.war (par exemple //D:\Workspaces\ePims\eP-Admin\eP-Admin.war//) | ||
+ | - Faire les mêmes manipulations pour **eP-POLE** : | ||
+ | * Lancez les //target ant// "resolve" puis "set.version". | ||
+ | * Cliquez-droit sur la racine du projet **eP-POLE** et faites "Export"->"War file". | ||
+ | * Dans la partie //Web-module// mettez "eP-POLE", | ||
+ | * Dans la partie //Destination// mettez [Dossier du workspace]\[dossier eP-POLE]\eP-POLE.war (par exemple //D:\Workspaces\ePims\eP-POLE\eP-POLE.war//) | ||
+ | - **eP-EAR** : Lancez la //target ant// "publish.install". | ||
- | **eP-Plate** is embedded in eP-Web, so just verfiy version in eP-Web is correct. | + | Vous avez alors dans le dossier défini dans la //property// "install.dir" (exemple : //Y:\cea\Install_ePims\4.1M1//) la distribution complète permettant l'installation d'ePims. |
- | **eP-Col** is used in almost all others modules, so just verfiy version are coherent. | + | |
- | + | ||
- | Run ant ''dist'', and more **recommanded** ''publish-install'' to create a folder with all needed distribution files. If you don't have a ivy repository, redefine install.dir properties in build.xml file. Do this for | + | |
- | * eP-Core | + | |
- | * eP-Back | + | |
- | * eP-TAF | + | |
- | + | ||
- | + | ||
- | ====== EAR Modules====== | + | |
- | + | ||
- | For GWT Projects (eP-Admin & eP-Pole): | + | |
- | * clean project (from project menu) in order to compile Java to javascript | + | |
- | * Export to war file at the project ''basedir'' | + | |
- | * see ReadMe file for more specific operations | + | |
- | + | ||
- | For other projects, run publish.install ant target | + | |
- | + | ||
- | and finally run eP-EAR publish.install target ! | + | |
- | + | ||
- | ====== Installation folder content ====== | + | |
- | + | ||
- | The distribution folder content (specified by install.dir in build.xml) contains all modules and configuration files in a well structured manner. See [[..:admin:epimsstructure#contenu_de_la_distribution]] for more details | + | |