You are on page 1of 16

MSC.

Acumen 2006
Runtime Release and
Installation Guide

Main Index
Corporate
MSC.Software Corporation
2 MacArthur Place
Santa Ana, CA 92707
Telephone: (800) 345-2078
Fax: (714) 784-4056

Europe
MSC.Software GmbH
Am Moosfeld 13
81829 Munich
GERMANY
Telephone: (49) (89) 43 19 87 0
Fax: (49) (89) 43 61 71 6

Asia Pacific
MSC.Software Corporation
Entsuji-Gadelius Building
2-39, Akasaka 5-chome
Minato-ku, TOKYO 107-0052, JAPAN
Telephone: (81) (3) 3505 0266
Fax: (81) (3) 3505 0914

Worldwide Web
www.mscsoftware.com

Disclaimer
MSC.Software Corporation reserves the right to make changes in specifications and other information
contained in this document without prior notice.
The concepts, methods, and examples presented in this text are for illustrative and educational purposes
only, and are not intended to be exhaustive or to apply to any particular engineering problem or design.
MSC.Software Corporation assumes no liability or responsibility to any person or company for direct or
indirect damages resulting from the use of any information contained herein.
User Documentation: Copyright 2006 MSC.Software Corporation. Printed in U.S.A. All Rights
Reserved.
This notice shall be marked on any reproduction of this documentation, in whole or in part. Any
reproduction or distribution of this document, in whole or in part, without the prior written consent of
MSC.Software Corporation is prohibited.
MSC is a registered trademark of the MSC.Software Corporation. NASTRAN is a registered trademark
of the National Aeronautics and Space Administration. MSC.Nastran is an enhanced proprietary version
developed and maintained by MSC.Software Corporation. MSC., MSC.Patran, and MSC.Acumen are
trademarks of MSC.Software Corporation.
All other trademarks are the property of their respective owners.
ACM*V2006*Z*Z*Z*DC-904000

Main Index
MSC.Patran Release Guide

MSC.Acumen 2006
Runtime Release and
Installation Guide
■ What’s New?
■ Windows NT Installation Instructions
■ UNIX Installation Instructions.
■ Runtime Licensing
■ Demonstration Application
■ Environment Variables

■ Linux Notes
■ Installation Notes

Main Index
2

1 What’s New?
• MSC Acumen support for the DEC Alpha (OSF1) platform is no longer
available.
• MSC Acumen for Linux x86 is now available!
• MSC Acumen is available in both a Runtime and a Development version.

Main Index
Windows NT Installation Instructions 3
Installation Guide

2 Windows NT Installation Instructions


1. Place the CD in the drive.
2. Run the Setup.exe executable in the root directory of the CD using either the
"Start" "Run" "Browse" desktop form or from a command window command
line.
The setup executable will run and present the user with the following forms:
• Acumen - Installation Folder.
This directory location is were the installation application will unpack
the files needed to continue the MSC Acumen installation process.
Note that this form does not specify the directory in which MSC
Acumen will be installed.
• Unpacking Acumen...
This form is displayed while the installation files are being unpacked
into the directory specified by the "Acumen - Installation Folder"
form.
• Welcome
This is the initial installation form which should be backed by a full
screen splash screen.
• Choose Destination Location
This form is used to define the location in which to be installed.
The target files will be installed into three sub-directories in the
directory specified by this form:
msc_acumen
msc_acumen.docs
msc_acumen.demo
• Start Copying Files
Used to verify the installation directory and to start the file
installation process.
• Choose Destination Location
This form is used to define a value for the environment variable
P3_HOME if one is not already defined. This value is used to
construct batch files that are used to start the various MSC Acumen
demonstration applications.
• Setup Complete
Indicates the end of the installation procedure.

Main Index
4

Note that MSC Acumen does not modify either the workstation environment
variables or the registry.
Rebooting the workstation after the installation of MSC Acumen is not
required.

Main Index
UNIX Installation Instructions. 5
Installation Guide

3 UNIX Installation Instructions.


1. Place the CD in the drive.
If you have been graced with a system that automounts the CD, the CD
should mount automatically to the appropriate mounting point.
If your system does not automount the CD, see the man page for "mount" for
the appropriate information.
2. Run the "mscsetup" script located in the root of the CD-ROM file system
from the command line and follow the instructions to install MSC Acumen.

Main Index
6

4 Runtime Licensing
MSC Acumen supports a Runtime license.
This license can be used with MSC Acumen only by placing the following command
on the command line used to start MSC Patran and the MSC Acumen application ( the
name is case sensitive ):
${P3_HOME}/bin/p3 -ifile aa_init.pcl -iam MSC.Acumen_RunTime

The MSC Acumen runtime license will be used only when the environment variable
ACUMEN_INTERFACE is set to DISABLE.
A command line window text message similar to the following will contain the text
"MSC.Acumen" indicating that a run time license is being used.
# MSC.Acumen #### has obtained 1 concurrent license(s) from FLEXlm

In all other cases licensing will fall back to the default of using an MSC Patran license.

Main Index
Demonstration Application 7
Installation Guide

5 Demonstration Application
A demonstration application is provided with this delivery to provide a quick way to
verify the installation of the product.
Hello World
An example of a minimal MSC.Acumen application
The demonstration application will be installed into the
msc_acumen.demo/hello_world subdirectory.
The demonstration application directory will contain a script or batch file that is used
to start the application.
hello_world/hello_world
hello_world/hello_world.cmd
The script or command files can be edited with a text editor as needed to correctly
define the needed environment variables.
MSC.Acumen requires no modifications to environment variables or registry entries.
All environment information needed to start and run an MSC Acumen application can
be contained in the script or command file used to start the application.
A shortcut on the desktop or a shell alias can be used to provide a convenient starting
mechanism for the user.

