Installing CES

The CES application is deployed after installing the ENOVIA server. The CES installation procedures explained in this page includes:
You must complete post installation tasks before working with CES. For details, see Post Installation Tasks.
Clicking Cancel at any stage results in aborting the deployment. You might need to start from the beginning.

Installing CES on WebTop

Installing CES on WebTop involves two steps, namely:

Installing ENOVIA CES V5Rn

Before deploying the CES application, you must install the ENOVIA CES V5Rn, where n represents the current release.
This task explains how to install ENOVIA CES V5Rn:
  1. Insert the ENOVIA CES V5Rn CD.

    The installation wizard is activated automatically, and the Welcome window appears.

  2. Click Next to continue.

    The License window appears.

  3. Click Next to continue.

    The Choose Destination Location window appears.

  4. The installer automatically detects the ENOVIA server installation location, and populates the value. You can use Browse,  only when multiple ENOVIA installations were made.  Click Next.

    The Choose Environment Location window appears.

  5. The installer automatically detects the Environment Directory location, and populates the value. You can use Browse,  to specify a different location, if needed. Click Next to continue.

    The Setup Type window appears.

    You have two options to install, namely Complete and Custom. The Complete is for installing all the CES products, whereas Custom is for installing the required CES products. The default selection is Complete.

  6. Select Custom to install the selected CES products, and then click Next.

    The Language dependent User Interface files window appears.

  7. Select the required Language Dependent User Interface files, and then click Next.

    The Configurations and Products options window appears.

  8. You have options to choose the required configurations, and products of CES. To install the required CES Products, from the Choose from list, select PRODUCTS.

    The list of CES products appears.

    All the CES products that can be installed in custom installation are listed. You can select more than one CES product. To select multiple products, press the Ctrl key on the keyboard, and then select the required CES product. The selected products are highlighted, and displayed along with the server configuration in the Selected Configurations and Products box with the space details. If you wish to cancel selection of a particular product, press the Ctrl key on the keyboard, and click the highlighted product you do not wish to install.

  9. After selecting the CES products for installation, click Next.

    The Values window appears.

    Note: The Values window is the continued installation procedure if you have selected the Complete installation, and then clicked Next in the Setup Type window.

  10. Enter the appropriate values for the Orbix configuration provided during the installation of ENOVIA server, and then click Next

    The Server Timeout Configuration window appears.

  11. Enter the required server timeout value, and then click Next.

    The Vault Client Configuration window appears.

  12. The vault server configurations are done when installing the ENOVIA server. Click Next.

    The Custom Shortcut Creation window appears.

  13. Select the required shortcut or shortcuts, and then click Next.

    The Select Documentation window appears.

  14. Select if you wish to install the online documentation, and then click Next.

    The Start Copying Files window appears.

    The Current Settings displays the details of the CES products selected for installation, environment file name, destination directory, space utilization, Orbix configuration, sever timeout duration, and vault client setup are displayed. Use the scroll bar to view complete details. If you wish to make modifications to the selections and values, click Back to make modifications.

  15. Click Install. The installation process takes some time, and the progress appears.

    After completion, the Setup Complete window appears.

  16. You can start the application immediately after installation, or prefer not to. The default selection is immediate launch. Click Finish.

    The application is launched.

Deploying CES Application

You can deploy the CES application only by automatic mode. The SDMSetupUI will also install the VPMNav. The VPM Lifecycle Navigator WEB product (VPMNav) is deployed in the default WebSphere application server (server1). If you wish to install VPMNav in a different server, you need to create the new server. For creating the new server, contact your WebSphere Administrator. Please note that before deploying the CES Application, if there are any released service packs (Rn SP2, Rn SP4, etc.) you must install these first.

You must have knowledge of the following:

  • WebSphere administration
  • ENOVIA installation
  • Database Administration
Before deploying CES, you must have:
  • Installed ENOVIA V5 VPM Rn GA
  • Created Persistency Database
  • Created WebSphere profile
  • Created a new application server on which the VPMNav has to be deployed (if the user does not want to install on the default server)
  • Set the environment variable JAVA_HOME pointing to the Java installation directory
  • The WebSphere application server where the VPMNav server to be deployed, is up and running.
