installation notes for unix - msc software...

Installation Notes for Unix

WelcomeSystem RequirementsInstalling MSC.EASY5The Flexible License ManagerStarting the License ManagerUpdating Your LicenseSetting Up Links and Testing your InstallationDefining Default Printer OptionsPlatform Specific NotesConfiguring Your X Server and Windows ManagerPC X Terminal Access to Unix with ExceedConfiguring Your System to run MSC.ADAMS and MSC.EASY5

Technical Sales & Support

Technical analysts are available to answer your questions on the installation, maintenance, and use of MSC.EASY5 products.

Region Company Telephone/Fax E-mail/World Wide Web

United States & MSC.Software Corporation 1-800-426-1443 [email protected] fax 425-641-6924 http://easy5.mscsoftware.com

Japan Sumisho Electronics Co., Ltd. 81-3-5217-5100 [email protected] 81-3-5217-5101 http://www.sse.co.jp/comid/engin/easy5

Comments about MSC.EASY5 and this manualWe welcome comments, corrections, and suggestions on any aspect of MSC.EASY5 and its documentation. You can use any of the communication methods listed above or contact us by mail at:

MSC.Software Corporation15400 SE 30th Place, Suite 202Bellevue, WA 98007 (U.S.A.)

Edition NoteThis edition of the MSC.EASY5 Install Note for Unix documents the 2004 release of MSC.EASY5.

Copyright © 2004 MSC.Software CorporationAll Rights Reserved. Printed in U.S.A. E5*V2004*Z*Z*UNIX*DC-OPS Lot 2/27/04

DisclaimersTHE DOCUMENTATION IS PROVIDED ON AN “AS-IS” BASIS AND ALL EXPRESS AND IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. IN NO EVENT SHALL MSC.SOFTWARE CORPORATION BE LIABLE TO ANYONE FOR ANY SPECIAL, COLLATERAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES ARISING OUT OF, RESULTING FROM, OR IN CONNECTION WITH USE OF THE CONTENTS OR INFORMATION IN THE DOCUMENTATION.

MSC.SOFTWARE CORPORATION RESERVES THE RIGHT TO MAKE CHANGES IN SPECIFICATIONS AND OTHER INFORMATION CONTAINED IN THE DOCUMENTATION WITHOUT PRIOR NOTICE.

Third Party Software Program CreditsThird-party software is copyrighted and licensed from MSC.Software suppliers. Copyright © 1990-2002 Hummingbird Ltd. All rights reserved. Copyright © 1997-2002 Mortice Kern Systems, Inc. All rights reserved.

TrademarksADAMS, EASY5, MSC, MSC., MSC.ADAMS, and MSC.EASY5 are trademarks or registered trademarks of MSC.Software Corporation or its subsidiaries in the United States and/or other countries.

NASTRAN is a registered trademark of the National Aeronautics Space Administration. MSC.Nastran is an enhanced proprietary version developed and maintained by MSC.Software Corporation.

Microsoft is a registered trademark of Microsoft Corporation. All other trademarks are the property of their respective owners.

