CADverter/CADviewerInstallation Guide for UNIX

Version 9.0

This software and related documentation are proprietary to Theorem Solutions Limited.© Copyright 2005 Theorem Solutions Limited

Theorem Solutions Limited,Tame House,

Wellington Crescent,Fradley Park,Staffordshire,WS13 8RZ,ENGLAND

Telephone: +44 (0)1543 444455Fax: +44 (0)1543 444454

e-mail sales@theorem.co.ukwww.TheoremSolutions.com

CADDS4X and CADDS5 are registered trademarks of PTC.ACIS is a registered trademark of Dassault Systemes.CATIA and CATIA V5 are registered trademarks of Dassault Systemes.I-DEAS is a registered trademark of UGS.UNIGRAPHICS is registered trademark of UGS.PARASOLID is a registered trademark of UGS.Icem is a registered trademark of ICEM TechnologiesCADverter is a registered trademark of Theorem Solutions Limited.CADviewer is a registered trademark of Theorem Solutions Limited.FLEXlm is a registered trademark of Macrovision CorporationNetscape Navigator is a registered trademark of AOL Time Warner

Table of Contents Section 1 - About this manual........................................................................................... 5 1.1 Purpose and scope................................................................................................................................... 5

Section 2 - Preparing for Installation................................................................................ 6 2.1 Introduction............................................................................................................................................... 6 2.2 Prerequisites.............................................................................................................................................. 6

Prerequisites CD........................................................................................................................... 6 Java Runtime Environment........................................................................................................... 6 HTML Browser.............................................................................................................................. 6 Unigraphics Translators................................................................................................................ 6 Catia V5 Translators..................................................................................................................... 6 IDEAS Translators........................................................................................................................ 6

2.3 Software Installation Directory................................................................................................................. 7 2.4 Alternative Installation Directory ............................................................................................................ 7 2.5 Determine the Machine ID......................................................................................................................... 7 2.6 Request License........................................................................................................................................ 8 2.7 Editing the FLEXlm license file................................................................................................................ 8

Section 3 - Installing the Software.................................................................................... 9 3.1 Introduction............................................................................................................................................... 9 3.2 Install the FLEXlm license file.................................................................................................................. 9 3.3 Mount the CD-ROM................................................................................................................................. 10 3.4 Installation of CADVerter........................................................................................................................ 10 3.5 Installation of Java runtime environment & 3D extensions................................................................. 16

Section 4 - CADverter HTML Documentation................................................................. 18 4.1 Introduction............................................................................................................................................. 18 4.2 Installation directory............................................................................................................................... 18 4.3 Viewing the manuals Off-Line................................................................................................................ 18 4.4 Viewing the manuals On-Line................................................................................................................ 18 4.5 Guides...................................................................................................................................................... 19

Section 5 - Configuring the Environment....................................................................... 20 5.1 Introduction............................................................................................................................................. 20 5.2 Setting Environment Variables............................................................................................................... 20 5.3 Common Environment Variables........................................................................................................... 20 5.4 Parasolid Environment Variables........................................................................................................... 21 5.5 STEP Environment Variables................................................................................................................. 22 5.6 Unigraphics Environment Variables...................................................................................................... 22

Section 6 - FLEXlm Licensing......................................................................................... 24 6.1 Introduction............................................................................................................................................. 24 6.2 Overview.................................................................................................................................................. 24 6.3 Loading the FLEXlm Software................................................................................................................ 24 6.4 The License File ..................................................................................................................................... 24 6.5 Starting the License Manager................................................................................................................ 25 6.6 Stopping the License Manager.............................................................................................................. 25 6.7 Checking the License Manager.............................................................................................................. 25 6.8 FLEXlm On-Line Documentation........................................................................................................... 26

Section 7 - Testing the Installation................................................................................. 27 7.1 CADverter Installation Testing............................................................................................................... 27

3 of 29

7.2 CADviewer Installation Testing.............................................................................................................. 27 7.3 Using I-DEAS Products........................................................................................................................... 28 7.4 Troubleshooting: Common Problems................................................................................................... 28

4 of 29

Section 1 - About this manual

1.1 Purpose and scope

This document covers the installation of CADverter software from Theorem Solutions Limited into a UNIX environment. It also details the FLEXlm Software License Manager set-up processes and the requirements for configuring and maintaining the CADverter license processes. In addition this document details the installation and usage of CADverter on-line documentation.

5 of 29

Section 2 - Preparing for Installation

2.1 IntroductionThere are several items to be considered before the Theorem software can be properly installed and run. While this manual cannot cater for all of the different computer configurations, it will try to give pointers to some of the obvious things that need to be configured.

2.2 Prerequisites

Prerequisites CDTheorem supplies a general prerequisites CD and specific UG independent library CD’s that provide all third party software to support our installations.