The SDMSetupUI is an extension of WASSetupUI.
This task explains how to deploy the VPMNav and the CES application:
  1. To start the CES deployment wizard, run the command <Installed Path>\<OS>\code\bin>catstart -run SDMSetupUI.

    Where,

    <Installed Path> is the location where the application software is available.

    <OS> specifies the operating system in which the application software is available. For example, for Windows it is intel_a, and for IBM AIX it is aix_a.

    The CES Deployment Wizard appears.

  2. The Source tab is similar to the Source tab of WASSetupUI. The available sources, that is, runtime images for the installation are listed. Enter the source path in the box marked, or click the Directory button to select the path, and then click Add.

    The source path selected appear in the list.

  3. Click Next .

    The Persistency tab appears.

  4. Specify the VPMNav persistency database details in the Persistency tab.

    This table explains the persistency information to be entered:

    Field

    Information Requirements

    Driver Type

    From the Driver Type list, select the database. The available options are, IBM DB2 (default) and Oracle.

    JDBC Driver File

    Enter the path of the JDBC driver, or click the Directory button to select the appropriate driver type.

    • ojdbc14.jar for Oracle
    • db2jcc.jar for DB2
    Database Name Enter the database name.
    Database Host Enter name of the machine hosting the database. <database_hostname>
    Database Port Enter the port number used by the database instance. <database_port>
    User Name Enter the name of the database user created.

    The username system is not allowed. The system user name is assigned for administration tasks. If you specify the system  password, it might lead to tablespace overflow, and also cause database administration impossible.

    Password Enter the password of the database user created.
    JNDI Name The Java Naming and Directory Interface (JNDI) name appears by default. Do not edit this field.
  5. You can test whether connection to the database can be established. To test, click Test Connection.

    The details appear in the Output tab, and after the test connection is complete, a successful connection message appears. A list of errors appears, if there is any, in the Output tab.

  6. Click OK, and then in the Persistency tab, click Next.

    The Target tab in the CES Deployment Wizard appears. Much of the information on the Target tab is required for CES installation, including Cell, Node, Profile, Server, etc. Make sure you select the appropriate entries on this Target tab. Click the More button to display additional information about the Websphere configuration

    This table explains the target information to be entered:

    Field

    Information Requirements

    Target Type

    The default display is WebSphere Application Server. Do not change the value.

    IBM WebSphere Application Server Directory

    Select the WebSphere installed directory from your local system.

    • For UNIX: Do not use the blank space in the directory. If a blank space is included, the installation procedures cannot be carried forward.

    • For Windows: Provide the short name if the value specified contains blank space for Windows. To know the short name, execute "dir \x".

    Application Root URI

    The context through which the CES is invoked. Make changes, if required. <http://localhost:port number//application root URI>

    Profile

    A list of all the profiles in the WebSphere application server. Select the appropriate profile name.

    Cell

    A list of all the cell names in the selected profile. Select the appropriate cell name.

    Node

    A list of all the node names in the selected cell. Select the appropriate node name.

    Server

    A list of all the server names in the node. Select the appropriate server name.

    The Profile, Cell, Node, and Server values are automatically populated. Change the values only if required. Before making any change, confirm with your WebSphere systems administrator.

  7. Manual Deployment is not supported in this release. Select only Automatic Deployment

  8. Click Next.

    The Security tab in the CES Deployment Wizard appears.

  9. For entering details in the Security tab, refer to the ENOVIA Installation Guide for details. Click Next.

    The CESSetup tab in the CES Deployment Wizard appears.

    This table explains the CES Setup information to be entered:

    Field

    Information Requirements

    CES Server Name Enter the server name that you want to create.

    Note: Do not use space while specifying the CES Server Name.

    Install CES Admin Desktop Check the Yes or No radio button to indicate whether to have the Administration Desktop application automatically installed. If it is installed automatically, you do not need to install it manually later. For information about installing the CES Administration Desktop manually, refer to Installing CES Administration Desktop.

    If you check Yes, to have the CES Administration Desktop application automatically installed, the Admin Desktop is installed in the srm.war directory (<WAS_HOME>\profiles\<PROFILE_NAME>\installedApps\<CELL_NAME>\SRMApp.ear\srm.war\<Admin Desktop directory>). After installation you must change the ExploreJavaServer.PORT value to the BOOTSTRAP_ADDRESS of the CES Server. For more information on this process, refer to Enabling the CES Administration Desktop. You must also update the virtual hosts using the Administration console, by specifying the http port of the CES Server as the default. The URL to launch the Admin Desktop is http://<hostname>:<CESServer> HTTP Port>/excalibur/CESAD/index.html. For more information, refer to Adding Virtual Hosts.

    Driver Type The Driver Type should be set based on the CES database created. If the database created is a DB2 database, set the Driver Type to IBM DB2. If the created database is an Oracle database, set the Driver Type to Oracle.
    JDBC Driver File The setting for this depends on the Driver Type setting. If the Driver Type is IBM DB2, set the JDBC Driver File to db2jcc.jar, available in <DB2_HOME>/SQLLIB/java/. If the Driver Type is Oracle, set the JDBC Driver File to classes12.zip, available in <ORACLE_HOME>/jdbc/lib/
  10. Click Next.

    The E-PM Setup tab in the CES Deployment Wizard appears.

  11. The E-PM Setup values need not be changed, as the facility to change is not supported in this release. Click Next.

    The E-PM Database Tables tab in the CES Deployment Wizard appears.

  12. The E-PM Database Table values need not be changed, as the facility to change is not supported in this release. Click Next.

    The E-PM Message Queue Workflow tab in the CES Deployment Wizard appears.

  13. Click Finish to complete the CES deployment.

    The Output tab in the CES Wizard appears.

    The details of the deployment are displayed in the Output tab.
     
    After successful deployment, the message prompting you to exit appears

  14. Click Yes to exit the deployment.

