Installing and Deploying Process Composer

Follow the instructions below to install and deploy all of the simulation process web apps: Process Composer, Performance Study, Simulation Companion, and Results Analytics.

This page discusses:

The installer places files on the collaboration server machine, and the ENOVIA WAR utility creates a Java web archive (.war) file or enterprise archive (.ear) file that is a packaged version of the application. You then use the .war or .ear file to deploy and run Process Composer on your Java EE application server.

Previous releases of Process Composer are upgraded to the current release by the installer.

Start the Installer

You can download a zip distribution file containing the Process Composer installer.

There are four different executable files that can be run for the installer:

  • setup.exe for the interactive (GUI) installer on Windows
  • StartTUI.exe for the text-based, command-line installer on Windows
  • StartGUI.sh for the interactive (GUI) installer on Linux
  • StartTUI.sh for the text-based, command-line installer on Linux

Run the desired installer executable on the collaboration server machine. The complete DVD installer media must be available.

For complete information about installer options, see the DS Installer Guide.

Warning: Do not manually modify the database schema of Process Composer. Deleting anything from the schema may cause the Process Composer installer to fail during an upgrade.

Installer Prompts

When the installer runs, you will be prompted for the following items:

  • The path to the ENOVIA 3DSpace Service installation directory (collaboration_server_dir).
  • A user name and password of a person that exists in the 3DEXPERIENCE platform (ENOVIA 3DSpace Service). You must enter the name and password of a user that has both Business and System Administrator privileges, such as creator. If the user has no password, leave the password field blank. The default user account is creator.

Notes:

  • The Process Composer, Performance Study, Simulation Companion, and Results Analytics apps are installed together into the following directory (pc_dir):

    collaboration_server_dir/Apps/SimProcessIntelligence/R2020x/

  • In a new installation, the installer creates a default administrator account (person) with the user name SLMInstallerAdmin and default password SLMInstallerAdmin. For more information, see About the Installation Administrator User Account.
  • The default workspaces, connectors, and templates for Process Composer are installed in the default database vault eService Production.

Warning:

Process Composer and the other simulation web apps must always be installed into the existing ENOVIA 3DSpace Service, which has a default Windows installation directory of:

C:\enoviaV6R2015x\server\

Due to restrictions in Windows, the path to the installation directory is limited in length. If you change the default path for ENOVIA 3DSpace Service, be sure to keep the path length to a minimum to avoid problems in the Process Composer installation. If the Process Composer installer fails because the path is too long, the installer will display an error message. If this happens, you must adjust theENOVIA 3DSpace Service installation to shorten the path and then rerun the Process Composer installer. Note that this restriction only exists on Windows, not Linux.

Upgrading from a Previous Release

If you are upgrading Process Composer from a previous release, you may need to set two environment variables before starting the installer. The installer will read the variables and upgrade your installation to the current release.

Before starting the installer on Windows, you must open the Command Prompt window with the right-click option Run as administrator. The installer requires these elevated permissions in order to perform the upgrade.

  • If you previously installed the default workspaces, connectors, and templates into any database vault other than eServiceProduction, you must set an environment variable named SCE_INSTALLATION_VAULT to specify the vault for the current upgrade. For example, if you used a custom vault named MySpecialVault, set the variable as follows before starting the installer:

    set SCE_INSTALLATION_VAULT=MySpecialVault
    This environment variable can also be used in a new installation to pick a vault other than the eServiceProduction default.

  • If you have changed the password of the default administrator account SLMInstallerAdmin, set an environment variable named SCE_ADMIN_USER_PASSWORD to this password. For example:

    set SCE_ADMIN_USER_PASSWORD=SpecialSecurePswd

Silent Installer

You can use the silent installer to install Process Composer with no GUI or prompts. This allows an unattended installation with no user interaction required.

For details, see "Install the Software in Silent Mode" under "Launching the 3DEXPERIENCE App Installation" in the DS Installer Guide.

Run the WAR Utility

After installing Process Composer, you must run the WAR utility to package a web application that can be deployed on the Java application server in a single .war or .ear file.

The WAR utility packages the directories and files located under the staging directory (collaboration_server_dir/STAGING/).

For details about running the WAR utility, see "Building the J2EE Archive File" under "Deploying Web Apps" in the 3DSpace Installation Guide.

Deploy and Start the Application on the Application Server

Use the archive file generated by the ENOVIA WAR utility to deploy the application on an application server.

Follow the instructions for your application server in "Deploying the J2EE Archive File" under "Deploying Web Apps" in the 3DSpace Installation Guide.

Start Process Composer within the applicatioon server.