Preparing the ENOVIA V5 VPM Server Environment

This section explains the additional operations that have to performed to prepare the ENOVIA V5 VPM server environment.
 

Editing the Server Environment

When you installed and set up the ENOVIA V5 VPM server, a runtime environment was created. You must now edit this environment and make some minor changes to ensure that end users logging onto the ENOVIA server inherit all the resources (settings, etc.) specific to each end user.

This mechanism concerns ENOVIA V5 VPM servers on both UNIX and Windows.

Windows

Note that, on Windows, you do not have to customize the default value: it will work as is. However, you are free to customize it if you wish. To do so:

  1. Start the Environment Editor.
     
  2. Locate the USER_HOME variable.

    The default value on Windows is:

    CSIDL_COMMON_APPDATA\DassaultSystemes\DSKEY_USERID

         which typically points to:

    C:\Documents and Settings\All Users\Application Data\DassaultSystemes\DSKEY_USERID
     
  3. Edit the variable and specify a path. You can specify a path like this, for example:

    C:\Documents and Settings\All_LCA_Users\%CATRealUser%\

    or like this:

    C:\Documents and Settings\All_LCA_Users\DSKEY_USERID\
     
  4. Save the environment and exit the Environment Editor.

UNIX

On UNIX, however, the default variable MUST be edited, it does not work as is.

  1. Start the Environment Editor.
     
  2. Locate the USER_HOME variable.

    The default value on UNIX is $HOME.
     
  3. Edit the variable and specify a path.

    On UNIX, for example:

    $HOME/ALL_LCA_Users/$CATRealUser

         where ALL_LCA_Users is the name of an existing directory. The path MUST contain the $CATRealUser variable.
     
  4. Save the environment and exit the Environment Editor.
 

Role of the USER_HOME  and $CATRealUser Variables

The USER_HOME variable points by default to the home directory of the physical userid created to start the ENOVIA V5 VPM server. It must always be customized on UNIX. If this value is not customized, successive end users will be able to log on, but they will inherit the settings of the previous user and then overwrite them with their own settings, which will in turn be inherited by the following user, etc.

Positioning the USER_HOME variable to point to the path of the userid creates all user settings in the same place; including the $CATRealUser variable in the path ensures that a directory is created in the same directory for storing user-specific settings.

We strongly recommend that you do not skip this step.
 

Issuing the xhost + Command on UNIX Before Starting the Server

For UNIX installations only, the xhost + command must be issued on the UNIX server console each time the server is booted up before any ENOVIA VPM Lifecycle Navigator or 3d com WebSphere application server is started. Also, once this is done, the window where it is issued must remain open on the console, but it can be minimized if desired. Additionally, in the case of a UNIX server that doesn't have a dedicated physical console installed, some form of a remote console logon setup is required to support the xhost + requirement.

There is an exception to the above on AIX servers, where the optional use of XVFB (virtual frame buffer) is supported. When this is used, and the application server DISPLAY environment entry in the application server is appropriately set to use it, the xhost + isn't required.

When there is a problem anywhere in the DISPLAY setup, the last entry in the SystemOut.log file during the application server startup will be:

[3/28/06 8:48:41:489 EST] e2cea37 SystemOut O + Registered servlet[hcb] Asynchronous Callback Servlet for HTML

Here's an example of an AIX server containing both the hardware graphics adapter (:0), and the XVFB (:1) capabilities setup. In this case, if the application server is set up to use the hardware graphics adapter, the xhost + is required, and the DISPLAY variable would be set to <servername>:0. However, if the application server is setup to use the XVFB, the xhost + command isn't required, and the DISPLAY variable would be set to <servername>:1.

HARDWARE GRAPHICS ADAPTER

root 131168 114868 0 Mar 22 - 0:44 /usr/lpp/X11/bin/X -x abx -x dbe -x GLX -D /usr/lib/X11//rgb -T -force :0 -auth /var/dt/A:0-A2Mlqa

XVFB

root 311462 1 0 Mar 22 - 0:00 /usr/bin/X11/X -force -vfb -x abx -x dbe -x GLX :1

Note: The XVFB setup is an excellent solution for situations where a hardware graphics adapter isn't available on the AIX server, or when optimum graphics processing throughput is desired, and sufficient server CPU and memory resources are available to support the requirements.

There is another situation on AIX servers that can lead to the application server failing to start, as indicated above. This is where someone has removed files from the /tmp directory, including the /tmp/.X11-unix directory. This directory is required for graphics processing, and in the case of the above server setup, it contains sub-directories for both the hardware graphics adapter (X0), and the XVFB (X1) as listed below. Once removed, graphics processing will fail until the server is rebooted.

# pwd
/tmp/.X11-unix
# ls
X0 X1