V5 Installation and Licensing Instructions

 

This page describes the general information about procedures and known issues for installing and licensing the following products:

Links to Official Online Documentation

Use the following links to consult the official installation documentation:

Installing the Code on Windows

Installing the Code on UNIX

Installing the Online Documentation

Installation

General Procedure for Windows
  1. Log on as an administrator.
    You must belong to the Administrators group, or have the privileges assigned to the Administrators group. Otherwise, you will not be able to start the installation.
  2. Insert the CD-ROM into the drive.
    The installation procedure starts automatically. A full self-explanatory graphical interface appears, in which you can easily navigate.
  3. After installation, a shortcut is created on your desktop. Double-click on it and the session will start.
    Additional information can be found in the Infrastructure User's Guide documentation.

 

General Procedure for Unix
  1. Log on as an administrator.
    You must be super-user (root) to install this CD-ROM.
  2. Insert the CD-ROM into the drive.
    After mounting the CD-ROM , change directory to the mount point and enter the command:
    ./start

    After a few seconds, a full self-explanatory graphical interface appears, in which you can easily navigate.

  3. After installation, if you have installed in the default /usr/DassaultSystemes/B19 directory, enter the following command to start:
    /usr/DassaultSystemes/B19/os_name/code/command/catstart

    Additional information can be found in the Infrastructure User's Guide documentation.

Notice about Support of WebSphere MQ on Windows XP Professional x64 Edition

WebSphere MQ, a corequisite for running the batch monitor, is not supported on Windows XP Professional x64 Edition.

Registry Corruption on Windows XP Professional x64 Edition

A problem of incompatibility between 32-bit and 64-bit registration is the cause of the problem when a V5R17 GA 64-bit product line has been installed after a V5R15 GA 32-bit product line with two different administrator users.

This may lead to this type of message during an installation or un-installation:
 

To repair this registry key, perform the following steps:

  1. Get the name of the user which performs the installation:
  2. To determine the owner of the key, on the key select mouse button 3, then Permissions. The following message will be displayed:



     

  3. Click OK, then the following dialog box will be displayed:


     
  4. Click on Advanced, then the following dialog box will be displayed:


     
  5. In the Owner tab, the message Unable to display the current owner is displayed. In this case, check the Replace owner on sub- containers and objects option, then click Apply then OK. The following dialog box will be displayed:


     
  6. This time, by selecting mouse button 3, then Permissions, you will obtain the owner of the key:



    DS\ogg is the administrator user which performed the 32-bit installation.
     
  7. Now you know the administrator user, log off then log on with the administrator user which performed the installation.
  8. To repair the registries, using the V5R15 GA 32-bit installation or also a V5R17 GA 32-bit installation, run the following command:

    Unload_directory/intel_a/code/bin/V5Regserver -unset

Check Integrity Problem during Installation:

You can ignore the problem with the following file if it presents errors during an integrity check under UNIX: CAAPSNInteroperability.edu

 

Distributing Code on Windows (DELMIA ONLY)

In the CATIA Installation and Administration Guide, section "Distributing Version 5 on Windows", the scenario "Accessing the Software From a Thin Client" explains that you can:

Note that, in either case, you will not be able to run the Batch Management utility or the Settings Management utility.

 

Problem Installing Manufacturing When McAfee Anti-Virus is Running (DELMIA ONLY)

If the installation stops during the unloading of the Manufacturing cabinet file and the following dialog box is displayed:

with the following message in the cxinst.log file:

Unload Manufacturing - CDROM 1
File UnloadDir\intel_a\control\Manufacturing.toc was not found

the problem may be due to the McAfee Anti-virus product.

The bypass is to open the McAfee VirusScan Console window and select "Access Protection" in the Task list. Then, use the right mouse button or Alt+Enter to display the "Access Protection Properties" window. Select the tab "File, Share and Folder Protection" and uncheck the option: Prevent access to suspicious startup items(.exe) **\startup\**\*.exe

Product Prerequisites (DELMIA ONLY)

Due to business process requirements and additional validation testing it is necessary to restate previously incorrect manufacturing product prerequisites.

CORBAServerInfra_post message during installation (DELMIA ONLY)

When installing some CATIA configurations, if an error occurs related to the execution of the CORBAServerInfra_post module, please, ignore it. It will have no consequence on the usage of the installed solutions and products.