Java Runtime EnvironmentThe Theorem CADverter, CADviewer and DXN products require a version of the Java runtime environment to be present. The CADviewer, specifically, requires the Java 3D extensions to be loaded in addition to the basic Java runtime Environment.

To avoid compatibility issues the correct version is provided on the prerequisites CD and must be installed into the Theorem installation directory subsequent to the installation of Theorem products

In addition, here are some web sites that will provide you with more information regarding Java downloads and installation.

HP-UX - www.hp.com/products1/unix/java/java2/sdkrte14/index.html

SGI Irix - www.sgi.com/software/java

Sun Solaris, Windows - www.java.sun.com/j2se/1.4.2/download.html

IBM AIX - www.ibm.com/developerworks/java/jdk/aix/service.html

HTML BrowserTheorem’s documentation is in html form and requires that a suitable browser is available on the user’s workstation. The Netscape and Mozilla browsers are supported by default. The user should be able to invoke a browser via the ‘netscape’ or 'mozilla’ command. If required, a browser can be installed from Theorem’s prerequisites CD.

Unigraphics TranslatorsA Unigraphics installation is required. This can be an installation of the Unigraphics product or can be independently supplied by Theorem Solutions Ltd.

Catia V5 TranslatorsA Catia V5 installation is required for CAA based CADverters.

IDEAS TranslatorsAn IDEAS installation is required.

6 of 29

2.3 Software Installation DirectoryThe CADverter software product range contains a large number of bi-directional translators, e.g. CATIA<>UNIGRAPHICS or CATIAV5<>CADDS. On average each bi-directional translator requires approximately 32Mb of disk space for installation. Therefore in order to plan for the software installation you will require 32 x Number of translators Mb of free disk space available. By default the installation directory for the CADverter software is /usr/theorem, however this can be overridden during installation when prompted.

Theorem Solutions recommends that if an alternative installation directory is required it should be achieved by the creation of a UNIX symbolic link from the desired directory location linked to the default directory. This is achieved by using the UNIX ln command. Assuming that the desired directory is in existence and the default directory does NOT exist, issue the following command:

unix-shell% ln –s /my/desired/directory /usr/theorem

Using this method overcomes the need to modify and maintain any of the supplied default files or operational settings.

2.4 Alternative Installation Directory If you install the CADverter software into an alternative installation directory it will be necessary to copy the file named .tsrc from the actual installation directory into the home directory of all intended CADverter users.

2.5 Determine the Machine IDTo facilitate the license management process it is necessary to acquire the unique characteristics of the specific system in operation. Therefore working from the UNIX shell prompt issue the following commands to determine both the machine unique identifier and machine specific name.

Machine Name:unix-shell% hostnametscpc06

Note the output, copying the text case exactly, this represents the machine-specified name, referred to by Theorem as the machine hostname.

Machine Identifier:

If you have already installed the CADverter software then you can use the supplied license management command. Assuming you have installed the software in the default directory of /usr/theorem, alternatively you will find the command in the directory flexlm within your installation directory;

unix-shell%/usr/theorem/flexlm/lmhostidlmhostid – Copyright © 1989-2003 by Macrovision Corporation. All rights reserved.The FLEXlm host ID of this machine is “8090a037”

Note the output between the quote marks, shown highlighted in the example, this represents the machine unique identifier, referred to by Theorem as the machine hostid.

Alternatively this information can be determined using the appropriate UNIX command, this is specific to the relevant hardware platform; Sun Microsystems:- unix-shell%hostid

8090a037Silicon Graphics:- unix-shell%echo `sysinfo –s` 16o p | dc

6902B0FFHewlett Packard:- unix-shell%echo `uname –i` 16o p | dc

77855EE1IBM RS6000:- unix-shell%uname –m

001490874C00 (Remove any leading and trailing zeros)

7 of 29

2.6 Request LicenseOnce these have been successfully identified both the HOSTNAME (e.g. tscpc06) and the HOSTID (e.g. 8090a037), shown highlighted in the previous section, you are in a position to request a CADverter software license. Complete the supplied LICENSE FAX-BACK FORM and return it to Theorem Solutions Sales Office for processing, alternatively contact your software provider for assistance.

2.7 Editing the FLEXlm license fileYour license file will usually be sent to you by E-mail, FAX or floppy disk. It will contain other text such as instructions on how to load it; this text will not affect the running of the license file. If you need to edit the file on the floppy or E-mail please make a copy of the file first in case you make any mistakes.If you receive the file by FAX you will need to use vi or some other text editor to enter the data. When creating the file in this manner you must ensure that you enter all the data matching upper and lower case text.

An example license file is shown below:Example License file

