basug

TOC

CATIA Infrastructure Preface What's New? Getting Started Basic Tasks Advanced Tasks Workbench Description Customizing Installation Requirements Glossary Index

Dassault Systmes 1994-2000. All rights reserved.

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugtoc.htm [5/23/2000 3:07:08 PM]

Preface

PrefaceWelcome to CATIA Version 5! CATIA Version 5 is the first release of the next generation of CATIA Solutions, and addresses advanced mechanical process centric design requirements. In addition to leading edge feature-based design functions, it includes highly productive capabilities for the design of mechanical assemblies and for drawing generation. Available on both UNIX and Windows environments, CATIA Version 5 is built to be totally compliant with Windows presentation standards. In order to integrate to an extended enterprise where CATIA Version 4 designs need to be exchanged and processed, it includes unique two-way interoperability with CATIA Version 4 data. Likewise, CATIA Version 5 benefits from the breadth of the CATIA Solutions Version 4 portfolio by offering interoperable applications. As an open solution, it includes interfaces with the most commonly used data exchange industry standards.

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugpr01.htm [5/23/2000 3:07:22 PM]

Using This Guide

Using This GuideThis book is the CATIA Version 5 Infrastructure Users Guide. It contains information about the user interface and basic tools common to all CATIA Version 5 applications: starting a session getting help activating application workbenches creating, opening and saving documents laying out documents selecting and manipulating objects printing, viewing and navigating rendering and lighting effects using macros using CATIA Version 5 data in OLE-compliant applications customizing toolbars and settings using the Knowledgeware Advisor and provides information for CATIA administrators on topics such as hardware and software prerequisites, network licensing, code distribution and environment management.

Conventions

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugpr02.htm [5/23/2000 3:07:57 PM]

Conventions

ConventionsCertain conventions are used in CATIA, ENOVIA & DELMIA documentation to help you recognize and understand important concepts and specifications. The following text conventions may be used: The titles of CATIA documents appear in this manner throughout the text. File -> New identifies the commands to be used. The use of the mouse differs according to the type of action you need to perform. Use this mouse button, whenever you read Select (menus, commands, geometry in graphics area, ...) Click (icons, dialog box buttons, tabs...) Double-click Shift-click Ctrl-click Check (check boxes) Drag Drag and drop (icons onto objects, objects onto objects) Drag Move Right-click (to select contextual menu)

Graphic conventions are denoted as follows: indicates the estimated time to accomplish a task.

indicates a target of a task. indicates the prerequisites. indicates the scenario of a task. indicates tips

file:///E|/users/ses/Adele/SESV5R4/CATEnglish/commain.doc/src/conventions.htm (1 of 2) [5/23/2000 3:08:02 PM]

Conventions

indicates a warning. indicates information. indicates the end of a task. indicates functionalities that are new or enhanced with this Release. Enhancements can also be identified by a blue-colored background in the left-hand margin.

file:///E|/users/ses/Adele/SESV5R4/CATEnglish/commain.doc/src/conventions.htm (2 of 2) [5/23/2000 3:08:02 PM]

What's New?

What's New?Getting Started New: Windows 2000 Ready (support for Windows 2000) New: initialization of inter-application communications backbone at installation Enhanced: a single environment (global) is now created at installation New: a command file now lets you uninstall in batch mode Enhanced: the Licensing Manager tab now specifies whether licenses are server licenses or nodelocked licenses, and provides a server timeout Enhanced: enhanced user interface for the Nodelock Key Management tool Basic Tasks New: you can now open BMP, JPEG, TIF and PICTURE files Enhanced: enhancements to online documentation homepage and online documentation searching New: you can now open sample documents via hypertext links located in the online documentation New: specification tree scrollbar, activate the specification tree only for zooming and panning Enhanced: the Search... command now supports more advanced searching for: visible or hidden objects, or objects with a specific linetype and thickness extension of the search language to support visible, hidden, linetype or line weight searching New: selection sets are now saved with your documents Enhanced: using the 3D compass, you can now move objects after isolating fixed elements or converting them to datum elements Enhanced: JPEG format enhancements Enhanced: new icons for setting capture options and capturing selected areas of images Enhanced: you can now save CATDrawing documents in PDF format for viewing with Acrobat Reader Enhanced: video capture tool enhancements Enhanced: support for colored light sources New: list of all commands for rapid access New: assignment of objects to Layers, creation of named layers and layer filters Enhanced: minor enhancements to the Walk and Fly and modes Advanced Tasks Enhanced: the CATErrorLog environment variable default value is no longer set to blank

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugwn.htm (1 of 3) [5/23/2000 3:08:26 PM]

What's New?

New: new options for the setcatenv command for CATIA environment management: new "-cs" option for creating environments for different product lines new "-v" option for verbose mode new "-new" option for overwriting existing or creating new environments new "-desktop" option for creating the desktop representation of an environment new "-a" option for creating both global and user environments new "-k" option (Windows only) new log file for logging environment creation new "-regserver" option for registering the application on the workstation (UNIX only) New: new System Information tab in the Software Management command New: support for multipiped, multithreaded virtual reality configurations Enhanced: new ways of running macros New: preview function enabling the viewing of all entities in a given catalog chapter to facilitate and expedite searches New: interactive functions for modifying a catalog by creating chapters, keywords and descriptions New: in Knowledgeware: The "Formulas" dialog box has been modified. The "Edit name, value or formula" field is replaced by the "Edit name or value of the current parameter" field and you can no longer add a formula directly in this field. The Incremental check box has been added. New: Specifying a Parameter Value as a Measure New: Specifying a Measure in a Formula Enhanced: Quick Reference of user tasks Workbench Description New: enhancements to the Commands tab for customizing command properties New: Commands List... command for listing and accessing directly all available commands New: keyboard shortcut list New: the Escape key now interrupts the current command Customizing - Settings New: option for switching between conferencing platforms Enhanced: new option for Reset... button in Tools->Options... command New: Devices tab for setting up peripheral devices (joystick, spaceball, spacemouse,...) and enabling stereoscopic viewing. New: new option in the Tree tab for graying out, in the specification tree, items placed in No Show area Enhanced: new settings in the Visualization tab: Highlight bounding box Collision detection enabled and Mouse Sensitivity (in Walk and Fly modes) Software Prerequisitesfile:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugwn.htm (2 of 3) [5/23/2000 3:08:26 PM]

What's New?

New: Windows 2000 Ready

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugwn.htm (3 of 3) [5/23/2000 3:08:26 PM]

Getting Started

Getting Started

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basuggs01.htm [5/23/2000 3:08:49 PM]

Installing CATIA Version 5 on Windows for the First Time

Installing CATIA Version 5 on Windows for the First TimeThis task explains how to install the CATIA Version 5 files for the first time on a single computer running a supported Windows operating system (Windows NT 4.0, Windows 2000, Windows 95 OSR2 or Windows 98), and set up your nodelocked licenses. Note, however, that depending on the Windows platform, certain CATIA configurations and/or products may not be available. If you want information about subjects such as: installing CATIA Version 5 on several computers setting up network licensing refer to "Advanced User Tasks". Installation and de-installation rely on Windows-compliant tools enabling anyone familiar with Windows procedures and concepts to install the software without assistance. On Windows 95 OSR2 or Windows 98, you must use network licensing, and we recommend that you configure a LUM (License Use Management) server, then configure your computer as a LUM client before starting the installation procedure. For more information, refer to "Licensing Mechanism on Microsoft Windows 95 OSR2 and Windows 98". From start to finish, this task should take approximately 15 minutes. Before starting the installation, refer to "What You Need Before Installing CATIA Version 5" to check you have all the hardware and software prerequisites. Furthermore, to prevent the installation from hanging due to concurrently running programs such as screen savers or virus scanning programs, we recommend that you first shut down any such programs. You must also have your license enrollment certificate (in electronic format) provided by your vendor. If you have the certificate, you will be able to register your license during the installation procedure. 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. On Microsoft Windows 95 OSR2 and Windows 98, log on as a normal user. All users have equal privileges on a local computer: administrator privileges do not exist. In the rest of this user's guide, if you are running either Microsoft Windows 95 OSR2 or Windows 98, log on as a normal user each time you are asked to log on as administrator. 2. Insert the CD-ROM into the drive. The Choose Setup Language dialog box appears, prompting you to choose the user interface language for the Setup program.

