Client Setup

Manufacturing Hub client configuration requires specific Java and environment configuration. This includes:

Additional recommended option settings are also noted below.

Any remaining administrative setup is not discussed in this user guide. Prerequisites which are required at this level of configuration are discussed in detail in the DELMIA Process Engineer Administrator documentation.

Setup considerations for Windows XP SP2

New security features introduced in Windows XP SP2 (such as Windows Firewall) require additional configuration steps for proper client-server communication. Please consult the DELMIA Process Engineer Administrator documentation for further information regarding client setup on the Windows XP SP2 platform.

Java requirements


Install the correct version of the JRE

In R14, the DPM infrastructure used to load data from the Manufacturing Hub was modified to provide improved load performance, particularly when loading data over a WAN. This new infrastructure requires the installation of Java JRE 1.5.0_05 on both the client and the server.

Set the JAVA_HOME environment variable

In addition, the environment variable JAVA_HOME must be defined that indicates the JRE installation directory (for example, C:\apps\jre1.5.0_05) on the client machine:

Recommended JVM heap settings

By default, the heap size for the Java Virtual Machine (JVM) is set at 64MB. To accommodate larger projects and improve performance, it is recommended that the heap size is set to a minimum of 128MB or higher. (Note that the limit is 2GB on Windows operating systems.)

To accomplish this, set the environment variable CATJWS_JAVA_OPTION to "-Xmx128M":


If the maximum heap size is reached when loading a project from the Manufacturing Hub, the load will fail and the following error message is displayed:

CATPPRReplica::GetReplicaFromBinary(const CATBinary&, CATBoolean, CATPPRReplica&) java.lang.OutOfMemoryError <<no stack trace available>>

If this occurs, please close the V5 session and increase the JVM maximum heap size as explained above, then restart DPM.


Setting the system path

Specify the location of the E5 installation

To support the loading of Work System Components, the E5 utility must included be in the system path. This includes adding the following directory paths to the system path:

<E5 Installation>\Bin;<E5 Installation>\PPRClient\Program\Bin;<E5 Installation>\PPRServer\Program\Bin;

where "<E5 Installation>" is the root directory of the E5 installation, and each path is delimited by a semicolon.

The above also sets the path to the executable GraphicExport.exe, which allows for geometry to be seen in the V5 viewer. This executable is is part of the E5 installation, and is located in <E5 Installation>\PPRClient\Program\Bin.

To add these entries to the system path:

  1. From the Windows taskbar, select Start > Settings > Control Panel to open the Control Panel window.

  2. In the Control Panel window, double-click the System icon to display the System Properties dialog box.

  3. Click the Environment tab to view the current system variables.

  4. In the User Variables window, highlight the PATH variable. The current path settings appear in the Value text field.

  5. Edit the Value text field to include the paths indicated above. Separate the paths being added from the existing paths in the list by a semicolon.

    This example shows "D:\EP5Proto" as the <E5 Installation> directory.

  6. Click the Set button to update the system PATH variable with the edited Value text field.

  7. Click OK to close the System Properties dialog box.


Recommended options

Disable automatic backups

It is recommended that the Tools > Options > General > Data Save option is set to No automatic backup for Manufacturing Hub projects: