mscweb.mscsoftware.com/support/prod_support/adams/... · installing msc.adams on windows getting...

MSC.ADAMS

Installing MSC.ADAMSon Windows

MSC.ADAMS 2003

Version 1.0

ii Installing MSC.ADAMS on Windows Copyright

The information in this document is furnished for informational use only, may be revised from time to time, and

should not be construed as a commitment by MSC.Software Corporation. MSC.Software Corporation assumes

no responsibility or liability for any errors or inaccuracies that may appear in this document.

Copyright Information

This document contains proprietary and copyrighted information. MSC.Software Corporation permits licensees

of MSC.ADAMS™ software products to print out or copy this document or portions thereof solely for internal

use in connection with the licensed software. No part of this document may be copied for any other purpose or

distributed or translated into any other language without the prior written permission of MSC.Software

Corporation.

Copyright © 2003 MSC.Software Corporation. All rights reserved. Printed in the United States of America.

Trademarks

ADAMS, EASY5, MSC, MSC., MSC.ADAMS, MSC.EASY5, and all product names in the MSC.ADAMS

Product Line are trademarks or registered trademarks of MSC.Software Corporation and/or its subsidiaries.

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. All other trademarks are

the property of their respective owners.

Government Use

Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212

(Commercial Computer Software) and DFARS 227.7202 (Commercial Computer Software and Commercial

Computer Software Documentation), as applicable.

Installing MSC.ADAMS on Windows iiiContents

Contents

Chapter 1. Getting Started 1

Overview 1Welcome to MSC.ADAMS Products 2What You Need 2About the MSC.ADAMS CDs 5Getting Help 5Once You Install MSC.ADAMS Products 6

Chapter 2. Installing MSC.ADAMS 7

Overview 7About Installing MSC.ADAMS Products 8Product Names 9Typical Installation 10File Server Installation 14License Installation 17Installing the MSC.ADAMS Online Help 18

Chapter 3. Managing MSC.ADAMS Licensing 21

Overview 21Licensing Basics 22About the License File Format 23Using Your Password Certificate to View License Setup 25Setting Up Initial Licensing 26Running Two Versions of MSC.ADAMS Products 29Updating Your License 30Troubleshooting the License Server 31Customizing End-User License Administration 32

Chapter 4. Troubleshooting 35

iv Installing MSC.ADAMS on WindowsContents

Overview 35Generating Problem Reports 36Obtaining New Passwords 36Common Problems 37

Chapter 5. Uninstalling Previous Versions of MSC.ADAMS 47

Index 49

1 Getting Started

OverviewThis chapter describes what you need to know and have available to install the MSC.ADAMS products. It contains the sections:

■ Welcome to MSC.ADAMS Products, 2

■ What You Need, 2

■ About the MSC.ADAMS CDs, 5

■ Getting Help, 5

■ Once You Install MSC.ADAMS Products, 6

Installing MSC.ADAMS on Windows

Getting Started2

Welcome to MSC.ADAMS ProductsMSC.ADAMS products provide you with tools to model, simulate, and optimize your mechanical systems. This guide explains how to install and license the MSC.ADAMS products on Windows, and gives you troubleshooting tips if you have any problems during an installation.

What You NeedBefore you start installing MSC.ADAMS products, there are a few things that you should be sure to do or have available:

■ Check to ensure that your Windows system contains the required hardware and software. Refer to the hardware and software specifications that come with your MSC.ADAMS software. For more on the hardware and software specifications, see the section, About Your Hardware and Software Specifications below.

■ Have your password certificate available so that you can get passwords and other information from it. For more on your password certificate, see About Your Password Certificate on page 3.

■ Obtain any general-user software patches at the MSC.ADAMS Web site at http://www.mscsoftware.com/support/prod_support/adams/. Once you are at our Web site, select Product Updates.

About Your Hardware and Software Specifications

The hardware and software specifications help you determine the requirements for your platform so that you can install, license, and run the MSC.ADAMS products. They also list the memory and disk space requirements. Please review these specifications before you select the system on which you want to install the MSC.ADAMS software. You can also access the hardware and software specifications at the MSC.ADAMS Web site at http://www.mscsoftware.com/support/prod_support/adams/

http://www.mscsoftware.com/support/prod_support/adams/



Getting Started3

About Your Password Certificate

To run the MSC.ADAMS products, you need passwords and licensing information that authorize their use. The passwords are listed on your password certificate. The password certificate is sent to you by e-mail.

When you receive the password certificate, copy it to a file as explained in the e-mail message. You can then use the file as input to the installation program.

The password certificate contains information necessary for installation. The installation information appears on the first page of the certificate as follows:

■ License contract information, including your request number, company name, license agreement number, and platform.

■ MSC.ADAMS license server IDs and a password (INCREMENT) for each product.

Your certificate also contains packaging information if the certificate was sent with your software, administrative information, and software licensing information. This information appears after the installation information.

The passwords listed on the password certificate are encoded. As you enter them, the installation program decodes them to ensure that they match the other information that you have entered.


Getting Started4

About Your License

There are two types of licenses for MSC.ADAMS products:

■ ADAMS: In the traditional method of providing software products, one software purchase equals one seat/license of that product. Two seats of a software product allows for two simultaneous use of that software solution. If a different software solution was needed, a new seat or seats of the new software solution must be purchased.

