CATIA Teamcenter Interface - CMI.

e!CMI - 

web based 

CATIA Metaphase 

Interface 

e!CMI Release 1.1 

Installation & 

Administration Guide

Copyright 

© 1999, 2000, 2001, 2002, 2003 T-Systems International GmbH. 

All rights reserved. Printed in Germany. 

Contact 

T-Systems International GmbH 

BC EPDM/D 

Fasanenweg 5 

70771 Leinfelden-Echterdingen Germany 

cmi_support@t-systems.com 

www.cmi-support.com 

Manual History 

Version 

1.0 

1.1 

Date 

January 2003 

May 2003 

Trademarks 

CATIA is a registered trademark of Dassault Systèmes. 

Metaphase is a registered trademark of Metaphase Technology, Inc. 

Teamcenter is a registered trademark of EDS PLM Solutions. 

Names of other products mentioned in this manual are used only for identification 

purpose and may be trademarks of their companies. 

ii 

e!CMI Installation & Administration Manual

Preface 

This manual describes the installation and administration of e!CMI. e!CMI is the web 

based solution of CMI and depends on CMI. 

About this Guide 

This guide provides installation and configuration information for the web based CATIA 

Metaphase Interface called e!CMI. Before using this guide, be sure you understand: 

the UNIX- / Windows (2000, NT) based operating system 

the administration of the CATIA system 

the administration of Collaboration Foundation (Metaphase) system 

the installation and administration of standard CMI 

Related Documents 

The following manuals contain information about the usage of e!CMI and installation, 

usage and customizing of the standard CATIA Metaphase Interface called CMI: 

Manual Title 

Release 

CATIA Metaphase Interface Installation & Administration Guide 8.3 

CATIA Metaphase Interface User’s Manual 8.3 

CATIA Metaphase Interface Customizing Guide 8.3 

Web based CATIA Metaphase Interface User’s Manual 1.1 

Your Comments are Welcome 

Please feel free to give us your opinion; we are always interested in improving our 

publications. Mail your comments to: 


Business Center EPDM/D 

Fasanenweg 5 

70771 Leinfelden-Echterdingen Germany 

mailto: cmi_support@t-systems.com 

e!CMI Installation & Administration Manual 

iii

Table of Contents 

CHAPTER 1................................................................................................................... 1 

OVERVIEW.................................................................................................................... 1 

ASSUMPTIONS FOR THIS DOCUMENT................................................................................ 1 

SYSTEM AND SOFTWARE REQUIREMENTS FOR E!CMI ....................................................... 1 

SHIPMENT FOR E!CMI.................................................................................................... 2 

LOADING THE SOFTWARE FROM CD-ROM....................................................................... 2 

CHAPTER 2................................................................................................................... 3 

INSTALLATION OF THE E!CMI SOLUTION FOR PRODUCT COLLABORATION............................. 3 

PREREQUISITES ............................................................................................................ 3 

INSTALLATION OF E!CMI................................................................................................. 3 

CHAPTER 3................................................................................................................... 5 

CONFIGURATION NEEDED FOR USING E!CMI..................................................................... 5 

E!CMI USER ................................................................................................................. 5 

TRANSFER MAP AND CATIA SETTINGS............................................................................ 5 

CLASSPATH SETTINGS................................................................................................ 7 

CHAPTER 4................................................................................................................... 9 

INSTALLATION OF CATIA V5 - E!CMI MODULE ................................................................ 9 

LOADING E!CMICATV5 SOFTWARE FROM CD-ROM........................................................ 9 

E!CMICATV5 INSTALLATION........................................................................................ 10 

Configuring the installation..................................................................................... 10 

USER DEPENDENT CONFIGURATIONS ............................................................................. 17 

Testing the installation ........................................................................................... 17 

CHAPTER 5................................................................................................................. 21 

LICENSE CONFIGURATION............................................................................................. 21 

LICENSE MANAGER INSTALLATION ................................................................................. 21 

Loading licman Software from CD-ROM ................................................................ 21 

LICMAN Installation ............................................................................................... 21 

License Configuration ............................................................................................ 21 


v

Table of Figures 

FIGURE 1: THE CMI PREFERENCES.................................................................................... 5 

