Deploying CATIA Instant Collaborative Design in IBM WebSphere Application Server

CATIA Instant Collaborative Design (CD1) is a corequisite product involved in collaborative design. CD1 is empowered by ENOVIA.

CD1 works in client/server mode only and in order to work in client/server mode requires both WebSphere and ENOVIA V5 VPM.

Refer to Integrating Instant Collaboration into IBM WebSphere Application Server for information about software prerequisites.

Setting Up CATIA Instant Collaborative Design

This is how CATIA Instant Collaborative Design, ENOVIA V5 VPM, Sametime and WebSphere work together:

The CATIA Instant Collaborative Design application is based on a 3-layer system:

  • Storage layer: The first layer is made up of the ENOVIA Vault Server (1) and of the ENOVIA V5 VPM Server (2). The physical data (briefcases created by the users) are stored in the ENOVIA vault (1).
    Sharing data (design collaboration data, and workspaces, data concerning which briefcase belongs to which workspace) are stored in the ENOVIA V5 VPM database (2).
  • Communicating layer: The second layer made up of the WebSphere (3) and the Domino (4) servers, enables the ENOVIA Vault Server (1), and the ENOVIA V5 VPM Server (2) to communicate with CATIA (5). Websphere is dedicated to collaboration, whereas the Domino server is dedicated to connectivity.
  • Design layer: The last layer made up of CATIA (5) enables the user to design.

To set up CATIA Instant Collaborative Design:

  1. Install CATIA Instant Collaborative Design on the CATIA client.
  2. Install WAS on the server.
  3. Install the the ENOVIA V5 VPM runtime view on the server:
    • Media: ENOVIA V5 VPM
    • Configuration: VDS
  4. Go the following directory, for example on UNIX:


    edit the following file:


    and remove the comments preceding and following each of the lines containing the COLLABWS declarations.
  5. Go to the following directory, for example on UNIX:


    and reload the application using the following command:

    catstart -run LoadAdmin

    followed by the full path to the VPMAdmin.adm file you just modified, like this:

    catstart -run LoadAdmin <path to vpmadm.adm>/vpmadm.adm
  6. Copy from another vault, the file:



    in the ENOVIA V5 VPM runtime view you are going to deploy in the WAS.
  7. Deploy the runtime view in the WAS, and follow all the necessary steps described elsewhere in this guide.
  8. Start the WebSphere Application Server if it is not already started.
  9. In a web browser, type the following URL:


    For example:


    The Web browser displays the following Server Administration page:


  10. Check the Enable Enovia server option, and provide the name of the machine hosting the server and the port number. The objective is to test communications with the ENOVIA V5 VPM server.
  11. Click Go to test Server page:

  12. Click test Web Services:

  13. Click Next:

  14. Provide your ENOVIA V5 VPM login and password, then click Connect:

  15. Click Next:

  16. To test the creation of a workspace in ENOVIA V5 VPM, fill in the dialog box, then click Create Workspace:

  17. Click Next:

  18. Click Test vault connection:

  19. Click Create briefcase:

    The configuration is completed. You can now exit the web browser.
  20. Restart the WAS.