Overview of Web App Deployment

After you have installed and configured the 3DSpace Service and all ENOVIA J2EE (Web) apps you will use, you then use the WAR utility to deploy the apps.

The WAR Utility builds Web apps and makes them available in a given installation directory.

This page discusses:

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

The 3DSpace Service is generally deployed with the WAR file, using the app server’s administrative tools to complete the configuration. However, since the EAR file contains all information needed for deployment (including the Web app name and context root), system administrators of an 3DSpace Service 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 app; for example, /ematrix.

More About J2EE

Directory Structure

When you install 3DSpace Service, the following directory structure is created:

3DSpace Service installation directory
   ¦-- distrib\
   ¦
   ¦-- PLATFORM\code\command\
   ¦
   ¦-- PLATFORM\resources\warutil\fragment\
   ¦
   ¦-- STAGING\

The 3DSpace Service 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 3DSpace Service. 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 3DSpace Service and added to with each installed ENOVIA app, this directory contains the files necessary to run ENOVIA apps. These become part of the EAR and/or WAR files when the WAR Utility is run.