FIGURE 2: THE E!CMI PREFERENCES................................................................................. 6 

FIGURE 3: DIRECTORY STRUCTURE OF THE CMICATV5 INSTALLATION FILES........................ 10 

FIGURE 4: E!CMI TOOLBAR ............................................................................................. 18 

FIGURE 5: CATIA V5 GENERAL->GENERAL SETTINGS....................................................... 18 

FIGURE 6: CATIA V5 GENERAL->DOCUMENT SETTINGS.................................................... 19 


vii

CHAPTER 1 

Overview 

The installation of the web based CATIA Metaphase Interface (e!CMI) contains the 

following steps. 

1. Installation of Collaboration Foundation 2.0 (server installation) 

2. Installation of standard CMI version 8.3 (or higher) 

3. Installation of a web application server (e.g. Websphere, Web Logic, Tomcat 3.3.1) 

4. Installation of Product Collaboration (thin client) 

with solution “Parts & Document Management” and solution “e!CMI” on the web 

application server 

5. Installation of CATIA V5 and the CATIA V5 module for e!CMI 

Assumptions for this document 

1. Collaboration Foundation 2.0 has been installed including the following modules 

(required for Product Collaboration “Parts & Document Management”) 

OMF, APC, ISC, LCM, DMM, EDT 

For more information about installing Collaboration Foundation 2.0 please refer to the 

following installation manuals of the EDS documentation: “Installation on Windows 

2000/NT or Unix Servers”. 

2. The CMI and GMI servers have been installed within Collaboration Foundation 2.0. 

For more information about installing standard CMI please refer to the document: 

”CATIA Metaphase Interface Installation Manual, Release 8.3”. 

3. A web application server has been installed and set up (for example Websphere, 

Web Logic or Tomcat 3.3.1). 

4. Product Collaboration (solution “Parts & Document Management”) has been installed 

on the web application server and all installation files are in the directory 

WEB_ROOT. 

For more information about installing the solution “Parts & Document Management” 

please refer to the Chapter “Installing Web Tier Components” in the manual 

“Installation on Windows 2000 / NT / UNIX”. 

5. CATIA V5 is installed on your system. 

System and Software Requirements for e!CMI 

Teamcenter Product Collaboration (thin client) on web application server 

on the following operation systems: Windows 2000 / NT 

All UNIX platforms 

Software requirements: 

Java Runtime Environment 

(version 1.3.1 or higher) 

e!CMI Installation & Administration Manual 1

CATIA V5 Client Version V5R8 GA Level or higher 

on the following operation systems: All UNIX platforms 

Windows 2000 / NT 

Shipment for e!CMI 

The software will be delivered on a CD-ROM in ISO-9660 format containing the following 

parts (depending on desired operating system architecture): 

e!CMI solution for thin client 

CATIA V5 extension 

Licman 1.2 license manager 

Documents 

 

 

 

 

Loading the Software from CD-ROM 

The CMI product family software is distributed on a ISO-9660 formatted CD-ROM (“High 

Sierra”, hsfs, cdfs). Magnetic tape distribution is optionally available. The following steps 

describe how to mount the software CD-ROM. 

Log in as root user to a host with a CD-ROM drive. If your host does not have a CD-ROM 

drive, log into another host that is NFS-accessible to the installation host. 

(If necessary) Create a mount-point directory for the CD-ROM: 

# mkdir /cdrom 

Place the CMI CD-ROM in the drive. On Solaris and SGI hosts, the volume manager 

mounts the CD-ROM automatically, so you can skip the next step. 

Mount the CD-ROM: 

Note: CD-ROM device names vary from host to host. Thus, you may need to adjust the 

mount command listed below. 

Architecture Mnemonic Mount Command 

Solaris solaris2 not necessary 

HP-UX hpux mount –F cdfs –r/dev/dsk/c3d0s2 /cdrom 

IRIX 6 mips not necessary 

AIX 4 aix mount –o ro –v cdrfs /dev/cd0 /cdrom 

If the CD-ROM drive is not on the installation host, use NFS facilities to export the CD- 

ROM drive’s mount point from its host, and mount it on the installation host. For example: 

On the host with the CD-ROM drive: 

# exportfs –i –o ro /cdrom 