SERVER tscpc06 8090a037 7601DAEMON theorem /usr/theorem/flexlmINCREMENT Cadds_Catia theorem 8.0 28-jun-2005 1 FD107DA4A8513C460E1A \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT Cadds_GCO theorem 8.0 28-jun-2005 1 AD508D749E14137F62FE \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT Catia_Cadds theorem 8.0 28-jun-2005 1 DDB03DD4A768AEC42403 \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT Catia_GCO theorem 8.0 28-jun-2005 1 1DD08D0456D95AE0E8E0 \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT GCO_Cadds theorem 8.0 28-jun-2005 1 5D00AD44484C311579F1 \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT GCO_Catia theorem 8.0 28-jun-2005 1 5D208DB457A1F9D7E756 \

VENDOR_STRING=cut_by_theorem_solutions_ltd

Only the important lines are shown in this example. They are split up into three types:1. SERVER followed by the HOSTNAME (tscpc06), the HOSTID (8090a037) and the PORTID (7601) the

HOSTNAME may need to be changed when you receive the file to match your machine HOSTNAME. It must also be changed if you change your machine name. The HOSTID must match the address of your machine. If you change your processor then the license will no longer function and must be re-cut by your software provider.

2. DAEMON followed by the path to the License server daemon executable. If you have installed the CADverter software in a path other than /usr/theorem then you must edit this line to reflect the location of the flexlm/theorem file.

3. INCREMENT followed by the feature name (e.g. Cadds_Catia) and other license data to protect the feature. These lines must not be edited or the INCREMENT will not work.

Note! Text may be wrapped over more than one line. When this occurs the continuation character is denoted by a '\'. The continuation line must then start with a 'tab'.

Once the license file is available you can continue to install the CADverter software or if necessary start the FLEXlm license manager.

8 of 29

Section 3 - Installing the Software

3.1 IntroductionThere are four discrete steps to the installation of Theorem software.

1. Installation of the FLEXlm license file2. Installation of the Software3. Installation of the Java runtime environment and 3D extensions.4. Configuration of the CADverter Environment5. Management of the FLEXlm License Processes

This Section covers “Installation of the Software”and “Installation of the FLEXlm license file“(3.2), Section 5 addresses “Configuring the CADverter Environment” and Section 6 describes “Management of the FLEXlm Software License Processes.”

By default the installation process will use the /tmp directory as a working directory to prepare data before installing the data into the actual install directory. Problems may occur during installation when the available disk space is smaller than required. This may be overcome by setting the environment variable TS_TEMP_DIR to a disk partition with more free space. This must be done in the shell that will run the INSTALL process.

3.2 Install the FLEXlm license fileThe installation process can determine, automatically, from your license file which products you should install. In order for this to happen you must first install your license file.

Having decided the intended installation directory (see 2.2), create the sub-directory flexlm e.g. for a default installation create the directory /usr/theorem/flexlmInstall the supplied license file into this directory and ensure that the file name is license.datThe installation process will then read this file and automatically select the products that you have a valid license for, in the product selection list.

If you do not have a license file available you are still able to install the CADverter software. However it would be necessary to identify which CADverter items you would be intending to use and you would also need to invoke the FLEXlm License Manager processes at a later date. Refer to Section 6 for instructions.

9 of 29

3.3 Mount the CD-ROMInsert the CD-ROM into your CD-ROM drive and perform the appropriate command to mount the CD-ROM for read-only access.

Depending upon the operating system and techniques employed will mean this action is performed either manually via the mount command or automatically via a process such as the Volume Management utility of Solaris.

Whichever method is used will result in a CD-ROM mount point, frequently named either /cdrom or /cdrom/label, where label is the given CD label. On some systems the mount point directory will be named in upper case, e.g. /CDROM, these variations are both hardware and system configuration specific. If you are in any doubt contact your Systems Administrator or Hardware Supplier for assistance.

For the purposes of this manual we will assume the mount point name is /cdrom/ and will refer to it within this documentation as /CDROM_MOUNT_POINT

3.4 Installation of CADVerterInsert the Theorem Solutions CADverter CD-ROM into your CD-ROM drive. If you are using a Graphical File Manager utility, such as shown in the example below, then double-click the INSTALL icon within the /CDROM_MOUNT_POINT directory.

Alternatively if you prefer you can use a unix shell and invoke the installation process. Begin by setting the current directory to the /CDROM_MOUNT_POINT

unix-shell% cd /cdrom/unix-shell% ./INSTALL

Either method will begin the CADverter Software Installation process. The first question that you need to respond to asks you to confirm the path to the /CDROM_MOUNT_POINT. You can either enter ‘y’ to accept the offered pathname or alternatively enter ‘n’ to continue and define the alternative path you want to use to find the software to be installed.

10 of 29

Having confirmed the /CDROM_MOUNT_POINT the process will now launch the Software Installation Interface.

The “Welcome” screen of the Software Installation Interface will identify the specific CD reference number together with the release number of the CD. In addition it will identify the CADverter Version number for main products found on the CD.

The reference number and the Version of the CD you receive will be an updated number and version (e.g. CD2102.2.01) and so different to the example given.

You are now able to continue the installation process by selecting “Next Page”. Selecting “Abort Installation” will exit the installation process.

11 of 29