■ CAMPUS: The VPD Campus License System is a token-based method, where you purchase a pool of tokens. Tokens are checked out from the pool and are used to access and run a full range of CAE solutions available under the VPD Campus License System from MSC.Software. Each individual product feature requires a certain number of tokens to run. After each use, the tokens are returned to the pool for other use. If all the tokens are in use, a batch request will go into a queue or an interactive request can be made so that the user may wait for available tokens on a first-come/first-served basis. For more information on the MSC VPD Campus License System, see our Web site at www.mscsoftware.com.

Refer to Managing MSC.ADAMS Licensing on page 21 for more information on licensing.

www.mscsoftware.com

www.mscsoftware.com

www.mscsoftware.com


Getting Started5

About the MSC.ADAMS CDsTwo CDs come with your MSC.ADAMS products. The first CD contains all of the files required to run the MSC.ADAMS products and install the documentation. The second CD contains the online documentation so users can access it offline, or install it in a different location. The CDs are:

■ Products - Complete set of MSC.ADAMS products. Refer to your password certificate for the MSC.ADAMS products for which you are licensed.

■ Online documentation - Online help in HTML format and tutorials in PDF format. We also provide Adobe Acrobat Reader 5.0 for your convenience.

Getting HelpIf you have questions or problems installing or testing your MSC.ADAMS products, refer to Troubleshooting on page 35. If the problems persist, go to the Customer Services Web pages at http://www.mscsoftware.com/support/prod_support/adams/. If the problems still persist, call MSC.Software Technical Support at the numbers listed below. Before contacting Technical Support, please have the following information available:

■ Hardware type (be as specific as possible)

■ Version of the Windows operating system, including build number and service packs

■ Hardcopy of all error messages (you can send it by fax or through e-mail)

If possible, generate a troubleshooting report as explained in Generating Problem Reports on page 36.

United States(800) 732-7284

InternationalContact your local distributor.



Getting Started6

Once You Install MSC.ADAMS ProductsOnce you install the MSC.ADAMS products, refer to the printed Welcome to MSC.ADAMS on running MSC.ADAMS products and the online help.

2 Installing MSC.ADAMS

OverviewThe installation of MSC.ADAMS products is divided into two parts: installing the files and online documentation, and licensing the products. The following sections explain how to install MSC.ADAMS products and online documentation by running the MSC.ADAMS installation program. For information on licensing MSC.ADAMS products after you’ve installed them, see Managing MSC.ADAMS Licensing on page 21.

■ About Installing MSC.ADAMS Products, 8

■ Installing the MSC.ADAMS Online Help, 18


Installing MSC.ADAMS8

About Installing MSC.ADAMS ProductsThere are three ways to install MSC.ADAMS products:

■ Typical Installation: Installs MSC.ADAMS software and licensing on one machine only.

■ File Server Installation: Configures one machine as a file server for MSC.ADAMS software and licensing. Other computers can then be configured as clients to access from this machine.

■ License Installation: Configures one machine as an MSC.ADAMS license server only, without installing any MSC.ADAMS product software.

Follow the steps in the appropriate sections that follow.



Product Names The product(s) you are licensed to use for MSC.ADAMS 2003 appear on the first page of your password certificate under the section Feature/Password.

Following are the available categories:

■ Core: Include ADAMS/View and ADAMS/Solver. Select Subproducts to remove Core products you do not want to install. Both Core products are required for any Vertical or Plugin product to run.

■ Vertical: Include ADAMS/Car, ADAMS/Driveline, ADAMS/Engine, ADAMS/Rail, and ADAMS/Aircraft. Select Subproducts to remove any Vertical products you do not want to install. Both Core products must be installed for any Vertical product to run.

■ Plugin: Include ADAMS/Car Ride, ADAMS/AutoFlex, ADAMS/Controls, ADAMS/Durability, ADAMS/Hydraulics, and ADAMS/Vibration. Select Subproducts to remove any Plugin products you do not want to install. Both of the Core products and certain Vertical products must be installed for these to run.

■ Standalone: Include ADAMS/PostProcessor, ADAMS/Insight, ADAMS/Chassis, and ADAMS/Flex. Select Subproducts to remove any Standalone products you do not want to install. Standalone products do not require Core, Vertical, or Plugin products to be installed.



Typical InstallationThis section shows you how to install MSC.ADAMS software and licensing on one machine only.

To perform a typical installation:

1 On your machine, log on to an account that has administrative privileges.

2 Insert the MSC.ADAMS Products CD into your CD-ROM drive.

The MSC.ADAMS for Windows Installation System dialog box appears. If the setup program does not start automatically, open Windows Explorer, select your computer’s CD-ROM drive, and double-click setup.exe. The Welcome dialog box appears.

3 Follow the instructions and precautions in the Welcome dialog box and then select Next.

4 From the Choose Install Type and Destination Location dialog box, select Typical.

5 If you would prefer MSC.ADAMS to be installed in a folder other than the default destination folder, select Browse, and then select the desired folder.

The default directory for installing MSC.ADAMS products is c:\Program Files\MSC.ADAMS x, where x is the version of the products you are installing.

6 Select Next.

The MSC.ADAMS 2003 Installation dialog box appears.

7 From the MSC.ADAMS 2003 Installation dialog box, select to install the online help files, and the types of MSC.ADAMS products to install.

Refer to your password certificate for the feature names of the products you are licensed to install and Product Names on page 9 to help you select the correct products during installation.



8 Select Next.

The Start Installation dialog box appears.

9 Select Next again to execute the installation.

If you specified to install the online help, you will be prompted to continue with the documentation portion of the installation.

10 Accept the default installation location for the online help files.