On the installation host: 

# mount drive-host:/cdrom /cdrom 

Now you can run the installation scripts as described in the following chapters. 

2 e!CMI Installation & Administration Manual

CHAPTER 2 

Installation of the e!CMI solution 

for Product Collaboration 

Prerequisites 

The EDS solution “Parts & Document Management” has been installed and your Web 

tier installation directory (WEB_ROOT) still exists on your computer. 

Installation of e!CMI 

Copy the installation files for e!CMI (TSYSTEMS_ECMI.EXE (Windows) or 

TSYSTEMS_ECMI.TZ (Unix)) from the CMI CD-ROM to the WEB_ROOT directory where 

all the other installation files are. 

Copy the documentation installation files for e!CMI (TSYSTEMS_API_DOCS.EXE 

(Windows) or TSYSTEMS_API_DOCS.TZ (Unix)) from the CMI CD-ROM to the 

WEB_ROOT directory where all the other installation files are. 

Copy the two ICD files “toc_tsystems_ecmi.icd” and “toc_tsystems_ecmi_docs.icd” 

from the CD to the directory WEB_ROOT\icd. 

Run the installation program insweb.exe in WEB_ROOT and 

you will see the following: 

Web Components Installer Startup 

Main Menu 

1. Install Solutions 

2. Generate/Re-generate Web Application file 

3. Change MTI Host 

4. Change MTI Port 

5. Configure Cache Manager 

6. Enable/Disable Shared Login 

7. EXIT 

Please enter in command: 

Choose “Install Solutions” and therefore enter 1 

you will then see the following: 


Solutions Menu 

1. Parts & Document Management 

2. TeamCenter Toolkit 

3. TeamCenter Toolkit Java API Documentation 

4. eCMI 

5. eCMI Java API Documentation 

6. Extended Enterprise 

7. Main Menu 

Please enter one solution number: 

Choose solution number 4 for installing the e!CMI components. The files will be extracted 

automatically. 

Choose solution number 5 for installing the e!CMI API documentation. The files will be 

extracted automatically. 

After successfully having installed e!CMI, choose number 7 “Main Menu” and then 

number 2 in the Main Menu “Generate/Re-generate Web Application file”. 

Copy this new created war-file to the deploy directory of your web application server. (e.g. 

for Tomcat this will be the webapps directory) and restart your web application server. 

First you have to do some configurations (see next chapter). After that you can start the 

mux and dispatcher. When mux and dispatcher are running you can try to log in and test 

this installation. Information about using e!CMI you can find in the document “Web based 

CATIA Metaphase Interface User’s Manual”. 


CHAPTER 3 

Configuration needed for using 

e!CMI 

For running e!CMI properly you have to do some configuration first. 

e!CMI user 

The first thing is that all e!CMI users have to be created within the OMF client by an 

administrator like the usual OMF client users. Via the web browser there is no possibility 

to manage administration tasks yet. 

Transfer Map and CATIA settings 

For all e!CMI users you have to set some special CMI preferences and e!CMI 

preferences. 

Therefore first open the “CMI Preferences” dialog box via 

CATIA Workbench à Options à Change Preferences à CMI Preferences. 

You have to change the values for working with the right CATIA system (V5) as you can 

see in Figure 1: 

Figure 1: The CMI Preferences 


The following preferences have to be set: 

Enable CATIA V5 Support 

Work With CATIA 

Use CATIA V5 Product Files 

CATProduct Worklocation 

Description 

It is possible to send models to CATIA 

V5. e!CMI allows handling of 

CATDrawing and CATPart. 

User can choose between work with 

CATIA V4 or CATIA V5. 

For e!CMI only CATIA V5 is supported 

yet! 

Preference permits handling of 

CATProduct files for CATIA V5. If not set 

no CATProducts will be sent to CATIA 

V5. 

If the preference above (Use CATIA V5 

Product Files) is set to TRUE then it is 

required to set this preference, too. 

The worklocation normally is used as a 

storage place for newly created Product 

files. 

It is not possible yet to create new 

Product files in e!CMI therefore this 

directory will not be needed and it is 

supposed to set its value to any 

temporary directory. 

Value 

TRUE 

V5 

TRUE 

or 