The “Information” screen offers information regarding the content of the CD by displaying the README.TXT file from the CD. This file details the specific products that can be found for all supported operating systems, together with information regarding contacting Theorem Solutions direct.

Having reviewed the file continue the process by pressing the “Next Page” button. Note you will be allowed to return to any of these screens by pressing the “Back” button.

This screen displays the current platform being used to perform the installation together with the default installation directory, /usr/theorem.

To install software for use on a different operating system to the active one, select the list dialog against the “Install Products for Unix Platform” label. This will then set the installation to extract versions of the software suitable for the specified operating system.

As well as specifying the Unix platform you can also limit the installation to be those products that are available to use at a specific lower operating system version. By default the Installation Process will allow all products to be installed irrespective of operating system version. To change this condition select the list dialog against the “Limit products to this OS version” label and identify the specific OS version available.

12 of 29

Your system configuration may be such that you will be executing the CADverter application on one Unix architecture while the FLEXlm license will be installed onto a different machine with a different Unix architecture.Therefore to install the FLEXlm License Manager for use with a different operating system than the one currently in use perform a separate installation of FLEXlm for the required operating system.

If you want to install the CADverter software into a different installation directory from the default /usr/theorem, select the “Browse” button and use the file selector panel to identify the required alternate installation directory.

You have the option to install Applications (“Install Theorem Solutions Applications”) and Flexlm (“Install FLEXlm License Software”) at the same time or independently. You can choose how these items are installed by selecting/deselecting the checkboxes. The default is to install both Applications and Flexlm at the same time. Having completed the page, select “Next Page” to continue.

You will now see a complete list of available products for the selected operating system, this list may also be constrained to a specific version of the operating system. You are now able to select the products you want to install. If you cannot see the required product in the viewable screen, use the slider bar on the right hand side to enable the full list to be viewed.

Assuming that you have previously installed the FLEXlm license file and configured the license environment the components you are licensed to use will already be selected. This can be seen on the following screen with the licensed items marked with a tick selection (). To select items for installation simply double-click with the mouse the item required.

Having selected the Components required press the “Next Page” button to continue with the installation.

The next screen you will see will be the “Confirm Settings” screen. Review the items selected for installation, if all the items you require are listed press the “INSTALL” button to begin the actual installation.

13 of 29

You will then see a screen monitoring the progress of the installation.

Finally you will see the “Installation Results” screen. This screen will confirm that the software has been installed

14 of 29

or detail any issues found during installation. You may also review any issues found by reading the file /tmp/tscprogressxinstall which is created for all installations.

When the installation is completed you will find the following files and sub-directories within the installation directory:

.tsrc User file to be copied to the home directory of all potential users.

Motif_support Solaris installations ONLY, Motif support libraries.bin Contains the Theorem executables.data Supporting data for CADverter applications.help User On-Line documentation files.guides Installation and Release documentsflexlm FLEXlm license management directorysamples Sample data files for all CAD systems.scripts Directory of all application start-up scripts.shlib Location of shared libraries needed for Theorem

applications.

15 of 29

3.5 Installation of Java runtime environment & 3D extensions

When the installation of the CADverters is complete you must install the Java runtime environment & 3D extensions. A message to prompt will be given in the command line window . The necessary Java runtime environment and 3D extensions are provided on the Java support and prerequisites CD. You will need to unmount the Theorem product CD. This is usually achieve by the command umount /CDROM_MOUNT_POINT

unix-shell% umount /cdrom

and then mount this CD (see previous example) and run the INSTALL process.

unix-shell% cd /cdrom/unix-shell% ./INSTALL

This will prompt for the location of the mounted CD and for the location of the Theorem install appropriate defaults should be available.

16 of 29

17 of 29

Section 4 - CADverter HTML Documentation

4.1 IntroductionUser manuals are mostly supplied in HTML format. For Unix users, to read these manuals on-line it is necessary to obtain a copy of Netscape Navigator or the Mozilla browser. These are freely available for all Unix platforms from the Internet sites http://www.netscape.com or http://www.mozilla.org

The HTML documents may be viewed off-line using any HTML browser that supports HTML Frames.

The exception to this is manuals that are provided for the ProductView suite of translators. In this case, documents are provided in .pdf format. Users will require a copy of the Adobe Acrobat Reader to be available to read these documents. This is freely available for all Unix platforms from the Internet site http://www.adobe.com/acrobat.

4.2 Installation directory.The documents and supporting images will be installed into the help sub-directory of the CADverter installation directory. For example, in a default installation these files would be stored in /usr/theorem/help.

4.3 Viewing the manuals Off-Line.To view the CADverter documentation Off-Line point your browser at the file bookshelf.htm in the documentation directory. For a default installation this file name will be /usr/theorem/help/bookshelf.htm. An alternative to this is by using the file helpmain.html under the CADverter installation directory

Figure 4.3.1 showing the “bookshelf.htm” file within Netscape.