Note: If you specify a location other than the default, the help files will not be integrated with the product. In other words, if you press F1 from a dialog box, the help will not be found.

11 Select Install Acrobat Reader if you do not have a copy of Adobe Acrobat Reader already installed on your system. You need this program to view the tutorials. The version is 5.0.

12 Select Next.

13 Select the products whose online help files you want to install.

14 Select Next.

15 When the installation is complete, select Finish.

16 Specify whether or not you want to install desktop icons, and then select Finish.

Once the product and online help installation is complete, the Licensing dialog box will appear.

17 Select the type of license you want to apply, and then select Next.

18 If you installed ADAMS/Controls, you need to install the MSC.ADAMS Extension for MSC.EASY5. Previously, this was done automatically by the ADAMS/Controls install program. For more information, refer to Installing the MSC.ADAMS Extension for MSC.EASY5 on page 12.

19 When finished, remove the MSC.ADAMS Products CD-ROM.



Installing the MSC.ADAMS Extension for MSC.EASY5

The following applies to the MSC.ADAMS 2003 release only.

The extension component for MSC.ADAMS in MSC.EASY5 (ADAMS extension) provides a mechanism for integrating an MSC.ADAMS model as a component in the MSC.EASY5 environment. Generally, the MSC.ADAMS extension is part of the delivery of MSC.ADAMS and should be installed into the MSC.EASY5 hierarchy as directed below.