Government UseUse, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212 (Commercial and DFARS 227.7202 (Commercial Computer Software and Commercial Computer Software Documentation), as applicable.

WE L C O M E

Introduction

These notes describe how to install EASY5 on a computer running the Unix operating system. Please review these notes before installing MSC.EASY5.

We recommend that you keep these instructions with the MSC.EASY5 User Guide for future reference.

Please refer to the MSC.EASY5 Release Notes for additional information about using MCS.EASY5 on a Unix or Windows operating systems.

Table of Contents1. System Requirements............................................................................52. Installing MSC.EASY5 ...........................................................................93. The Flexible License Manager .............................................................154. Starting the License Manager ..............................................................215. Updating your license...........................................................................276. Setting Up Links and Testing Your Installation ....................................297. Defining Default Printer Options...........................................................318. Platform Specific Notes........................................................................339. Configuring Your X Server and Windows Manager .............................3510. PC X Terminal Access to Unix with Exceed.......................................3711. Configuring Your System to Run MSC.ADAMS and MSC.EASY5 ....41

Installation Notes 3

WELCOMEConventions Used in This Guide

Conventions Used in This Guide

This guide uses the following text conventions to identify functions and procedures:

• Text in a Courier font indicates a file name or text to be entered.

Enter open_loop in the input field.

• Text in an italic font in angle brackets indicates that you must enter your local computer information:

<host_directory>/easy5/lmgr

• Text enclosed in angle brackets indicates that you are to press a key.

Press <Enter>.

• Most keyboard shortcuts require that you press the Control key together with another key Press Ctrl + S.

• Text in all caps followed by a direction (right or left) indicates that you are to use the specified button in the following ways.

CLICK-L Click and release the left mouse button.CLICK-R Click and release the right mouse button.DOUBLE CLICK-L Click the left mouse button twice in rapid succession

and release.

• Text in a bold Arial font with right angle brackets between words indicates that you select a menu and subsequent submenus with your mouse.

Go to File > Print Preview to view your document.• Text in an Arial font enclosed in brackets indicates that you are to CLICK-L a button on the

screen.Click [OK] to close the window.

Additionally, certain icons are also used throughout this guide to bring your attention to certain items.

Items preceded by a flag person icon indicate important or critical information about the operation and installation of MSC.EASY5.

Items preceded by an exclamation point in a triangle indicate a warning about performing an action that could adversely affect your computer, your operating system setup, or your MSC.EASY5 setup.

4 MSC.EASY5 2004

SY S T E M RE Q U I R E M E N T S 1

Operating System Requirements

The following table indicates the minimum required versions of the operating system and f77 Fortran compiler for the Unix platforms on which MSC.EASY5 is available.

NOTE: (1)MSC.EASY5 version 5.3.2 and higher no longer runs under the Sun operat-ing system (OS). (2)Fortran90 is only available on SGI MIPS3 and MIPS4 processors. (3) Harris PowerHawk is no longer supported as of v2004.

Additional Software RequirementsFortran Compiler

In addition to the operating system described in the preceding section, you must also have a Fortran 77 (or Fortran 90) compiler version compatible with your respective operating system. The compiler does not need to be installed and running when you install MSC.EASY5. However, you must install it before attempting to start MSC.EASY5.

Platform Operating system f77 compiler

HP 9000/700 series HP-UX 11.0 F90 v2.4.13+

HP Itanium HP-UX IA64 F90 v2.6.3

Sun(1) Sun Solaris 2.6 5.x

Silicon Graphics Irix 6.5 (N32 and 64 bit) 7.2.1 (2)

IBM RS/6000 AIX 4.3+ 5.01

Linux- IA32n RedHat 9.0 GCC 3.2.2


SYSTEM REQUIREMENTSAdditional Software Requirements

Web Browser We recommend using the Netscape Navigator web browser to view MSC.EASY5’s online documentation, as this is the program default. However, you have the option of over-riding the default and setting the EASY5_BROWSER to any launch any web browser you want to use.

When you run the installation script, you will be prompted to enter the full path name to the command that launches Netscape. MSC.EASY5 sets the environment variable EASY5_BROWSER to this command.

Adobe Acrobat ReaderThe Adobe Acrobat program that is used to view PDF (Portable Document Format) files must be installed to run MSC.EASY5, since MSC.EASY5 uses PDF files in the online help program called “MSC.EASY5 Guide”.

If the server does not have the Acrobat program, download this (free) program from Adobe’s web site at:

http://www.adobe.com

The default command used to launch Acrobat is “acroread”. When you run the installation script, you will be prompted to enter the full path name to the “acroread” command that launches Acrobat. MSC.EASY5 sets the environment variable EASY5_PDF_READER to this command.

You can over-ride the default and set EASY5_PDF_READER to launch Acrobat as they desire. However, if set by the user, the command should also include “-name easy5”. For example:

setenv EASY5_PDF_READER “acroread -name easy5”

Acrobat Reader Requirements

All MSC.EASY5 users should have access to Acrobat and the “acroread” command, which is used to launch the Acrobat Reader program.

In addition, each user will have an acrobat file in their login directory called “.acrorc ”. The user should edit this file and add the following three lines to the top of the file:

easy5x_exe*MaxOpenDocuments: 1easy5x_exe*ShowMenuBar: falseacroread*MaxOpenDocuments: 10

6 MSC.EASY5 2004

SYSTEM REQUIREMENTSHard Disk Drive

Hard Disk Drive

You must be able to access a hard disk from your workstation. For software installation, the required hard disk space depends on the platform version of MSC.EASY5 as indicated in the table below:

Note that in addition to program space, you must have enough space to maintain the files you create while using the software. Depending on the user, working space requirements vary between 100 and 500 MB.

Memory Requirements

A minimum of 16 MB of memory is recommended for acceptable operation of MSC.EASY5. However, it is recommended that you have 24 MB or more of memory. Computers configured with 24 MB of memory exhibit better performance when running this software.

A minimum of 4 MB of stack space is also required. Use the “ulimit -a” command to determine and set the stack space.

Platform Final disk space required, megabytes

HP/UX (HP-UX) 300

IBM RS6000 (AIX) 300

SGI (Irix) 300

Sun Solaris (5.x) 300


SYSTEM REQUIREMENTSMemory Requirements

8 MSC.EASY5 2004

IN S T A L L I N G MSC.EASY5 2

Installation Guidelines

The following list provides the basic guidelines for MSC.EASY5 software installation:

• You should be logged into the machine on which you are installing MSC.EASY5 and using a disk that is not an NFS temporary mount point.

• You must perform the installation from an account that has write permission in all directories and has access to a cartridge tape drive.

• You should be in the X Window environment before starting the installation procedure.You will see that the following installation instructions are given for the C Shell. If you are running the Bourne Shell, you must substitute the appropriate commands. For example, to set an external variable, the C Shell and corresponding Bourne Shell commands are

C Shell setenv external_variable value

Bourne or Korn Shell export external_variable=value

Flexible License Manager

MSC.EASY5 uses the Flexible License Manager (FLEXlm v9.2g) from Macrovision Corp. FLEXlm must be running to run MSC.EASY5. All software required to run FLEXlm is supplied with MSC.EASY5, including the FLEXlm license file template (license.dat), a license daemon program (lmgrd), the MSC vendor daemon program (MSC), and a set of useful FLEXlm utilities. The daemon programs run in the background to manage MSC.EASY5 licenses. See "Configuring Your X Server and Windows Manager" on page 35 for more information.

MSC.EASY5 installation is complicated by the fact that many other commercial software applications also use FLEXlm, and it may already be running on your computer. If you have other applications already installed that run FLEXlm, the MSC.EASY5 installation is slightly different. Instructions for these options are included in the following sections.


INSTALLING MSC.EASY5Decisions To Make Before Starting the Installation

Decisions To Make Before Starting the Installation

Before starting the installation, you should perform the following steps and make note of your decisions:

1 You must choose a directory where you want the MSC.EASY5 software to reside. In the following instructions, this directory is referred to as the <host_directory>.

This directory must exist or be created in a partition that is accessible to all users. Do not call the <host_directory> easy5. A name that reflects the version being installed, such as easy5_v2004, is highly recommended. The files in easy5 are assigned read and execute permissions for all users.

2 If FLEXlm v9.2+ has not been previously installed on this computer and is not available on another network computer, you must install it as part of the MSC.EASY5 installation procedure. FLEXlm v9.2 is automatically installed when installing MSC.EASY5 and is located in the easy5/lmgr directory.

MSC.EASY5 Installation Instructions

1 To start the MSC.EASY5 installation procedure, you must be logged into a computer with access to the proper hardware for reading the MSC.EASY5 product media.

2 Set the working directory to the MSC.EASY5 <host_directory>. If this directory does not already exist, create it using the mkdir command.

3a Installing from a tape device. Insert the magnetic tape cartridge into the tape cartridge drive. Enter the appropriate command or commands for the platform where you are installing the software. Your device name may differ from the following commands:

Sun tar xvf /dev/rst8

HP-UX tar -xvo

IBM RS/6000 tar xvf /dev/rmt2

Silicon Graphics dd if=/dev/tapens | tar xvof - easy5or tar xvf /dev/rmt/[<tape device>]v (device must end in “v”)

When the tar extraction is complete, proceed to Step 4.

10 MSC.EASY5 2004

INSTALLING MSC.EASY5MSC.EASY5 Installation Instructions

3b Installing from a CD-ROM device. Insert the MSC.EASY5 CD-ROM into the CD-ROM drive.

• Mount the CD-ROM device (commands for mounting the CD-ROM are platform dependent). On most systems, once the CD-ROM is mounted and ready for use, the CD-ROM directory is called /cdrom.

• List the contents of the CD-ROM directory by entering: ls /cdrom.• Look for the file unixinst.cd. If this filename is in upper case, run the extraction

script by entering the command /cdrom/UNIXINST.CD\;1. If this filename is in lower case, run the extraction script by entering /cdrom/unixinst.cd.

• You have two installation options to choose from: 1 Install the license manager only; use this option only if you need to install the

license manager on a license server 2 Install EASY5 and the license manager

NOTE: The CD-ROM and the installation program gives you access to all Unix and Linux version of MSC.EASY5. You may install any of the Unix versions on a server. For example, you could install the HP/UX version of MSC.EASY5 on a Sun Solaris server.

• The extraction script is self explanatory and prompts you for data when needed. This script copies the necessary files and uncompresses and untars the EASY5 directory and files. When the extraction is complete, proceed to step 4.

WARNING for HP-UX Installations: Log in as root and change the protection on /dev/lan0 to allow the license manager to acquire a proper hostid. To do this, enter chmod 666 /dev/lan0


INSTALLING MSC.EASY5MSC.EASY5 Installation Instructions

4 Set your working directory to easy5 (cd easy5) and run the installation shell script by entering the following command:

./install.csh

At the prompt, you are given 3 options:

1) Install MSC.EASY5 software (default)2) Install MSC.EASY5 license management software only.3) Quit.