4.4 Viewing the manuals On-Line.To enable the CADverter process to launch Netscape Navigator, the Unix path variable must contain the search path to the Netscape executable.

Most CADverter Graphical User Interface panels contain a button marked “Help”. Selecting this button will open the relevant HTML document and locate the required section for the user to review.

18 of 29

Figure 4.4.1 Showing CADverter interface and Netscape with document page loaded.

From this position you are able to browse back and forth through the manual reviewing any sections necessary. The Netscape view is in two frames; the left-hand frame will contain an index into the right-hand frame. The right-hand frame contains the main text.

4.5 Guides.Documents of a more general nature can be found in the guides sub-directory of the installation. These include this document (Installation guide) and release notes for the particular release of the software. These are in “pdf” format and will require Adobe Acrobat reader to view. This is available for free for all platforms from http://www.adobe/acrobat.

19 of 29

Section 5 - Configuring the Environment

5.1 IntroductionOnce the CADverters have been installed, it may be necessary to change some of the environment variable settings. Each CADverter has its own environment variables and parameters that can be set to improve or refine the translation process. These are detailed below.

5.2 Setting Environment Variables The CADverter products all have default translation characteristics, most of which can be overriden by either the use of Graphical User Interface (GUI) button selections or command line arguments. Some characteristics are overriden by setting new values to system defined environment variables.

The supplied application scripts cover using the product via the GUI. The scripts are all written using the C shell language. During the startup of the application the supplied scripts will check for the existence of the file named .tsrc located within the users home directory.

To configure an application to operate to suit your specific requirements check the list of available environment variables and potential settings and add the required settings to the .tsrc file. Remember to use the C shell syntax for any user settings and also ensure that you don’t change any of the existing settings by error.

The syntax for setting environment variables using C Shell Syntax;

unix-shell% setenv variable_name value

Alternatively, the CADverter products can be run directly using the appropriate executable or script. All required environment variables must be set in the environment that the CADverter executable is run in.

5.3 Common Environment VariablesTS_INST -Theorem Solutions Installation directoryThis variable identifies the installation location of the Theorem translator software and is set by default in the sample .tsrc file at install time.

e.g. setenv TS_INST /usr/theorem

THEOREM_LICENSE_FILEThis variable identifies the location of the FLEXlm license file. It may be set to the location of the file on the current machine. Alternatively if the FLEXlm license server is running on a remote machine, the variable may be set to server_portid@server_hostname

e.g. setenv THEOREM_LICENSE_FILE 7601@tscpc06

TSC_PROG_FILE - (Command Line Only)During the translation process a progress file detailing the conversion of each element within the input CAD file from its native data into a Generic Cad Object (GCO) and subsequently from its GCO form into the target system format. This audit trail is recorded in an ASCII text file with the following default name /tmp/tscprogressxy where x is the product code for the source system and y is the product code for the target system derived from the following table:-

20 of 29

Product code

System Product code

System

0 Cadds d PVS1 Catia e ICEM3 SC03 h STEP AP2145 Unigraphics i DirectModel6 Parasolid j ProductView8 Acis m ProE9 STEP AP203 n Granitea GCO r ICADb Catia5i t STEP AP209c I-DEAS MS y Catia V5

Therefore assuming a Catia to Cadds translation the default name of the progress file will be /tmp/tscprogress10. This default name can be overridden by setting the environment variable TSC_PROG_FILE to an alternate value

E.g. setenv TSC_PROG_FILE /data/partname.log

The progress file name may also be changed using the Command Line Interface,

E.g. progress_file /data/partname.log

TSC_TEMP_DIRUsed by most aspects of Theorem Solutions products to identify the file system that will be used to create any temporary working data. By default this will be set to /tmp. To set this variable to an alternative disk partition, enter the following:

E.g. setenv TSC_TEMP_DIR /largedisk/freespace

5.4 Parasolid Environment VariablesThe following environment variables are optional and are set using the method described in Section 5.2.

P_SCHEMAThe software provided will read and write Parasolid files of the same version as the version of Parasolid used to build the products. If you wish to read or write Parasolid files of an earlier version you must set up the P_SCHEMA environment variable. By default this variable will be set as follows:

E.g. setenv P_SCHEMA /usr/theorem/data/ps_schema

TSC_PS_ROLL_SIZEDuring Parasolid processing, the translator will occasionally create a ROLLBACK file so that if errors occur it can revert back to a previous point in the processing. This environment variable allows the maximum size of the ROLLBACK file to be changed from the default of 10Mb. It should not normally be required, but may be if a run fails because a ROLLBACK file needs to be larger than 10Mb. Its other use is when there is only a small amount of disk space available and a 10Mb file would cause disk space problems. If used, this variable requires an integer number of Mb, between 1 and 100.

E.g. setenv TSC_PS_ROLL_SIZE 50