Documentation Change: Deploying Instant Collaboration in IBM WebSphere Application Server (DELMIA ONLY)

In the Version 5 Installation and Deployment Guide, section Deploying Instant Collaboration in IBM WebSphere Application Server, section Phase 1, the paragraph "V5 Collaboration Client" now reads:

Install the V5 runtime view of the VDM code on the V5 collaboration client:

Media: ENOVIA V5 VPM

Configuration: VDM containing VPM Navigator.

Note that you also have to install from the ENOVIA_DMU_Navigator media a configuration containing the DMU Navigator (for example, DM2). If no DMU license is present, you will not have access to certain functions.

n the following table:

Yes The command is available
No The command is not available or grayed out
NA Not applicable

 

FUNCTIONS CONFIGURATIONS --> VDM VDM + DM2
Peer-to-Peer mode
INSTANT COLLABORATION TOOLBAR
3D Conferencing icon Yes Yes
3D Conferencing window    
  • Publish/Listen tab -> Publish / Listen checkboxes
Yes Yes
  • Publish/Listen tab -> Keep viewpoint sharing active
Yes Yes
  • Publish/Listen tab -> Activate mouse pointer sharing
No Yes
  • Publish/Listen tab -> Activate slave mode
No Yes
  • Annotated Views tab -> Activate
No Yes
  • Annotated Views tab -> Send
No Yes
Client/Server mode
INSTANT COLLABORATION TOOLBAR
Connectivity icon Yes Yes
Connectivity Toolbar
  • Community icon
Yes Yes
    • Community Window
      • Connectivity tab
Yes Yes
      • Collaborative Review tab
Yes Yes
        • Collaborative Review ->  (contextual menu) -> Create a 3D conference
No Yes
        • Collaborative Review ->  (contextual menu) -> Invite others to the current 3D conference
No Yes
        • Collaborative Review ->  (contextual menu) -> Leave current 3D conference
No Yes
  • Disconnect icon
Yes Yes
Instant Messaging icon Yes Yes
INSTANT MESSAGING TOOLBAR
Create an Audio Meeting Yes Yes
  • Invite others to meeting -> Meeting tools -> 3D
No Yes
  • Invite others to meeting -> Meeting tools -> (Others)
Yes Yes
  • Invite others to meeting -> Meeting tools -> Secure meeting
Yes Yes
  • Invite others to meeting -> Meeting tools -> Add/Remove invitees
Yes Yes
3D Conferencing icon No Yes
3D Conferencing window    
  • Publish/Listen tab -> Publish / Listen checkboxes
No Yes
  • Publish/Listen tab -> Keep viewpoint sharing active
No Yes
  • Publish/Listen tab -> Activate mouse pointer sharing
No Yes
  • Publish/Listen tab -> Activate slave mode
No Yes
  • Annotated Views tab -> Activate
No Yes
  • Annotated Views tab -> Send
No Yes
Meeting Toolbar Yes Yes
  • Create a Screen Sharing Meeting -> Invite others to a meeting -> Meeting tools -> 3D
No Yes
  • Create a Screen Sharing Meeting -> Invite others to a meeting -> Meeting tools -> (Others)
Yes Yes
  • Create a Screen Sharing Meeting -> Invite others to a meeting -> Meeting tools -> Secure Meeting
Yes Yes
  • Create a Screen Sharing Meeting -> Invite others to a meeting -> Meeting tools -> Add/ Remove Invitees
Yes Yes
  • Create a Whiteboard Meeting -> Invite others to a meeting
Yes Yes
  • Create a Collaboration Meeting -> Invite others to a meeting
Yes Yes
  • Create a 3D Conference -> Invite others to a meeting
No Yes

Documentation Change: Deploying Instant Collaboration in IBM WebSphere Application Server (DELMIA ONLY)

The sharing program may not work on the publisher side and the whiteboard may not be displayed on the listener side:

The same behavior has been found using the Microsoft Communicator client: it is not possible on the listener side to close the sharing window. If the listener kills the display sharing process using the Task Manager, the sharing window is no longer usable.

Single Sign-On (DELMIA ONLY)

If you are using CATIA VPM Navigator in Single Sign-On mode on 32-bit Windows, you need to install the following packages on each client:

HTTP Tunneling

HTTP Tunneling for ENOVIA V5 VPM

If a forward proxy is used along with HTTP Tunneling mode for ENOVIA V5 VPM client, and if Microsoft Internet Explorer is setup so as to use a proxy server through its  "Use a proxy server for you LAN" option located in its 'Tools / Internet Options / Connections / LAN Settings' dialog, then the "Bypass proxy server for local addresses" option must be checked in the same dialog.

If Microsoft Internet Explorer is setup so as to use a proxy server through its  "Use a proxy server for you LAN" option located in its 'Tools / Internet Options / Connections / LAN Settings' dialog, and the "Bypass proxy server for local addresses" option in the same dialog is not checked, then ENOVIA V5 VPM client will fail to connect to ENOVIA Server in HTTP Tunneling mode.

 

Single Sign-On

Modifying the number of users displayed in Single Sign-On Administration Console for Update or Export Credentials operations

In the Single Sign-On Administration Console, the dialogs for updating or exporting credentials operation use a table view to display the user for which the operation is wanted. The maximum number of lines displayed in this table view can be changed using the following manipulations:

  1. To change the maximum number of displayed lines in 'Update Credentials' dialog to 50 lines:
    Edit file <os>/resources/dialog/updateCredentials.XMLDlg using a text editor or an XML editor.
    Find the line containing either:
      <Table Name="Table1" onRowSelect="initApplicationComboBox" Attribute="_UserList"/>
    or:
      <Table Name="Table1" onRowSelect="initApplicationComboBox" Attribute="_UserList" Height="100"/> 
    Change this line into:
      <Table Name="Table1" onRowSelect="initApplicationComboBox" Attribute="_UserList" Height="50"/> 
    Restart the WebSphere application Server and try this dialog. The maximum number of displayed lines in the 'Update Credentials' table view is now 50.
     
  2. To change the maximum number of displayed lines in 'Export Credentials' dialog to 50 lines:
    Edit file <os>/resources/dialog/ExportCredentials.XMLDlg using a text editor or an XML editor.
    Find the line containing either:
      <Table Name="Table1" Attribute="_list"/>
    or:
      <Table Name="Table1" Attribute="_list" Height="100"/>
    Change this line into:
      <Table Name="Table1" Attribute="_list" Height="50"/> 
    Restart the WebSphere Application Server and try this dialog. The maximum number of displayed lines in the 'Export Credentials' table view is now 50.

Specific options for ENOVIA VPM Lifecycle Navigator Web

If Single Sign-On mode for ENOVIA VPM Lifecycle Navigator Web is to be activated, it must be noted that ENOVIA V5 VPM Server will have to connect to the Single Sign-On Server which is embedded in the same Web application as ENOVIA VPM Lifecycle Navigator Web. In some situations, the web application is deployed on an IBM WebSphere Application Server, but used through some possibility authenticated reverse proxies. In such cases, the connection from the ENOVIA V5 VPM Server to ENOVIA VPM Lifecycle Navigator Web server must be setup so that it directly refers to the IBM WebSphere Application Server port and machine:  the Single Sign-On mode will fail if ENOVIA V5 VPM Server is setup so as to connect to the Single Sign-On server through an authenticated reverse proxy.

 

In practice, this setup can be achieved by assigning proper host and port values to the CATJWSServiceDirectory and to the CATLoginServletHost environment variables; as described in "Activating SSO on the ENOVIA Server" subsection of the "Activating Single Sign-On" section of the Installation guide.

 

However, depending on the way ENOVIA VPM Lifecycle Navigator Web was first used, i.e., if it was used through the reverse proxy, the URL used by the  ENOVIA V5 VPM Server to connect to the Single Sign-On server can incorrectly be switched to the reverse proxy.

 

If such behavior is observed, then the following environment variables can be set at same place as CATJWSServiceDirectory and to the CATLoginServletHost environment variables; with the following values:
 

 

Licensing

The licensing system of the above V5 products is IBM License Use Management. More information on LUM can be obtained on the IBM web site at http://www.ibm.com/software/lum or in the LUM 4.6.8 CDROM that may have been distributed with this V5 package.

LUM does not need to be configured if your license is node locked.

For ENOVIA 3d com only:

