Add a new task: upgrade.

It gathers all the task to perform the upgrade of Silverpeas to a new
version.

Author: mmoqui

src/main/groovy/org/silverpeas/setup/SilverpeasSetupPlugin.groovy

@@ -124,6 +124,20 @@ class SilverpeasSetupPlugin implements Plugin<Project> {
       jboss = jBossServer.useLogger(log)
     }
 
+    project.tasks.register(UPGRADE.name, SilverpeasInstallationTask) {
+      description = "Upgrade Silverpeas in JBoss/Wildfly to version ${project.version}"
+      dependsOn project.tasks.named('clean'), migration
+
+      installation = extension.installation
+      settings = extension.settings
+      jboss = jBossServer.useLogger(log)
+
+      doFirst {
+        FileLogger log = FileLogger.getLogger(UPGRADE.name)
+        log.info("Upgrade of Silverpeas to version ${project.version}")
+      }
+    }
+
     initializePredefinedTasks(project, extension)
   }
 
@@ -138,7 +152,7 @@ class SilverpeasSetupPlugin implements Plugin<Project> {
     try {
       TaskProvider<Task> assemble = project.tasks.named(ASSEMBLE.name)
       assemble.configure {
-        description = 'Assemble all the software bundles that made Silverpeas'
+        description = 'Assemble all the software bundles making up Silverpeas'
         onlyIf {
           !extension.installation.distDir.get().exists() &&
                   !extension.installation.dsDriversDir.get().exists()

src/main/groovy/org/silverpeas/setup/api/SilverpeasSetupTaskNames.groovy

@@ -28,15 +28,42 @@ package org.silverpeas.setup.api
  * @author mmoquillon
  */
 enum SilverpeasSetupTaskNames {
-
+  /**
+   * Extracts all the software bundles making up Silverpeas and assembles their content into a single location
+   */
   ASSEMBLE('assemble'),
+  /**
+   * Builds the Silverpeas Web application by generating the JEE required descriptors (web.xml, persistence.xml, ...)
+   */
   BUILD('build'),
+  /**
+   * Assembles from different software bundles and builds the Silverpeas Web application.
+   */
   CONSTRUCT('construct'),
+  /**
+   * Configures the JBoss/Wildfly JEE server for running Silverpeas.
+   */
   CONFIGURE_JBOSS('configure_jboss'),
+  /**
+   * Configure Silverpeas.
+   */
   CONFIGURE_SILVERPEAS('configure_silverpeas'),
+  /**
+   * Configure both JBoss/Wildfly and Silverpeas.
+   */
   CONFIGURE('configure'),
+  /**
+   * Migrates the data source structure from the current version to the latest one.
+   */
   MIGRATE('migrate'),
-  INSTALL('install')
+  /**
+   * Installs Silverpeas into JBoss/Wildfly
+   */
+  INSTALL('install'),
+  /**
+   * Upgrade Silverpeas from the current version to the one specified in its installation descriptor.
+   */
+  UPGRADE('upgrade')
 
   final String name
 

src/main/groovy/org/silverpeas/setup/installation/SilverpeasInstallationTask.groovy

@@ -50,7 +50,7 @@ class SilverpeasInstallationTask extends DefaultTask {
   final FileLogger log = FileLogger.getLogger(this.name)
 
   SilverpeasInstallationTask() {
-    description = 'Installs Silverpeas into JBoss/Wildfly'
+    description = "Installs Silverpeas ${project.version} into JBoss/Wildfly"
     group = 'Build'
   }