TSC_PS_MAX_SIZE If large models are being processed, there is potentially a large amount of Parasolid data held in the CADverter’s memory. This causes the Parasolid processing to slow down and makes conversion times very long. This variable can be set to an integer number of Mb that will limit the size of the Parasolid file produced, hence removing Parasolid data from memory. When an entity has been processed, the converter will check the estimated file size against the limit supplied by TSC_PS_MAX_SIZE. If the estimated file size is greater than the limit, the converter will produce a Parasolid file containing the entities processed so far which has a number appended to the supplied Parasolid filename. For example, if the filename supplied was ps_test then the first file produced will be ps_test-01.x_t for NT or ps_test-01.xmt_txt for Unix. This will continue until all the entities have been processed.

21 of 29

E.g. setenv TSC_PS_MAX_SIZE 2

5.5 STEP Environment VariablesThe following environment variables are for use with the STEP products and are set in the same way as those in Section 5.2.

TSC_STEP_LINE_SIZESpecifies the limit on the number of characters per line in the STEP file to be created when writing a STEP file. If not used then 72 characters per line will be assumed.

E.g. setenv TSC_STEP_LINE_SIZE 60

TSC_STEP_REAL_ZEROSpecifies a value below which any value encountered which is to be written to a STEP file, will be printed as zero (0) in the STEP file. This is to keep the size of the files down. If not used then values below 0.0000000000001 will be printed as zero.

E.g. setenv TSC_STEP_REAL_ZERO 0.000001

TSC_STEP_RTOLSpecifies a rounding tolerance for real numbers written to a STEP file. Any real numbers greater than the given tolerance which are also within the given tolerance of NUM.ABC (a decimal value with 3 significant digits) will be written to the STEP file as NUM.ABC. If not specified then a default tolerance of 0.00000001 will be used. For example, with the default tolerance in force, the number 245.677999996 will be written to the STEP file as 245.678.

Note! Care should be taken when setting this variable as large values will have a detrimental effect on the resultant quality of solids data.

E.g. setenv TSC_STEP_RTOL 0.000000001

TSC_STEP_PREC1Specifies the precision of numbers greater than 1 (the number of decimal places to print out when writing to a STEP file). If not used, then a value of 9 is assumed.

E.g. setenv TSC_STEP_PREC1 6

TSC_STEP_PREC2Specifies the precision of numbers less than 1 (the number of decimal places to print out when writing to a STEP file). If not used, then a value of 12 is assumed.

E.g. setenv TSC_STEP_PREC2 8

5.6 Unigraphics Environment VariablesThe following environment variables are for use with the UNIGRAPHICS products and are set in the same way as those in Section 5.2.

e.g. setenv UGII_LICENSE_FILE /usr/ugsxxx/ugii/ugflexlm/license.dat or setenv UGII_LICENSE_FILE 27000@ server_hostnamee.g. setenv UGII_BASE_DIR /usr/ugsxxxe.g. setenv UGII_ROOT_DIR /usr/ugsxxx/bin/

xxx depends on the version of Unigraphics being used. For NX 1 it is normally 190 and for NX 2 it is normally 020.

Unigraphics Shared Libraries

22 of 29

CADverter makes use of the Unigraphics User Functions to support both reading and writing of Unigraphics data. Accordingly, the Unigraphics Runtime Environment must be accessible from the machine performing the translation. This runtime environment is found within all installations of the Unigraphics product or can be independently supplied by Theorem Solutions Ltd.

In order for the CADverter to reference these libraries certain environment variables must be set. The specific name of the environment variable is dependent upon the operating system being utilised;

Sun Microsystems:-e.g. For NX 1.0, setenv LD_LIBRARY_PATH ${UGII_BASE_DIR}:/usr/ugs190/ugii/uglibse.g. For NX 2.0, setenv LD_LIBRARY_PATH ${UGII_BASE_DIR}:/usr/ugs020/ugiiSilicon Graphics:-e.g. For NX 1.0, setenv LD_LIBRARY_PATH ${UGII_BASE_DIR}:/usr/ugs190/ugii/uglibse.g. For NX 2.0, setenv LD_LIBRARY_PATH ${UGII_BASE_DIR}:/usr/ugs020/ugiiHewlett Packard:-e.g. For NX 1.0, setenv SHLIB_PATH ${UGII_BASE_DIR}:/usr/ugs190/ugii/uglibse.g. For NX 2.0, setenv SHLIB_PATH ${UGII_BASE_DIR}:/usr/ugs020/ugiiIBM RS6000:-e.g. For NX 1.0, setenv LIBPATH ${UGII_BASE_DIR} :/usr/ugs190/ugii/uglibse.g. For NX 2.0, setenv LIBPATH ${UGII_BASE_DIR}:/usr/ugs020/ugii

TSC_LOAD_LIBThis variable indicates in which directory the GCO to Parasolid translator (gco_ps) will be found when CADverter is creating solids data into the Unigraphics application. The default value for this variable is /usr/theorem/bin