To install MSC.EASY5 (including required license management software), press <Enter>.

To install only MSC.EASY5 license management software, select 2 and press <Enter>. The latter option is useful, if you only want to install and setup an MSC License Server on a Unix server.

NOTE: All default responses to queries for information by the script are shown in square [ ] brackets.

If your machine type supports multiple versions of the Fortran complier, the installation script prompts you for the version of the MSC.EASY5 libraries you want to use. For example, for Sun/Solaris workstations, the MSC.EASY5 libraries are lib_so53 and lib_so50, including “fast” variants. The number 50 and 53 refer to the major version number (5.0 and 5.3) of the compiler.

The MSC.EASY5 installation is complete. You must now either obtain, specify, or install your MSC.EASY5 license file and start up the license manager, if needed, as explained in the following sections.

12 MSC.EASY5 2004

INSTALLING MSC.EASY5MSC.EASY5 License File

MSC.EASY5 License File

You must obtain and install the license codes required to run MSC.EASY5. The encrypted license codes are contained in a license file, typically named license.dat . You may already have been provided with the file. If this is the case, proceed to the next section "Using an Existing MSC.EASY5 License File and License Server" on page 14.

Otherwise, you first need to obtain the MSC.EASY5 license file. To do this, contact your MSC.EASY5 representative, preferably via email to [email protected], and provide the following information:

• Name, phone number, and company name.

• E-mail address or fax number (if you do not have e-mail).

• Host platform type and operating system (i.e., HP-UX 735 11.0).

• Server hostname and hostid for the computer where the license manager software resides.

• If you have purchased a node-locked license, provide the hostname and hostid of each client machine to which the MSC.EASY5 license is node-locked to.

NOTE: If you do not know the hostid, see "Acquiring the hostid" on page 22 for instructions.

E-mail this information to [email protected]. If you do not have e-mail, then call MSC.EASY5 Support at 1-800-426-1443.

Your MSC.EASY5 license codes, contained in the license file (license.dat), will be e-mailed (or faxed, if necessary) to you. Move to the appropriate directory (usually called lmgr) containing the existing license file (Review Step 2 on page 10 if you cannot find this directory) and update the current license file with the new license file sent to you. Either replace the file or edit the existing file and copy in the new feature codes.

You have updated the license manager license file (license.dat). Now you must start up the license manager daemon as explained in section "Starting the License Manager" on page 21.


INSTALLING MSC.EASY5Using an Existing MSC.EASY5 License File and License Server

Using an Existing MSC.EASY5 License File and License Server

If a license server has already been started and has a valid license file, and uses a version of FLEXlm that is compatible with the current version of MSC.EASY5, then you can use that license (and server) without performing any license manager startup steps. To be compatible, the FLEXlm version of the license server must be greater than or equal to the version of FLEXlm used by MSC.EASY5.

To use an existing MSC.EASY5 license file (and license server), you must:

1 Specify its “address” and 2 Set an MSC.EASY5 environment variable to make MSC.EASY5 aware of it.

There are three methods for specifying an existing MSC.EASY5 license file:

1 Use a “port@host” designation. This method relies solely on TCP/IP network communication to find the license on a given network. It requires only knowledge of the “port” and “host” of the existing installed MSC.EASY5 license file’s SERVER line, and is the most commonly used license file designation.

The SERVER line in the MSC.EASY5 license file should have the form:

SERVER <host> <hostid> <port>.

Then, simply assign the environment variable MSC_LICENSE_FILE as:

setenv MSC_LICENSE_FILE <port>@<host> C-Shellexport MSC_LICENSE_FILE=<port>@<host> Korn/Bourne shell

2 Use the network (NFS) path of the existing MSC.EASY5 license file. This network path should be always available so that MSC.EASY5 can be run without interruption. Set the environment variable MSC_LICENSE_FILE to the appropriate network path, as described above.

3 Copy the existing MSC.EASY5 license file to the current MSC.EASY5 “lmgr” directory, or elsewhere. If you have appropriate permissions, you can simply replace the existing license file in the MSC.EASY5 lmgr directory, typically license.dat. You may not have to set the MSC_LICENSE_FILE environment variable, unless you rename it from its default value., or want to store the copied license file somewhere else, such as in your home directory.

14 MSC.EASY5 2004

TH E FL E X I B L E LI C E N S E MA N A G E R

3

MSC.EASY5 uses the Flexible License Manager (FLEXlm) from Macrovision Corp. If you are provided a concurrent or campus type license, you will need to have a FLEXlm (MSC) License Server running. Node-locked uncounted licenses do not require a license server. A license server comprises of a vendor daeamon program, and a license daemon program, as described below.