Installing CES on WinTop

The procedures for installing CES on WinTop is identical to the steps mentioned in Installing ENOVIA CES V5Rn.

Installing the CES WinTop with ENOVIA LCA Interop

This task explains how to install the CES WinTop application with ENOVIA LCA Interop.
  1. Install CATIA P1, P2 or P3.

  2. Mount the ENOVIA V5 VPM V5Rn CD.

    The installation wizard is activated automatically, and the Welcome window appears.

  3. Click Next.

    The Choose Destination Location window appears.

  4. The installer automatically detects the ENOVIA V5 VPM server installation location, and populates the value. You can click Browse,  only when multiple ENOVIA V5 VPM installations were made.  Click Next.

    The Choose Environment Location window appears.

  5. The installer automatically detects the Environment Directory location, and populates the value. You can click Browse to specify a different location, if needed. Click Next.

    The Setup Type window appears.

  6. Select Custom to install the selected ENOVIA V5 VPM client, and then click Next.

    The Language dependent User Interface files window appears.

  7. Select the required Language Dependent User Interface files, and then click Next.

    The Configurations and Products options window appears.

  8. You have options to select the required configurations, and products of ENOVIA V5 VPM. Select VPC - ENOVIA Client Product, and then click Next.

    The CATIA V5 Information window appears.

  9. Select if you wish to install the online documentation, and then click Next.

    The Choose Orbix Configuration window appears.

  10. Enter the appropriate values for the Orbix configuration provided during the installation of ENOVIA server, and then click Next

    The Server Timeout Configuration window appears.

  11. Enter the required server timeout value, and then click Next.

    The Vault Client Configuration window appears.

  12. The vault server configurations are done when installing the ENOVIA server. Click Next.

    The Data Directory selection window appears.

  13. Enter the Java home path in the Please enter Java Home Path The vault server configurations are done when installing the ENOVIA server. Click Next.

    The Custom Shortcut Creation window appears.

  14. Select the required shortcut or shortcuts, and then click Next.

    The Select Documentation window appears.

  15. Select if you wish to install the online documentation, and then click Next.

    The Start Copying Files window appears.

    The Current Settings displays the details of the ENOVIA V5 VPM selected for installation, environment file name, destination directory, space utilization, Orbix configuration, sever timeout duration, and vault client setup are displayed. Use the scroll bar to view complete details. If you wish to make modifications to the selections and values, click Back to make modifications.

  16. Click Install. The installation process takes some time, and the progress appears.

    After completion, the Setup Complete window appears.

  17. You can start ENOVIA V5 VPM immediately after installation, or prefer not to. The default selection is immediate launch. Click to Finish.

    The application is launched.

  18. Install ENOVIA CES.

  19. Go to the Environment directory:

    C:\Documents and Settings\All Users\Application Data\Dassault Systems\CATEnv

    In CATIA_P3.V5R18.B18D25.txt
    add
    CATIAV5_ENOVIAV5=1

    In ENOVIA_CES.V5R18.B18D25.txt
    add
    SDMWin=1
    CATIAV5_ENOVIAV5=1

    In ENOVIA_V5_VPM.V5R18.B18D25.txt
    add
    VaultClient_PropertiesFilePath=<Installed Path>\<OS>\docs\java

    VaultClient_PropertiesFileName=VaultClient.properties.<name>
    CATIAV5_ENOVIAV5=1