Overview

After you have installed and configured the ENOVIA Live Collaboration Server and all ENOVIA J2EE (web) applications you will use, you then need to deploy the applications. The WAR Utility builds web applications and makes them available in a given installation directory.

You deploy a web application by completing steps 4 through 6 of the General Installation for ENOVIA Live Collaboration Server procedure, and then:

  1. Modifying J2EE Settings
  2. Building the J2EE Archive File
  3. Deploying the J2EE Archive File

ENOVIA Live Collaboration Server installs descriptor files that are used to configure the ENOVIA web application. You can make modifications to these files based on your requirements. Also installed is the WAR Utility, which enables packaging ENOVIA web applications for use in an application server. The WAR Utility creates an EAR (Enterprise Archive) file or a WAR (Web Archive) file, based on the configured descriptor files. The application server then deploys the J2EE archive file.

The ENOVIA Live Collaboration Server is generally deployed with the WAR file, using the application server’s administrative tools to complete the configuration. However, since the EAR file contains all information needed for deployment (including the web application name and context root), system administrators of an ENOVIA Live Collaboration Server may deploy the EAR file instead, so that the context root is already configured. The context root is the relative path to the server root for a particular web application; for example, /ematrix.

Directory Structure

When you install ENOVIA Live Collaboration Server, the following directory structure is created:

ENOVIA Live Collaboration Server installation directory
   ¦-- distrib\
   ¦
   ¦-- PLATFORM\code\command\
   ¦
   ¦-- PLATFORM\resources\warutil\fragment\
   ¦
   ¦-- STAGING\

The ENOVIA Live Collaboration Server installation directory (SERVER_INSTALL on Windows or SERVERHOME on UNIX/Linux) uses the path you assigned during the installation. It has the following subdirectories (as well as several others):

  • distrib—Built when you run the WAR Utility, this directory contains the generated EAR and/or WAR files, as well as the expanded contents of those files.
  • PLATFORM\code\command—Built when you install the ENOVIA Live Collaboration Server. This directory contains the WAR utility (war_setup.bat or war_setup.sh). The previous ematrixwarutil directory will eventually be removed. In V6R2012 it is still present, with an intermediate version of the WAR Utility that redirects to the new location.
  • PLATFORM\resources\warutil\fragment—Contains the web.xml.part files, which you can use to adjust your J2EE settings.
  • STAGING—Built when you install the ENOVIA Live Collaboration Server and added to with each installed ENOVIA application, this directory contains the files necessary to run ENOVIA applications. These become part of the EAR and/or WAR files when the WAR Utility is run.