All software required to run FLEXlm is supplied with MSC.EASY5, including the FLEXlm license file template (license.dat), a license daemon program (lmgrd), the MSC vendor daemon program (MSC), and a set of useful FLEXlm utilities. The daemon programs run in the background to manage the MSC.EASY5 licenses. This section gives you, as the system administrator, a general overview of FLEXlm and how MSC.EASY5 licenses are managed.

NOTE: A complete reference guide to Globetrotter FLEXlm is provided in the README_FLEXLM file in the <host_directory>/easy5/lmgr direc-tory. You can print this file.

This section explains the basics of floating (network) licensing and gives a quick overview of the FLEXlm components. It explains where system administrators have control and where end users have control. A section called “Getting Started Checklist” tells system administrators how to start managing FLEXlm.

Introduction to FLEXlm

FLEXlm is a network license manager used by many software developers to control the use of their software products. FLEXlm allows software licenses to be available (float) anywhere on a network, instead of being tied to specific machines. Floating licensing benefits both users and system administrators. Users can make more efficient use of fewer licenses by sharing them on the network. You can control who uses the licensed application and the node or nodes where the licenses are available.


THE FLEXIBLE LICENSE MANAGERIntroduction to FLEXlm

FLEXlm ComponentsThe four main components of FLEXlm are:• License file (usually named license.dat; the MSC.EASY5 license file is called

license.dat).• Application program (MSC.EASY5).• License manager daemon (lmgrd).• Vendor daemon (MSC).

License Manager DaemonThe license manager daemon (usually called lmgrd) handles the initial contact with the client application programs, passing the connection on to the vendor daemon. It also starts and restarts the vendor daemons. FLEXlm permits multiple redundant license manager daemons on different server nodes, allowing you to make your license available if any two out of three server nodes is running. Also, you do not have to split your licenses among multiple servers or rely on any one machine.

Vendor DaemonIn FLEXlm, licenses are handled by running processes. There is one process, called the vendor daemon, for each vendor who has a FLEXlm-licensed product on the network. MSC.EASY5’s vendor daemon is called MSC. The MSC daemon keeps track of how many MSC.EASY5 licenses are checked out and who has them. Note that the MSC daemon serves many other MSC.Software products, including MSC.Nastran, MSC.Patran, MSC.ADAMS, among others. If the MSC daemon terminates for any reason, all MSC.EASY5 users would lose their licenses. Users normally regain their license when the daemon restarts.

Client programs (like MSC.EASY5) communicate with the vendor daemon through TCP/IP sockets. This enables client and daemon processes to be on separate nodes in a network. The traffic between the client and the daemon is machine independent, which means that any process can run on different machine types. (This is what is meant by heterogeneous.)

16 MSC.EASY5 2004


License FileLicensing data is stored in a text file called the license file, which is generally named license.dat. The MSC.EASY5 license file is typically named license.dat. The license file is created by the MSC.EASY5 or MSC.Software staff and sent via email to the system administrator. It contains information about the server nodes and vendor daemons, and one line of data (called a FEATURE line) for each licensed feature. A feature line contains an encryption code based on the data in that line, the hostids specified in the server lines, and other vendor-specific data.

In some environments, the licensing information for several vendors can be combined into a single license file in the default location /usr/local/flexlm/licenses/license.dat.

You can override this location by setting the environment variable MSC_LICENSE_FILE to point elsewhere or by following instructions supplied with these installation notes, or license file. If your site has software from multiple vendors with incompatible license files (because of different sets of servers), you can keep the data in separate files and set the MSC_LICENSE_FILE variable to reference multiple files using a colon (“:”) extension between file names.

Application ProgramIn this example, the application program is the MSC.EASY5 program. MSC.EASY5 is linked with the program module (called the FLEXlm client library) that provides the communication with the license manager daemon. During execution, the application program communicates with the vendor daemon to request a license.

License Request ProcessWhen the application program calls the FLEXlm client library to request a license, the following process occurs:

1 The license module in the client application finds the license file, which includes the host name and port number of the license manager daemon.

2 The client establishes a connection with the license manager daemon and tells it what vendor it needs to talk to.

3 The license manager daemon (lmgrd) determines which machine and port correspond to the master vendor daemon (if multiple redundant daemons are running) and sends that information back to the client.

4 The client establishes a connection with the specified vendor daemon and sends its request for a license.



5 The vendor daemon checks to see if any licenses are available and sends a grant or denial back to the client.

6 The license module in the client returns to its caller with the grant or denial, and the application takes the appropriate action.

Configuring FLEXlmYou can configure most FLEXlm parameters by setting

• The location of the license file.

• The location of all executables.

• The location of all log files.

• The TCP/IP port number of clients looking for the license manager.

In addition, you can reserve licenses for specific users, nodes, or groups and control other license-related options.

Getting Started ChecklistThis section provides a quick overview of how to set up and use licensing for FLEXlm- licensed products. By scanning the list, you should be able to quickly find the areas of interest.

As system administrator, you are responsible for setting up licensing on your system or network. This section tells you how to do that. If you are an end user of the application and you are not be involved in installing it, then you can skip this section.

The installation guide given in chapter 3 is the final word on installing and configuring FLEXlm for MSC.EASY5 use. Generally, however, installing FLEXlm licensing requires the following steps:

1 Select your license server nodes and get their hostids.2 Send the hostids to [email protected] and get a license file (or the

data to enter in the license file) in return.3 Determine how the new license file relates to any other license files that may already

be on your system, and install it appropriately.4 Start lmgrd (the license daemon) manually, or set it up to run automatically at

startup.These steps are discussed briefly in the following sections.

18 MSC.EASY5 2004


License Servers and HostidsBefore running any FLEXlm-licensed program using floating licenses, you must set up your license server node or nodes. You must select which node or nodes to run your license servers on and provide the hostid of those machines to MSC.EASY5.

You can get the hostid of the server machine by running FLEXlm’s lmhostid utility on that machine. If you don’t have lmhostid, you can get the hostid of your machine by using the appropriate command as described in “"Acquiring the hostid" on page 22.

After giving the hostid of your server machines to MSC.Software support, the support staff will send you a license file that enables the application software.

Lmgrd and License FilesOnce you have received a license file, you must install it on your system and start up the license server.

• If you have multiple FLEXlm-licensed products, take care to avoid licensing conflicts.• MSC.EASY5 has selected a default location in the <host_directory>/easy5/lmgr