FALSE 

/temp 

or 

C:\temp 

After setting all preferences you have to save these settings with the button “Save…” in 

the dialog window. Then drag&drop this saved preferences file onto the “Startup 

Preferences” in the Home Collection Browser. 

You have to drop it onto the Startup Preferences” in the Home Collection Browser. The 

changes will have effect the next time the user logs in again. 

The next step is to do some settings in the e!CMI preferences.Therefore first open the 

“CMI Preferences” dialog box via 

CATIA Workbench à Options à Change Preferences à e!CMI Preferences. 

You have to fill in valid values for the e!CMI Transfer Map of the user. The Transfer Map 

is the directory to which all CATIA models will be either downloaded or copied to when 

working with e!CMI and CATIA V5. It has to be the same directory as the CMIXMAP for 

CATIA V5 !!! 

Figure 2: The e!CMI Preferences 


The following preferences have to be set: 

e!CMI Transfer Map UNIX 

e!CMI Transfer Map Windows 

Description 

The directory for CATIA V5 files when 

working with e!CMI on a UNIX platform 

The directory for CATIA V5 files when 

working with e!CMI on a Windows 

platform 

Value 

Path to 

directory 

Path to 

directory 

After setting all preferences you have to save these settings with the button “Save…” in 

the dialog window. Then drag&drop this saved preferences file onto the “Startup 

Preferences” in the Home Collection Browser. 

You have to drop it onto the Startup Preferences” in the Home Collection Browser. The 

changes will have effect the next time the user logs in again. 

CLASSPATH settings 

The java classes (jar files) of xalan and xerces for XML transformation tasks need to be 

at the beginning of your CLASSPATH of the web application server. Without this settings 

e!CMI won’t work. 

Therefore you have to download the file xalan-j_2_4_1.zip (recommended version). 

You can find this for example at: http://xml.apache.org/xalan-j/ 

Unpack the zip file and add the following three jar files to your CLASSPATH: 

CLASSPATH: 

“YOUR_PATH\xalan-j_2_4_1\bin\ xercesImpl.jar;YOUR_PATH\ xalan-j_2_4_1\bin\xmlapis.jar 

;YOUR_PATH\xalan-j_2_4_1\bin\xalan.jar 


CHAPTER 4 

Installation of CATIA V5 - 

e!CMI module 

The e!CMICATV5 (e!CMI-CATIA V5 Integration) module of T-Systems International 

GmbH extends the CATIA V5 functionality to work with the Teamcenter e!CMI solution. 

You should perform the following steps with your CATIA system administrator. The 

e!CMICATV5 module includes all of the supported platform data in a compressed file. 

Thus, you should choose an installation location for all CATIA V5 clients. 

In the following example sections it is supposed that the software will be installed in 

directory /catia/cmicatv5 on unix and c:\catia\cmicatv5 on Windows 2000. You can 

choose another destination for the module if you want. 

Loading e!CMICATV5 Software from CD-ROM 

Mount CD-ROM. See chapter “Loading the Software from CD-ROM” . 

UNIX 

Change to any temporary installation directory: 

catusr~> cd /home/catusr 

Unpack the compressed file: 

catusr~> cat /cdrom/CMICATV5_R10_V300.tar.Z|uncompress –c | tar xvf - 

Windows 2000 

Use the Windows Explorer to locate the d:\cmicatv5\CMICATV5_V300.tar.Z file on 

the CD. Extract the content of the archive file to a temporary installation location. 


e!CMICATV5 Installation 

Configuring the installation 

After you have successfully transferred the installation files to your installation host; the 

following steps will install the files and configure your installation. 

The CMICATV5_R10_V300 Installation Directory has the following structure: 

CMICATV5_Rx_Vy 

config 

data 

install 

licman 

unix 

nt_os 

aix_a 

hpux_a 

irix_a 

solaris_a 

intel_a 

unix 

nt_os 

Figure 3: Directory structure of the CMICATV5 installation files 

The config directory contains the file cmiEnv.txt. During the installation (UNIX) the file is 

merged with the actual CATIA V5 environment. 

The config directory also contains sample CATIA V5 Configuration files for UNIX and 

Windows 2000. The unix configuration contains two sample environment settings for the 

