Installation: Configuring the Reverse Proxy

Configuring the Reverse Proxy is required to enable the Live Collaboration and Live Meeting functionalities in 3DLean.

On premises only: Configuring the Reverse Proxy is only available with the On Premises version.

3DLean is automatically installed alongside the 3DEXPERIENCE platform. By default, the app is installed and fully usable without the Live Collaboration and Live Meeting functionalities.

Before you begin: Install the 3DEXPERIENCE platform. For more information, see Installation and Setup: Install: 3DEXPERIENCE platform.
  1. On the Reverse Proxy server, edit the Apache httpd.conf file.

    Note: On a Linux server, this file is usually located in the following directory: /usr/local/reverseproxy/conf/httpd.conf

  2. Customize the <VirtualHost *:_port_> tag by adding the contents of the following fragment file, which is installed on the 3DSpace server:
    • (Windows) <3DLeanInstallPath>\win_b64\templates\3DLean_httpd_fragment.conf
    • (Linux) <3DLeanInstallPath>/linux_a64/templates/3DLean_httpd_fragment.conf

    Warning: This fragment file must be included after the 3DSpace fragment.

    The fragment file provides the required configuration parameters to enable Java WebSockets communication.
  3. Restart the Reverse Proxy server. On a Linux server, this is achieved by executing the following command as root:

    /usr/local/reverseproxy/bin/httpd -k restart

Sample: Reverse Proxy Configuration Using httpd.conf

If you are using <Location /3DSpace> in your httpd.conf file, add the following modification:

Listen 443
<VirtualHost *:443>
    <Location /3DSpace>
    …
    </Location>
    # 3DLeanLive
    <Location /3DSpace/3dlean/live>
        ProxyPass ws://3dspace.mydomain:10490/3DSpace/3dlean/live
        ProxyPassReverse ws://3dspace.mydomain:10490/3DSpace/3dlean/live
    </Location>
</VirtualHost>

Else, add the following modification:

Note: Be careful to respect the order between /3DSpace/3DLean/live and 3DSpace.
Listen 443
<VirtualHost *:443>
    # Reverse Proxy Web Socket rules as to appear before the Webapp "/3DSpace" rule
    ProxyPass /3DSpace/3dlean/live ws://3dspace.mydomain:10490/3DSpace/3dlean/live
    ProxyPassReverse /3DSpace/3dlean/live ws://3dspace.mydomain:10490/3DSpace/3dlean/live
    …
    # 3DSpace conf is defined after in this case
    ProxyPass        /3DSpace http://3dspace.mydomain:10490/3DSpace
    ProxyPassReverse /3DSpace http://3dspace.mydomain:10490/3DSpace
</VirtualHost>