subdirectory for your license file. However, you can use any location you wish.• Some vendors provide special scripts to start up the license daemon. If not, you can run

the lmgrd program directly. To automatically run lmgrd at startup, you must modify your system files.

Administration ToolsFlexLM administration tools also provided with MSC.EASY5. Move to the host_directory/easy5/lmgr directory. To get a list of license manager utilities, enter

./lmutil lmstat -help.

To check if the MSC daemon started properly, enter:

./lmutil lmstat -S MSC.

To get FLEXlm diagnostics, enter:

./lmutil lmdiag.



MSC.EASY5 also provides options that allow you to check your license.dat file, called license.dat, and to check on the MSC daemon to be certain the MSC.EASY5 license is running.

To determine what type license you have, and where the license manger is installed, enter

easy5x -license.

This returns the full pathname to the license.dat file and lists all of the MSC.EASY5 features that your license contains.

To determine the status of the MSC daemon, enter

easy5x -lmstat

This returns a status of all features served by the MSC daemon, the number of licenses available for each MSC.EASY5 feature, and how many licenses are checked out.

20 MSC.EASY5 2004

4ST A R T I N G T H E LI C E N S EMA N A G E R

Configuring the System

If you have root privileges, it is recommended that you configure your system to automatically start the license manager daemon at start time. This is not necessary, but is highly recommended. The instructions for performing these configurations are platform dependent.

Sun SolarisPut the code fragment supplied in the file <host directory>/easy5/lmgr/rc.lm.template into your /etc/rc.local file. We recommend that you insert the code immediately following the commands that start the line printer daemon (lpd) and other network services but preceding the line echo \’.\’\.

NOTE: rc.local is run in a Bourne Shell, so do not use the C Shell (csh) >& redirection syntax.

HP-UX, IBM/RS6000Put the code fragment from <host directory>/easy5/lmgr/rc.lm.template into your /etc/rc files with the appropriate modifications.

HP-UX SGI/Irix, Sun/SolarisPut the file <host directory>/easy5/lmgr/S998lmgrd into the /etc/rc2.d directory.

Edit this file and replace the local variables licdir with the directory where the FLEXlm license manager daemon (lmgrd) is installed and licfile with the fully qualified name of the FLEXlm license file. Make sure the /etc/rc2.d/S998lmgrd file is executable.


STARTING THE LICENSE MANAGERAcquiring the hostid

In the System V form of the system startup, scripts that start specific processes are in certain directories. The sequencing during startup is controlled by the alphabetical order of the scripts in the directory.

NOTE: The MSC.EASY5 license manager daemon must be started after the network daemons, because the location of the license manager execut-ables and the license.dat file can be NFS mounted. To start the MSC.EASY5 license manager daemon as late as possible, it is given the name S998lmgrd. The S indicates that it is a start script, and the 998 places it after most of the other scripts but before the very last script. The very last script is normally something such as S99adm or S99cde. Any scripts that start network daemons should occur before this position in the alphabetical order.

Acquiring the hostid

When you install MSC.EASY5, the installation script automatically obtains the proper hostid (required by FLEXlm license manager) for your machine and displays it during the installation procedure. However, if at any time you need the proper hostid of your machine, go to the <host directory>/easy5/lmgr subdirectory and enter the command:

./lmutil lmhostid

If you do not have EASY5 installed, then you need to enter the Unix commands in the following table.

bFor IBM RS6000, the command in the previous example returns 000276513100; remove the last two digits and use the remaining last eight digits.

Platform Command to enter on the license server

Example of hostid

HP-UX uname -i 2014000912

IBM RS/6000 uname -mb 02765131

SGI echo ‘/etc/sysinfo -s‘ 16o p | dc 69022F72

Sun uname -i 170a3472

22 MSC.EASY5 2004

STARTING THE LICENSE MANAGERBefore Starting the License Manager

Before Starting the License Manager

Versions of EASY5 prior to v6.0.4 used the FLEXlm daemon named “boeingcs”. From EASY5 6.0.4+ through v7.1, it used FLEXlm version 7.2 vendor daemon (“easy5lmd”) and lmgrd license management programs. This means if you are upgrading from any previous EASY5 version 7.1 and lower, you will need to update any existing EASY5 license servers with this version of FLEXlm -- as provided from our MSC.EASY5 CD. Only one version of the license daemon (lmgrd) should be running at one time, and this should always be the one with the latest FLEXlm version. This means you would need to:

1 Stop the existing license server (see below).2 Install updated license server files from the MSC.EASY5 CD (by installing

MSC.EASY5).3 Start the new license server (see below).

Starting the License Manager Delivered With MSC.EASY5

These startup instructions are to be used if you are using the FLEXlm license manager provided with MSC.EASY5 version 2004. A script called S998lmgrd is provided to manage the MSC.EASY5 license as follows:

S998lmgrd start Starts the license serverS998lmgrd stop Stops (kills) the license serverS998lmgrd status Displays the status of the license serverS998lmgrd update Updates the license server with new license

1 You can use this script and options at any time to manage the MSC.EASY5 license. Perform the following steps to start the license manger.

2 Set your working directory to the <host diretory>/easy5/lmgr directory and enter:

./S998lmgrd start

This script automatically starts the FLEXlm daemon process (lmgrd).

3 To make sure the daemon started properly, examine the file license.log using the command:

cat license.log


STARTING THE LICENSE MANAGERStarting Your Non-EASY5 System License Manager

NOTE: If you have trouble interpreting any error messages that are displayed, consult the FLEXlm End-User Manual, provided for you in the readme file in the lmgr directory.

4 Use the status option to further check if the daemon started properly. You can use this extremely useful utility any time to inquire about the status and activity of the license manager. Enter:

./S998lmgrd status

Starting Your Non-EASY5 System License Manager

These startup instructions are to be used if you are using a FLEXlm license manager that was not provided with MSC.EASY5.

1 Determine where FLEXlm is installed. This is most easily done by entering the following command:

ps -ef | grep lmgrd on SYS V Unix systemsps -aux | grep lmgrd on BSD or SunOS Unix systems

The response of this command includes a path name to the license.dat file. In these notes, this directory is referred to as the <default_lmgr_dir>. The MSC.EASY5 directory that contains a similar license.dat file is referred to as <host directory>/easy5/lmgr in these notes.