The languages you can choose from are: U.S. English (default) French German Japanese. 3. Click the OK button to start the installation using the English user interface, or select another language from the list box, then click the OK button.file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basuggs02.htm (1 of 13) [5/23/2000 3:09:04 PM]


The Setup program displays a message telling you that it is preparing the installation procedure.

The progress indicator gives you an idea how much of the preparation process has been completed. Once setup is completed, an animated CATIA Version 5 installation splashscreen appears, filling up the whole screen. On Windows NT IBM License Use Management Runtime (LUM), needed to be able to manage nodelock licensing, is no longer installed automatically with the CATIA files: it is now integrated in the CATIA software. The installation sets up the following folder:C:\ifor\Ls\Conf

On Microsoft Windows 95 OSR2 or Windows 98 On Microsoft Windows 95 OSR2 and Windows 98, only one licensing mechanism exists: network licensing. For more information, refer to "Licensing Mechanism on Microsoft Windows 95 OSR2 and Windows 98". The splashscreen remains displayed in the background throughout the entire installation procedure, and the different dialog boxes you will interact with will be displayed in the foreground. The Welcome dialog box is then displayed:

4. Click the Next button to move to the next step.

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basuggs02.htm (2 of 13) [5/23/2000 3:09:04 PM]


On Windows NT only (not on Windows 95 OSR2 or Windows 98), the [FrontPage Substitution Component] V5R4 License dialog box appears, asking you if you want to enter a nodelock license key for the computer on which you are installing the software.

Note that the target id of the computer on which you are performing the installation is displayed after the dialog box title. 5. On Windows NT only, if you want to enter a nodelock license, click the Import Certificate button to access the Import Certificate dialog box. This dialog box lets you import the license certificate (that is, if you received your license certificate by electronic mail, and provided you detached it and stored it on your disk).

6. On Windows NT and Windows 2000 only, explore your environment containing the license certificate (ending with the suffix ".lic"), then click OK. This creates (or updates) a nodelock file on your computer, and stores your license in the nodelock file in:C:\ifor\Ls\Conf\nodelock

If you already installed LUM elsewhere, the nodelock file will be updated in the correct LUM environment. If you decide to skip the licensing step, or if you have a license enrollment certificate in paper format only (and not in electronic format), you can enroll your licenses later, after the installation has been completed. For more information, refer to "Enrolling Nodelock Licenses After the Installation".



Licensing Mechanism on Microsoft Windows 95 OSR2 or Windows 98 On Microsoft Windows 95 OSR2 or Windows 98, only one licensing mechanism is offered: network licensing. Network licenses can only be served by a LUM (License Use Management) network license server configured on Windows NT or UNIX. Consequently, you must: configure a LUM network license server (on Windows NT or UNIX) and register your CATIA licenses configure the computer on which you are installing CATIA as a LUM client. The LUM software and documentation is available on the "IBM License Use Management (LUM)" CD-ROM shipped with the CATIA CD-ROM. Refer to the LUM documentation for full details. We recommend that you configure the LUM license server and client before starting the installation procedure. 7. Click the Next button to move to the next step. The Choose Destination Location dialog box appears. A default destination folder is already proposed: C:\Program Files\Dassault Systemes\B04\intel_a (Windows NT or Windows 2000 platform)C:\Program Files\Dassault Systemes\B04\win_a (Windows

95 OSR2 or Windows 98 platforms)

8. If the default destination folder is suitable, click the Next button to move to the next step, or click the Browse... button and navigate to select another folder and click OK. The folder you choose must be empty. You can also specify a new folder: the folder will be created after confirmation. 9. Click the Next button to move to the next step. The Setup Type dialog box appears:



This dialog box lets you specify whether you want to install all of the software on the CD-ROM, or select the configurations and/or products to be installed: Complete: specifies you want to install all the software, and moves on to the next installation step (installation of online documentation files) when you click Next Custom: lets you choose the configurations and/or products to be installed. 10. If you want to choose which configurations and/or products to install, check the Custom option and click the Next button to move to the next step. The Select Software dialog box appears:



By default, the list of all the configurations on the CD-ROM is displayed. 11. Choose whether you want to install configurations and/or products by using the list box provided. Depending on what you chose, the list will display the names of all the configurations or products on the CD-ROM. 12. Click on the configurations and/or products to select them. The selected configurations and/or products are listed in the "Selected Software" list. The dialog box specifies the space available for the installation. Clicking on each configuration or product also specifies the amount of space required for installing those configurations or products; the space required is updated progressively as you select from the list. In our example, we chose to install the DP2 - CATIA - Drawing Production 2 Configuration and the MD2 - CATIA Mechanical Design 2 Configuration:

13. Click the Next button to move to the next step. The Choose Communications Ports dialog box is displayed:



This allows you to set up on your computer: a port reserved for the communications backbone process a port reserved for starting the communications backbone process automatically a port reserved for processing events when using peripheral devices (spaceball, spacemouse, joystick). By default, the "Set up communication ports" option is checked because it is strongly recommended. For more information about the communications backbone, refer to "Communications Backbone Files". For more information about peripheral device handling, refer to "CATIA device broker". 14. Click the Next button to move to the next step. The Select CATIA V5R4 Documentation dialog box appears:



15. Check the CATIA V5R4 Documentation check box only if you want to install the online documentation during the code installation procedure: this choice is optional. If you check this box, you will be prompted after the software has been copied to your computer: to remove the CATIA V5R4 code CD-ROM and insert the CATIA V5R4 documentation CD-ROM. 16. Clicking the Next button displays the Start Copying Files dialog box. The central area lists the current settings you set in the previous steps: CATIA V5R4 product names and documentation destination folder. The result looks something like this (depending on which software you chose to install). Note that the dialog box reflects our choice to install the MD2 CATIA - Mechanical Design 2 Configuration and the DP2 - CATIA - Drawing Production 2 Configuration:

There is nothing to prevent you from installing all the configurations and products on the CD-ROM. However, you will be able to use only the software for which you have enrolled licenses, except if you are using a demo mode license as explained in "Running in Demo Mode". 17. Click the Next button to start copying the files to your computer. A progression indicator appears, and an animated sequence starts showing you some of the products that you will be able to create with the software. Once the files have been copied, you may be prompted at this point to restart your computer. This is because the certain Windows system libraries are also shipped and installed with the CATIA V5R4 software: these libraries will be installed if the existing libraries on your system are not present or at a lower level. After restarting, you must then relog onto the computer using the same administrator logon. Once the files have been copied, and only if you checked the CATIA V5R4 Documentation check box, the Setup CATIA V5R4 Documentation dialog box appears:



18. If you want to install the online documentation, remove the CATIA V5R4 product CD-ROM from the drive, insert the CATIA V5R4 online documentation CD-ROM for your language, and click OK to restart the Setup program, this time to install the online documentation files. The default folder in which the documentation will be installed is:C:\Program Files\Dassault Systemes\B04doc

Note that the dialog box also provides a path for specifying another drive or folder from which you can install the online documentation. The default path is the drive name (usually D:) on the computer from which you are performing the installation. Modifying this path is useful if: you already inserted the online documentation CD-ROM into another drive you copied the online documentation files from the online documentation CD-ROM to a folder. If this is the case, click the Browse... button and specify the appropriate drive or folder. If you have several online documentation CD-ROMs (one for each supported language), you can only install one of these CD-ROMs at this stage of the installation. If you do not want to install the online documentation immediately, you can always install it later. For more information, refer to "Installing the Online Documentation After Installing the Code". Once both the product and (optional) online documentation files have been copied, the Setup Complete dialog box informs you that the installation has been completed.