To automate this process, we included a script called install_adams_controls.py in the MSC.ADAMS 2003 release software. This script can be found in install_dir/controls/easy5/ (where install_dir is the installation directory of MSC.ADAMS 2003.

To use this script:

1 Copy install_adams_controls.py to your working directory (where the exported ADAMS/Controls plant files, including the inf file, reside).

Note: This is not necessary if you’re running MSC.EASY5 version 7 or above.

2 Start MSC.EASY5.

3 To open a command shell, from the File menu, select Open Command Shell.

4 Issue the following command:

■ On UNIX: adams03 -c python install_adams_controls.py exit

■ On Windows: adams03 python install_adams_controls.py exit

Note: If you don’t want to copy the .py file to your working directory, you can issue one of the following commands from an MSC.EASY5 command shell:

■ On UNIX: adams03 -c python install_dir/controls/easy5/install_adams_controls.py exit

■ On Windows: adams03 python install_dir/controls/easy5/install_adams_controls.py exit

where install_dir is the directory where MSC.ADAMS is installed.



Because the ADAMS extension is version specific, you must run this script from your current MSC.ADAMS installation directory. The installation script will overwrite the old extension installation with the new one.



File Server InstallationThis section shows you how to configure a machine as a file server for MSC.ADAMS software and licensing, and then configure other computers as clients to access from this machine.

To perform a file server installation:




3 Follow the instructions and precautions in the Welcome dialog box, and then select Next.

4 From the Choose Install Type and Destination Location dialog box, select File Server.

5 Enter the name of the directory where you want MSC.ADAMS installed.

The default directory for installing MSC.ADAMS products is c:\Program Files\MSC.ADAMS x, where x is the version of the products you are installing. To set the file server installation directory, select Browse, and then select the desired folder.

Note: You must enter the directory path without spaces (for example, c:\adams03). After entering the directory, you must share it (and any other subdirectories) with the same name as the directory itself. For example, if you entered c:\programs\adams03, you must share programs as programs and share adams03 as adams03. Setting up the clients or running MSC.ADAMS on the file server will not work properly unless the sharing is done this way.

6 Select Next.

The MSC.ADAMS 2003 Installation dialog box appears.



7 From the MSC.ADAMS 2003 Installation dialog box, select to install the online help, and the MSC.ADAMS products you want to install.

8 Select Next.

The Start Installation dialog box appears.

9 Select Next again to execute the installation.

If you specified to install the online help, you will be prompted to continue with the documentation portion of the installation.

10 Accept the default installation location for the online help files.

Note: If you specify a location other than the default, the help files will not be integrated with the product. In other words, if you press F1 from a dialog box, the help will not be found.

11 Select Install Acrobat Reader if you do not have a copy of Adobe Acrobat Reader already installed on your system. You need this program to view the tutorials.

12 Select Next.

13 Select the products whose online help files you want to install.

14 Select Next.

Once the product and online help installation is complete, the Licensing dialog box will appear.

15 Select the type of license you want to apply. See About Your License on page 4 for a description of the types of licenses.

16 If you installed ADAMS/Controls, you need to install the MSC.ADAMS Extension for MSC.EASY5. Previously, this was done automatically by the ADAMS/Controls install program. For more information, refer to Installing the MSC.ADAMS Extension for MSC.EASY5 on page 12.

17 When finished, remove the MSC.ADAMS Products CD-ROM.

18 If necessary, install the online help by following the steps in Installing the MSC.ADAMS Online Help on page 18.

The installation and licensing process is complete. You can now run your MSC.ADAMS products.



To set up a client machine for a file server installation:

1 On the client machine, open My Network Places, and then browse to the File Server installation directory.

For example, if the fileserver name is FS01, you would browse to \\FS01\adams03\Client Setup.

2 Double-click the Client Setup shortcut. This executes the setup program.

3 From the Start menu, point to Programs, point to MSC.Software, point to MSC.ADAMS 2003, and then select the MSC.ADAMS product(s) you want to run.



License InstallationThis section shows you how to configure this machine as an MSC.ADAMS license server only, without installing any MSC.ADAMS product software.




3 Follow the instructions and precautions in the Welcome dialog box and then select Next.

4 From the Choose Install Type and Destination Location dialog box, select License.

5 Select Next.

The MSC.ADAMS License Manager software is installed on your machine and setup is complete.



Installing the MSC.ADAMS Online Help

Note: If you installed the online help as part of the product installation, you do not need to complete this section.

The online help installation program installs the following:

■ Online help in HTML format and tutorials in PDF format. If you do not install the online help to a disk drive, you can view it from the CD-ROM.

■ Adobe Acrobat Reader so you can view the online documentation from within MSC.ADAMS products. The installation program for Reader is separate from the MSC.ADAMS installation program.

To install the MSC.ADAMS online help after the product installation:

1 Insert the MSC.ADAMS Online Help CD into your CD-ROM drive.

2 Follow the instructions on your screen to install the MSC.ADAMS online help. Select the Next button to continue through the installation.

The installation program asks you to choose the following:

■ Directory in which you want to place the MSC.ADAMS online help.

The default directory for installing MSC.ADAMS online help is where you installed the MSC.ADAMS products. In order for it to function properly, you must keep the online help with the MSC.ADAMS products.

■ Online help that you want to install. Be sure that you have enough disk space to install the documentation that you select. As you select files to install, the installation program displays the disk space required to install the files. If you do not have enough disk space to install the online help, you can clear the selection of some of the products, change your installation directory, or remove unused files from the current file system. Remember that you can always read the online help from the CD-ROM if you do not install all of it.



3 When the installation is complete, select Finish.

If you selected to install Adobe Acrobat Reader the installation program appears.

4 Follow the instructions on your screen to install Acrobat Reader. Select the Next button to continue through the installation. When the installation is complete, select Finish.

3 Managing MSC.ADAMS Licensing

OverviewMSC.ADAMS products use a license server to manage the access to its products. Therefore, before you can run the products you just installed, you must license them. The next sections explain more about MSC.ADAMS licensing, the initial licensing options, and how you can manage the licensing after you’ve initially licensed the products.

■ Licensing Basics, 22

■ Setting Up Initial Licensing, 26

■ Updating Your License, 30

■ Troubleshooting the License Server, 31

■ Customizing End-User License Administration, 32


Managing MSC.ADAMS Licensing22

Licensing BasicsYou can license MSC.ADAMS products in three ways:

■ Set up a license server that is available to your users through the network, and set up the number of users who can use MSC.ADAMS. The number of users who can run MSC.ADAMS concurrently depends on the number of licenses you purchased. Refer to your password certificate for information on the number of users who can run MSC.ADAMS.

You can run the license server on one machine or on three. We strongly recommend that you use a one-server configuration, however. If you select a three-server configuration, the machines act as backups to the other machines. You must install passwords on all of the server machines to set up a three-server configuration.

You can select to load only the licensing tools on the license server and install the MSC.ADAMS products only on the clients.

You also can set up the licensing so that it is locked to a particular machine or node. If your MSC.ADAMS licensing is node-locked, then users can only run MSC.ADAMS products on that machine. To see if you have purchased node-locked licensing, refer to your password certificate.

■ Enter an evaluation password so you can evaluate MSC.ADAMS products before purchasing them. In this case, you do not use a license server. You cannot use an evaluation password with the VPD Campus License System. (For more on VPD Campus Licensing, see About Your License on page 4.

■ Set up a client using an existing license server.



About the License File FormatThe installation program converts the MSC.Software passwords that you enter to valid FLEXlm license files (license.dat). The following shows a simple example of license.dat and explains each line in the file.

SERVER earth 69092d71 1986DAEMON adamsd /usr/adams03/network/irix32/adamsd

INCREMENT ADAMS_FULL_SIM_PACKAGE adamsd 2003.0 31-jan-2005 509BCA0D8102DE VENDOR_STRING=MDIISSUED=14-apr-2003 SUPERSEDE HOSTID=69092d71

■ SERVER keyword - The SERVER line contains the MSC.ADAMS license server’s hostname, unique hostid, and the TCP/IP port number that the procedures will use to communicate with license daemons.

■ DAEMON keyword - The DAEMON line contains the name of MSC.Software’s license daemon and the file system path to find that daemon.



■ INCREMENT keyword - INCREMENT lines are the license for MSC.ADAMS software. An INCREMENT line always contains:

■ INCREMENT keyword

■ INCREMENT name - The name of the license.

■ Name of MSC.Software’s license daemon (should be the same as the DAEMON line).

■ Version number - The major revision number of MSC.ADAMS for which the license will authorize use. You can also run previous versions of MSC.ADAMS that have a revision number less than the revision number of your license.

■ Expiration date - The date on which the license expires.

■ Number of licenses granted - The number of simultaneous uses of the product that the license authorizes.

■ Password key - 12- character string, which is the encrypted password.

■ VENDOR_STRING - The company (MSC.Software) that issued the password.

■ ISSUED date - The date on which the license was issued. It acts as a time-stamp on the password; it is used with the SUPERSEDE keyword.

■ SUPERSEDE keyword - Used with the ISSUED date to time stamp the password and replace any previous passwords that match the INCREMENT name.

■ HOSTID - The optional hostid locks the use of the product to a particular system.



Using Your Password Certificate to View License SetupAll the information about the licensing that you have purchased from MSC.Software is available on your password certificate. The password certificate shows the products you have licensed, the machines on which you will run the license server, and the number of users, or clients, that can run MSC.ADAMS at a time.

Figure 1 shows the portion of the password certificate containing license information. The numbers on the password certificate in Figure 1 refer to information you enter during licensing. The licensing steps in the next sections refer to these numbers to help you know what information to enter.

As noted earlier, MSC.Software e-mails your password certificate to you. Before setting up your licensing, as explained in the next section, be sure to have your password certificate available, and copy it to a file as explained in the e-mail message.

Figure 1. Password Certificate License Information

Note that under the section Feature/Password, MSC.Software lists the products that you have been licensed to use. MSC.Software uses the feature names of the products as you enter them into the installation program, not the actual names of the products. Refer to Product Names on page 9 for a list of the feature names and what you select when installing the products as explained in Installing MSC.ADAMS on page 7.

ATTENTION SOFTWARE INSTALLERTHIS PASSWORD INFORMATION IS REQUIRED TO AUTHORIZE YOUR SOFTWARE

Server Host Name Server Host ID Issued Dateibmrs 1315C 19-JAN-2002

Node LockedFeature/Password Expiration Date Users Host ID ADAMS_FULL_SIM_PACKAGE 31-JAN-2005 1 5c2d32f

DA906978D91E

1 2

8

64

3

75



Setting Up Initial LicensingAs explained in Licensing Basics on page 22, there are three ways to license MSC.ADAMS products. The next sections explain how to set up each of these options:

■ Setting Up a License Server and Entering Passwords, 26

■ Entering an Evaluation Password, 27

■ Setting Up a Client, 28

Setting Up a License Server and Entering Passwords

In this section, you set up a license server on the machines on which you are licensed to run it. The installation program automatically starts the license server.

To enter a server password and start a license server:

1 Log on to an account on your machine that has administrative privileges.

2 Be sure that you still have the MSC.ADAMS for Windows Installation System dialog box displayed on your screen. If it is not, insert the MSC.ADAMS Products CD in your CD-ROM drive and select your drive from the Windows Explorer.

3 From the MSC.ADAMS for Windows Installation System dialog box, select License ADAMS.

4 Select Server License and then select Apply.

The Server License Setup dialog box appears.

5 Use the Browse button to locate the password certificate file, and then select OK.

The installation program reads the file and creates a license server for you.



Entering an Evaluation Password

MSC.Software lets you evaluate MSC.ADAMS products before purchasing them. In this case, you do not use a license server. You simply enter an evaluation password.

Note: You cannot use an evaluation password with VPD Campus Licensing.

To enter an evaluation password:



3 Select Evaluation License, and then select Apply.

The Evaluation License Setup dialog box appears.

4 Enter your 12-character password.

5 Select OK.



Setting Up a Client

If you already installed MSC.ADAMS on your network and have a license server running, you can enter the hostname and TCP/IP port number of the license server to run MSC.ADAMS from that license server. If a license server is running on the current machine, the installation program shuts it down.

For MSC.ADAMS installations, the TPC/IP port number defaults to 1986 and is in the following format, where hostname is the name of the host:

1986@hostname

If you do not know the name of the host, enter the command hostname at a command prompt. Or, you can refer to the SERVER line of your password certificate/license file.

To enter the port number and host name:



3 Select Client License, and then select Apply.

4 In the dialog box that appears, enter the TCP/IP port number and host name.

Note: If your license uses three servers, enter the host names of all three servers. Most installations have only one server.

5 Select OK.

You can now run MSC.ADAMS from the license server.



Running Two Versions of MSC.ADAMS ProductsYou can run two versions of MSC.ADAMS on the same machine. Both of the versions can be installed on the same machine.

To install and license two versions of MSC.ADAMS:

1 Install the new version of MSC.ADAMS from the CD, as explained in Installing MSC.ADAMS on page 7.

2 License the new version of MSC.ADAMS from the CD, as explained in Setting Up Initial Licensing on page 26.

3 Set up previous version of MSC.ADAMS as client to the same machine, as explained in Setting Up a Client on page 28.

For example, if the previous version of MSC.ADAMS was 12.0, do the following:

■ From the Start menu, point to Programs, point to ADAMS 12.0, point to License, and then select Client.

■ Enter the name of the machine, and then select OK.



Updating Your LicenseThe following explains how to update the licenses for your MSC.ADAMS products. To obtain new passwords, see Obtaining New Passwords on page 36.

Updating an Evaluation License

If your evaluation license expired, you can update it if you have received an updated license from MSC.Software.

To update an evaluation license:

1 From the Start menu, point to Programs, point to MSC.Software, point to MSC.ADAMS 2003, point to License, and then select Evaluation.

The Evaluation License Setup dialog box appears.

2 Enter your 12-character password.

3 Select OK.

Updating Your License Server

If you have received new passwords from MSC.Software, you can update your license server.

To update your license server:

1 From the Start menu, point to Programs, point to MSC.Software, point to MSC.ADAMS 2003, point to License, and then select Server.

2 Follow the instructions in Setting Up a License Server and Entering Passwords on page 26.



Starting and Stopping Your License Server

To start your license daemons:

■ From the Start menu, point to Programs, point to MSC.Software, point to MSC.ADAMS 2003, point to License, and then select Start - License Server.

To stop your license daemons:

■ From the Start menu, point to Programs, point to MSC.Software, point to MSC.ADAMS 2003, point to License, and then select Stop - License Server.

Troubleshooting the License ServerTo help you track and manage license data, we’ve included a license tool, called lmtools. The tool is in the network subdirectory of your MSC.ADAMS installation directory and it is called lmtools.exe.

To run lmtools:

■ From the Start menu, point to Programs, point to MSC.Software, point to MSC.ADAMS 2003, point to License, and then select Tools (FLEXlm tools).

To check that the license manager daemon (lmgrd and adamsd) is running:

1 Right-click a blank area on the Start taskbar.

2 From the menu that appears, select Task Manager.

3 Select Processes.

4 Double-click Image Name.

5 Check that both adamsd.exe and lmgrd.exe are in the list.

If the lmgrd and adamsd are not in the list, see Licensing Problems on page 38.



Customizing End-User License AdministrationYou can use the daemon options file provided with the license manager to customize the installation. This option file allows the end-user to:

■ Reserve licenses for specified users or groups of users.

■ Restrict the use of the software to certain people.

■ Set software time-outs.

■ Log activity for use with an optional report writer.

Note: For more information, refer to http://www.macrovision.com/solutions/esd/support/index.html.

These options and their functions are listed below.

Table 1. Daemon Options File Options

The option: Does the following:

RESERVE Ensures that the MSC.ADAMS products are always available to one or more users, or on one or more host computer systems.

INCLUDE Allows the end-user to specify a list of users who are allowed to access the MSC.Software software.

EXCLUDE Allows the end-user to restrict certain people from using MSC.ADAMS products.

GROUP Allows the specification of a group of users for use with other commands.

TIMEOUT Allows licenses that are idle to be returned to the free pool for use by another user.

REPORTLOG Specifies that a log file be written suitable for use by the report writer.

NOLOG Filters messages of a specified type out of the daemon’s log output.



To use the daemon options:

1 Create a daemon option file.

2 List its pathname as the fourth field in the DAEMON line of the license.dat file.

A daemon options file consists of lines in the following format:

RESERVE number feature {USER | HOST | DISPLAY | GROUP} nameINCLUDE feature {USER | HOST | DISPLAY | GROUP} nameEXCLUDE feature {USER | HOST | DISPLAY | GROUP} nameGROUP name <list_of_users>TIMEOUT feature timeout_in_secondsNOLOG {IN | OUT | DENIED | QUEUED }REPORTLOG file

The system ignores lines beginning with the # character, which you can use to specify comments. If the filename in the REPORTLOG line starts with a + character, the old report log file will be reopened for appending.

For example, the following options file reserves one copy of AVIEW for user pat, three copies for user lee, and one copy for anyone on a computer with the hostname of terry. In addition, it does not allow the user joe to use AVIEW. It also causes the log file to omit QUEUED.

RESERVE1AVIEW USER patRESERVE3AVIEW USER leeRESERVE1AVIEW HOST terryEXCLUDEAVIEWUSERjoeNOLOG QUEUED

If this data were in the file C:\PROGRA~1\ADAMS1~1.0\network\options.fil, then you modify the license file DAEMON line as follows:

DAEMON adamsd C:\PROGRA~1\ADAMS1~1.0\network\adamsd.exeC:\PROGRA~1\ADAMS1~1.0\network\options.fil

4 Troubleshooting

OverviewThis chapter describes how to generate problem reports to send to MSC.ADAMS Technical Support. It also lists some common problems that can occur when installing, updating, and running MSC.ADAMS software, and recommends solutions to those problems.

■ Generating Problem Reports, 36

■ Obtaining New Passwords, 36

■ Common Problems, 37

If you do not find your problem in this chapter or if the recommended solution does not solve your problem, then:

■ Refer to the MSC.ADAMS Knowledge base at support.adams.com/kb

■ Contact MSC.ADAMS Technical Support as explained in Getting Help on page 5.


Troubleshooting36

Generating Problem ReportsYou can generate a report that examines your system configuration and places important debugging information in the file adams_problem_report.txt. If you have problems running ADAMS, you can generate this report and review it or send it to MSC.ADAMS Technical Support by fax or e-mail. As you review the report, refer to Common Problems on page 37 for explanations of many of the error messages that appear in the report.

Note: For correct results, you must run the problem report from the license server, not the client machine.

To generate and review a report:

1 From the Start menu, point to Programs, point to MSC.Software, point to MSC.ADAMS 2003, point to License, and then select Troubleshoot - Problem Report.

MSC.ADAMS creates a problem report in your home directory.

2 To review the report, open it into a text editor, such as Notepad.

Obtaining New PasswordsIf you need new passwords, you can obtain them by calling MSC.Software Technical Support at (800) 732-7284.

When requesting new passwords, provide the following information:

■ Request number and Schedule 1 number (Sched 1 #) from your password certificate. The request number is at the top of the certificate and the Schedule 1 number is in the Administrative Information section.

■ System ID and host name of your CPU. Instructions for obtaining this information for your particular CPU are in the hardware and software specifications.


Troubleshooting37

Common ProblemsThis section describes commonly encountered problems. It divides the problems into the following categories:

■ Licensing Problems, 38

■ TCP/IP Installation Problems, 42

■ Network License Daemon Problems, 43

If your problem is not described in this chapter or if the recommended solution does not solve your problem, get help as explained in Getting Help on page 5.


Troubleshooting38

Licensing Problems

The following are some common licensing problems:

■ License Troubleshooting Checklist, 38

■ MSC.ADAMS FLEXlm Service Does Not Start, 39

■ Client Cannot Connect to Server, 40

■ Not Licensed to Run Product, 41

■ Incorrect Formatting in license.dat, 42

License Troubleshooting Checklist

Here are some tips for checking the license installation:

1 Check the license.dat file:

■ Is the format correct? Check the lines: SERVER, DAEMON, PACKAGE, INCREMENT. For more on license.dat, see About the License File Format on page 23.

■ Does the SERVER information match the machine hostname and hostid?

2 Check the license.log (in the network subdirectory under the MSC.ADAMS install_dir):

■ Are the INCREMENT and COMPONENT names listed?

■ Are there any error messages?

3 Can the client or server machine access the license server?

Tip: Use the program lmtools as explained in Troubleshooting the License Server on page 31.


Troubleshooting39

MSC.ADAMS FLEXlm Service Does Not Start

Error message:

Error: Could not start Service on machine ’xxxxxx’ error 1067.

Description:

You receive this error message if FLEXlm won’t start as a service when you select Start License Server.

Solution:

Depending on the cause of the error do one or more of the following:

■ The Simple TCP/IP Services software needs to be installed. To install it:

1 Insert the Windows CD into your CD-ROM drive.

2 From the Start menu, point to Settings, and then select Control Panel.

3 From the Control Panel folder, double-click Network, and then select the tab Protocols.

4 Select TCP/IP Protocol, and then select Add.

5 Select Close.

■ The hostname of your computer has been changed and the DNS needs to be reconfigured. To reconfigure the DNS:

1 Insert the Windows CD into your CD-ROM drive.

2 From the Start menu, point to Settings, and then select Control Panel.

3 From the Control Panel folder, double-click Network, and then select the tab Protocols.

4 Select TCP/IP Protocol, and then select Properties.

5 Make sure the hostname is correct, and then select Close.

The above steps install or configure the necessary software to run the license manager. Once completed, your machine reboots and the MSC.ADAMS FLEXlm server starts.


Troubleshooting40

Client Cannot Connect to Server

Error message:

Client cannot connect to license server on the server machine.

Description:

You receive this error message when the license manager daemon (lmgrd and adamsd) is not running or your ADAMSD_LICENSE_FILE environment variable is incorrect.

Solution:

Check the Services tool on the Control Panel folder for the FLEXlm license server. Then, try restarting the daemon. If MSC.ADAMS still does not run, check to make sure ADAMSD_LICENSE_FILE is not set. The environment variable is not needed for server licenses for MSC.ADAMS. At runtime, the mdi.bat script sets the variable.

To check that the environment variable is not set:

1 From a DOS prompt, type set | more.

If the variable doesn’t display, it is not set. Continue to step 3.

2 To unset the variable, type set ADAMSD_LICENSE_FILE= and then press Enter.

The variable is now unset.

3 If you still cannot connect to the server, contact MSC.ADAMS Technical Support and provide a problem report as explained in Generating Problem Reports on page 36.

You can also check to ensure that the client can contact the server. If it cannot, there is a problem with the connection. See your system administrator.

To check if the client can contact the server:

■ At a DOS prompt, enter the following, where server_name is the name of the server:

ping server_name

If there is no reply, see your system administrator.


Troubleshooting41

Not Licensed to Run Product

Error message:

Cannot run <product>. Call your systems support personnel.

Description:

You see an error similar to the one shown above if you are not licensed to run a product. You see this error when:

■ The system ID information in your password does not match the system ID you are currently using. See the instructions in the section, Obtaining New Passwords on page 36, to obtain a new password.

■ You have not entered the passwords correctly. The passwords must match those listed on your password certificate. You must enter all the passwords listed in the order given on your password certificate, even if you do not install all the products. The letters O and L are not used in passwords; the numbers 0 and 1 are used.

■ You are running a user executable created in an earlier version of ADAMS/Solver. For example, you created the user executable under version x.0, and now you are running version x.1. You need to create a new user executable under the current version of ADAMS/Solver.

Solution:

The system ID listed on your password certificate should match the physical address of your CPU. If the network card has changed since MSC.Software created the password, you need to get new passwords as explained in Obtaining New Passwords on page 36.


Troubleshooting42

Incorrect Formatting in license.dat

The data in the file license.dat must match the information on your password certificate. The file license.dat is located in the subdirectory network of your MSC.ADAMS installation directory. The licensing portion of the installation program automatically creates license.dat if your site has network licensing. You have network licensing if your password certificate lists the name of a network license server. For more information on license.dat, see About the License File Format on page 23.

TCP/IP Installation Problems

The following error indicates that TCP/IP is not installed correctly:

{hostname}: socket() call failed (-57, 17:10047) WinSock error code

Check all of the following:

■ TCP/IP Protocol network software is installed.

■ TCP/IP Protocol is configured.

■ Simple TCP/IP service is started.

■ Your network card supports TCP/IP.


Troubleshooting43

Network License Daemon Problems

The next sections explain how to troubleshoot network license daemon problems:

■ Overview of Network Licensing Problems, 43

■ Incorrect Server Name in license.dat, 44

■ License Daemons Started on Machine Whose hostid is Not the Same as Password Certificate hostid, 45

Overview of Network Licensing Problems

Network license daemons errors can occur because:

■ The daemons have not been started or have been shut down.

■ The daemons have been started more than once.

■ The hostid in license.dat is incorrect.

■ The hostid of the machine on which the license daemons have been started is not the same as the hostid listed on the password certificate.

■ A different software product’s license daemon uses the same socket address.

When any of these occur, you usually see the following error message:

Checkout of XXXXX failed.

client:cannot connect to license server (Connection refused) Cannot run ADAMS/XXX Cannot grant a license Call your system support personnel

Solutions to each of these errors are given in the next sections. In addition, you should examine the license.log file to determine the cause of network licensing errors. license.log is located in the subdirectory network, under your installation directory. The first and last 30 lines in license.log are useful for identifying errors. Some of the error messages listed in the next sections can appear in license.log.


Troubleshooting44

Incorrect Server Name in license.dat

Error message:

(lmgrd) "que": Not a valid server hostname, exiting

Description:

This message appears in the license.log file if the server name in the license.dat file does not match the hostname of your machine.

Solution:

If the server name and hostname do not match, change the server name in the license.dat file to match the string returned by the command hostname.


Troubleshooting45

License Daemons Started on Machine Whose hostid is Not the Same as Password Certificate hostid

Error message:

(adamsd) Wrong hostid, exiting (expected 760a0a2, got 76260a0a1)

Description:

This message appears in the license.log file if the license daemons were started on a different hostid than the one listed on your password certificate.

Solution:

Shutdown the daemons and restart them on the correct hostid, as instructed in the section, Setting Up a License Server and Entering Passwords on page 26.

If the hostid does not match, you may need a new password. For instructions, see Obtaining New Passwords on page 36.


Troubleshooting46

A Uninstalling Previous Versions of MSC.ADAMS

You can uninstall previous versions of MSC.ADAMS products and documentation. You can select to uninstall all files that were initially copied to your hard disk or select only those files that you want removed. Note that the uninstall program does not remove files that were created after the initial installation, such as your license.dat.

To uninstall MSC.ADAMS products and documentation:

1 From the Start menu, point to MSC.Software, point to Programs, point to MSC.ADAMS 2003, and then select Uninstall ADAMS.

2 Follow the instructions on your screen to uninstall the MSC.ADAMS products. Select the Next button to continue through the installation.

The installation program asks you to choose the type of uninstall you want to perform. You can select:

■ Automatic - Removes all MSC.ADAMS product files. It does not remove any files that you created in the installation directory.

■ Custom - Lets you select the files that you want to delete.

3 When the uninstall is complete, select Finish.


Uninstalling Previous Versions of MSC.ADAMS48

Installing MSC.ADAMS on Windows 49Index

Index

A - B

ADAMS license 4

ADAMSD_LICENSE_FILE environment variable 40

C - D

Campus licensing 4

Clientcan’t connect to server 40setting up 28

Contacting Technical Support 5

Documentationabout 5installing 18

E - F

Enteringevaluation password 27passwords 26

Environment variable, setting ADAMS_LICENSE_FILE 40

Evaluation passwordentering 27updating 30

Existing license server, using 28

Extension, MSC.ADAMS for MSC.EASY5 12


Index50

Feature names 9, 25

Format of license file 23

Formatting, incorrect in license.dat 42

G - H

Generating problem reports 36

Getting help 5

Hardware and software specifications, about 2

Help, getting 5

I - J

Installation requirements 2

Installation typesfile server 14license 17typical 10

Installing MSC.ADAMS products and documentation 8–19

K - L

License administration, customizing 32

License daemon problems 43

License file format 23

License servercannot connect to 40doesn’t start as service 39incorrect name for 44setting up 26starting and stopping 31troubleshooting 31updating 30using existing 28


Index51

license.dat

described 42format of 23formatting problems in 42incorrect server name in 44typographical errors in 42

license.log, described 43

LicensingADAMS 4basics of 22Campus 4information on password certificate 25not licensed to run product 41problems 38–42running two versions of MSC.ADAMS 29setting up initial 26–28

M - N

MSC.ADAMS CDsabout 5loading Products 10, 14, 17

MSC.ADAMS documentationabout 5installing 18

MSC.ADAMS Extension for MSC.EASY5, installing 12

MSC.ADAMS productsinstalling 8–19licensing two versions of 29names for 9, 25not licensed to run 41uninstalling 47ways to license 22


Index52

MSC.EASY5, installing extension for MSC.ADAMS 12

MSC.Software Technical Support, contacting 5

Namesfor MSC.ADAMS product 9incorrect 44MSC.ADAMS product 25

Network licensingcustomizing end-user 32daemon problems 43–45

New passwords, obtaining 36

O - P

Obtaining new passwords 36

One-server configuration, explained 22

Online helpabout 5installing 18

Password certificatedescribed 3license information in 25

Passwordsentering 26entering evaluation 27entering updated 30entering updated evaluation 30obtaining 36

ProblemClient cannot connect to server 40incorrect formatting in license.dat 42incorrect server name in license.dat 44MSC.ADAMS FLEXlm service does not start 39


Index53

not licensed to run product 41Password certificate hostid different 45TCP/IP 42

Problem reports, generating 36

Productsinstalling MSC.ADAMS 8–19licensing two versions of 29not licensed to run 41uninstalling MSC.ADAMS 47

Q - R

Reports, generating problem 36

Requirements for installation 2

Runningproducts, not licensed to 41two versions of MSC.ADAMS 29

S - T

Service, license server doesn’t start as 39

Setting upADAMS_LICENSE_FILE 40client 28license server 26

Specifications, hardware and software 2

Starting, license server 31

Stopping, license server 31

System requirements 2

TCP/IP installation problems 42

Technical Support, contacting 5


Index54

Three-server configuration, explained 22

Troubleshootinglicense server 31MSC.ADAMS installation 37

Typographical errors in license.dat 42

U - V

Uninstalling MSC.ADAMS 47

Updatingevaluation license 30license server 30

Using existing license server 28

VPD Campus license 4

mscweb.mscsoftware.com/support/prod_support/adams/... · installing msc.adams on windows getting...

Documents