2 Move into the <default_lmgr_dir> directory. This directory contains the license.dat file used to manage one or more products. Edit the license.dat file, and copy the EASY5 codes provided in the MSC.EASY5 license.dat file. Then, edit the line that contains DAEMON MSC ./ and replace the ./ with the full pathname to the <host directory>/easy5/lmgr directory.

3 You are now ready to launch the lmgrd process. First, set the license variable:

setenv MSC_LICENSE_FILE ‘pwd‘/license.dat

(Note: Enter ‘pwd‘ with backward apostrophes as shown.)

24 MSC.EASY5 2004


If the license manager is not running, then start it by entering

./lmgrd > license.log

If the license manager is already running, then update your current license by entering the following:

./lmutil lmreread

4 To make sure the daemon started properly, examine the file license.log with the command:

cat license.log.

If you have trouble interpreting any error messages that are displayed, consult the FLEXlm End-User Manual, provided for you in the readme file in the lmgr directory.

5 Use the lmstat utility to further check if the daemon started properly. You can use this extremely useful utility any time to inquire about the status and activity of the license manager. Enter the following:

./lmutil lmstat -S MSC

To display the various lmstat options, enter

./lmutil lmstat -help

If the license manager is not running, then start it by entering

./lmgrd > license.log

If the license manager is already running, then update your current license by entering the following:

./lmutil lmreread

1 To make sure the daemon started properly, examine the file license.log with the command:

cat license.log.


2 Use the lmstat utility to further check if the daemon started properly. You can use this extremely useful utility any time to inquire about the status and activity of the license manager. Enter the following:


To display the various lmstat options, enter

./lmutil lmstat -help


26 MSC.EASY5 2004


UP D A T I N G Y O U R L I C E N S E5

These instructions are for updating an MSC.EASY5 license that is currently running. It assumes that you already have the MSC daemon running a current MSC.EASY5 license, but that you have updated the license features in the license.dat file, and you now need to update the license manager with the new features. There is no need to stop the license manager, or even stop the MSC daemon. Instead, you can use the lmreread command as instructed in the following steps.

1 First, determine which directory is being used by FLEXlm to manage your MSC.EASY5 license by entering

easy5x -license

This returns the directory which contains the license.dat file used to manage the MSC.EASY5 license.

2 Move to this directory by using the “cd” command.

3 If you are using the FLEXlm provided with MSC.EASY5, enter the following commands:

S998lmgrd update

Otherwise, enter the following commands:

setenv MSC_LICENSE_FILE ‘pwd‘/license.dat

(Note: enter ‘pwd‘ with backward apostrophes as shown)

./lmutil lmreread

This updates the FLEXlm daemon process (lmgrd) with your new license.


UPDATING YOUR LICENSEStarting Your Non-EASY5 System License Manager

4 To make sure the license was properly updated, examine the file license.log using the command

cat license.log


5 Enter the following command to get the license status:

./S998lmgrd status

Alternately, you can use the lmstat utility to further check if the daemon started properly. This is an extremely useful utility that can be used any time to inquire about the status and activity of the license manager. Enter:


28 MSC.EASY5 2004

SE T T I N G UP LI N K S A N D TE S T I N G YO U R IN S T A L L A T I O N

6

This section explains the procedure used to set up links in order to test your installation.

Creating a Link

Create a link to the MSC.EASY5 script so that all users have the command easy5x in their command search path (environment variable PATH in Unix shells). For example, the link may be placed in the /bin directory; all users should have the /bin directory in their search path.

If you don’t want to use a link, you will need to instruct individual MSC.EASY5 users how to perform this step themselves, or use an alias.

1 To create a link in the /bin directory, first move to this directory by entering the command cd /bin.

Do not use the cd command to go to the <host_directory>/easy5/easy5x/bin directory.

2 To establish the link, enter the following commands:

ln -s <host_directory>/easy5/easy5x/bin/easy5x.ksh easy5x

rehash

3 If, after creating links, users are having trouble accessing MSC.EASY5, have the user enter the command:

which easy5x

If the response is no easy5x in ..., expand each user search path to include the directory containing the link or change the location of the links to be in the search path.

4 To run MSC.EASY5, users must have the DISPLAY environment variable set correctly. This should be set to whatever is returned by the command hostname followed by :0.0. For example, in the C Shell, the command hostname should be entered, to which the computer responds with something such as barco. The user should then enter:

setenv DISPLAY barco:0.0.


SETTING UP LINKS AND TESTING YOUR INSTALLATIONCreating a Link

Alternatively, a single line inserted in each user .login file could read

setenv DISPLAY ‘hostname‘:0.0

(Note: Enter ‘hostname‘ using backward apostrophes as shown.)

In addition, the computer must be configured to run the standard TCP/IP protocol. A way to test this is to enter the command telnet ‘hostname‘.

If the response is not a login prompt or is a message such as Network is unreachable, MSC.EASY5 cannot start. If the response is a login prompt, log in as yourself and then exit.

5 Perform a quick test of the MSC.EASY5 installation. Move to a working directory, and enter the following command to copy a test file:

easy5x -tutorial

This copies an MSC.EASY5 model named mass_default. Run MSC.EASY5 and load the model by entering

easy5x mass_default

If the installation is successful, the MSC.EASY5 window is displayed with the Opening Menu dialog box. Now, test to see that the necessary compilers are linked. Build an executable model by selecting Build > Create Executable from the menu bar. This launches a background process that builds and compiles an executable model.

If the build is successful, the message “EASY5 executable has been created” is displayed at the bottom of the MSC.EASY5 status line bar. If the build fails, then check to make sure that you have access to a Fortran or a C compiler and that the correct paths and variables required by the compilers are set correctly. See “"Setting Up Links and Testing Your Installation" on page 29 for further information.

When finished testing, go to File > Quit to exit. If the installation was not successful, review these instructions and make sure you correctly followed the steps. Also, make sure that your X server, window manager, and compilers are properly configured. To finish installing MSC.EASY5, you must set up the printer options as instructed in the following chapter.

30 MSC.EASY5 2004

DE F I N I N G DE F A U L T PR I N T E ROP T I ON S

7

