| Info |
|---|
Sont donnés ici les différents pré-requis techniques à mettre en place avant l'installation du page de l'ENT EsupPortail. Plus qu'un listing classique on donne également un certain nombre de recommandations ; en résumé les voici :
|
...
Ces lignes bash peuvent être ajoutées à un script env-esup.sh dans lequel vous mettrez toutes les autres lignes permettant d'obetnir obtenir un environnement propre au lancement de votre ENT EsupPortail (JAVA_HOME, JAVA_OPTS avec la mémoire allouée, PATH, MAVEN_HOME, etc.).
...
| Info | ||
|---|---|---|
| ||
A noter que JDK7 n' est supporté qu'à partir de dès la version v.4.0.8 d'uPortal (cf JIRA issue) |
...
| Bloc de code | ||
|---|---|---|
| ||
?> java -version #Pour vérifier le bon fonctionnement de Java (dans un "terminal") java version "1.67.xx" #Installation OK |
>> Bonnes pratiques (Linux)
Pour faciliter les montées de version du JdkJDK, vous pouvez utiliser un lien symbolique (par ex. : "ln -s jdk1.6.0_43 jdk") qui vous permettra de toujours conserver le même chemin dans le JAVA_HOME :
| Bloc de code | ||
|---|---|---|
| ||
/usr
/local
/jdk1.67.0_4379 #chemin réel vers le dossier d'installation du jdk
/jdk -> jdk1.67.0_4379 #à utiliser pour le JAVA_HOME -> JAVA_HOME=/some/path/to/jdk |
Cette pratique (tout comme l'idée du script env-esup.sh) est à généraliser (et adapter) également aux autres utilitaires ANT et MAVEN présentés ci-dessous.
...
La version de Tomcat préconisée est la 67.0.xx (dernière version stable en 7.0 : actuellement 7.0.3659)
Il est conseillé de ne pas passer par le gestionnaire de packages (yum, apt-get) afin de bien maitriser son installation et donc de télécharger le logiciel sur le site de l'éditeur.
Un exemple de configuration est présent en pièce jointe, ainsi qu'un script d'installation (plus bas).
Des détails supplémentaires sont disponibles dans la page Tomcat (esup 4)
La variable CATALINA_HOME peut être valuée, et le chemin"$CATALINA_HOME/bin" (Linux) ou "%CATALINA_HOME%\bin" (Windows) rajouté au PATH :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
...
export CATALINA_HOME=<cheminVersHomeTomcat>
export PATH=$PATH:$CATALINA_HOME/bin
... |
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
SET CATALINA_HOME=<cheminVersHomeTomcat>
SET PATH=%PATH%;%CATALINA_HOME%\bin |
>> Bonnes pratiques (Installation de Tomcat)
Au prix de quelques configurations Tomcat, il peut être intéressant de séparer "CATALINA_BASE" (conf) et "CATALINA_HOME" (install Tomcat, binaires,...) pour faciliter les montées de version.
Cela peut se faire notamment via cet exemple de scripts :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
...
export CATALINA_HOME=/usr/local/tomcatexport
export CATALINA_BASE=/opt/tomcat
export CATALINA_TMPDIR=$CATALINA_BASE/temp
export CATALINA_OPTS="-Djavax.net.ssl.trustStore=/path/to/esup.keystore"
export CATALINA_PID=/opt/tomcat/uportal.pid
... |
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
./home/ENT/env.sh
HOME=$CATALINA_HOME/..
BASE=$CATALINA_BASE/..
cd $HOME
wget http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.36/bin/apache-tomcat-6.0.36.tar.gz
tar -xzf apache-tomcat-6.0.36.tar.gz
ln -s apache-tomcat-6.0.36 tomcat
mkdir $CATALINA_BASE
cp -r $CATALINA_HOME/conf $CATALINA_BASE
mkdir $CATALINA_BASE/logs
mkdir $CATALINA_BASE/temp
mkdir $CATALINA_BASE/work
mkdir -p $CATALINA_BASE/shared/lib
mkdir -p $CATALINA_BASE/shared/classes
mkdir -p $CATALINA_BASE/lib
mkdir $CATALINA_BASE/common
ln -s $CATALINA_HOME/lib/ $CATALINA_BASE/common/lib
cp $CATALINA_HOME/conf/server.xml $CATALINA_BASE/conf/
cp $CATALINA_HOME/conf/catalina.properties $CATALINA_BASE/conf/
cp $CATALINA_HOME/conf/logging.properties $CATALINA_BASE/conf/
mkdir $BASE/webapps
|
Les applications sont à déployer dans $BASE/webapps. Adapter les fichiers $CATALINA_BASE/conf/server.xml, $CATALINA_BASE/conf/catalina.properties et $CATALINA_BASE/conf/logging.properties
Par rapport à l'exemple d'installation dans le fichier $CATALINA_BASE/conf/server.xml bien spécifier le bon path des contextes d'application comme ceci :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
...
<Context path="/portail" docBase="/opt/webapps/uPortal" reloadable="false" ...>
<Resource name="jdbc/PortalDb" auth="Container" type="javax.sql.DataSource"
username="USER" password="PASSWORD"
driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://database.ip:3306/uPortal4"
maxActive="100" maxIdle="30" maxWait="10000"
poolPreparedStatements="true"
removeAbandoned="true"
removeAbandonedTimeout="300"
validationQuery="SELECT 1"
logAbandoned="true"
/>
...
</Context>
...
|
Lors d'une migration de Tomcat, il suffira de:
- faire un arrêt du Tomcat,
- faire pointer le lien symbolique /usr/local/tomcat vers la nouvelle version des sources tomcat
- puis relancer.
!! Attention toutefois lors d'un changement de version majeure !!
On peut ici se contenter d'installer (c'est à dire décompresser l'archive récupéré sur le site officiel de Tomcat) simplement le Tomcat dans le répertoire /opt (par exemple).
Pour faciliter les mises à jour (notamment vis à vis des configurations du package EsupPortail, mais aussi plus tard des portlets), on utilisera comme pour le jdk, ant et maven un lien symbolique de ce type :
/opt/tomcat-esup -> /opt/apache-tomcat-7.0.59
Apache
La version d'Apache préconisée est la 2.2 ou plus exactement celle disponible depuis votre gestionnaire de paquest simplementpaquets simplement (2.4 sous Debian Jessie à présent par exemple).
Technologie non liée à Java, il est conseillé de simplement passer par le gestionnaire de paquets (yum, apt-get) pour installer Apache et ses modules associées (mod_ajp, mod_balancer, etc.).
...