ModelChecker™  9.0 Installation Instructions

ModelChecker (TM)  Installation Instructions

5/1/2005

Two sets of instructions are included herein, Installing on a Windows System and Installing on a UNIX system.  Please use the instructions that are appropriate for your system.  At the end of the instructions are some non-installation notes that are applicable to both types of systems.  Please review these notes as well.

Note: These instructions refer to installing ModelChecker for ANSYS 9.0. This version of ModelChecker will only function with ANSYS 9.0. If you are using an earlier version of ANSYS please contact your reseller to obtain the appropriate version of ModelChecker

Installing Model Checker(MC) on a Windows System

To install the ModelChecker software on a Windows system (NT/2000/XP), the CD must first be mounted on the system.  The files used by ModelChecker are supplied in a ZIP file format.  The zip file (on the CD or downloaded from the website or received by e-mail) is called mcwind90.zip.

NOTE: Companies that have created their own customized Tcl/Tk routines in ANSYS will need to regenerate the "tclIndex" file by running "auto_mkindex" from within a Tcl Shell. It is recommended that you make a backup copy of your "tclIndex" file, prior to installing the software , as this file will be overwritten by the ModelChecker installation.

To Install the files

The ModelChecker files are supplied as a ZIP file. The ZIP file is coded with the correct directory structure and the files should be extracted to the ANSYS 9.0 installation directory. Note: On a PC this is typically C:\Program Files\Ansys Inc\v90\ANSYS\ but may have been changed during the initial ANSYS 9.0 installation.). Make sure that you are using a Zip utility that is set to follow directory paths and to overwrite files when extracting files.

Final setup

Modify the menulist90.ans file

In the "UIDL" subdirectory of the ANSYS\gui\en-us directory, you must edit the file menulist90.ans (eg. C:Program Files\Ansys Inc\v90\ansys\gui\en-us\UIDL\menulist90.ans) and add the following line to the end of the file:

C:\Program Files\Ansys Inc\v90\ansys\gui\en-us\UIDL\CAEG.GRN

substituting the correct path to your "gui\en-us\UIDL" directory where appropriate.

This will modify the ANSYS menus (for all users) to include MC.  If the use of MC is to be limited to one or more users, leave the original menulist90.ans in the "UIDL" subdirectory, create a modified copy as described, and place the modified copy in the working or home directory of the users that will be using MC.

Install license file

You will also need to put the license file, caegmc.code, in the DOCU directory (eg. C:Program Files\Ansys Inc\v90\ansys\docu). This license file should be e-mailed to you or obtained from your reseller. 

Add company name

The file caegmc.head (placed in the ansys\docu\ directory) should be edited to contain your company name or some other text (32-character limit) that you would like to see at the beginning of each HTML report created by MC.  Please make sure that the file extension remains the same (.head).

Users can either leave this file in the ansys\docu\ directory or move it to their working directory.

Troubleshooting

          If you have any problems running the ModelChecker, please check the following:

Check the protection on the file CAEG.GRN

Make sure that the CAEG.GRN and CAEG.EUI (in the gui\en-us\UIDL subdirectory) are not write-protected!  These file must be indexed by the ANSYS program the first time ModelChecker is used.  After the first use, CAEG.GRN and CAEG.EUIcan be write-protected.

Check the presence/location of other required files

• CAEGxxxx.MAC files are in the ansys\apdl directory
• caegmc.code, the license key, must be in the ansys\docu directory
• the subdirectory, mc_help, is located in the ansys\docu\en-us directory
• menulist90.ans (in the ansys\gui\en-us\UIDL directory) has been modified to add the additional line that points to CAEG.GRN (see the “ Modify menulist90.ans file” section above)

Installing Model Checker (MC) on a UNIX System

To install the ModelChecker software on a UNIX system, the CD must  be mounted on the system.  Once the CD has been mounted, the tar file can be copied and untarred in the correct locations (see Unpacking the file).  If the tar file has been downloaded from the ModelChecker website, or received by e-mail, proceed to the “Unpacking the file” step of the instructions.

Mounting the CD

Depending on your site's system, you will need to run the installation procedure using either a locally- or remotely-mounted CD . Table 1. ,CD-ROM Device Names, provides the CD device name for each platform.

Table 1. CD-ROM Device Names

In Table 1., in the column labeled CD-ROM Device Names (second column), the # symbol must be replaced with the SCSI ID of the CD device.

Locally-Mounted CD-ROM Procedures describe the commands to mount a CD locally for each platform. In the tables, replace cdrom_dir  with the directory name where you wish to mount the CD device. This should be a new or existing empty directory. Also, replace device with the actual device from CD-ROM Device Names (such as /dev/sr0).

Mounting the CD Locally

For a locally-mounted, CD-ROM installation, issue the commands from Locally-Mounted CD-ROM Procedures, Table 2.,  for your specific platform.

Table 2. Locally-Mounted CD-ROM Procedures

Mounting the CD Remotely