shells sh and csh. The nt_os configuration contains a sample CATIA V5 Environment 

file for the CATIA V5 Environment editor. 

The data directory contains the binary distributions for the CMICATV5 module for the 

supported operating system mnemonics. 

The supported operation systems and their mnemonics are: 

AIX4.3 

HPUX 11 

IRIX 6.5 

Solaris 2.7 

Windows 2000 SP2 

aix_a 

hpux_a 

irix_a 

solaris_a 

Intel_a 

UNIX 

F 

You do not need root access to install the e!CMI CATIA V5 module. 

The licman license manager must be installed on the CATIA V5 client host. If the CMI 

CATIA V4 module is installed on this host the licman is already installed. 

Start the installation script and follow the instructions. Your installation setting will be 

stored in the file config.env. This file will be located in the same directory as the install.sh 

script. 

Catusr~> CMICATV5_R10_V300/install/unix/install.sh 

********************************************************* 


* * 

* CMI CATIA V5 PRODUCT FAMILY INSTALLATION * 

* * 

* * 

* CMI CATIA V5 * 

* * 

* e!CMI CATIA V5 * 

* * 

* s!CMI CATIA V5 * 

* * 

* CMI CATIA V5 + Import Tool * 

* * 

* * 

* The installation performs two steps * 

* * 

* 1. Step: Configuration * 

* * 

* 2. Step: Installation * 

* * 

********************************************************* 

You can interrupt with cntr-C or continue with Return 

********************************************************* 

* * 

* Which Products of the CMI Family do you want to * 

* install * 

* * 

* 1. CMI * 

* (CATIA Metaphase / Teamcenter Interface) * 

* * 

* 2. e!CMI * 

* (CATIA Teamcenter Thin Client Web Interface) * 

* * 

* 3. s!CMI * 

* (Supplier Integration of CMI) * 

* * 

* 4. CMI + Import Tool * 

* (CMI + Import of existing CATIA V5 strucures to * 

* Metaphase / Teamcenter) * 

* * 

* 5. CMI + Import Tool + e!CMI + s!CMI * 

* (Complete Installation only useful for evaluation) * 

* * 

* Note: Every package needs a different license * 

* * 

********************************************************* 

Which package you want to install[1]:2 

********************************************************* 

* * 

* Installing Package: * 

* e!CMI CATIA V5 package 

* * 

* 1. Step: Configuration * 

* * 

********************************************************* 

In which directory would you like to install 

the e!CMI CATIA V5 package 

Type the full path or hit return to accept the default. 

[/home/catusr/cmicatv5_r10_v300] 

Installation directory of standard CATIA. 



[/usr/DassaultSystemes/B10] 

Environment file of standard CATIA 


[/CATEnv/CATIA.V5R10.B10.txt] 

e!CMI CATIA V5 package 

needs a local directory to perform the file exchange 

between Metaphase / Teamcenter OS user and CATIA. 

This directory is located in the $HOME directory of 

each user, e.g. if you want to use $HOME/xmap then type 

xmap. Make sure this directory exists for every user. 

[xmap] 

********************************************************* 

* e !CMI CATIA V5 package Installation 

* * 

* 2. Step: Installation * 

* * 

********************************************************* 

* * 

* If you are not sure if all settings are correct * 

* (see below) this is your last chance to interrupt * 

* the installation and make corrections in config.env: * 

* * 

********************************************************* 

* 

* Installation dir : /home/catusr/cmicatv5_r10_v300 

* CMI exchange map : $HOME/xmap 

* CATIA V5 environment : /CATEnv/CATIA.V5R10.B10.txt 

* 

********************************************************* 

You can interrupt with cntr-C or continue with Return 

For which architecture do you wish to make this installation 

type one of the following or enter for all: 

aix_a hpux_b irix_a solaris_a : 

install for all architectures! 

/home/catusr/cmicatv5_r10_v300 created 

/home/catusr/cmicatv5_r10_v300/config created 

installing aix_a 

aix_a/ 

aix_a/code/ 

aix_a/code/productIC/ 

aix_a/code/productIC/CMIFrameworkIC.script 

aix_a/code/lib/ 

aix_a/code/lib/CMIAddin.exp 