To use concurrent licenses, you need to install and configure a LUM server and configure LUM clients.

NOTE THAT LUM 5 IS NOT COMPATIBLE WITH THIS V5 DELIVERY. 4.6.8 level of LUM is required on all platforms for all product brands.

LUM 4.6.8 + 4.6.8.3 patch is the latest level certified by Dassault Systemes. It is recommended to migrate your LUM servers to this level.

IBM License Use Management may be obtained at no charge from:

http://www.ibm.com/software/awdtools/lum/support.html

The LUM license certificate has the following format:

[LicenseCertificate]
CheckSum=2293A23783325F036CCBA9438CC87971
TimeStamp=905414500
PasswordVersion=7
VendorName=Dassault Systemes
VendorPassword=hnj43snv8pr3a
VendorID=5242378dbf8d.02.c0.09.c8.93.00.00.00
ProductName=MD2-CATIA Mechanical Design 2
ProductID=2119
ProductVersion=85SH024
ProductPassword=umd9wvnqdmt9ayzzbdb2xdc4tiam8
ProductAnnotation=85SH0245691-
LicenseStyle=nodelocked
LicenseStartDate=10/01/1999
LicenseDuration=92
LicenseEndDate=12/31/1999
LicenseCount=1
MultiUseRules=
RegistrationLevel=3
TryAndBuy=No
SoftStop=No
TargetType=26
TargetTypeName=MS Win-32 MAC
TargetID=50ebc1e2
ExtendedTargetType=
ExtendedTargetID=
DerivedLicenseStyle=
DerivedLicenseStartDate=
DerivedLicenseEndDate=
DerivedLicenseAggregateDuration=
SerialNumber=85SH0245691
Upgrade=No

The certificate should be saved in a temporary file with the ".LIC" extension, with the first line being "[LicenseCertificate]".

This is the certificate that the installation procedure prompts you to import. Do not import nodelock certificates using LUM utilities.

If needed, to import a certificate once the installation has been performed, instead of importing it during the installation,  run "CATNodelockMgt.exe" for Windows or "CATNodelockMgt" for UNIX. This command is located in the code/bin directory. For Windows, you can access this tool from Start/Programs/Catia/Tools menu and by running the Nodelock Key Management tool.

See the ReadMe.txt file located on the CDROM for information on how to get the Windows target id.

Incorrect Target ID for Some Users

On Windows computers having more than one network card, it may happen that the Target ID used by different user accounts be not the same.

The problem can be fixed by setting "Full Control" permission for the registry key {HKEY_LOCAL_MACHINE\SOFTWARE\IBM\License Use Runtime}. This permission can be set for individual users or groups, or for Everyone.

Run Regedit. Go to HKEY_LOCAL_MACHINE\SOFTWARE\IBM\License Use Runtime. Right click on it. Select Permissions. Select the appropriate user and/or group, and allow Full Control. Or add Everyone group and allow Full Control.

Concurrent Offline Licensing - Issue with i4_offline_mig

If an abnormal end occurs when running the i4_offline_mig command, you must restart and then stop again the LUM license server.

For ENOVIA DMU only:
Furthermore, the licenses generated by IBM before December 2003 for the ENOVIA DMU configurations based on DM1, DM2, DPS and PS1 possess an obsolete format which does not work for concurrent offline licensing.  i4_offline_mig 4.6.7.1 allows these licenses to work. You can find i4_offline_mig 4.6.7.1 at the following URL:

http://www.ibm.com/support/docview.wss?rs=886&context=SW860&uid=swg21204240

Documentation Modification

In "Common Installation and Administration Tools", "Miscellaneous Installation Tasks on Windows -"Uninstalling Version 5", the following has been added:

"Dassault Systemes Software Prerequisites x86 can be removed only once you have uninstalled all
Dassault Systemes software."

Documentation Modification

In the "Installation and Deployment Guide", "Licensing", "Enabling Concurrent Offline Licensing", the correct version is of LUM is 4.6.8 not 4.6.7.

Documentation Modification

In the "Installation and Deployment Guide", "Managing Settings", "About Settings", "Specifying Settings Without Running a Session", "On Windows", the correct command for starting CATOptionsMgt in
administration mode is:

catstart -run "CATOptionsMgt -admin" -env envname