Main Index
8

6 Environment Variables
MSC Acumen requires no modifications to the workstation parent environment
variables or registry entries.
One of the original design goals of MSC Acumen was to have as small an impact as
possible on MSC Patran or any other applications installed on the workstation.
This goal was achieved by using environment variables that can be defined in a script
or command file. These environment variables are used to identify the location of the
MSC Acumen core code, required application files, the MSC Patran files, and the
location of an external html browser used to display help files.
The environment variables are defined as follows.

ACUMEN_HOME
Purpose
This environment value defines the installation location of the
MSC/Acumen Application Core and MSC/Acumen Toolkit core code.
Assumed file locations and names:
All core .plb and status message files will be placed directly in the
ACUMEN_HOME directory.
It will be assumed that the status message file will have the name
"aa_message_core.dat"
It will be assumed that the core shared libraries will be placed in the location
"ACUMEN_HOME"/lib for UNIX and "ACUMEN_HOME"/bin for
WINNT, allowing the location to be consistent with the rules currently used
by MSC.Patran.
Default value.
If the environment variable "ACUMEN_HOME" is not defined, the default
value of "P3_HOME" will be used. If "P3_HOME" is not defined,
"/patran/patran3" will be used for UNIX, "c:\msc" for WINNT.
Analysis Application environment variables replaced.
"ACUMEN_DIR", "AdvisorPLB"

ACUMEN_APPLICATIONS
Purpose
This environment variable provides the path and file name for the home
drive page of a user developed MSC/Acumen application.
Assumed file locations and names:

Main Index
Environment Variables 9
Installation Guide

It will be assumed that the master .xio and .xml files will be located directly
in the ACUMEN_APPLICATIONS directory.
It will be assumed that the .def file will have the same path and base file
name as the application home drive page with a .def extension.
It will be assumed that the labels file will have the same path and base file
name as the application home drive page with a .labels extension.
It will be assumed that all .html help files will be in a subdirectory under the
directory in which the home drive page is located named "help".
It will be assumed that the pulldown menu title definitions file will have the
same path and base file name as the application home drive page with a
.dwn extension.
It will be assumed that application specific .plb file will have the same path
and base file name as the application home drive page with a .plb extension.
If a file with the specified extension cannot be found, no action will be taken.
It will be assumed that application specific .png files will be in a subdirectory
under the directory in which the home drive page is located named
"app_images".
Default value.
If the environment variable "ACUMEN_APPLICATIONS" is not defined, the
value of "ACUMEN_HOME/acumen_applications/master" will be used
where "master" will be the default application name.
Analysis Application environment variables replaced:

"AdvisorPAGE1", "AdvisorLIB",
"AdvisorFORMPARAMS", "AdvisorPULLDOWN
",
"AdvisorERROR", "AdvisorINPUTS"

ACUMEN_INTERFACE
Purpose
This environment variable will "ENABLE" or "DISABLE" the MSC.Patran
menu bar pull down interface to MSC/ACUMEN.
Default value.
The default value of this environment variable is "DISABLE". The setting of
this environment variable will not be case sensitive.
Analysis Application environment variables replaced.
"PATRAN_USER"

Main Index
10

ACUMEN_BROWSER
Purpose
This environment variable provides a string that will be used to start the web
browser used to display HTML help pages. This string might take the
following form:
/usr/netscape/netscape
A fully qualified path and file name for the appropriate file will be passed to
the executable through the command line.
Default value: none.
This value is established at installation time, checked and validated at run
time. If the browser cannot be found, a warning message will be displayed
at MSC/Acumen startup.
Analysis Application environment variables replaced.
"AdvisorBROWSER"

ACUMEN_MOTIF
Purpose
To force the use of the MSC.Acumen motif interface with Windows NT. This
provides for backwards compatibility with MSC.Patran V8.5 on the
Windows NT platform.
Default value.
The default value of this environment variable is "DISABLE" on the
Windows NT platform, "ENABLE" on the UNIX platforms. The setting of
this environment variable is not be case sensitive.

ACUMEN_Y_SCALE
Purpose
Allows the definition of a real value used to scale the MSC Acumen user
interface along the Y axis.
This provides a method to rescale the MSC Acumen user interface for a
better fit on LCD displays.
Default value.
Depending on the settings of ACUMEN_MOTIF, ACUMEN_INTERFACE
and the type of machine (Windows NT vs. UNIX), the default value of
ACUMEN_Y_SCALE is from 0.8-1.10.

Main Index
Environment Variables 11
Installation Guide

HTML_IMAGE_PATH
Purpose
Defines the path used to retrieve images with xml files.

Main Index
7 Linux Notes
The mscsetup installation script file requires the Korn Shell or ksh to do its magic. If
your system does not have ksh installed a good place to start looking for a copy is
http://www.kornshell.com/

Main Index
8 Installation Notes
Hewlett Packard UNIX machines may have problems reading the MSC Acumen CD-
ROM.
Symptoms of these problems are extra characters at the end of file names on the
delivery CD after it has been mounted on a machine.
A workaround has been provided in the form of a tar file in a subdirectory containing
the complete installation cd file set.
This tar file is located in
msc_acumen/msc_acumen.tar

on the CD-ROM.
The tar command ( see man tar ) can be used to extract the installation cd file set to a
temporary directory. The mscsetup script file can then be run in the temporary
directory to install MSC Acumen.

Main Index
Main Index