aix_a/code/lib/CMIBackbone.exp 

< installing many files > 

Generating new environment files 

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 

. . . . . . . . . . . . 

Do you wish to install the license manager 

now y/n: [y] 

Debis License Manager 1.2 Installation 

-------------------------------------- 


Modules are available for the following operating systems : 

aix_4.3.2 aix_4.3.3 hp7_10.20 hp7_10.20_pa2.0 hp7_11.00 sgi_6.5 

sgi_6.5_mips4 sol_5.7 

Specify the operating system(s) identifier 

selected archs = aix_4.3.3 hp7_11.00 sgi_6.5_mips4 sol_5.7 

Using script installation directory 

/home/catusr/cmicatv5_r10_v300/licman ... 

Using binary installation directory 

/home/catusr/cmicatv5_r10_v300/licman/bin/aix_a ... 

Installing shell scripts ... 

Installing modules for operating system aix_4.3.3 ... 


/home/catusr/cmicatv5_r10_v300/licman/bin/hpux_b ... 

Installing modules for operating system hp7_11.00 ... 


/home/catusr/cmicatv5_r10_v300/licman/bin/irix_a ... 

Installing modules for operating system sgi_6.5_mips4 ... 

Creating installation directory 

/home/catusr/cmicatv5_r10_v300/licman/bin/solaris_a ... 

Installing modules for operating system sol_5.7 ... 

********************************************************* 

* * 

* CMI CATIA V5 Installation finished * 

* * 

********************************************************* 

* * 

* e!CMI CATIA V5 package Licese: 

* To get a trial license please fill the form at: * 

* http://www.cmi-support.com/trial_license.html * 

* Copy the licenses (clients) file to * 

* /home/catusr/cmicatv5_r10_v300/licman/data 

* * 

* You can start CATIA V5 with the script * 

* cmicatstart.sh or cmicatstart.csh * 

* in the installation directory * 

* /home/catusr/cmicatv5_r10_v300 

* * 

* For more information refer to the file * 

* /home/catusr/cmicatv5_r10_v300/README 

* * 

********************************************************* 

F 

The installation procedure creates two scripts to launch CATIA V5 with CMI. One can be 

used if you use a C-shell the other if you use a K-shell in your pdmsetup. 

The start scripts use the new generated CATIA V5 environment file “cmicatiaenv.txt”. 

This environment includes the old CATIA V5 environment and the CMI settings. 

If you already have an existing licman installation you have to change the licman 

configuration in the start script. 

It is not possible to have more than one licman installation on one host. 


The start script for the C-shell looks like this: 

#!/usr/bin/csh –f 

######################################################################### 

# # 

# Example start script to start CATIA V5 with a CMI product # 

# # 

######################################################################### 

# directory of the CMI CATIA V5 installation 

setenv CMI_INSTDIR /home/catusr/cmicatv5_r10_v300 

# directory of the CATIA V5 installation 

setenv CMI_CATINSTDIR /usr/DassaultSystemes/B10 

# name of the CATIA environment 

setenv CMI_CATENVNAME cmicatiaenv.txt 

# CATIA architecture 

setenv CMI_OS `$CMI_CATINSTDIR/GetOSDS` 

# choose architecture 

switch (`uname`) 

case AIX: 

setenv LIC_OS AIX 

breaksw 

case HP-UX: 

setenv LIC_OS HP-UX 

breaksw 

case IRIX*: 

setenv LIC_OS IRIX 

breaksw 

case SunOS 

setenv LIC_OS SunOS 

breaksw 

default: 

echo "No OS found" 

exit 1 

endsw 

# debis Licman installation 

setenv debisLICDIR /home/catusr/cmicatv5_r10_v300/licman/data 

setenv debisLICBIN /home/catusr/cmicatv5_r10_v300/licman/bin/$LIC_OS 

# launch licman 

/home/catusr/cmicatv5_r10_v300/licman/licman12 lld 

# launch CATIA V5 

setenv CMD "$CMI_CATINSTDIR/$CMI_OS/code/command/catstart" 

$CMD -env $CMI_CATENVNAME -direnv $CMI_INSTDIR/config 

The README shows additional information about the installation / configuration of the 

CATIA V5 part of CMI 

