Software Prerequisites

The 3DOrchestrate Distribution Server requires a Java EE application server and a database. The application server software is provided in the 3DOrchestrate Distribution Server installer.

This page discusses:

See Also
3DOrchestrate Installation and Administration

Because it is a Java enterprise application, the 3DOrchestrate Distribution Server has two prerequisites:

  • The Apache TomEE+ application server. You do not need to have TomEE+ pre-installed; the 3DOrchestrate Distribution Server installer includes TomEE+ and will install, configure, and deploy the application within TomEE+.
  • A database. The database can be installed on the same machine or on another server on your network. Three databases are supported:
    • Oracle
    • Microsoft SQL Server
    • Derby (not a prerequisite—this database is included with 3DOrchestrate and can be used instead of Oracle or SQL Server if desired)

The 3DOrchestrate Distribution Server can be run on 64-bit Windows or 64-bit Linux platforms. See the Program Directory for specific version numbers of the prerequisite software, including operating systems and databases. The Program Directory is additional documentation, similar to release notes, delivered on the Dassault Systèmes software CD/DVD and documentation CD/DVD (if any). The Program Directory information can also be accessed online through http://www.3ds.com/support.

Because 3DOrchestrate is part of the 3DEXPERIENCE platform, your on-premise network should already have the following items installed:

  • DS License Server (DSLS) with all appropriate licenses enrolled
  • 3DSpace Service, including the Main Collaboration Server (MCS) and File Collaboration Server (FCS)
  • 3DPassport service for user account management and authentication
  • 3DEXPERIENCE platform simulation process client apps such as Process Composer, Performance Study, and Results Analytics. These apps may be 1) native (C++ wintop) rich clients that are installed on individual users' computers, or 2) browser-based web apps that are installed into the 3DSpace Service.

The recommended best practice is to install the 3DOrchestrate Distribution Server on a separate server machine (separate from the other 3DSpace Service components). The 3DOrchestrate Distribution Server application can use the same database/instance as the 3DSpace Service; however, they must have separate database user accounts for the different schemas. The 3DOrchestrate Distribution Server application can also use a local database that is on the same machine.

Oracle Database Prerequisites

If the Oracle database is located on the same machine as the 3DOrchestrate Distribution Server, the deployment utility can start and stop the database server software. If the database is on a different machine on your network, you can provide the Oracle SYS as SYSDBA password to allow the deployment utility to create the schema user, create the database tables, and configure the schema. If you do not provide the SYS as SYSDBA password, the schema user must be created beforehand and the deployment utility will only create the database tables and configure the schema.

The Oracle database character set must be set to AL32UTF8 and NLS_NCHAR_CHARACTERSET must be set to AL16UTF16. If Oracle is installed on Linux, it should be installed as the same (non-root) user that is used to install the 3DOrchestrate Distribution Server; this allows the deployment utility to create a tablespace.

See Oracle Configuration Options for complete information.

Java Runtime Environment (JRE) Requirements

You might need to install and configure a newer version of the Java Runtime Environment (JRE) to use 3DOrchestrate Stations in a production environment.

For some SIMULIA roles, installing the role prompts the 3DEXPERIENCE Native App installer to embed a SIMULIA 3DOrchestration private station as well. The embedded private station includes a 64-bit Java Runtime Environment (JRE), which is required, but the version of the JRE provided is suitable for testing and qualification only. It is not suitable for a production environment.

If you want to use the private station for production, you must install an external Java Development Kit (JDK) or JRE that is suitable for your system. The Java levels required for production are: Oracle JDK 11.0.3 or higher; and AdoptOpenJDK/OpenJ9 11.0.3 or higher.

To install a suitable version of the JDK or JRE, do the following:

  1. Download the appropriate JDK or JRE from one of the following links:
    Note: Both pages include several download links. Confirm that you are downloading the 64-bit version and the one suitable for your operating system.
  2. Extract the contents of the downloaded file, and install the software.
    Note: To simplify upgrade operations for both Java and the SIMULIA 3DOrchestrate Station, you should use a Java installation path independent from the Java level.
  3. After the Java installation is complete, set the environment variable SMAEXE_JRE to point to the Java installation home.

    Once you perform this step, starting a 3DOrchestration Station (either from a native app or from any other shortcut) picks the installation designated by SMAEXE_JRE automatically.