Client Setup

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

• Ensuring the installation of the correct version of the Java Runtime Environment (JRE)
• Creating and setting the JAVA_HOME environment variable
• Increasing the default JVM heap size
• Setting the system path so that the E5 utility can be accessed, and also that the geometry is displayed in the DPM viewer

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

Please refer to the Quick Prerequisite Checklist in the DELMIA Installation & Deployment Guide for the current required version of the Java Runtime Environment (JRE).

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":

CATJWS_JAVA_OPTION=-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: