01 - Description technique (esup 4)

initportal

Exécute toutes les tâches nécessaires au déploiement du portail et prépare la base de données du portail :

1. Fait appel à la tâche "deploy-ear"
2. Fait appel à la tâche "initdb"

initdb

Supprime toutes les tables et prépare la base de données du portail :

1. Fait appel à la tâche "db"
2. Fait appel à la tâche "db-hibernate"

3. Fait appel à la tâche "db-import"

db-update

Met à jour une base de données existante pour passer à la version supérieure :

1. Fait appel à la tâche "db-hibernate-update"

db

Charge certaines tables et données :

1. Charge le fichier des tables "/properties/db/tables.xml"
2. Charge le fichier des données "/properties/db/data.xml"
3. À l'aide des deux fichiers précédemment chargés, créé un script de création de tables en faisant appel à la méthode "db" de la classe "portalShellBuildHelper" du package
4. Fait appel à la tâche "up-shell" avec comme paramètre le script précédemment créé

Supprime et créé les tables gérées par Hibernate :

1. Fait appel à la tâche "db-hibernate-portal"
2. Fait appel à la tâche "db-hibernate-raw-events"
3. Fait appel à la tâche "db-hibernate-aggr-events"

Effectue les modifications de la base de données (dans le cas des montées de version du portail) pour le portail et les schémas d'évènements :

1. Fait appel à la tâche "db-hibernate-portal-update"
2. Fait appel à la tâche "db-hibernate-raw-events-update"
3. Fait appel à la tâche "db-hibernate-aggr-events-update"

Supprime et créé les tables gérées par Hibernate pour le portail :

1. Créé un script de suppression de tables en faisant appel à la méthode "hibernateDrop" de la classe "portalShellBuildHelper" du package
2. Complète le script avec la création de tables en faisant appel à la méthode "hibernateCreate" de la classe "portalShellBuildHelper" du package
3. Fait appel à la tâche "up-shell" avec comme paramètre le script précédemment créé

Supprime et créé les tables gérées par Hibernate  pour le stockage des évènements bruts du portail :

1. Fait appel à la tâche "db-hibernate-portal" avec comme paramètre "databaseQualifier" la valeur "RawEventsDb"

Supprime et créé les tables gérées par Hibernate  pour le stockage des évènements élaborés du portail :

1. Fait appel à la tâche "db-hibernate-portal" avec comme paramètre "databaseQualifier" la valeur "AggrEventsDb"

Effectue les changements demandés (sur la base de données du portail - lors des montées de version) pour le schéma du portail :

1. Créé un script de modification de base en faisant appel à la méthode "hibernateUpdate" de la classe "portalShellBuildHelper" du package
2. Fait appel à la tâche "up-shell" avec comme paramètre le script précédemment créé

Effectue les modifications de la base de données (dans le cas des montées de version du portail) pour le stockage des évènements bruts du portail :

1. Fait appel à la tâche "db-hibernate-portal-update" avec comme paramètre "databaseQualifier" la valeur "RawEventsDb"

Effectue les modifications de la base de données (dans le cas des montées de version du portail) pour le stockage des évènements élaborés du portail :

1. Fait appel à la tâche "db-hibernate-portal-update" avec comme paramètre "databaseQualifier" la valeur "AggrEventsDb"

db-import

Importe le contenu de fichier XML par défaut dans la base de données :

1. Fait appel à la tâche "db-import-required"
2. Si la variable "noDefaultData" n'est pas valuée, fait appel à la tâche "db-import-default"
3. Si la variable "noQuickstartData" n'est pas valuée, fait appel à la tâche "db-import-quickstart"

Importe en base de données les fichiers requis :

1. Fait appel à la tâche "data-import" avec comme répertoire des données le répertoire "uportal-war/src/main/data/required_entities"

Importe en base de données les fichiers par défaut :

1. Fait appel à la tâche "data-import" avec comme répertoire des données le répertoire "uportal-war/src/main/data/default_entities"

Importe en base de données les fichiers de "démarrage rapide" :

1. Fait appel à la tâche "data-import" avec comme répertoire des données le répertoire "uportal-war/src/main/data/quickstart_entities"

deployPortletApp

Déploie la portlet dont le .war est précisé en paramètre :

1. Assemble la portlet à l'aide de la tâche "AssembleTask" de pluto
2. Fait appel à la tâche "fastWarDeploy" avec comme paramètre la portlet

deploy-ear

Déploie le portail, les librairies et les portlets dans le conteneur de servlet :

1. Si demandé (cleanShared à true), fait appel à la tâche "clean-shared"
2. Ajoute "uportal-ant-tasks/pom.xml" à la liste des dépendances maven
3. Créé le répertoire "shared/lib" à la racine de tomcat
4. Déploie l'ear dans tomcat (à l'aide de la tâche précédemment chargée dans uportal-ant-tasks)

Supprime le contenu du répertoire "shared/lib" de tomcat (supprime les librairies partagées) :

1. Purge le répertoire concerné

deploy-war

Déploie la webapp uPortal dans le conteneur de servlet :

1. Fait appel à la tâche "fastWarDeploy" avec comme paramètre le war de uPortal

fastWarDeploy

Déploie le .war en paramètre dans le conteneur de servlet :

1. Si spécifié (removeExisting à true), supprime le .war existant
2. Copie le .war dans le conteneur de servlet (extractWars à false) ou extrait le .war à côté des autres webapp (extractWars à true).

Note : Techniquement le traitement est différent sous Windows et sous Centos.

data-export

Exporte des données vers un fichier XML :

1. Créé un script de sélection de données en faisant appel à la méthode "dataExport" de la classe "portalShellBuildHelper" du package
2. Fait appel à la tâche "up-shell" avec comme paramètre le script précédemment créé

data-import

Importe en base de données le ou les fichier(s) XML en paramètre :

1. Créé un script d'insertion en base en faisant appel à la méthode "dataImport" de la classe "portalShellBuildHelper" du package
2. Fait appel à la tâche "up-shell" avec comme paramètre le script précédemment créé

data-delete

Supprime les données spécifiées (Type et Id en paramètre) :

1. Créé un script de suppression de la base en faisant appel à la méthode "dataDelete" de la classe "portalShellBuildHelper" du package
2. Fait appel à la tâche "up-shell" avec comme paramètre le script précédemment créé

Exécute le script en paramètre :

1. Exécute la classe "PortalShell" et donne le script en paramètre (délègue l'exécution du script)

db / db-hibernate-portal

db-hibernate-portal-update

data-export / data-import

data-delete

deploy-ear