Reverse Proxy Configuration for 3DOrchestrate

On-premise installations of the 3DEXPERIENCE platform require a reverse proxy server.

See Also
Results Analytics and File Monitoring Services

As with the other 3DEXPERIENCE web server applications (services), the 3DOrchestrate Distribution Server application must be configured in the reverse proxy rules to allow simulation client apps and 3DOrchestrate Stations to connect to it.

This configuration is needed because the 3DOrchestrate Distribution Server is located behind a reverse proxy server and your 3DOrchestrate Stations and client apps will request connections from the other side of the reverse proxy.

The supported reverse proxy software is Apache HTTP Server; see the DS Program Directory for supported Apache versions in each release of the 3DEXPERIENCE platform.

When you use the Configure server option (or command-line config action) of the 3DOrchestrate deployment utility, a template file for the Apache HTTP Server reverse proxy configuration is generated for you in the following file:

<server_install_dir>/config/3DOrchestrate_httpd_fragment.conf

This template file is also copied into the following directory:

<server_install_dir>/<os>/template/3DOrchestrate_httpd_fragment.conf

The Apache reverse proxy configurations in this file for the 3DOrchestrate Distribution Server are as follows:

ProxyPass        /SMAExeServer-REST http://<servername>:port/SMAExeServer-REST
ProxyPassReverse /SMAExeServer-REST http://<servername>:port/SMAExeServer-REST

ProxyPass        /SMAExeServer/jms http://<servername>:jmsport
ProxyPassReverse /SMAExeServer/jms http://<servername>:jmsport

ProxyPass        /SMAExeServer/ejb http://<servername>:port/SMAExeServer/ejb
ProxyPassReverse /SMAExeServer/ejb http://<servername>:port/SMAExeServer/ejb

ProxyPass        /SMAExeServer http://<servername>:port/SMAExeServer
ProxyPassReverse /SMAExeServer http://<servername>:port/SMAExeServer

ProxyPassMatch   /ek/(.*)$ ws://$1

In these lines, replace <servername> with the host name of the machine on which your 3DOrchestrate Distribution Server application is running. Replace port with the port number for the 3DOrchestrate Distribution Server application.

The default jmsport is 61716, but you can change the port number using the 3DOrchestrate deployment utility.

You must copy these configuration lines for the 3DOrchestrate Distribution Server (SMAExeServer) into the virtual host definition of the reverse proxy configuration.

Note:

For an overview of reverse proxy servers in the 3DEXPERIENCE platform, see 3DEXPERIENCE Platform Installation Guide: Before Starting the Installation

For reverse proxy software requirements, see the following page in the Program Directory:

Strategic Platform Requirements: Server Hardware and Software Requirements