BDA Template Scripts - Install.xml

Ant Target Flow

Target Names in bold are targets users may call. Targets name not in bold are generally supporting targets and users will probably never call them

If a target has no documentation then it was probably documented on some line above your current line.

install.xml

Install target

This is the default target of the installer distribution. It installs all containers. It calls the wrapper targets for container installs.

• install - Install all components on all boxes (Run on developer desktops/ci)
  • install:validation:pre-install - run pre-install checks
  • install:jboss:stop - Stop JBoss
  • install:tomcat:stop - Stop Tomcat
  • install:validation:pre-install:ports - Validate desired ports are not in use
  • install:clean - Clean up destination directory
  • install:init - Make directories and file prep
  • install:database - Database install wrapper target
  • install:jboss
  • install:tomcat
  • install:validation:post-install

Install Database targets

Recreates a database from baseline scripts and runs any incremental updates.

• install:database - Creates database (if mysql), runs baseline scripts, runs incremental scripts. Supports Oracle, MySQL or PostgreSQL based on database.type property. (Generally runs on JBoss server)
  • install:database:prep - Copies over database files with filtering
  • install:clean
  • install:init

Install Tomcat targets

Install/configure Tomcat, and install/configure a webapp into Tomcat and start/stop Tomcat.

• install:tomcat - Installs Tomcat, configures Tomcat, installs/configures the webapp.
  • install:validation:pre-install
  • install::tomcat:stop
  • install:validation:pre-install:ports
  • install:clean
  • install:init
  • install:tomcat:binaries - Installs tomcat binaries
  • install:tomcat:configure - Configures Tomcat (ports)
  • install:tomcat:grid- Installs webapp (our sample is the grid)
  • install:tomcat:grid:configure - Configures webapp (our sample is the grid)
  • install:tomcat:start

Install JBoss targets

Install/configure JBoss, and install/configure a webapp into JBoss and start/stop JBoss.

• install:jboss - Installs and configures jboss binaries, installs and configures webapp (*.ear, *.war)
  • install:validation:pre-install
  • install:jboss:stop
  • install:validation:pre-install:ports
  • install:clean
  • install:init
  • install:jboss:binaries - Installs jboss binaries
  • install:jboss:generic-webapp:re-configure - Extracts ears, wars and jars that need runtime attributes changed (like hibernate configuration)
  • install:jboss:generic-webapp - installs web-application and required lib files
  • install:jboss:generic-webapp:configure - Copies/manipulates configuration files (generic-webapp-ds.xml, properties-service.xml, ect)
  • install:jboss:configure - Configures JBOSS Binaries
    • -install:jboss:configure:ports - configures ports for jboss using bindings manager
    • -install:jboss:configure:login-conf - Adds login-conf.xml settings either ldap or database
    • -install:jboss:configure:jbossmq-dest - Adds jbossmq-destinations.xml content
    • -install:jboss:configure:log4j - Adds custom log4j settings
    • -install:jboss:remove:jfs - removes required files for jsf
    • -install:jboss:configure:update-shutdown - Updates port in $JBOSS_HOME/bin/shutdown.jar so shutdown works without adding command line options
  • install:jboss:grid - Installs grid (globus libs, globus default war, custom grid war)
  • install:jboss:grid:configure - Configures grid (changes * hostname/port references, changes api url, changes index service url)
  • install:jboss:start

Upgrade Targets

Install/configure webapps into existing containers not changing anything about the existing container and also run incremental databases updates.

• upgrade - Upgrades all components on one server. Installs and configures applications only not binaries. (Runs on Dev wrokstation CI)
  • install:jboss:stop
  • install:tomcat:stop
  • install:validation:pre-install
  • install:init
  • upgrade:init - reads database connection properties from deployed jboss, these should not be provided in properties files
  • upgrade:database - Call wrapper db upgrade target.
  • upgrade:jboss - Calls wrapper jboss upgrade target.
  • install:validation:post-install

Upgrade Database targets

Runs incremental database updates.

• upgrade:database - Runs incremental database update scripts. Supports Oracle, MySQL or PostgreSQL based on database.type property. (Generally runs on JBoss server)
  • install:init
  • upgrade:init - reads database properties from existing JBoss *-ds.xml file.

Upgrade JBoss targets

Install/configure JBoss, and install/configure a webapp into JBoss and start/stop JBoss.

• upgrade:jboss Upgrades applications in jboss. (Runs on JBoss server)
  • install:validation:pre-install
  • install:jboss:stop
  • install:init
  • upgrade:init
  • install:jboss:generic-webapp:re-configure
  • install:jboss:generic-webapp
  • install:jboss:generic-webapp:configure
  • install:jboss:grid
  • install:jboss:grid:configure
  • install:jboss:start

Install Tomcat targets

Install/configure Tomcat, and install/configure a webapp into Tomcat and start/stop Tomcat.

• upgrade:tomcat Upgrades tomcat application.
  • install:validation:pre-install
  • install:tomcat:stop
  • install:init
  • upgrade:init
  • install:tomcat:generic-webapp
  • install:tomcat:generic-webapp:configure
  • install:tomcat:start

Database Targets

• upgrade:database:tag - Tag the database to a version for future rollbacks
• upgrade:database:rollback - Rollback the database to a previous tag based on property database.rollback.version.