Microsoft Windows 95 OSR2 and Windows 98 You are using network licensing. You will only be able to start a CATIA session if you have previously: configured a LUM network license server (on Windows NT or UNIX) and registered your CATIA licenses configured the computer on which you are installing CATIA as a LUM client. 19. Click the Finish button to exit the installation program and run CATIA Version 5, If you do not want to run CATIA Version 5 now, uncheck the check box prompting you to run CATIA Version 5 now, then click the Finish button. If you chose to run CATIA Version 5 now, the CATIA Version 5 window will look like this, for example, if you installed the configurations CATIA - Mechanical Design (MD2) and CATIA - Drawing Production (DP2):



Because you imported a license certificate, the license is automatically reserved, allowing you to enter the session immediately without having to reserve the license using the License Manager. An installation log is created in the current temporary directory, located by default in: C:\TEMP\cxinst.log If you did not import a license certificate: If you chose to run CATIA Version 5 now, but did not import a license certificate, a message window appears informing you that you have not yet requested a configuration or product license:

Click the OK button. The CATIA V5 application window now appears, along with the License Manager dialog box:



The License Manager dialog box lists the configurations and products you installed. In our example, we installed the CATIA - Mechanical Design 2 Configuration. Note that the field to the left of each product name specifies: "No License". This is because this is the first time you are starting CATIA Version 5, and you have not yet reserved any licenses. At this stage, if you click the OK button, a CATIA V5R4 session will still be started, but you will not be able to work with the product: menu commands will be grayed out, and you will only be able to use the File->Exit command. The TargetId of your computer is displayed at the top of the License Manager dialog box. You have to communicate the target id to your vendor when ordering licenses. At this stage, you will not be able to go any further until you register your licences. To register nodelock licenses after the installation, you must select the Start->Programs->CATIA ->Tools->Nodelock Key Management V5R4 as explained in Enrolling "Nodelock Licenses After the Installation", to import a license certificate. Once you have imported a nodelock license certificate, double-click the CATIA V5R4 default environment shortcut on the desktop to start a CATIA V5R4 session directly. You can now use the software you installed and for which you enrolled a license. Your licensing settings are stored in a settings file. During a CATIA session, you can reserve and release licenses using the Licensing tab accessible via the Tools->Options... command. For more information, refer to "Reserving Licenses Using the License Manager". About the Environment Created on Windows A CATIA Version 5 installation has the following impact on your computer:



Installation Folder The software is installed (if you used the default location) in the folder:C:\Program Files\Dassault Systemes\B04\intel_a

(Windows NT or Windows 2000 platform)

or:C:\Program Files\Dassault Systemes\B04\win_a (Windows

95 OSR2 or Windows 98 platforms)

Desktop The installation: creates the CATIA V5R4 default environment shortcut on the desktop Only one environment is created: a global environment (not a user environment). For more information about global and user environments, refer to "What are global and user environments?". sets up the Start->Programs->CATIA->CATIA V5R4 default environment shortcut, and the Start->Programs->CATIA ->Tools menu containing the Environment Editor V5R4, Nodelock Key Management V5R4 (except on Microsoft Windows 95 OSR2 or Windows 98) and Software Management V5R4 commands. Registry The following registry keys are modified: HKEY_LOCAL_MACHINE\SOFTWARE\DASSAULT SYSTEMES HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Dassault Systemes B04 (for uninstallation) HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppPaths\Cnext.exe (sets up the Start->Run... command so you can enter the cnext command to start a session) HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\FONTS (sets up fonts in True Type format, describing the full name and filename of the font) HKEY_CLASSES_ROOT (CATIA V5 document types). Registry entries, folders and files are not protected. On Windows NT and Windows 2000 only, you can protect access to these entries using system tools, for example the regedt32 command. Please note that this command is only recommended for advanced users because it is potentially dangerous. Communications Backbone Files The communications backbone is a CATIA-specific implementation of message-oriented middleware (MOM), used to support process interoperability for distributed application networks in heterogeneous environments. Installing CATIA sets up the communications backbone on your computer. The backbone needs to be set up on each computer running applications which need to communicate. When one application attempts to communicate with another, the backbone process is started automatically. If the process is already running, it is not restarted. A timeout is triggered once there are no more clients attempting to communicate with other applications. A typical scenario involving the use of the inter-application communications backbone is implemented to allow the ENOVIA Portal DMU Navigator and ENOVIA Portal WEB to communicate: ENOVIA Portal WEB can load geometry and product structures into a viewer such as ENOVIA Portal DMU Navigator, 4D Navigator or CATIA. An installation sets up the communications backbone by creating the following lines: catiav5bb 6666/tcp catiav5run 6667/tcp in the file: %windir%\system32\drivers\etc\services Note that the line: CATDeviceBroker 6668/tcp which concerns peripheral device handling is also added to this file. If you do not want to set up communication ports during the installation, you can always edit the above-mentioned files manually later.



Other Folders An installation also affects the following: C:\Winnt\system32 on Windows NT and Windows 2000, and C:\Windows\system on Windows 95 OSR2 and Windows 98 (certain Windows system libraries will be installed if the existing libraries on your system are not up to date) the folder C:\ifor\Ls\Conf is created (on Windows NT and Windows 2000 only), in which the file nodelock is stored if you imported a nodelock license certificate, C:\Temp\cxinst.log (installation log). Administrator Setting Environments When running a CATIA session at the end of the installation procedure (as administrator), administrator settings are created in: C:\Winnt\Profiles\administrator\CAT* (CATTemp, CATCache, CATSettings) on Windows NT C:\Documents and Settings\CAT* on Windows 2000 C:\Windows\CAT* (CATTemp, CATCache, CATSettings) on Windows 95 OSR2 and Windows 98 All end users can now log onto the same computer and run a CATIA Version 5 session, because the environment created at installation is global.


Deinstalling CATIA Version 5 on Windows

Uninstalling CATIA Version 5 on WindowsThis task explains how to remove the CATIA Version 5 files. Note that you are not able to selectively uninstall a configuration or product. Uninstalling relies on Windows-compliant tools enabling anyone familiar with Windows procedures and concepts to uninstall the software without assistance. Prior to removing the CATIA software, you must remove any user environments you may have created after the initial installation using the tools described in "Customizing Your Environment on 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 uninstall the software. 2. On the Windows desktop, select the Start->Settings->Control Panel, then double-click the Add/Remove Programs control. An Install/Uninstall dialog box appears, and looks something like this (depending on the software installed on your computer):



3. Select the item "Dassault Systemes Software B04" from the list, then click the Add/Remove... button. A message informs you that the folder:C:\Program Files\Dassault Systemes\B04

is about to be removed, and prompts you to confirm that you want to continue and remove all the software. You can also use this command to remove the CATIA online documentation. The item name for the English documentation will be, for example: "Dassault Systemes CATIA - EnglishDocumentation B04". 4. Click Yes to confirm. ALL the installed configurations and products will be removed. The program removes: the installation folder all desktop items (environment icon, Start->Programs->CATIA menu) the last environment created all registry entries except for the components specified below. You may be prompted to kill any running processes which use the version you are uninstalling. What Is Not Removed? Note that the following components are not removed: the fonts installed with the CATIA software any system libraries installed to update your system. The Start->Programs->CATIA menu will not be removed if it still contains environments created using the tools described in "Customizing Your Environment on Windows". If you delete the installation folder instead of uninstalling cleanly using the Add/Remove Programs control via the Start->Settings command, your registry will be corrupted. Before, when you attempted to reinstall, you were blocked. Now, a message will prompt you to click the OK button if you want to automatically clean up the registry and continue the installation. Uninstalling in Batch Mode On WINDOWS, you can also uninstall in batch mode by executing a command file. 1. Open a command prompt (MS-DOS) window.



2. Enter the following command: Unload_Dir\DSUninstall.bat where "Unload_dir" may be, for example: C:\Program Files\DassaultSystemes\B04. This command removes the software in the same way as the Add/Remove Programs control. However, note that the procedure automatically kills any running processes which use the version you are uninstalling.


Installing CATIA Version 5 on a UNIX Workstation for the First Time