If you are installing via a remotely-mounted CD device, first follow the steps in Locally-Mounted CD-ROM Procedures for your platform to mount the CD device locally on the system where the CD device is located. Then follow the appropriate procedure in Remotely-Mounted CD-ROM Procedures in the ANSYS 7.0®  Installation Guide to complete the remotely-mounted installation.

You are now ready to unpack the ModelChecker files.

Unpacking the file

NOTE: Companies that have created their own customized Tcl/Tk routines in ANSYS will need to regenerate the "tclIndex" file by running "auto_mkindex" from within a Tcl Shell. It is recommended that you make a backup copy of your "tclIndex" file, prior to installing the software , as this file will be overwritten by the ModelChecker installation.

Copy the file unixmc90.tar from cdrom_dir  to the ANSYS 9.0 installation directory, typically this is /ansys_inc/v90/ansys/ but may have been changed during initial ANSYS installation.  On some UNIX systems (e.g., on the HP system if you forget to use the –o and the cdcase when mounting the CD) the file, unixmc90.tar, may appear to be upper case on the CD and may even have another extension, e.g., UNIXMC90.TAR;1.  In such an instance, copy the file from the CD using the copy command(assuming the CD is /cdrom and you are in the  ANSYS 9.0 installation directory):

cp cdrom/*.TAR*     unixmc90.tar

to copy the file from the CD and rename it to the proper lowercase filename.

Then, in the  ANSYS 9.0 installation directory,  issue the command:

tar –xvf unixmc90.tar 

This operation will unpack all of the files to the correct locations. The file, unixmc90.tar, can then be deleted or archived.

Final setup

Modify the menulist90.ans file

In the "UIDL" subdirectory of the ansys/gui/en-us directory, you must edit the file menulist90.ans (eg. /ansys_inc/v90/ansys/gui/en-us/UIDL/menulist90.ans) and add the following line to the end of the file:

/ansys_inc/v90/ansys/gui/en-us/UIDL/CAEG.GRN

substituting the path to your "UIDL" directory where appropriate.

This will modify the ANSYS menus (for all users) to include MC.  If the use of MC is to be limited to one or more users, leave the original menulist90.ans in the "UIDL" subdirectory, create a modified copy as described, and place the modified copy in the working or home directory of the users that will be using MC.

Install license file

You will also need to put the license file, caegmc.code, in the DOCU directory (eg. /ansys_inc/v90/ansys/docu/). This license file should be e-mailed to you or obtained from your reseller. 

Add company name

The file caegmc.head (placed in the ansys/docu directory) should be edited to contain your company name or some other text (32-character limit) that you would like to see at the beginning of each HTML report created by MC.  Please make sure that the file extension remains the same (.head).

Users can either leave this file in the ansys/docu directory or move it to their working directory.

Troubleshooting

          If you have any problems running the ModelChecker, please check the following:

Check the protection on file CAEG.GRN

Make sure that the CAEG.GRN and CAEG.EUI files (in the gui/en-us/UIDL subdirectory)  is not write-protected!  These files must be indexed by the ANSYS program the first time ModelChecker is used.  After the first use, they can be write-protected.

Check the “case” on the ModelChecker macro names

Make sure that all the supplied macros (CAEGxxxx.mac), CAEG.GRN and CAEG.EUI, have filenames that are upper case (as supplied).

Check the presence/location of other required files

• CAEGxxxx.MAC files are in the ansys/apdl directory
• caegmc.code, the license key, must be in the ansys/docu/ directory
• the subdirectory, mc_help, is located in the ansys/docu/en-us directory
• menulist90.ans (in the ansys/gui/en-us/UIDL directory) has been modified to add the additional line that points to CAEG.GRN (see the “ Modify menulist90.ans file” section above)

Non-Installation Notes

Accessing the Users Manual

The Users Manual can be accessed within the ANSYS program by clicking on the HELP button in any ModelChecker dialog box.  You can also copy the contents of the subdirectory docu/en-us/mc_help to any directory on any computer with a Web browser, with or without ANSYS installed, and use the file, caeghelp.htm, in the mc_help directory to bring up the Users Manual in your browser.  The Users Manual also contains a sample HTML report.

ModelChecker documentation files

The CD contains two other files that users may find useful but are not necessary for the use of ModelChecker.  If you downloaded the MC files, or received the MC files by e-mail, you may not have this file.  If you would like a copy, send an e-mail to laduroch@earthlink.net requesting copies of the files and giving your ANSYS Agreement Number.

ModelChk.htm and ModelChk.pdf  (same content, different format) are HTML and PDF files that indicate what quantities are stored in the arrays created by ModelChecker.  Most users will never use these files. It is documentation for users that would like to do additional calculations or would like to review stored information that is not presented in the HTML report.  The files also discuss how to implement additional functionality via user macros.

ANSYS is a registered trademark of ANSYS, Inc.  All other product names used throughout this document are trademarks or registered trademarks of their respective manufacturers.