MSC.EASY5 uses the print options settings file schema_print_config. This is used to set up the printing of the schematic block diagram. When the plotter is run, MSC.EASY5 uses the print options settings file plot_print_config. This is used to set up the printing of the plots. These two files are in the directory named <easy5 home>/resource/settings, where <easy5 home> is the directory where MSC.EASY5 is installed. You can determine this directory by entering easy5x -home at a shell prompt.

As the installer, you must modify these files to define your site’s default print command and the printer name. You can also modify any other print file format options. The usage and setup of these files is straightforward; comment lines are used to explain each data entry. Edit and change these two files:

<easy5 home>/resource/settings/schema_print_config

<easy5 home>/resource/settings/plot_print_config

The print command line (option 10) is set to unspecified; enter the appropriate command for your system. For System5 (SVR3, SVR4), use the lp-c command. For Berkeley (BSD4.3) systems, use the lpr command.

The printer name line (option 11) is set to lp; enter the appropriate printer name for your system.

Having edited these files, each user sees the options you specify as their default print options. Note that each MSC.EASY5 user can create and save their own custom print options settings and save and restore them to their current or home directories by selecting Save and Restore options in the File menu of the Print Options form. The programs first looks for these files in the current working directory, then in the user’s home directory, and finally in the <easy5x home>/resource/settings directory


DEFINING DEFAULT PRINTER OPTIONSCreating a Link

32 MSC.EASY5 2004

PL A T F O R M SP E C I F I C NO T E S 8

If you are running the Open Look Window Manager, make sure that you start in the focus follow mode, using the command olwm -f. The default mode for Open Look is click to type, which is not what you want. MSC.EASY5 does not run properly if you run in this mode.

Sun workstation users may receive warning messages when starting MSC.EASY5. These warning messages contain many lines telling you that translation keys were not found. MSC.EASY5 still runs but will not allow the usage of the backspace and delete keys within the software.

If either of the above warning messages occur, perform the following steps.

1 Create a directory (if one does not exist) named $OPENWINHOME/lib, where $OPENWINHOME is the directory specified by the OPENWINHOME environment variable. To determine this directory, enter echo $OPENWINHOME.

2 Move the XKeysymDB file located in the easy5x -home/resource directory to the directory created in step 1.

The Sun Solaris installation requires the following three items be set correctly:

1 You need the paths for the ar and f77 commands set. To check if these are set, enter the two commands and see if the commands are found. If not, enter the which or the whereis command (i.e., which ar) to determine the location, then add it to your path.

2 You may need to set the LD_LIBRARY_PATH environment to point to the f77 library and also include it in your own path. For 2.x Fortran compilers, the path name is most likely /usr/lang/lib. For 3.x Fortran compilers, the path name is most likely /opt/SUNWspro/lib.


PLATFORM SPECIFIC NOTESSGI Workstation Installations

These directory pathnames depend on how your Fortran compiler was installed and may be different from the listed names. Check to see what the variable is set to, by entering env | grep LD_LIBRARY_PATH. If it is not set correctly, then add this as a colon extension to the end of the variable using the appropriate Unix command.

For example, if you need to add /opt/SUNWspro/lib to the LD_LIBRARY_PATH variable, enter the following C Shell command:

setenv LD_LIBRARY_PATH /path1:/path2: ... :/opt/SUNWspro/lib

This should be added to the user’s .profile, .login, or .cshrc file.

SGI Workstation Installations

Current SGI platforms are being delivered with 64-bit operating system and 64-bit chip sets. The compilers are capable of generating 64-bit or 32-bit object code, depending on their settings. MSC.EASY5 is delivered with 32-bit and 64-bit object code libraries, and which library MSC.EASY5 uses is selected at installation. Once this is done, every time you start EASY5, the SGI_ABI environment variable is set. This environment variable tells the SGI compilers and linkers whether to use 32-bit or 64-bit mode. For further information on SGI_ABI, look at a man page for a compiler such as f77 or cc.

The settings selected by MSC.EASY5 are

library: lib_sg40 ---> SGI_ABI = -32

library: lib_sg60 ---> SGI_ABI = -64

You need the paths for the ar and f77 commands set. To check if these are set, enter the two commands and see if the commands are found. If not, enter the which or the whereis command (i.e., which ar) to determine the location, then add it to your path.

If you cannot find the ar command, it may not have been installed with your OS, as SGI has removed it from the minimum required set of programs as of IRIX 6.5. The ar command should be in /usr/bin, and is found on the IRIX Foundation CD (as of 6.5) under dev.compilers.sw.util - usr/bin/ar. MSC.EASY5 cannot function without the ar command.

34 MSC.EASY5 2004

CO N F I G U R I N G YO U R X SE RV E RA N D WI N D O W S MA N A G E R

9

The MSC.EASY5 graphical interface is based on the X Windows environment. The software will run on computers with X11 R4 (and higher) compliant operating systems and an X Windows Manager that conforms to your configuration; the exception is the IBM RS6000, which requires Motif 1.2 running X11R5.

NOTE: It is strongly recommended that users run MSC.EASY5 under the Motif Window Manager (MWM). MSC.EASY5 is written using Motif widgets and behaves better under MWM than under other window managers. In addition, the user’s X resource file (such as .Xdefaults) should contain the line Mwm*keyboardFocusPolicy: pointer

Depending on which X Server and Window Manager you are using, the systems typically come with the example files listed below, containing default settings.

File Description

.xinitrc X Server startup script executed during X Windows initialization.

.mwmrc MWM startup script.

.twmrc MIT Typical Window Manager (TWM).

.openwin-init Start-up script for Openlook Window Manager executed by the default Openwin .xinitrc. If you have your own .xinitrc, make sure it runs .openwin-init.

.openwin-menu Root menu custom file. Similar to .mwmrc and .twmrc.


CONFIGURING YOUR X SERVER AND WINDOWS MANAGERSGI Workstation Installations

To use MSC.EASY5, you must have the location of the X11 files in your path. This is typically set in the user’s .cshrc or .profile file. In a Sun installation these could be located in /usr/lib/X11, /usr/bin/X11, /usr/lib/X11R4, /usr/lib/Motif1.1, or /usr/openwin/lib.

NOTE: MSC.EASY5 Support cannot provide help in configuring your network or X Windows software. Please check with your system administrator or call the computer manufacturer for help.

36 MSC.EASY5 2004

PC X TE R M I N A L AC C E S S T OUNI X W I T H EX C E E D