Installing CATIA Version 5 on a UNIX Workstation for the First TimeThis task explains how to install the CATIA Version 5 files for the first time on a single workstation running UNIX, and set up your nodelocked licenses. The concepts, procedures and look and feel of the installation procedure for Windows have been carried over to the UNIX environment in order to provide a common CATIA Version 5 installation interface for all supported operating systems. From start to finish, this task should take approximately 15 minutes. Before starting the installation, refer to "What You Need Before Installing CATIA Version 5" to check you have all the hardware and software prerequisites. 1. Logon as root. 2. Insert the CD-ROM for your UNIX operating system into the drive. 3. If you are running AIX or HP-UX, check whether the CD-ROM drive is declared. On AIX, run the command:lsdev -C -c cdrom

If a line like this is not displayed:cd0 Available 00-01-00-30-CD-ROM Drive

you need to add the CD-ROM drive by using the smit AIX command, for example. On HP-UX, run the command:cat /etc/fstab

If a line like this is not displayed:/dev/dsk/c201d1s0 /CDROM cdfs ro 0 0 0

you need to add the CD-ROM drive, by using the sam HP-UX command, for example. If you are running IRIX or Solaris, inserting the CD-ROM declares and mounts the CD-ROM automatically (unless you disabled this feature).



4. On AIX and HP-UX, check whether the CD-ROM drive is mounted. If the CD-ROM drive is not mounted, you will have to mount it before proceeding. You can determine if the drive has already been mounted by typing the command:mount

In the output lines, you should see a list of mounted file systems. The CD-ROM drive has already been mounted on your local system if a line similar to one of the following lines appears in the list: /dev/cd0 cdrom cdfrs "date" ro (AIX) cdrom on device readonly on "date" (HP-UX) where "date" is the current date. 5. On AIX and HP-UX, mount the CD-ROM drive, if necessary, by typing the commands:mount -v cdrfs -r /dev/cd0 /cdrom (AIX) mount /cdrom (HP-UX)

6. Change directory to the CD-ROM mount point and enter the command: ./start to start the installation procedure, or: ./start -s if you want to start the installation procedure without the accompanying music. The CATIA Version 5 setup program will be run. The setup program checks you have the correct prerequisites. Then, the Welcome dialog box greets you. The setup program invokes a full self-explanatory graphical interface which walks you through the installation. The installation steps are approximately the same as on Windows, as described in "Installing CATIA Version 5 on Windows for the First Time". An installation log is created in: $HOME/cxinst.log



What about the online documentation? Note, however, that on UNIX you cannot install the online documentation directly from within the installation procedure. If you want to install the documentation, copy the contents of the CD-ROM into a directory with sufficient free disk space. Then, use the setcatenv command to change the value of the CATDocView variable to point to the location where the CD-ROM contents were copied. Optionally, you may use the CD-ROM directly and set the value of the CATDocView variable to the CD-ROM mount point. For information about the setcatenv command, refer to "Customizing Your Environment on UNIX". About the Environment Created on UNIX A CATIA Version 5 installation has the following impact on your workstation: Installation Path The software is installed (if you used the default location) in the folder directory:/usr/DassaultSystemes/B04/OS_a

where "OS_a" is: aix_a hpux_a irix_a solaris_a Environment The installation offers you the choice of where to create the /CATEnv directory. The default is the root $HOME directory (typically "/"), but you can create the /CATEnv directory anywhere you like. Note that, if an environment already exists, the installation procedure offers you the choice between replacing it or creating a new environment with a different name. The installation creates in this directory the following global environments required to set the CATIA Version 5 runtime environment variables: CATIA.V5R4.B04.sh (for use with Korn or Bourne shells) CATIA.V5R4.B04.csh (for use with C shell). Note: UNIX system administrators can also setup a /CATEnv environment directly in the home directory of end users. CDE Desktop on AIX, HP-UX and Solaris The /CATCDE directory required for CDE desktops is now created in the /CATEnv directory.



The installation creates the following filetree required for integrating CATIA into the CDE desktop: /CATEnv/CATCDE/CATIA /dt/appconfig/appmanager/C/CATIA/CATIA.V5R4.B04 (file required for graphic representation of environment in the CDE desktop) /CATEnv/CATCDE/CATIA /dt/appconfig/types/C/CATIA.V5R4.B04.dt (action description file for environment icon) /CATEnv/CATCDE/CATIA /dt/appconfig/types/C/CATIA.dt (action description file for CATIA directory) /CATEnv/CATCDE/CATIA /dt/appconfig/types/C/CATIAFiles.dt (action description file for CATIA document types) /CATEnv/CATCDE/CATIA /dt/appconfig/icons/C (contains icons for CATIA document types). The CATIA application is registered in the CDE application base via the "dtAppIntegrate" command which is executed automatically during the installation. The result of registering the application is that the /etc/dt/appconfig/ environment on your workstation is modified. This environment contains links to the CATIA desktop filetree located under /CATCDE (described above). The visible impact on the CDE desktop is: the creation of the CATIA directory in the Application Manager cabinet, accessible via the front panel the creation in this directory of the default global environment icon CATIA V5R4. To display the default global environment icon CATIA V5R4, once the installation is completed, you must click the Application Manager icon on the CDE front panel, go into the Desktop Tools cabinet, then double-click the Reload Applications icon. You can also log off and log on to display the icon. Magic SGI Desktop on IRIX The /CATSGI directory required for SGI desktops is created in the /CATEnv directory.



The installation creates the following directory required for integrating CATIA into the Magic SGI desktop: /CATEnv/CATSGI/CATIA /CATIA.V5R4.B04 (file required for graphic representation of the environment in the Magic SGI desktop) and installs the following files in the following system directories: /usr/lib/filetype/install/Dassault_Systemes.CATIAFiles.ftr (action description file for CATIA document types) /usr/lib/filetype/install/Dassault_Systemes.CATIAEnvironment.ftr (action description file for environment icon) /usr/lib/filetype/install/iconlib (contains icons for CATIA document types). Installing CATIA on IRIX takes longer than on the other UNIX platforms because the Magic SGI desktop is recompiled. Communications Backbone Files The installation procedure allows you to declare on your computer: a port reserved for the communications backbone process a port reserved for starting the communications backbone process automatically a port reserved for processing events when using peripheral devices (spaceball, spacemouse, joystick). To do so, check the option "Set up communications ports (strongly recommended)" when prompted. The communications backbone is a CATIA -specific implementation of message-oriented middleware (MOM), used to support process interoperability for distributed application networks in heterogeneous environments. Installing CATIA sets up the communications backbone on your computer. The backbone needs to be set up on each computer running applications which need to communicate. When one application attempts to communicate with another, the backbone process is started automatically. If the process is already running, it is not restarted. A timeout is triggered once there are no more clients attempting to communicate with other applications. A typical scenario involving the use of the inter-application communications backbone is implemented to allow the ENOVIA Portal DMU Navigator and ENOVIA Portal WEB to communicate: ENOVIA Portal WEB can load geometry and product structures into a viewer such as ENOVIA Portal DMU Navigator, 4D Navigator or CATIA . An installation sets up the communications backbone by creating the



following lines: catiav5bb 6666/tcp catiav5run 6667/tcp in the file: /etc/services and the following line: catiav5bb stream tcp nowait root /path/CATSysDemon in the file: /etc/inetd.conf where "path" is the path containing the CATIA executable files. For example: catiav5bb stream tcp nowait root /usr/DassaultSystemes/B04/solaris_a/code/bin/CATSysDemon Note that the line: CATDeviceBroker 6668/tcp which concerns peripheral device handling is also added to this file. For more information about peripheral device handling, refer to "CATIA device broker". If you do not want to set up communication ports during the installation, you can always edit the above-mentioned files manually later. Other Directories The CATIA Version 5 installation procedure on UNIX sets up on your workstation a filetree for storing IBM License Use Management Runtime (LUM) nodelock licenses, that is, if LUM is not already installed on your workstation. This is needed to manage nodelock licensing. The nodelock file is created by default in:/var/ifor/nodelock (AIX) /opt/lum/ls/conf/nodelock (HP-UX, IRIX, Solaris)

