Installing the 3DOrchestrate Distribution Server

If you obtain the 3DOrchestrate Distribution Server installer in a Windows .zip file or Linux .tar file, extract (unpack) the archive to a temporary directory.

On Windows, extract the archive to a scratch directory such as C:\temp\ on a local disk drive. Windows requires a local disk drive because of the manner in which its Administrator rights work when User Account Control (UAC) is enabled.

Important: Do not use a UNC path or a shared directory mounted on a drive letter.

Start the installer.

You can run the installer as a graphical user interface (GUI), as a command-line text user interface (TUI), or silently. For more information, see Launching the Installation.

To start the installer with a graphical user interface, double-click or execute the following file:

Windows: <temp_dir>\1\setup.exe
Linux: <temp_dir>/1/StartGUI.sh

On Windows, use the right-click Run as administrator option.

Specify the installation directory, and then click Next.

On Windows, you should change the default installation directory to a path that does not contain spaces. For example, change C:\Program Files\Dassault Systemes\ to C:\DassaultSystemes\. On Linux, you should pre-create the installation directory as root and assign ownership of the directory to the non-root user that is running the installer.

Specify the components you want to install, and then click Next.

For a standard installation, select only the server component:

3DEXPERIENCE Execution Server

If you want to run simulation processes on a station on this server machine, select both of the following components as well:

3DEXPERIENCE Execution Station
SIMULIA Station Adapter Executors

Specify the Java Runtime Environment (JRE) by selecting Use embedded JRE? to use the version that is embedded within 3DOrchestrate or by clearing this option to select a different version, and then click Next.

Specify the 3DOrchestrate deployment type, and then click Next:

Option	Description
Express	Installs, configures, and deploys 3DOrchestrate using Derby.
Standard	Configures and deploys 3DOrchestrate with preconfigured Oracle or MSSQL.
High Availability	Configures the 3DOrchestrate High Availability Configuration.
Advanced	Configures and deploys 3DOrchestrate manually.

For all deployment types other than Advanced, specify the following 3DOrchestrate settings:

Option	Description
3DOrchestrate Server Name	Server name. The default name is 3DOrchestrate, but you can specify a custom name.
Deployment Directory	Location of the 3DOrchestrate Server. This directory is the location of the TomEE Instance.
Tomcat Connection Port	Connection port for Tomcat. By default, the Tomcat connection port is 8080; if you change the port number, the installer increments all other Tomcat default ports by 1 from their default port number.

For Standard or High Availability deployments, do the following:

Specify whether you want to configure an Oracle database or a SQL Server database as the back-end database for the server.
Specify the database name, port, and service name for the database; and enter a user name and password.

Run Deploy Program? to run the 3DOrchestrate Distribution Server deployment utility that builds, deploys, and starts the EAR file in the Java application server (TomEE+).

If you choose not to run the deployment utility during the installation, you can run it later from the command line.

Specify the certificate's location, which is the path to a directory containing the SSL public key certificates of your reverse proxy server (or 3DSpace and the 3DSpace FCS). The installer imports these certificates into the Java trusted key store of the 3DOrchestrate Distribution Server. For more information, see Installing HTTPS Certificates in 3DOrchestrate.

If you do not provide the 3DEXPERIENCE certificates to the installer, you will have to import them manually.

Review the final installation details, and then click Install.