********************************************************* 

* * 

* CMI CATIA V5 package README 

* * 

********************************************************* 

1. Contact 

2. Licensing 

3. Adapting CMI CATIA V5 

1. Contact 



Fasanenweg 5 

70771 Leinfelden-Echterdingen 

Germany 

http://www.cmi-support.com 

cmi_support@t-systems.com 

2. Licensing 

1 License: 

To get a trial license please fill the form at: 

http://www.cmi-support.com/trial_license.html 

Copy the licenses (clients) file to 

/home/catusr/cmicatv5_r10_v300/licman/data 

For more information refer to: 

/home/catusr/cmicatv5_r10_v300/licman/doc/licman12.pdf 

3. Adapting CMI CATIA V5 

You can start CATIA V5 with one of the following scripts: 

/home/catusr/cmicatv5_r10_v300/cmicatstart.sh 

(use this start script if you work with a k-shell: sh / ksh / bash) 

/home/catusr/cmicatv5_r10_v300/cmicatstart.csh 

(use this start script if you work with a c-shell: csh / tcsh) 

The start scripts use the file cmicatiaenv.txt to get the 

CATIA V5 environment. 

Environment files (all containing the same environment): 

/home/catusr/cmicatv5_r10_v300/config/cmicatiaenv.txt 

/home/catusr/cmicatv5_r10_v300/config/cmicatiaenv.ksh 

/home/catusr/cmicatv5_r10_v300/config/cmicatiaenv.csh 

To start CATIA V5 without the start script use: 

( sh / ksh / bash ) 

# source CATIA V5 environment 

. /home/catusr/cmicatv5_r10_v300/config/cmicatiaenv.ksh 

# set licman environment and start licman 

debisLICDIR=/home/catusr/cmicatv5_r10_v300/licman/data 

export debisLICDIR 

debisLICBIN=/home/catusr/cmicatv5_r10_v300/licman/bin/$OSDS 

export debisLICBIN 


# start CATIA 

CNEXT 

( csh / tcsh ) 

# source CATIA V5 environment 

source /home/catusr/cmicatv5_r10_v300/config/cmicatiaenv.csh 

# set licman environment and start licman 

setenv debisLICDIR /home/catusr/cmicatv5_r10_v300/licman/data 

setenv debisLICBIN /home/catusr/cmicatv5_r10_v300/licman/bin/$OSDS 


# start CATIA 

CNEXT 

Change of the CMI CATIA environment: 


If you change the CMI CATIA environment please provide the 

changes to the 3 environment files the same way. 

/home/catusr/cmicatv5_r10_v300/config/cmicatiaenv.txt 

/home/catusr/cmicatv5_r10_v300/config/cmicatiaenv.ksh 

/home/catusr/cmicatv5_r10_v300/config/cmicatiaenv.csh 

Variable 

CMIXMAP 

Value Description 

exchange directory between Metaphase/ 

Teamcenter and CATIA V5 

CMI_CALC_BBOX ON calculate bounding boxes 

CMI_DEBUG ON generate debug output of the CMI 

CATIA module. 

Windows 2000 

Use the Windows Explorer to copy the intel_a directory from the temporary installation 

location to the installation directory (e.g. c:\catia\cmicatv5) 

Use the Windows Explorer to copy the sample CATIA Environment file to the CATIA 

Environment directory. 

Edit the sample environment scripts with an editor of your choice. 

CMIV5DIR must point to the CatiaV5Module install directory. 'intel_a' must be included. 

For example: c:\catia\cmicatv5\intel_a 

DSINSTALLDIR points to the main CATIA V5 install directory. for example: c:\Program 

Files\Dassault Systemes 

set CMIV5DIR=c:\catia\cmicatv5\intel_a 

set DSINSTALLDIR=c:\Program Files\Dassault Systemes 

in a command shell 

or for the main environment with 

MyComputer->properties->advanced->Environment->add 

For the Installation of the license manager please refer to the Licman 1.2 Installation 

Manual. 

The licman license manager must installed on the CATIA V5 client host, please refer to 

section 

License manager installation on page 21. 


User dependent configurations 

Name of 

Environment Variable 

CMIXMAP 

The following Environment settings are possible for the user 