Administrator Setting Environments When running a CATIA session at the end of the installation procedure (as administrator), administrator settings are created in the /CATSettings and /CATTemp directories.



All end users can now log onto the same workstation and run a CATIA Version 5 session, because the environment created at installation is global. Start Command Syntax The start batch command lets you install CATIA Version 5 without the graphical user interface. To perform a batch installation, change directory to the CD-ROM mount point and enter the command: start with at least one of the following arguments: -u: specifies the unload directory. The default unload directory is: /usr/DassaultSystemes/B04. -newdir: creates the unload directory if it doesn't exist. -D: specifies the /CATEnv environment directory. The default environment directory is /CATENV. -lic "pathname": specifies the path and name of the license certificate to import for nodelocked licensing. -env new|replace: if the environment file already exists, you can choose to erase it or create a new one. -env new: If you install the same level of CATIA several times, the same environment is created each time, and using the same name, except that the name is incremented incremented like this each time: CATIA.V5R4_1.B04.sh, CATIA.V5R4_02.B04.sh, etc. -env replace: if you already installed CATIA, you may then have deleted the installation directory, in which case the environment remains; in this case, use the "-env replace" argument to overwrite the existing initial environment and create a new one during the installation. Note that the "replace" option does not replace existing environments that you may have created using the "new" option (or using the "Create New Environment" option when installing using the GUI), and whose name is incremented, for example: CATIA.V5R4_1.B04.sh. -exe: runs a CATIA session at the end of the installation. -s: silent mode (without music). -v: verbose mode. -h: displays help. -list: lists the configurations and products on the CD-ROM. -all: unloads all the configurations and the products on the CD-ROM.



-l "list_to_unload": specifies the list of configurations and/or products to unload. You have to type the list of configurations and/or products, which you can obtain by running the command using the "list" argument. In the list, configuration names look like this: ME2.slt., and product names look like this: KIN.prd. These are the names you must type. Separate the names using a blank. The arguments: -list -all -l "list_to_unload" are mutually exclusive. -backbonePorts port1 port2: specifies the ports reserved for the communication backbone - default values are 6666 and 6667"; -VRPort port3: specifies the port reserved for processing events when using peripheral devices (spaceball, spacemouse, joystick). -noSetupPorts: specifies you do not want to set up any communication ports. Reminder: if you run the command without arguments, the installation will be started using the graphical user interface.


Uninstalling CATIA Version 5 on UNIX

Uninstalling CATIA Version 5 on UNIXThis task explains how to remove the CATIA Version 5 files from your workstation on UNIX. Prior to removing the CATIA software, you must remove any user environments you may have created after the initial installation using the tools described in "Customizing Your Environment on UNIX". End users who set up their own user environments using the setcatenv command can only remove them using the delcatenv command. 1. Log on as root. 2. Go to your /CATEnv directory, then enter the following command to set up the environment:. /CATEnv/CATIA.V5R4.B04.sh (for Bourne or Korn shell) source /CATEnv/CATIA.V5R4.B04.csh (for C shell)

3. Delete the environments you created using the command:delcatenv -e env_name

This command is located in the directory:/usr/DassaultSystemes/B04/OS_a/code/bin

where "OS_a" is: aix_a hpux_a irix_a solaris_a and "env_name" is the name of the environment. Note that environments cannot be deleted using simple operating system commands. The delcatenv command is essential for removing all trace of environments in the desktop environment. CDE Desktop on AIX, HP-UX and Solaris The delcatenv command removes only the following components: /CATEnv/CATIA.V5R4.B04.sh (and CATIA.V5R4.B04.csh) if you specified these environment names using the -e option /CATEnv/CATCDE/CATIA /dt/appconfig/appmanager/C/CATIA/CATIA.V5R4.B04 (file required for graphic representation of environment in the CDE desktop).file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basuggs05.htm (1 of 2) [5/23/2000 3:10:02 PM]

Uninstalling CATIA Version 5 on UNIX

Magic SGI Desktop on IRIX The delcatenv command removes the following components: /CATEnv/CATIA.V5R4.B04.sh (and CATIA.V5R4.B04.csh) if you specified these environment names using the -e option /CATEnv/CATSGI/CATIA /CATIA.V5R4.B04 (file required for graphic representation of the environment in the Magic SGI desktop) if you specified this environment name using the -e option. 4. Only when all environments have been deleted, you can then delete the installation directory using the command:rm -r /usr/DassaultSystemes/B04


Reserving Licenses Using the License Manager

Reserving Licenses Using the License ManagerThis task explains how to reserve product licenses during a session using the Licensing tab via the Tools->Options... command. 1. Select the Tools->Options... command. 2. Select the General category, then the Licensing tab to display the Licensing tab. The role of the Licensing tab is to allow you to reserve licenses before using these products. You will not be able to work with any CATIA Version 5 products until you have first reserved the corresponding licenses. You must select at least one configuration license. In our example, it will look like this if you installed the configurations CATIA - Mechanical Design (MD2) and CATIA - Drawing Production (DP2), and imported a nodelock license for the CATIA - Mechanical Design (MD2) configuration:



The list contains all the installed configurations and products. Note that, if you have not previously reserved any licenses, none of the check buttons is checked. If you entered a nodelock license during the installation, the corresponding configuration is preselected in the list. In our example, the CATIA - Mechanical Design (MD2) configuration (DS58BB40000 - MD2) option is checked because we imported a nodelock license for this configuration during the installation. All configurations are considered as custom configurations. When you install a configuration, the list in the dialog box will contain: custom configurations, represented in the form of a serial number (in our example: "DS58BB40000 - MD2"), appear at the top the names of the products appear after the name of the last configuration. In the upper part of the tab: Target id: specifies the target id of your computer Display Type: informs you whether you are running on a local or remote display; Local: you are running on a local display and you are working with a nodelocked or server license Remote: you are running on a remote display and you are working with a server license only Server Timeout: a slider lets you specify approximately the amount of time you are prepared to wait for a server license to be made available by the license server. In our example, note that: the check button next to the configuration "DS58BB40000 - MD2" is checked because, during the installation, the corresponding nodelock license was imported the status Granted appears next to the products in the list which belong to that configuration. The product names in the list are grayed out and the check buttons cannot be checked: this is because, in our example, no licenses exist for the individual products. Furthermore, the status Not Granted means that you attempted to reserve a license that is not available (nodelock license expired, server license expired, network server down, etc.). the status No License appears next to "DP2 - CATIA - Drawing Production 2 Configuration": this means that the configuration has been installed, but you do not have a license. The configuration name is grayed out in the list, and the check button cannot be checked. Below each license, you will see Local or Server which informs you whether the license is a nodelock license or a server license. If you are using a server license, the name of the server will be displayed like this: Server (ip:server_name) You will be able to work in demo mode if you registered and reserved at least one configuration license, and checked the Demo Mode option. For more information about the demo mode, refer to "Running in Demo Mode". 3. Check the check buttons for the configurations and/or products for which you want to reserve a license. When you are working with nodelock licenses, the license will be reserved by default when you start your session, even if you unchecked the corresponding check button. 4. Click OK. 5. Exit and restart your session. You need to restart your session after reserving configuration and/or product licenses. Licensing settings are stored in a settings file. The settings active in the License tab depend on what you set the last time you used it. Troubleshooting Messages You may encounter one of the following messages when using the Licensing Manager: "Environment xxx not set or incorrect" Set an environment using the setcatenv command. "Environment xxx incorrect" Set a valid environment using the setcatenv command. For more information about customizing environments, refer to "Customizing Your Environment on Windows" .



"No Configuration/Product Available" The path containing the information required to display the list of configurations/products, referenced by the CATICPath CATIA environment variable, is incorrect, or the information is incomplete. "You have not requested one or more product licenses, but no configuration license" Click OK and select at least one configuration license using the Licensing tab. "No License Available for Requested Configuration(s)" Click OK and select at least one valid configuration license using the Licensing tab. "Not All Licenses Available" Contact your administrator.