1 0

Many users use an X terminal from a workstation running the Windows operating system to access EASY5 on a Unix workstation. It is highly recommended that you use the Hummingbird Communications, Ltd., Exceed X Server software. This section describes the Exceed setup and recommended settings.

NOTE: It is highly recommended that you use version 5.1.3 or greater of Exceed for compatibility with Windows NT version 4.0. For Windows 9x/Me, use Exceed v6.0+. If you are using Windows 2000, you should use Exceed 6.2.0.17 or higher, preferably Exceed 7.0. If you do not have this version, contact Hummingbird directly to obtain an update.

Exceed Configuration Settings

Exceed configuration settings are a powerful means to control how MSC.EASY5 works and displays on your computer. If you are using Exceed for other applications, be careful that settings you make for other applications do not negatively impact your MSC.EASY5 environment, and vice versa. Exceed configuration settings are managed by the Xconfig program. Settings are stored in the Exceed User directory as file exceed.cfg.

Launching the Exceed Configuration Program

You can access the Exceed configuration settings by CLICK-R the Exceed Task on the Taskbar and selecting Tools > Configuration. This launches Xconfig, the Exceed configuration program. You can use this program to view and modify your Exceed configuration settings. Currently, Hummingbird does not provide a way to remotely configure Exceed for use with MSC.EASY5. Therefore, you must launch the Exceed Configuration tool and make settings manually. To do this, select the application Xconfig from the Start Menu (under Programs > Exceed or Hummingbird > Connectivity ), or CLICK-R an existing Exceed icon on the Taskbar and select Tools > Configuration menu item.


PC X TERMINAL ACCESS TO UNIX WITH EXCEEDLaunching the Exceed Configuration Program

Recommended Default Exceed Settings for MSC.EASY5Without the correct Exceed configuration settings, MSC.EASY5 may not be properly enabled. Please follow these instructions to avoid such problems.

It is strongly recommended to start with the default settings throughout and then ensure that the following settings are correct:

Exceed 5.1.3

InputMiddle Button Emulation = YES (if your mouse is a 2-button mouse)

CommunicationMode = Passive (enables local X clients like EASY5)

Window ModeClose Warning on Exit = NOCascade Windows = NOFocus Policy = Click (see discussion on p. 32)

X SelectionAuto Copy X Selection = NOAuto Paste to X Selection = NO

PerformanceSave Unders = YESMaximum Backing Store = When MappedDefault Backing Store = When MappedMinimum Backing Store = When Mapped

38 MSC.EASY5 2004


Exceed 6.x, Exceed 7.x, Exceed 8.0

(Keyboard) InputMiddle Button Emulation = YES (if your mouse is a 2-button mouse)

CommunicationMode = Passive (enables local X clients)

Screen DefinitionCommon Settings (Tab)Close Warning on Exit = NOFocus Policy = ClickScreen 0 (Tab)Cascade Windows = NOWindow Mode = MultipleWindow Manager = Native

PerformanceSave Unders = YESMaximum Backing Store = When MappedDefault Backing Store = When MappedMinimum Backing Store = When Mapped



40 MSC.EASY5 2004

CO N F I G U R I N G YO U R SY S T E M T O RU N MSC.ADAMS A N D MSC.EASY5

1 1

To run MSC.ADAMS and MSC.EASY5 together as documented in the MSC.ADAMS manual “Getting Started with MSC.ADAMS/Controls”, you must first install the MSC.ADAMS extension into MSC.EASY5.

In addition, if you wish to import models exported from MSC.EASY5 that contain components from licensed MSC.EASY5 libraries into MSC.ADAMS 2003, you must first configure your computer so that MSC.ADAMS can locate your MSC.EASY5 license.

Installing the MSC.ADAMS/Controls Extension

1 Verify that both MSC.EASY5 v2004 and MSC.ADAMS 2003 have been installed.

To install the MSC.ADAMS extension into MSC.EASY5 v2004, you must have permission to add files to and modify files in the MSC.EASY5 installation directory. This may require you to have root (‘superuser’) privilege on Unix computers.

2 Identify the command you would enter for the version of MSC.ADAMS that you want to run with MSC.EASY5. Some examples are shown below:

MSC.ADAMS Release Command Line Command

MSC.ADAMS 2005 adams05

MSC.ADAMS 2003 adams03

MSC.ADAMS 12.0 adams12

NOTE: If you are unable to identify a command line command to run MSC.ADAMS but you can identify the top level directory of the MSC.ADAMS installation, you may use –d “directory path” in place of the command line command in the following steps.

3 Open an xterm window and set your working directory to a directory not in the MSC.EASY5 installation directory tree. (You are not allowed to run MSC.EASY5 in a program directory).


CONFIGURING YOUR SYSTEM TO RUN MSC.ADAMS AND MSC.EASY5Running Licensed Exported MSC.EASY5 Models within MSC.ADAMS

4 Start MSC.EASY5, as usually done by entering the command:

easy5x

NOTE: You may use whatever method you have used starting MSC.EASY5 according to previous instructions.

5 When the MSC.EASY5 main window appears, select the File > Open Command Shell… menu item. This opens an EASY5 Command Shell.

6 At the prompt in the EASY5 Command Shell, enter the command:

$EZHOME/install_adams_controls.ksh <adams_command>

where adams_command is the command line option from Step 2.

7 Type exit to close the EASY5 Command Shell window, and if you have opened MSC.EASY5, select File > Quit to exit MSC.EASY5.

The MSC.ADAMS extension installation is now complete.

Running Licensed Exported MSC.EASY5 Models within MSC.ADAMS

To verify that MSC.ADAMS can locate the correct MSC.EASY5 license file, identified via the environment variable MSC_LICENSE_FILE, do the following:

1 Start MSC.EASY5 and either a) select the Help > Licensed Features... menu item, and select the Info button, or b) open an MSC.EASY5 command shell by selecting the File > Open Command Shell… menu item.

2 If using method b) at the prompt in the command shell, enter:

easy5x –license.

The resulting text output includes the value of MSC_LICENSE_FILE to use.

Then, environment variable MSC_LICENSE_FILE should be set to this value whenever running MSC.ADAMS containing an embedded MSC.EASY5 exported system model. Please see your Release Notes for information on setting environment variables.

42 MSC.EASY5 2004