Pages enfant
  • b) Installation rapide (esup 4)

Vous regardez une version antérieure (v. /wiki/pages/viewpage.action?pageId=257556525) de cette page.

afficher les différences afficher l'historique de la page

« Afficher la version précédente Vous regardez la version actuelle de cette page. (v. 42) afficher la version suivante »


  1. Vérifier les prérequis ;
  2. Récupérer les sources du portail ESUP à partir de GitHub :
    1. sous forme d'archive :
      1. Aller sur le repo Github du projet : https://github.com/EsupPortail/esup-uportal
      2. Switcher sur la version que vous souhaitez (tag ou branche) via le menu déroulant
      3. Télécharger l'archive Zip
    2. via Git directement :
      1. Exécuter la commande "git clone https://github.com/EsupPortail/esup-uportal.git" (afin de récupérer le projet)
      2. Exécuter la commande "git tag" (afin de consulter la liste des versions tagguées du projet)
      3. Copiez le nom de la version désirée (afin de ne pas récupérer la version en cours de développement)
      4. Exécuter la commande "git checkout <nom_version>" (afin de se placer sur la version désirée)
  3. Modifier le fichier "build.properties.sample"
    • Le renommer en "build.properties" ;
    • Modifier le paramètre "server.home" de build.properties : préciser le chemin utilisé pour la variable CATALINE_HOME. Attention : Linux et Windows, utiliser des slashs "/".
      (Bonne pratique respectée = se reporter à la section   |   Installation par défaut = utiliser /path/to/apache_tomcat_6.0.36/)
    • Modifier le paramètre "server.base" de build.properties : préciser le chemin utilisé pour la variable CATALINA_BASE. Attention : Linux et Windows, utiliser des slashs "/".
      (Bonne pratique respectée = se reporter à la section   |   Installation par défaut = utiliser ${server.home})
    • Modifier le paramètre "server.webapps" de build.properties : préciser le chemin du répertoire webapps de tomcat utilisé pour le déploiement des applications. Attention : Linux et Windows, utiliser des slashs "/".
      (Bonne pratique respectée = se reporter à la section   |   Installation par défaut = utiliser ${server.base}/webapps)
  4. Modifier le fichier "filters/esup.properties":
    1. modifier la section "Database Connection Settings" :
      1. Décommenter le connecteur JDBC désiré
      2. Renseigner les paramètres de connexion
    2. modifier la section "logs" :
      1. Renseigner la propriété "environment.build.log.logfileDirectory" avec un chemin valide.
  5. Modifier le fichier "pom.xml" et décommenter le bon connecteur SQL :

    pom.xml
        <properties>
            <!-- The final name of the uPortal web-application -->
            <uportal.docbase>uPortal</uportal.docbase>
            <project-site-path>/uportal/${project.version}</project-site-path>
            
            <!-- The JDBC Driver used by uPortal -->
            
            <!-- HSQL driver. Uncomment if you need to -->
            <!--
            <jdbc.groupId>org.hsqldb</jdbc.groupId>
            <jdbc.artifactId>hsqldb</jdbc.artifactId>
            <jdbc.version>${hsqldb.version}</jdbc.version>
            -->
        
            <!-- POSTGRESQL driver. Uncomment if you need to -->
            <!--
            <jdbc.groupId>postgresql</jdbc.groupId>
            <jdbc.artifactId>postgresql</jdbc.artifactId>
            <jdbc.version>9.0-801.jdbc4</jdbc.version>      
            -->
            <!-- MYSQL driver. Uncomment if you need to -->
            <!--
            <jdbc.groupId>mysql</jdbc.groupId>
            <jdbc.artifactId>mysql-connector-java</jdbc.artifactId>
            <jdbc.version>5.1.22</jdbc.version>      
            -->
  6. Lancer votre serveur de base de données. Pour cela, exécuter une des commandes ci-dessous, en la laissant en tâche de fond afin de laisser le serveur de base de données actif :
    • [MySQL] "mysqld.exe" / "mysqlsafe" (selon le système d'exploitation)
    • [PostgreSQL] "postgres.exe" / "postgres" (selon le système d'exploitation)
    • [HSQL] "ant hsql" (à la racine du projet)
    • ...
  7. Exécuter la commande "ant -Dmaven.test.skip=true clean initportal" (effectue le déploiement initial) ou "ant -Dmaven.test.skip=true clean deploy-ear" (effectue les autres déploiements)
  8. Exécuter la commande "startup.bat" / "startup.sh" de tomcat selon le système d'exploitation (démarre le serveur applicatif)
  9. Se connecter à http://localhost:8080/uPortal

 

Git

L'utilisation de Git est documentée par ailleurs sur le wiki : 06 - Git (esup 4)

  • Aucune étiquette