Running in Demo Mode

Running in Demo ModeThis task explains how to run CATIA Version 5 in demo mode. You must have already registered either one demonstration license, or at least one configuration license (which automatically provides access to the demo mode). What Is Demo Mode? Running in demo mode lets you use all the features of all the configurations and/or products installed, apart from the few exceptions listed below. In demo mode: the automatic save (roll) mechanism is deactivated. you can open only specially marked CATIA Version 4 or Version 5 demo documents you cannot embed CATIA documents in OLE documents you cannot open CATIA documents using OLE technology you cannot save documents on Windows, the clipboard is unavailable for cutting, copying and pasting you cannot record or execute macros you can create new workbench-specific documents, but you cannot save them. Note that when running a normal (non-demo) session, you can read specially marked CATIA Version 4 or Version 5 demo documents, and save them as non-demo documents. By default, demo mode is not activated. 1. Display the License Manager. The License Manager is displayed automatically after starting CATIA Version 5 (either for the first time, or each time you start a session until you reserve a license). You can also display it by selecting the Tools->Options... command, then the Licensing tab in the General category. 2. Check the Demo Mode option, and click OK. A message informs you to restart your session. 3. Click OK and restart CATIA . The CATIA V5 application window is opened in demo mode.


Running in Demo Mode


Installing Additional Products

Installing Additional ProductsThis task explains how to install additional products to an existing installation. The installation procedure is the same as for a first-time installation, with a few minor differences. On Windows, to prevent the installation from hanging due to concurrently running programs such as screen savers or virus scanning programs, we recommend that you first shut down any such programs. 1. Log on as an administrator. 2. Insert the CD-ROM into the drive. 3. Follow the instructions as before. 4. When prompted, enter the new nodelock licenses (if any) for the additional products. The licenses are added to the existing nodelock file. Keep in mind that on Microsoft Windows 95 OSR2, or Windows 98, network licensing is used. 5. Continue with the installation until a dialog box appears listing the configurations and products you have already installed In the following example, the MD2 and DP2 configurations have already been installed:

6. Click Next. This displays a list of the configurations and products you have not yet installed:


Installing Additional Products

7. Select the additional configurations and/or products you want to install, and complete the installation as before. If you previously installed a service pack, you will be prompted to reinstall the service pack near the end of the installation. When installing additional products on UNIX, you will be prompted to update your existing environment, or delete it and create a new environment.


Enrolling Nodelock Licenses After the Installation

Enrolling Nodelock Licenses After the InstallationThis task explains how to enroll nodelock licenses outside the installation procedure. On Microsoft Windows 95 OSR2, or Windows 98, network licensing is used, so this procedure does not apply to these platforms. 1. Log on as an administrator. 2. On Windows NT and Windows 2000 only, select the Start->Programs->CATIA ->Tools->Nodelock Key Management V5R4 command, or run the program:install_root\code\bin\CATNodeLockMgt

where "install_root" is the name of your installation folder which is, by default:C:\Program Files\Dassault Systemes\B04\intel_a

The "Enroll Product License (Nodelock)" dialog box appears:

Note that the target id of the computer on which you are performing the installation is displayed inside the dialog box. The File menu contains the following commands: Import Add Read Check Exit Note that you can display the tool without logging on as administrator, but you will not be able to use it. If you attempt to do so, you will be reminded that using the tool requires administrator privileges. 3. To import your electronic license certificate (if you have one), select the File->Import command. This displays a file selection box which opens with the C:Temp folder contents displayed:

Explore your filetree and select the license certificate file which uses the prefix ".lic", then click the Open button to import the certificate. This imports the license and creates the file named "Nodelock" (or updates the existing "Nodelock" file) in the default LUM environment:C:\ifor\ls\conf\nodelock



This procedure can be used both after installing for the first time and after installing additional products. 4. To add a license, select the File->Add command. This is useful when you do not have a license certificate file to import, and your license is sent to you on paper. The "Add License Manually" dialog box appears:

Type the following information (contained in your license on paper) in the appropriate fields: Version Password Serial Number There may or may not be a serial number, depending on the case: a serial number exists for all configurations: all configurations are custom configurations if you already have a custom configuration, you can extend it by adding products: in this case, a new license is provided, and the new license contains the same serial number as the original configuration a serial number does not exist for standalone (shareable) products. Annotation Comment Then, click the Add button to add the license. The "Nodelock" file is created or updated just as if you had imported a license certificate. 5. To read a license, select the File->Read command. This displays the license in the "Nodelock Key File Content" box:

6. To check whether your license is still valid, and check the number of days before your license expires, select the File->Check command to display the following dialog box:

Note that: a green light opposite the license serial number means that the license will still be valid for at least 30 days an orange light opposite the license serial number means that the license will still be valid for less than 30 days a red light opposite the license serial number means that the license has expired. If the license is still valid, the number of days left before the license expires is indicated. On UNIX 1. Log on as root.



2. To enroll licenses after the installation, go to your /CATEnv directory, then enter the following command to set up the environment:. /CATEnv/CATIA.V5R4.B04.sh (for Bourne or Korn shell) source /CATEnv/CATIA.V5R4.B04.csh (for C shell)

3. Enter the following command to display the " Enroll Product License (Nodelock)" dialog box: CATNodeLockMgt This command is located in the directory:/usr/DassaultSystemes/B04/OS_a/code/bin

where "OS_a" is: aix_a hpux_a irix_a solaris_a The user interface on UNIX is the same as the user interface on Windows described above. While not recommended, you can also enroll licenses after the installation by editing the nodelock file created by default in:/var/ifor/nodelock (AIX) /opt/lum/ls/conf/nodelock (HP-UX, IRIX, Solaris)


Installing the Online Documentation After Installing the Code

Installing the Online Documentation After Installing the CodeThis task explains how to install the online documentation after installing the code. Installing the Online Documentation On Your Computer on Windows Follow this procedure if you did not install the documentation during the code installation procedure. Installing the online documentation is very similar to installing the CATIA Version 5 software. 1. Log onto your computer. You do not need to have administrator privileges to install the online documentation. 2. Insert the CD-ROM. Unlike when installing the software, the documentation installation procedure does not start automatically. 3. Use the Windows (NT) Explorer to explore the documentation CD-ROM, and double-click the Setup.exe program on the CD-ROM to start the installation. 4. Follow the instructions. You will be prompted to specify the destination folder, or accept the default folder which is:C:\Program Files\Dassault Systemes\B04doc

5. Click OK. This sets up the documentation in the default folder. Uninstalling the Documentation on Windows 1. On the Windows desktop, select the Start->Settings->Control Panel, then double-click the Add/Remove Programs control. 2. In the Install/Uninstall dialog box, select the item "Dassault Systemes CATIA-EnglishDocumentation B04" (if the documentation is in English) from the list, then click the Add/Remove... button, then confirm when prompted.



Uninstalling the Documentation on Windows In Batch Mode Enter the command: C:\Winnt\IsUninst.exe -a -f"Doc_Install_Path\UninstXXXX.isu" where "XXXX" is the name of the documentation package, for example: CATIA-EnglishDocumentation. The IsUninst.exe program will be present if you have installed at least one Dassault Systemes or non-Dassault Systemes product using InstallShield in English. If you installed products using InstallShield in other languages, the following programs will be present, depending on the language: IsUn0407.exe: German IsUn040C.exe: French IsUn0411.exe: Japanese When installing additional documentation for the same CATIA version (for example, in another language), the additional documentation will be installed in the same folder. Installing the Online Documentation on Your Workstation on UNIX On UNIX, you cannot install the online documentation directly from within the code installation procedure, and there is no tool for installing the online documentation from the CD-ROM. To install the documentation, copy the contents of the CD-ROM into a directory with sufficient free disk space. You could, for example, copy the documentation files to the default directory:/usr/DassaultSystemes/B04doc

On UNIX, if you decide to install the documentation elsewhere than in the default location, you must update the value for the CATDocView variable in your default environment to specify the location of the documentation files. For more information, refer to "Managing Environments" .