e.g. setenv TSC_LOAD_LIB /usr/theorem/bin

23 of 29

Section 6 - FLEXlm Licensing

6.1 IntroductionThis section outlines FLEXlm based licensing.

6.2 OverviewThis system is provided by Macrovision Corporation and is widely used within the CAD/CAM software industry.

Full details of the options available with this software may be found on the Macrovision Corporation home page http://www.macrovision.com

The information below defines how to use the FLEXlm license mechanism with the Theorem Solutions CADverter software.

6.3 Loading the FLEXlm SoftwareThe FLEXlm software is loaded automatically from the CD during software installation.

6.4 The License File To obtain a valid license file you must supply two pieces of information. The machine hostid and the machine hostname. Details of how to obtain these are shown in Section 2 of this manual.

Your license file will usually be sent to you by E-mail, FAX or floppy disk. It will contain other text such as instructions on how to load it, this text will not affect the running of the license file. If you want to edit the file on the floppy or E-mail please make a copy of the file first in case you make mistakes.If you receive the file by FAX you will need to use vi or some other text editor to enter the data.

An example license file is shown below:

Example License file

#example,5110,8090a037,U#My Name,myemail@mycompany.co.ukSERVER tscpc06 8090a037 7601DAEMON theorem /usr/theorem/flexlmINCREMENT Cadds_Catia theorem 8.0 28-jun-2005 1 FD107DA4A8513C460E1A \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT Cadds_GCO theorem 8.0 28-jun-2005 1 AD508D749E14137F62FE \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT Catia_Cadds theorem 8.0 28-jun-2005 1 DDB03DD4A768AEC42403 \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT Catia_GCO theorem 8.0 28-jun-2005 1 1DD08D0456D95AE0E8E0 \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT GCO_Cadds theorem 8.0 28-jun-2005 1 5D00AD44484C311579F1 \

VENDOR_STRING=cut_by_theorem_solutions_ltdINCREMENT GCO_Catia theorem 8.0 28-jun-2005 1 5D208DB457A1F9D7E756 \

VENDOR_STRING=cut_by_theorem_solutions_ltd

Only the important lines are shown in this example. They are split up into three types:

1. SERVER followed by the HOSTNAME (tscpc50), the HOSTID (8090a037) and the PORTID (7601) the HOSTNAME may need to be changed when you receive the file to your machine HOSTNAME. It must also be changed if you change your machine name. The HOSTID must match address of you machine. If

24 of 29

you change your processor then the license will no longer function and must be re-cut by your software provider.

2. DAEMON followed by the path to the License server daemon executable. If you have installed the CADverter software in a path other than /usr/theorem then you must edit this line to reflect the location of the flexlm/theorem file.

3. INCREMENT followed by the feature name (e.g. Cadds_Catia) and other license data to protect the feature. These lines must not be edited or the FEATURE will not work.

Note: text may be wrapped over more than one line. When this occurs the continuation character is denoted by a '\'. The continuation line must then start with a 'tab' character.

Once the license file has been installed you may start the license manager.

6.5 Starting the License ManagerBy convention the license file is named license.dat and is installed in the /usr/theorem/flexlm directory. However, this file may be saved as anyname and placed in anydirectory. If an alternate name or directory location is used then the software will determine this new location from the setting of an environment variable named THEOREM_LICENSE_FILE.

E.g. setenv THEOREM_LICENSE_FILE /anydirectory /anyname

Once the product(s) has been installed from the CD and the license file is in place the next step is to start the FLEXlm License Manager Daemon. This is achieved by either issuing the full command line syntax;

unix-shell% /usr/theorem/flexlm/lmgrd –c /usr/theorem/flexlm/license.dat –l /usr/theorem/flexlm/license.log &

Or alternatively by using the supplied shell script

unix-shell% /usr/theorem/flexlm/TS_updaemon.

If you have installed the software into a user defined directory location then the directory name for both the full command line syntax and the shell script must be changed to reflect the user defined installation directory. In addition the shell script file must be edited to accommodate the new installation directory.Note! The process of starting the License Manager must be undertaken each time that the host machine is rebooted. This may be added to your machines reboot process.

6.6 Stopping the License ManagerTo shut down the FLEXlm daemon operation you can either issue the full command line syntax:-

unix-shell% /usr/theorem/flexlm/lmdown –c /usr/theorem/flexlm/license.dat or alternatively by using the supplied shell script

unix-shell% /usr/theorem/flexlm/TS_downdaemonAgain, if you have installed the software into a user defined directory location then the directory name for both the full command line syntax and the shell script must be changed to reflect the user defined installation directory. In addition the shell script file must be edited to accommodate the new installation directory.

6.7 Checking the License ManagerTo determine the current status of the license manager process you can use either the full command line syntax:-

unix-shell% /usr/theorem/flexlm/lmstat –c /usr/theorem/flexlm/license.dat -a