Short Description 

location of the cmi exchange map 

can be the same as the exchange map 

for the CMI CATIAV5 module (see 

Fehler! Verweisquelle konnte nicht 

gefunden werden. on page Fehler! 

Textmarke nicht definiert.) 

CMI_CALC_BBOX Calculate bounding boxes ON 

Possible Values 

CMI_DEBUG 

generate debug output of the CMI 

CATIA module. 

ON 

Testing the installation 

Common prerequisites 

1. The CMIXMAP (CMI exchange map) environment variable must point to a directory 

with write permissions and has to be the same as the TransferMap in the CMI 

Preferences. 

2. The debisLICDIR environment variable must point to licman installation directory. 

3. The licman license manager must be started. 

4. For testing purpose,(using the functionality), the e!CMI browser must be started and 

the CATIA Workbench (in Metaphase) must be opened. 

UNIX 

Source the environment scripts 

start the CATIA V5 executable 

CNEXT 

Windows 2000 

Start CATIA V5 with the following commands from a command shell (CNEXT.exe must 

be found in the path set by your PATH environment variable) 

set CNEXTOUTPUT=CONSOLE 

(to open a command Window with the CATIA output) 

CNEXT.exe -env CatiaCMIEnv -direnv C:\CatiaV5Env\CATEnv 

(C:\CatiaV5Env is the CATIA Environment directory, this Directory is chosen as an 

example) 

CATIA V5 

After the CATIA V5 has started the following message should appear in the command 

window: 

"@(#)###################################" 

"@(#)# CMI CATIAV5 Module #" 

"@(#)# Version: 3.0 #" 

"@(#)# CATIAV5R10 #" 

"@(#)# (c) T-Systems 2002 #" 


"@(#)###################################" 

e!CMI: Module Number 1017 : license successful allocated 

The License Module Number may vary. 

Figure 4: e!CMI Toolbar 

The e!CMI Toolbar should be present if a CATProduct, CATPart, or an CATDrawing is 

the active CATIAV5 window, because the CMI Toolbar is only present in the Product 

Structure, Part Design and Drafting workshop. 

In the CATIA Settings the following options must be set as described below: 

The Load Referenced documents option must be set in Tools->Options-> General 

settings (see Figure 5). 

Figure 5: CATIA V5 General->General Settings 

In the Linked Document localization the Options Folder of the link and Folder of the 

pointing document must be set to yes (see Figure 6). 


Figure 6: CATIA V5 General->Document Settings 

For CMI functionality please refer to the CATIA Metaphase Interface User’s Manual. 


CHAPTER 5 

License configuration 

License manager installation 

Loading licman Software from CD-ROM 

Mount CD-ROM. See chapter “Loading the Software from CD-ROM” on page 1. 

UNIX 

Windows 2000 

The licman installation is part of the CMI CATIA V5 module installation. 

Use the Windows Explorer to locate the d:\licman12\ licman12win2000.zip file on 

the CD. Extract the content of the archive file to a temporary installation 

location. 

LICMAN Installation 

Please refer to the Licman Installation Manual (Licman.pdf) located on the CD in the 

licman12 folder. 

License Configuration 

The use of CMI is controlled by a license manager. Thus, to run CMI a license file and a 

license manager installation is needed. The license manager is a part of this delivery. 

If you are new with CMI and you are not owner of a license file, contact us for a 

temporary license (cmi_support@t-systems.de). For license file generation we need only 

a free port number at your CATIA machine. 

Client/Server file 

Only if you have a floating license, you need to put a file called “clients” into the 

debisLICDIR on the client machine. 

This file is a table that describes which client (LLD) machines should use which GLD 

host. 

The format is like follows: 

Each line contains the name or IP of a client machine, followed by the name or IP of the 

GLD server host. On subsequent lines you can omit the server host if it is the same. 

You can use a “*” on the last line, clients that are not explicitly given will use the current 

GLD host. 

Example: 

clienthost1 

clienthost2 

clienthost3 

serverhost1 

serverhost2 


* 

In this example “clienthost1” and “clienthost2” will use the GLD on “serverhost1”, 

“clienthost3” and all other clients will use “serverhost2”.

CATIA Teamcenter Interface - CMI.

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?