Accessing the Online Documentation Directly From the CD-ROM Drive: Windows Insert the CD-ROM into the drive, then start a CATIA session and select the Help->CATIA V5 Help command. If you want to browse the documentation directly from the CD-ROM drive, and without running a CATIA Version 5 session, insert the documentation CD-ROM into the drive, access the device using the Windows (NT) Explorer, and double-click the following file (depending on the language) to display the CATIA Version 5 online documentation homepage: homepage.htm (English) Frenchhomepage.htm (French) Germanhomepage.htm (German) Japanesehomepage.htm (Japanese). Accessing the Online Documentation Directly From the CD-ROM Drive: UNIX Optionally, you may use the CD-ROM directly and set the value of the CATDocView variable to the CD-ROM mount point. If you want to consult the documentation directly from the CD-ROM drive, and without running a CATIA Version 5 session, insert the documentation CD-ROM into the drive, mount the CD-ROM where necessary, then use your HTML browser to open the following file (depending on the language) to display the CATIA Version 5 online documentation homepage: homepage.htm (English) Frenchhomepage.htm (French) Germanhomepage.htm (German) Japanesehomepage.htm (Japanese). Installing the Online Documentation on a Server: Windows You may want to install the documentation files on a server to save disk space. 1. Install the documentation files on a computer as explained above. 2. Log onto another computer where there are no documentation files. 3. Select the Start->Programs->Windows (NT) Explorer command to run the Explorer. 4. Select Tools->Map Network Drive... and map the appropriate network drive before starting a session. 5. Start a session and use one of the commands for obtaining help. For example, press F1 for contextual help. A dialog box will prompt you to specify the online documentation path. 6. In the dialog box, specify the path where the documentation is located. Installing the Online Documentation on a Server: UNIX



Copy the contents of the CD-ROM into a directory on the server with sufficient free disk space. You set up a documentation server the same way as you set up a CATIA Version 5 code server. For more information, refer to "Enabling User Access to the Software Over the Network".


Basic Tasks

Basic Tasks

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugbt0000.htm [5/23/2000 3:42:51 PM]

Starting CATIA Version 5

Starting CATIA Version 5


Starting a Session on Windows

Starting a Session on WindowsThis task explains how to start the default CATIA Version 5 environment on Windows. Method 1 1. On the Windows desktop, double-click the CATIA V5R4 environment shortcut . Method 2 1. On the taskbar, select the Start->Programs->CATIA->CATIA V5R4 environment shortcut. Method 3 1. On the taskbar, select the Start->Run... command, enter the command:cnext

or:cnext.exe

2. Click OK. Method 4 1. Open an MS-DOS window. 2. Change to the default folder in which you installed the product. The default folder is:C:\Program Files\Dassault Systemes\B04\OS_a\code\bin

where "OS_a" is: intel_a (Windows NT and Windows 2000 platform) win_a (Windows 95 OSR2 and Windows 98 platforms). 3. Enter the command:cnext

or:cnext.exe

file:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugbt0101.htm (1 of 3) [5/23/2000 3:43:07 PM]


Run the following command to get help on the different options:CNEXT -h

The options are: -env: specifies the name of the environment with which to start CATIA (for more information, refer to "Managing Environments"); by default, the default environment is started -e: starts CATIA and executes a command you specify -batch: starts CATIA in batch mode (an interactive session is not displayed) -c: starts CATIA and activates the workbench you specify -object: followed by object to load (between " ") when starting CATIA; for example, the following command runs CATIA and loads a CATPart document: cnext -object "e:\users\steve\Part1.CATPart" Or, followed by arguments between " "; for example, -object "arg1 arg2" -macro: starts the specified macro -admin: starts a session in administrator mode for the purpose of locking settings -h: displays help. Running Macros Using the CNEXT Command To start CATIA and run a macro automatically, run the command like this:cnext -env CATIA.V5R4.B04 -macro /tmp/Mymacro.CATScript

or like this:cnext -env

CATIA.V5R4.B04

-batch -macro /tmp/Mymacro.CATScript

if you want to run the macro in batch mode. Starting a Session in Administrator Mode To Lock Settings 1. Enter the command: cnext -env "my_env" -admin where "my_env" is the name of the environment, if you want to run CATIA in administrator mode for the purpose of locking settings. This prevents all users of that environment from changing the settings you locked. For more information, refer to "Locking Settings".




Starting a Session on UNIX

Starting a Session on UNIXThis task explains how to start the default CATIA Version 5 environment on UNIX. Method 1 1. On CDE desktops (AIX, HP-UX and Sun Solaris), open the Application Manager cabinet on the front panel. 2. Open the CATIA directory. 3. Double-click the CATIA V5R4 icon. On IRIX, access the CATIA tab Application Manager in the desktop, then double-click the CATIA.V5R4.B04 icon. Method 2 1. Log on as either root or end user. 2. Enter the following command to set up the environment required for startup:. ./CATEnv/CATIA.V5R4.B04.sh (for Bourne or Korn shell) source /CATEnv/CATIA.V5R4.B04.csh (for C shell)

You may want to add this line to your .profile file. This environment is created when the root userid performs the installation. 3. Enter the command:CNEXT

For information, this command is located in the directory:/usr/DassaultSystemes/B04/OS_a/code/bin/

where "OS_a" is: aix_a hpux_a irix_a solaris_a



Run the following command to get help on the different options:CNEXT -h

The options are: -e: starts CATIA and executes a command you specify -batch: starts CATIA in batch mode (an interactive session is not displayed) -c: starts CATIA and activates the workbench you specify -object: followed by object to load (between " ") when starting CATIA; for example, the following command runs CATIA and loads a CATPart document: CNEXT -object "/tmp/Part1.CATPart" Or, followed by arguments between " "; for example, -object "arg1 arg2" -macro: starts the specified macro -admin: starts a session in administrator mode for the purpose of locking settings -h: displays help. Method 3 1. Log on as either root or end user. 2. Enter the command:/usr/DassaultSystemes/B04/OS_a/code/command/catstart

where "OS_a" is: aix_a hpux_a irix_a solaris_a to start CATIA using the default environment.



Run the following command to get help on the different options: catstart -h The options are: -d: specifies another directory (other than $HOME/CATEnv) containing the environment -env: specifies a new environment name (for more information, refer to "Managing Environments") -object: followed by object to load (between " ") when starting CATIA; for example, the following command runs CATIA and loads a CATPart document: CNEXT -object "/tmp/Part1.CATPart" Or, followed by arguments between " "; for example, -object "arg1 arg2" -macro: used with -object, this argument starts a session and runs the macro whose name you specify -batch: used with -object, this argument runs macros in batch mode (an interactive session is not displayed) -run: followed by the program to start (CATNodelockMgt, CATSoftwareMgt, for example); if this option is not specified, CATIA is started by default; this option is also used to start other product lines. If the program you want to start requires parameters, you must enclose the program name and the parameters between " ". For example, the following command: catstart -run "CATSoftwareMgt -L" lists the installed configurations and/or products on your workstation. -s: non-verbose mode -h: displays help. Running Macros Using the catstart Command To start CATIA and run a macro automatically, run the command like this: catstart -d $HOME/CATEnv -env CATIA.V5R4.B04 -object "-macro /tmp/Mymacro.CATScript" or like this: cnext -env CATIA.V5R4.B04 -object "-batch -macro /tmp/Mymacro.CATScript" if you want to run the macro in batch mode. Starting a Session in Administrator Mode To Lock Settings



Enter the command: catstart -run "CNEXT -admin" if you want to run CATIA in administrator mode (using the default environment) for the purpose of locking settings. This prevents all users of that environment from changing the settings you locked. You could also enter the command: CNEXT -env "my_env" -admin where "my_env" is the name of the environment. For more information, refer to "Locking Settings".


Starting a Session Using Document Icons