or alternatively by using the supplied shell script

unix-shell% /usr/theorem/flexlm/TS_statdaemon

25 of 29

Again, if you have installed the software into a user defined directory location then the directory name for both the full command line syntax and the shell script must be changed to reflect the user defined installation directory. In addition the shell script file must be edited to accommodate the new installation directory.

6.8 FLEXlm On-Line DocumentationThe FLEXlm License manager software package contains a complete set of End User Documentation written in HTML format. To review these documents point your browser to /usr/theorem/flexlm/htmlman/index.htm

26 of 29

Section 7 - Testing the Installation

7.1 CADverter Installation TestingTo test that the CADverter is correctly installed, sample parts are included on the product CD and will be installed. These models will be installed into a samples directory relative to the installation directory and by default will be named /usr/theorem/samples. If an alternate installation directory was specified then the samples directory will be located within it. Samples exist for all the major CAD systems supported, each model residing in a subdirectory named after the modelling system.

To test the CADverter installation, use either the Graphical User Interface script or the Command Line Interface.

To use the GUI issue:

unix-shell% /usr/theorem/scripts/cadvert To use the CLI issue:

unix-shell% /usr/theorem/scripts/cadvert –cli cadverter cadverter_argumentsORunix-shell% /usr/theorem/bin/cadverter cadverter_arguments

e.g.unix-shell% /usr/theorem/scripts/cadvert –cli catia_cadds /usr/theorem/samples/catia/PH4M1.model /test/parts/ph4m1ORunix-shell% /usr/theorem/bin/catia_cadds /usr/theorem/samples/catia/PH4M1.model /test/parts/ph4m1

N.B. The latter method assumes that all required environment variables have already been set. (see section 5)

7.2 CADviewer Installation TestingTo test that the CADviewer is correctly installed, sample parts are included as part of every installation. These models will be installed into a samples directory relative to the installation directory and by default will be named /usr/theorem/samples. If an alternate installation directory was specified then the samples directory will be located within it. Samples exist for all the major CAD systems supported, each model residing in a subdirectory named after the modelling system. Please note, by default the samples directory has no write access for users that are not in the same group as the installation owner, therefore you may not be able to write data into the samples directory.

To test the CADviewer installation, use the Interface Start-up script.

unix-shell% /usr/theorem/scripts/cadview

27 of 29

7.3 Using I-DEAS ProductsThe I-DEAS products require that they are executed within an active I-DEAS Orbix environment. Make sure that the I-DEAS Orbix server is correctly installed (please refer to your I-DEAS installation documentation).

Before running any Theorem software, start I-DEAS and launch a command-prompt window (type ‘oaxx execute xterm’ in the I-DEAS prompt window). To confirm that an active Orbix server is available, using the xterm window, type:

echo $OI_SERVER_NAME

If active, this should return a name that looks something like ‘OpenIdeas1234’ (the numbers will be different).

I-DEAS sets an environment variable 'TSC_LOAD_LIB' to run the built-in theorem CADDS translator. This must be removed to prevent interference with this software, use:

unsetenv TSC_LOAD_LIB

Within the xterm window, the Theorem software can be executed by changing to the directory where you installed the software, and running either:

• ./scripts/cadvertor• ./scripts/cadview

7.4 Troubleshooting: Common Problems• Check that the license file is called /usr/theorem/flexlm/license.dat or if an alternative filename is used

ensure that the filename matches the setting of the environment variable THEOREM_LICENSE_FILE

• The first line of a FLEXlm license.dat file should resemble the following SERVER hostname 77af8387 7601If the second argument is "hostname" or “user-to-edit” this means that this information was not available when your license was created. You must change "hostname" to the specific hostname of your machine. To determine this information see Section 2.5 of this manual. The third argument is your machine hostid. Both of these values hostname and hostid must exactly match the text case of the information found.

• The current system date and time should be correct. If incorrectly set, the license file may NOT be valid.

• If you have installed the software in a new location ensure that each user has a copy of the .tsrc file in their home directory. The master version of the .tsrc file is created in the installation directory.

• If your operating system is Solaris ensure that the Motif support libraries are installed.

• If you are unable to install all Components during installation, this may be due to the available working disk space in the default directory /tmp. Try setting the environment variable TS_TEMP_DIR /new/directory refer to Section 5 of this manual.

• If the ‘Help’ + ‘Help Topics’ menu item fails to launch the user’s default Browser to display help documents, it is possible to use a more basic ‘built-in’ browser.To enable the basic browser, you must edit the Theorem Property data using the‘Tools’ + ‘Property File Editor’ menu option.

28 of 29

Figure 8.1

If the checkbox in the ‘Comment’ column is ticked on the line containing property name “Theorem.HelpBrowser”, the basic ‘built-in’ browser will be used.After ticking the comment box, ‘Save’ the edited version and re-start the application to apply the changed properties and enable the built-in browser for viewing help files.

29 of 29