Starting a Session Using Document IconsThis task explains how to start a session using icons for existing documents. Method 1 1. Locate the document icon using your platform's Explorer (Windows) or File Manager (UNIX). The icons look like this: this is a Part Design document icon: this is an Assembly Design document icon: this is a Generative Drafting document icon: this is a CATIA Version 4 model icon: 2. Double-click on the icon. .

This will run CATIA Version 5, open the document and activate the workbench used to create the document originally. Method 2 1. Drag and drop a document icon onto the CATIA V5R4 environment icon on your desktop (Windows only). Method 3 1. Drag and drop a document icon onto an open CATIA Version 5 window. Note that this possibility is not available on IRIX.


Starting a Session in a Language Other than English on Windows

Starting a Session in a Language Other than English on WindowsThis task explains how to start CATIA Version 5 in a language other than English on Windows. Installing CATIA Version 5 installs the user interface files for all supported languages: English (default language) French German Japanese. You then simply use the tools on your operating system to choose the language in which you want to start your session. If no language is chosen, your session will be started in English. On Windows 1. On Windows, select the Start->Settings->Control Panel command, double-click the Regional Settings control, then click the Regional Settings tab (if it is not displayed by default). The following dialog box appears:



In our example above, English is selected. 2. Select the desired language from the languages available on the list. For example, selecting any of: French (Belgian) French (Canadian) French (Luxembourg) French (Standard) French (Swiss) will start the session in French. The same applies to the other language variants. Note that The Regional Settings tab does not activate your input locale: for example, it does not activate the keyboard map for the language you selected. 3. On Windows NT only, click the Input Locales tab if you want to select the input locale for your language. The Input Locales tab is displayed. 4. Select the appropriate input locale. In our example below, you selected French (Standard).



5. Click OK, then start CATIA Version 5.


Starting a Session in a Language Other than English on UNIX

Starting a Session in a Language Other than English on UNIXThis task explains how to start CATIA Version 5 in a language other than English on UNIX. Installing CATIA Version 5 directly installs the user interface files (message catalogs) for the following languages: English (default language) French German Japanese The user interface files for the French, German and Japanese languages are already translated for you. If you install in the default installation directory:/usr/DassaultSystemes/B04/OS_a/

where "OS_a" is: aix_a hpux_a irix_a solaris_a the following default environment is set up:/usr/DassaultSystemes/B04/OS_a/resources/msgcatalog (containing the English files) /usr/DassaultSystemes/B04/OS_a/resources/msgcatalog/French /usr/DassaultSystemes/B04/OS_a/resources/msgcatalog/German /usr/DassaultSystemes/B04/OS_a/resources/msgcatalog/Japanese

This default environment (/usr/DassaultSystemes/B04/OS_a/resources/msgcatalog) is pointed to by the environment variable: CATMsgCatalogPath. What about the other languages? Installing the software also sets up in:/usr/DassaultSystemes/B04/OS_a/resources/msgcatalog

a subdirectory for each additional language supported (but for which translated user interface files are not provided). The list of languages is: Czech Polish Russian Korean Simplified Chinesefile:///E|/users/ses/Adele/SESV5R4/BasEnglish/basug.doc/src/basugbt0105.htm (1 of 3) [5/23/2000 3:43:31 PM]


For example:/usr/DassaultSystemes/B04/OS_a/resources/msgcatalog/Russian /usr/DassaultSystemes/B04/OS_a/resources/msgcatalog/Czech /usr/DassaultSystemes/B04/OS_a/resources/msgcatalog/...

How do I run CATIA Version 5 using translated files? Copy the file to be translated from:/usr/DassaultSystemes/B04/OS_a/resources/msgcatalog

to:/usr/DassaultSystemes/B04/OS_a/resources/msgcatalog/Russian

and translate the file. When you run a CATIA Version 5 session, your translated files will be loaded. What about the fonts for these languages? The installation also sets up in each language directory a file named "Dialog". This file contains all the font declarations for use as is, for the language and locale you want to use (we have chosen the same fonts as used in CATIA Version 4 to facilitate the transition to CATIA Version 5). If you want to use other fonts, comment out the previous font declarations and declare the new fonts. The file also contains other user interface texts. You then simply use your operating system tools to choose the locale in which you want to start your session. If no locale is chosen, your session will be started in English. 1. Open a shell window. 2. Export the LANG variable for the desired locale before starting a session. For example, for the French language, enter this command on AIX:export LANG=fr_FR

this command on HP-UX:export LANG=fr_FR.iso88591

this command on Sun Solaris and IRIX:export LANG=fr

3. Start CATIA Version 5.




Getting Help

Getting Help


Displaying Tooltips and Help Messages

Displaying Tooltips and Help MessagesThis task explains how to display tooltips and the corresponding help messages. 1. Point to an icon. The tooltip is displayed in a small box, with the corresponding message in the status bar.

You can switch tooltip display on and off using the Tooltips option of the Options tab in the Tools->Customize... command, or by right-clicking any toolbar and selecting the Customize... command to access the Options tab. But you have to restart a session to take the new settings into account.


Using the What's This? Command

Using the What's This? CommandThis task explains how to use the What's This? command to get help on toolbar icons. 1. Click the What's This? icon or select the Help->What's This? command.

The cursor takes on the shape of the What's This? icon. 2. Point to an icon, then click the icon. This displays a long help message in a box:


Accessing the Online Help Library

Accessing the Online Help LibraryThis task explains how to access the online help library. The CATIA Version 5 documentation is totally Web oriented, using HTML, GIF and JPEG standard formats, allowing easy access and navigation using a standard Web browser. Navigation aids includes full text searching and a framed layout allowing a direct access from the table of contents to the information. 1. Select the Help->Contents, Index and Search command. The welcome page of the CATIA Version 5 online help library is displayed, and a short animation runs while the page is loading:



If you installed the online documentation in the default location, the welcome page will be displayed immediately. If you installed the online documentation elsewhere, you must first update the CATDocView variable in your environment to reference the environment containing the online documentation. If you do not reset the CATDocView variable, a dialog box will prompt you to specify the location: if you installed the online documentation locally on your computer, you can specify a path like this, for example, on Windows:C:\online_doc_folder

where "online_doc_folder" is the name of the folder in which you installed the online documentation. if you installed it elsewhere on the network, you must first map the appropriate network drive before starting a session, then specify a path as above when prompted. Doc Installation Path In the General tab, accessible via the Tools->Options command, the "Doc installation path" field for the CATIA Documentation Location option displays the path of the folder in which the online documentation is installed. The path is the same path you entered when installing the online documentation: the path displays the value of the CATDocView environment variable. When you request help using the Help->Contents, Index and Search command (or press the F1 key for contextual help), the online documentation may not be displayed. This may be because the online documentation may have been physically moved to another location. If the online documentation is not found, the following dialog box appears:

Browse to select the online documentation location. Selecting the location updates the "Doc installation path" field for the CATIA Documentation Location option, in the General tab accessible via the Tools->Options command. Note: You can also type the location in the "Doc installation path" field for the CATIA Documentation Location option. You must enter the real location; otherwise, the path you enter will be ignored. Note that UNC (Universal Naming Convention) names on Windows is allowed. For example, you can specify the following path type:\\remote_computer\online_doc_folder

2. Point to the different icons to the left to display the icons for the corresponding online users guides, then click on the icon of your choice to access the documentation. 3. Click the Infrastructure icon to get familiar with CATIA Version 5 fundamentals, or the icon for the workbench you need information about. In each case, the information you require is displayed in a framed layout:



4. Select the Home button to return to the home page. The Home page provides access to the following: the Index button to access the indexes for all the workbench documentation the Print button to print user guides in PDF format. To print the documentation, click the Print icon. This opens a similar home page. Click on the icon for the product whose documentation you want to print. This opens a PDF version of the documentation using Acrobat Reader. To print the documentation, use the Acrobat Reader File->Print... command. the Search button to perform a full text search throughout the online library: for more information about searching, refer to "Searching the Online Help Library".




Searching the Online Help Library

Searching the Online Help LibraryThis task explains how to perform full-text searching in the online help library. The CATIA Version 5 documentation is totally Web oriented, using HTML, GIF and J