Managing Mentor Graphics PCB Systems Softwares2.bitdownload.ir/Engineering/ELECTRONIC/PADS 9.1...

Managing Mentor Graphics PCBSystems Software

PADS 9.1: Installation and Licensing

December 2009

© 1992-2009 Mentor Graphics CorporationAll rights reserved.

This document contains information that is proprietary to Mentor Graphics Corporation. The original recipient of thisdocument may duplicate this document in whole or in part for internal business purposes only, provided that this entirenotice appears in all copies. In duplicating any part of this document, the recipient agrees to make every reasonableeffort to prevent the unauthorized use and distribution of the proprietary information.

This document is for information and instruction purposes. Mentor Graphics reserves the right to makechanges in specifications and other information contained in this publication without prior notice, and thereader should, in all cases, consult Mentor Graphics to determine whether any changes have beenmade.

The terms and conditions governing the sale and licensing of Mentor Graphics products are set forth inwritten agreements between Mentor Graphics and its customers. No representation or other affirmationof fact contained in this publication shall be deemed to be a warranty or give rise to any liability of MentorGraphics whatsoever.

MENTOR GRAPHICS MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIALINCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY ANDFITNESS FOR A PARTICULAR PURPOSE.

MENTOR GRAPHICS SHALL NOT BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, ORCONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS)ARISING OUT OF OR RELATED TO THIS PUBLICATION OR THE INFORMATION CONTAINED IN IT,EVEN IF MENTOR GRAPHICS CORPORATION HAS BEEN ADVISED OF THE POSSIBILITY OFSUCH DAMAGES.

RESTRICTED RIGHTS LEGEND 03/97

U.S. Government Restricted Rights. The SOFTWARE and documentation have been developed entirelyat private expense and are commercial computer software provided with restricted rights. Use,duplication or disclosure by the U.S. Government or a U.S. Government subcontractor is subject to therestrictions set forth in the license agreement provided with the software pursuant to DFARS 227.7202-3(a) or as set forth in subparagraph (c)(1) and (2) of the Commercial Computer Software - RestrictedRights clause at FAR 52.227-19, as applicable.

Contractor/manufacturer is:Mentor Graphics Corporation

8005 S.W. Boeckman Road, Wilsonville, Oregon 97070-7777.Telephone: 503.685.7000

Toll-Free Telephone: 800.592.2210Website: www.mentor.com

SupportNet: supportnet.mentor.com/Send Feedback on Documentation: supportnet.mentor.com/user/feedback_form.cfm

TRADEMARKS: The trademarks, logos and service marks ("Marks") used herein are the property ofMentor Graphics Corporation or other third parties. No one is permitted to use these Marks without theprior written consent of Mentor Graphics or the respective third-party owner. The use herein of a third-party Mark is not an attempt to indicate Mentor Graphics as a source of a product, but is intended toindicate a product from, or associated with, a particular third party. A current list of Mentor Graphics’trademarks may be viewed at: www.mentor.com/terms_conditions/trademarks.cfm.

http://www.mentor.com

http://supportnet.mentor.com/

http://supportnet.mentor.com/user/feedback_form.cfm

http://www.mentor.com/terms_conditions/trademarks.cfm

Managing Mentor Graphics PCB Systems Software 3December 2009

Table of Contents

Chapter 1Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Before You Begin Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Downloading Software on Windows Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Quick Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Installing PADS on Remote Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Creating the Batch Installation File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Creating the Installation Arguments File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Running the Batch Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Installing Other Products After Initial Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Chapter 2Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Understanding Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Using Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Ordering Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Configuring Licensing on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Chapter 3Managing Environment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Setting Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Setting SDD_HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Setting MGC_HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Setting MGLS_LICENSE_FILE or LM_LICENSE_FILE . . . . . . . . . . . . . . . . . . . . . . . . 28Setting WDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Using the Configurator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Who Can Run the Configurator? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Understanding the Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Structural Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Managing Multiple Mentor Graphics Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Chapter 4Managing Mentor Graphics Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Understanding the Documentation Tree Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Defining Optional Documentation Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . 37

Setting Variables on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Setting Variables on UNIX/Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Using the Mentor Graphics Documentation System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Accessing the Mentor Graphics Documentation System . . . . . . . . . . . . . . . . . . . . . . . . . . 39Finding Answers with InfoHub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Browsing the List of Manuals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Custom Tab of the InfoHub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Table of Contents

4December 2009

Managing Mentor Graphics PCB Systems Software

Navigating HTML Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Required Internet Explorer Option with Windows XP SP2 . . . . . . . . . . . . . . . . . . . . . . . . . 50

Permanent Workaround . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Temporary Workaround . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Chapter 5Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Hardware and Operating System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Mentor Graphics SupportNet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Troubleshooting Common Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Troubleshooting Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Index

End-User License Agreement


Chapter 1Installation Overview

This chapters covers the following installation instructions:

• Before You Begin Installation

• Downloading Software on Windows Platforms

• Quick Install

• Installing PADS on Remote Computers

o Creating the Batch Installation File

o Creating the Installation Arguments File

o Running the Batch Installation

• Installing Other Products After Initial Installation

Before You Begin InstallationThe following are pre-requisites to the Mentor Graphics product installation.

1. Obtain your license file from Mentor Graphics. For existing customers, the license filecan be downloaded from:

http://supportnet.mentor.com/myaccount/index.cfm?fa=user.licenses

For new customers, contact your local Mentor Graphics sales office. See “OrderingLicenses”.

NoteTo make full use of the Install program’s automatic product selection by licenses, set upyour software licensing environment before running the Install program. For additionalinformation, refer to “Licensing” on page 17.

2. Check system requirements. For current system requirements, refer to SupportNet for alist of all supported system configurations:

http://supportnet.mentor.com/systemreqs/index.cfm

Managing Mentor Graphics PCB Systems Software6

Installation OverviewDownloading Software on Windows Platforms

December 2009

Downloading Software on Windows Platforms1. Create a <release_name> folder on your computer and download the zip file for this

release to it. Downloads are available at

http://supportnet.mentor.com/downloads

2. In Windows Explorer, right-click the .zip file.

3. From the pop-up menu, select Extract to...

4. Navigate to the folder to uncompress to.

5. Select Use folder names and click Extract.

The data are uncompressed to the selected location.

6. Close WinZip when uncompression completes.

7. Navigate to and select the uncompressed data folder.

8. To install the software, locate and run autorun.exe. Then, on the Autorun menu, clickInstall under PADS Products to start the Install Program.

If you receive a security error during the download, it’s possible you are dealing with alocal security policy. For example:

Devices: Restrict CD-ROM access to locally logged-on user only.

The security policy needs to be disabled through the policy editor, per Microsoft article290896. Modify the following registry key:

HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\WinLogon - AllocateCDRoms must = 0 (zero)

Tip: You can also install the software by running setup.exe.

9. Follow the instructions listed in Quick Install.

Installation OverviewQuick Install


Quick Install1. Run autorun.exe in Windows from the downloaded software available from SupportNet

or from the CD-ROM. On the Autorun menu, double-click Install PADS Products.

Tip: You can also install the software by running setup.exe.

a. Download the software from SupportNet.

b. Run autorun.exe to access the AutoRun menu.

c. Click Install under PADS Products to start the Install Program.

Alternately, if you are installing from CD-ROM, insert the CD into your CD-ROMdrive. If the installation does not automatically start, select Start > Run, specify theCD-ROM drive and install executable (for example, D:\autorun.exe orD:\setup.exe), and click OK.

NoteYou must have Administrator privilege to install the software products from CD-ROM onWindows systems.

d. In the Installation Information window, click OK to disable all anti-virus and anti-spyware software during the installation and continue with the installation.

e. In the Choose Licensing Scheme window, select the licensing scheme you are usingand click Next.

Tip: For detailed information on installing with each licensing scheme, see theinstallation instructions in the PADS CD Insert or the PADS web-based download.

f. Specify the license file location and click Next:

o If you selected the Node-locked using Hardware key or Ethernet option: Inthe Enter License File window, type or select the license file path.

o If you selected the Network license client option, In the Set Port and Serverwindow, select or type the address and host name of the server.

g. In the Enter Project Path window, select a default path for your PADS projectfolders (the location where each new design is created). The Mentor Install windowappears.

2. In the Mentor Graphics Install window, click Install Products.



December 2009

Tip: After the Mentor Graphics Install program invokes, instructions for performing eachof the following tasks are available in the online help.

3. Specify the source location by typing the source path in the source location field or clickBrowse to select the source directory. The default source location is the path where youinvoked autorun.exe (or setup.exe) in Windows.

Type the target path in the target location field or click Browse to select the targetdirectory.

Click Next to display the Product Selection screen.

4. Select the SDD products to install by selecting the appropriate check boxes. Theproducts that have previously been installed at the target folder will display a “target”icon to the right of the product name.

NoteIf you choose a licensing scheme in Step 1, product check boxes are automaticallyselected.

Click Next to display the License Agreement window.

5. Read the licensing agreement and click Agree to accept. The Confirm Selectionswindow displays.

6. Confirm the product selections by clicking Install.

7. Optionally, specify a WDIR. If you have DxDesigner installed and have previously setthe WDIR environment variable, the Set WDIR window appears to let you change theWDIR. You can accept the current WDIR or specify another path. Then, click Next.

NoteIf you do not have DxDesigner installed or you have it installed but have not specified aWDIR, the Set WDIR window does not appear.

8. When installation is complete you can register your PADS products and then click Doneand Done again to finish the installation.

CautionSome software installations launch post-installation processes that may include separatedialogs and command shells. Do not dismiss these dialogs or shells; they will eithercomplete automatically or certain dialogs will require input. If any reboot requests occurduring the installation process, respond No and reboot after the installation hascompleted. Once all the post-install processes are complete, the install wizard indicatesthe overall install process is complete.



CautionIf you choose to run verification on the install, run it immediately after installation andprior to running any of the products as the products can modify the installed files.


Installation OverviewInstalling PADS on Remote Computers

December 2009

Installing PADS on Remote ComputersThe PADS release provides a batch installation mechanism that lets a system administratorinstall PADS2007 (and later) releases on multiple remote computers without any userinteraction.

NoteBatch installation does not support node-locked installations.

The batch installation has two phases:

• Capturing information that you normally supply interactively during a standardinstallation. To do this you create two files:

o A batch installation file. For information, see Creating the Batch Installation File.

o An installation arguments file. For information, see Creating the InstallationArguments File.

• Running the batch installation. For information, see Running the Batch Installation.

Creating the Batch Installation FileBefore you can run a batch installation, you need to create the batch installation file. This file isan ASCII file containing information (in xml format) about the source of the installation and theproducts to be installed. For an example file, see Example Batch Installation File. The PADSprocess only makes use of a portion of the new format of the batch script.

Procedure

NoteThe batch install is performed using a PADS download, not a CD-ROM.

1. Double-click the autorun.exe to access the AutoRun menu.

2. Click Install under PADS Products to start the Install Program.

3. In the Installation Information window, click OK to disable all anti-virus and anti-spyware software during the installation and continue with the installation.

4. In the Choose Licensing Scheme window, select Skip or Postpone License Setup.

5. In the Enter Project Path window, accept the default project path for your PADS projectfolders. Click Next.

6. In the Mentor Graphics Install screen, click Tools > Batch Tool.



7. In the Welcome to the Batch Tool screen, click Wizard.

Proceed through the Wizard.

NoteIf the source files reside on a server, do not use the mapped drive path, use the UNC path.The following is an example of an acceptable UNC path:\\www.mydomain.com\software\PADS91_source\setup.exe

8. On the Product Selection screen, select the products you want to install with the batchinstallation.

Tip: If you plan to use the batch installation to install different product sets on differenttarget computers, select all products for installation. You can later manually edit this listfor different installations.

NoteSteps 8 (License Agreement Viewing Preference) and 9 (Batch Script Options) have nouse within the PADS flow and your selections in these steps will be removed from thebatch file. Choose anything in order to proceed through the Wizard.

9. On the Confirm and Save screen, type a location or click Browse to navigate to alocation to save product selections and installation session information to a file. ClickSave. This file will be your batch installation file.

NoteYou can use any filename and extension.

10. On the Finished screen, click Done.

11. Exit the Installer.

12. Using a text editor, open the batch script you just created.

13. Remove everything in the batch file except for the XML data.

Tip: Remove everything up to and including the line which reads:REM ##### BELOW HERE IS XML DATA #####

14. Rename the file to have an .xml file extension such as batchfile.xml

This file will be your batch installation file.



December 2009

Example Batch Installation FileThe following is an example of a batch file when all products are selected for installation.

Example 1-1. Batch Installation File

<batchFile><source value="\\www.mydomain.com\software\PADS91_source"/><target value="C:\MentorGraphics"/><platform value="Windows"/><release name="PADS9.1">

<product name="CAMCAD Professional" productroot="9.1PADS"/><product name="DxDataBook" productroot="9.1PADS"/><product name="DxDesigner" productroot="9.1PADS"/><product name="DxDesigner Basic Libraries" productroot="9.1PADS"/><product name="DxLibraryStudio" productroot="9.1PADS"/><product name="DxWebPack" productroot="9.1PADS"/><product name="HyperLynx Analog" productroot="9.1PADS"/><product name="HyperLynx BoardSim / LineSim" productroot="9.1PADS"/><product name="HyperLynx Extended IBIS Library"

productroot="9.1PADS"/><product name="PADS Layout" productroot="9.1PADS"/><product name="PADS Libraries" productroot="9.1PADS"/><product name="PADS Logic" productroot="9.1PADS"/><product name="PADS Router" productroot="9.1PADS"/><product name="Remote Server Configuration Manager"

productroot="9.1PADS"/><product name="Thermal" productroot="9.1PADS"/><product name="Variant Manager" productroot="9.1PADS"/>

</release></batchFile>

Creating the Installation Arguments FileThe installation arguments file is an ASCII file that specifies the information necessary for theinstallation.

NoteIt is assumed that node-locked licensing is not the case.



To create this file, open a text editor and type the key-value pairs for the information you wantto include.

Table 1-1. Batch Installation Arguments

Key Description

batch=batch_installation_file This argument is required.

Specifies the path to the batch installation fileon the target computer. For example:

batch=C:\batchinstall.xml

If the path contains spaces, enclose it in doublequotations marks (“ ”).

project=PADS_project_dir This argument is optional.

Specifies the path to PADS project directoryon the target computer.

If the path contains spaces, enclose it in doublequotation marks (“ ”). For example:

project=“C:\PADS Projects”

If you do not specify a path, the batchinstallation sets the PADS project directory toC:\PADS Projects on the target machine.

If the directory does not exist, the batchinstallation programs creates it.

license=license_file This argument is optional if theMGLS_LICENSE_FILE environment variableis already set.

Specify a network license server . Forexample:

license=1717@licserverA

If you do not specify this argument and theMGLS_LICENSE_FILE environment variablehas not been set, the batch installation does notprompt for a license.



December 2009

Example Installation Arguments FileHere is an example installation arguments file:

Example 1-2. Installation Arguments File

batch=C:\batchinstall.xmlproject="C:\PADS Projects"license=1717@licserverA

Running the Batch InstallationAs system administrator, you can log in to each target computer and run the batch installationfrom the command prompt. Or you can write a script that runs the batch installation on aspecific set of target computers.

Requirements

• The person performing the PADS 9.1 installation must have system administratorprivileges on each target computer.

• The target computer must be in a valid state and running a valid operating system.Supported operating systems are:

o Windows Vista SP1

o Windows XP Professional SP2

o Windows XP Home SP2

• The system administrator must have performed one PADS installation and haveaccepted the License Agreement during that installation.

• The system administrator must have created two files:

o The batch installation file. See Creating the Batch Installation File.

o An installation arguments file. See Creating the Installation Arguments File.

NoteIf the WDIR environment variable is set on the target computer, the batch installationoverwrites it with the default setting (the path of the PADS Project plus the standarddirectory in the installation). After batch installation, you can set the variable to adifferent path.



Procedure

1. Access the target computer (for example, using Windows Remote Desktop).

2. Copy the batch installation file and the installation arguments file to the C:\ drive of thetarget computer.

3. Change to the location of the downloaded image. In this example, the UNC path:\\www.mydomain.com\software\PADS91_source\.

4. Enter the batch installation command. The syntax is:

setup.exe -batch installation_arguments_file

Where:

-batch — Specifies the path to the installation arguments file on the target computer.For example:

\\www.mydomain.com\software\PADS91_source\setup.exe -batch C:\install_args.txt

5. Check the batchinstall.err file. This file contains a message stating whether theinstallation completed or failed. For more information, see The Installation Error File(batchinstall.err).

The Installation Error File (batchinstall.err)The batch installation process creates an error file at the following location:

C:\batchinstall.err

This file contains a message identifying whether the installation completed successfully orfailed.

If the installation failed, the file lists errors. For example:

• Cannot create PADS project directory.• Batch file does not exist.• Running programs.

NoteIf the Mentor Graphics Install program ran, it also creates a file that contains informationabout the installation. The file is located at:C:\MentorGraphics\Install\msi_history.txt


Installation OverviewInstalling Other Products After Initial Installation

December 2009

Installing Other Products After Initial InstallationAfter you have performed the initial product installation, you can open the Install program andinstall other products.

On Windows systems, go to Start > Programs > Mentor Graphics and click Mentor Install.


Chapter 2Licensing

This chapter contains the following sections:

Understanding Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Using Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Ordering Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Configuring Licensing on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Understanding LicensingNoteMentor Graphics recommends installing licensing before installing application software.In the PADS installation, PADS 9.0 Setup screens provide a way to set up licensingbefore installing application software.

Mentor Graphics sells two kinds of licenses: nodelocked and floating. See Figure 2-1 for anoverview of the licensing installation process.

Nodelocked licenses are locked to a specific piece of hardware, either an Ethernet card or ahardware key. These devices provide a unique identifier for the license that is generated. Thesoftware will run only on the system that has that particular piece of hardware installed.Additionally, there are the following nodelocked indicators:

• Nodelocked counted: the license count is non-zero and a license server is necessary

• Nodelocked uncounted (mobile compute): the license count is the numeral “0” or thekeyword “uncounted” and a license server is not needed

Floating licenses can be used by any user on a network, but this requires a license server to berunning. The license server tracks how many licenses are available and how many are currentlyin use. Optionally, license servers can be configured to allow access to only certain groups orindividuals (via the Options file). This allows sharing of a few licenses among many users.Floating licenses are tied to a server hostid provided by an Ethernet card or FLEXnet hardwarekey. In order for the floating licenses to work, the licenses must be served from the host (eithera workstation or server machine) whose hostid matches that listed on the server line in thelicense file.


LicensingUnderstanding Licensing

December 2009

Figure 2-1. Basic Licensing Flow Overview

New users must order software licenses prior to installing Mentor Graphics software. Forinformation on ordering licenses, refer to the section “Ordering Licenses” on page 20.

For additional licensing information, refer to the Licensing Mentor Graphics Software manualavailable in the release_documents directory on the CD-ROM or from SupportNet.

Obtain License File

Install License File2

Start License Server3

Point Clients toServer4

This figure illustrates thebasic steps for configuringlicensing on Windowsplatforms. It assumes thatlicensing software is alreadyinstalled.

NOTE: Mentor Graphicsrecommends installinglicensing before installingapplication software. In thePADS installation, PADSSetup screens provide a wayto set up licensing beforeinstalling applicationsoftware.

Edit License File1b

Node-lockeduncounted

Verify Licenses canbe checked out5

YES

NO

1a

Point Clients toLicense File

LicensingUnderstanding Licensing


Using Environment VariablesMentor Graphics supports two licensing environment variables, MGLS_LICENSE_FILE andLM_LICENSE_FILE.

NoteMGLS_LICENSE_FILE should be used as the default licensing environment variable forMentor Graphics products.

MGLS_LICENSE_FILE is used when multiple products have FLEXnet Licensing to allowother vendor products to use the LM_LICENSE_FILE variable, while allowing MentorGraphics products to get their licenses from the value of MGLS_LICENSE_FILE. You areencouraged to use the MGLS_LICENSE_FILE for optimum performance of Mentor Graphicsapplications. Only Mentor Graphics software recognizes MGLS_LICENSE_FILE; softwarefrom other vendors that use FLEXnet will ignore it. The standard FLEXnet Licensingcommands such as lmutil, lmstat and lmreread do not recognize the MGLS_LICENSE_FILEvariable, so those commands should be explicitly pointed to the license location using a “-c”switch. (For example, in the DOS shell, type: lmstat -c %MGLS_LICENSE_FILE%.)

NoteWhen you set up licensing at the beginning of the PADS installation, theMGLS_LICENSE_FILE variable is set automatically.

MGLS_LICENSE_FILE and LM_LICENSE_FILE have the same syntax (for Windows):

license_file_pathname1;license_file_pathnameN;port@host1;port@hostN

NoteUse a semicolon (;) as the path separator for license files and independent servers.

To view or change the settings, see “Setting Environment Variables.”

LM_LICENSE_FILE is the FLEXnet licensing standard environment variable used by thelicense server and application to determine the location of license data files. You can useLM_LICENSE_FILE on client workstations to allow applications invoked on thoseworkstations to use a license file not stored in the default location or to point to one or morelicense servers.

In some environments, you may combine the FLEXnet licensing information for severalvendors into a single license file. The default locations are:

• Windows — C:\flexlm\license.dat


LicensingOrdering Licenses

December 2009

NoteFor a nodelocked installation, the PADS installation copies the license file toC:\Documents and Settings\All Users\Application Data\pads\9_0\license.dat.

For additional information on these variables or redundant license server configurations, pleaserefer to the Licensing Mentor Graphics Software manual available from the release_documentsdirectory on the CD-ROM or from SupportNet.

Ordering LicensesNew users must order software licenses prior to installing Mentor Graphics software. To orderlicenses, contact your local Mentor Graphics sales office. The sales office can provide you withinformation on the number of nodelocked and floating licenses your company purchased andany current license sever configurations you may have. Provide them with:

• Any new license server configuration information

• The hostIDs of client workstations for nodelocked licenses

• The hostID of the license server workstation for all floating licenses

Licensing reports are available for existing customers at the Customer Support website:

http://supportnet.mentor.com/myaccount/index.cfm?fa=user.licenses

NoteThe Customer Support website requires a login and password.To register and obtain a password, go tohttp://supportnet.mentor.com/user/register.cfmIf you have difficulties, email [email protected] assistance if you are registered but have forgotten your password usehttp://supportnet.mentor.com/user/forgot_password.cfm

Configuring Licensing on WindowsMentor Graphics provides two different types of licenses for products running in the Windowsenvironment. Floating licenses require a license server in operation somewhere on the network.Nodelocked uncounted (mobile compute) licenses are issued to a specific workstation andrequire no server.

This section explains how to set up and use both types of licenses. Both require a license file.An environment variable, MGLS_LICENSE_FILE or LM_LICENSE_FILE, is required, butmay be substituted by a registry value.

LicensingConfiguring Licensing on Windows


Step 1: Determining What Kind of Licenses You HaveNodelocked Uncounted (Mobile Compute) Licenses (No Server Required)

NoteRequirement: You must log on with administrator privileges or contact the networkadministrator to install the software for you.

A license file does not require a server if it does not contain a line that starts with the wordSERVER or DAEMON, and the quantity listed for each INCREMENT is zero. The quantity isfound immediately to the right of the expiration date of the license.

An example is provided below of nodelocked uncounted (mobile compute) licenses. Theexpiration date is these examples is 30-Sep-2008 and the quantity is 0.

INCREMENT msimpevcom mgcld 2008.090 30-Sep-2008 0 \0C0981E404D1CC65BC42 VENDOR_STRING=69172E61 SN=235567\HOSTID=FLEXID=8-5E7000039670

INCREMENT msimpevsim mgcld 2008.090 30-Sep-2008 0 \C497194A68CCE0532E0 VENDOR_STRING=83A699CF SN=235568\HOSTID=FLEXID=8-5E7000039670

Nodelocked uncounted (mobile compute) licenses are issued to a unique system identifier,either the media access control address (macaddr) of the system’s Ethernet network interfacecontroller (NIC) or an ID provided by a hardware key (dongle). The HOSTID field may appeardifferent from the example depending on the type of identifier specified when the features weregenerated. Table 2-1 lists several types of HOSTIDs.

If you require assistance with this step, contact Customer Support or consult the appropriate CDbooklet.

Table 2-1. Example HOSTIDs

Type Example HOSTID Description

Parallel Port Hardware Key HOSTID=FLEXID=8-5E7000123ABC Dallas Dongle

Parallel Port Hardware Key HOSTID=FLEXID=7-bc2409fd orHOSTID=FLEXID=6-a6309832

RainbowSentinel Dongle

Parallel Port Hardware Key HOSTID=SSI_ACT=0635705008263737 PADS Pink Key

Parallel Port Hardware Key HOSTID=CPLUS_ID=1026e7f1 ePD SentinelDongle

USB Port Hardware Key HOSTID=FLEXID=9-36a6dfdd6 USB Dongle

Ethernet Address HOSTID=000cf41a42bc NIC physicaladdress



December 2009

Floating Licenses (Server Required)

Requirements:

• You must log on with administrator privileges or contact the network administrator toinstall the software for you.

• Install licensing on the computer that will act as the license server for the applicationsoftware. This can be any computer on the network. You do not need to install theapplication software on the license server.

• Make sure the computer you use for a license server has a static IP address on thenetwork. MGLS does not support DHCP or dynamic IP addresses.

• Make sure the floating license server computer and the client computers supportTCP/IP.

A license file requires a server if it contains a line that starts with the word SERVER orDAEMON, and each INCREMENT line has a quantity greater than zero. The licenses in theexample below require a license server. In this example, the expiration date is 30-Sep-2006 andthe quantity for each license is 5.

SERVER hood 00C04FA124CB 1700DAEMON mgcld C:\Mentorgraphics\Licensing\mgcld.exeINCREMENT msimhdlcom 2006.090 30-Sep-2006 5 \

7CC9D1040F6835A92C29 VENDOR_STRING=86B572C5 SN=235567INCREMENT msimhdlsim mgcld 2006.090 30-Sep-2006 5 \

5C09313E67E87EA6470 VENDOR_STRING=AC0FEF7C SN=235568INCREMENT msimcdebug mgcld 2006.090 30-Sep-2006 5 \

7C79F124F451646636A0 VENDOR_STRING=5567AF80 SN=235569INCREMENT msimcompare mgcld 2006.090 30-Sep-2006 5 \

5CD9C1A4E0699C54712 VENDOR_SRING=A0E23A25 SN=235570INCREMENT msimdataflow mgcld 2006.090 30-Sep-2006 5 \

5C191104BF137B16055F VENDOR_STRING=E055C9F3 SN=235571

Step 2: Editing the License FileNodelocked Uncounted (Mobile Compute) Licenses

NoteIf, at the beginning of the PADS installation, you already pointed to the license file, youcan skip the licensing setup.

Tip: If you have already installed PADS, you may run the Install License shortcut fromthe Start > Programs > Mentor Graphics SDD > PADS<version> > Licensing Toolsarea. This will take care of the nodelocked uncounted licensing setup.



1. Save your licenses in a file on your local harddrive. The file name must not containany spaces and must end in .dat, .lic or .txt. It must be a plain text file. Ensure that thereare no blank spaces at the end of any line.

2. On each client computer, ensure that the licensing environment or registryvariable points to your license file.

a. Navigate to System Properties. Right-click on the My Computer icon and selectProperties or go to Control Panel > System.

b. Go to Environment Variables. Select the Advanced tab and click theEnvironment Variables button.

c. Check the variable MGLS_LICENSE_FILE. If you have nodelocked uncounted(mobile compute) licenses, define the variable as the path to the license file startingwith the drive letter and ending with the license file name. For example:C:\flexnet\license.dat.

Tip: MGLS_LICENSE_FILE can be created as a System Variable, available to all usersthat log in to this system, or it can be created as a User Variable, available only to thecurrent user. A user with Administrator privileges may create a System Variable. Be surethat only one variable points to your license file. Duplicate pointers can slow downperformance and may cause other technical problems.

Floating Licenses

1. On the license server computer, edit the license file. The license file, which MentorGraphics provides, contains some placeholder information. Edit the placeholder data byreplacing it with information correct for your site.

a. Edit the SERVER line of the license file to reflect the correct hostname. Thefield immediately after the keyword SERVER, put_server_name_here, must bechanged to the TCP/IP hostname on which the server is to run. Be sure you replacethat entire string with the actual hostname. To find the correct hostname, open acommand window and execute the ipconfig /all command.

b. Verify the port number. The fourth field of the SERVER line is thecommunication port number. The default value is 1700 or 1717. This number can beset to any other port number which is currently not in use.

Tip: If the IPX/SPX protocol is present on the license server, specify TCPcommunication by placing TCP: before the port number. This keyword forcescommunication through TCP rather than the less reliable UDP.

In this example, here is the SERVER line after editing:

SERVER cipher 00C04FA124CB TCP:1700



December 2009

c. Edit the DAEMON line to include the path to the mgcld vendor daemon. On theDAEMON line, the third field, path_to_mgcld, must be changed to an absolutepathname which resolves to the mgcld.exe executable, which is located in thedirectory where the license server software was installed to. By default, this is theC:\MentorGraphics\Licensing directory. Locate mgcld.exe and specify its path.

In this example, here is the DAEMON line after editing:

DAEMON mgcld C:\MentorGraphics\Licensing\mgcld.exe

Tip: There must be no spaces in the pathname specified on the DAEMON line. Longfilenames are supported as long as there are no spaces. If the path specified contains aspace, surround the entire path with double quotes, or convert it to a MS-DOS formatfilename. For example, Program Files becomes Progra~1. If you cannot locate mgcld.exeon your license server computer, you probably have not installed Mentor Graphicslicensing. If you require assistance with this step, contact Customer Support.

d. Ensure that there are no blank spaces at the end of any line.

Step 3: Starting the License Server

Floating and Nodelocked counted only

Tip: You can install and configure the network license server software from the Autorunmenu of the PADS installation. Access the Autorun menu from the PADS CD-ROM orby running autorun.exe from your PADS installation download area.

1. Define the license server service. You need to configure this application to run theserver to your specifications.

An application, lmtools.exe, controls the license server. Typically, this program will befound from the Start Menu at Start > Programs > Mentor Graphics Licensing. If youdo not see it there, search the license server harddrive for the file name lmtools.exe.Some tools store this executable inside the tree.

a. Invoke LMTOOLS from the Start Menu or by double-clicking on the executable.The executable is typically located in the Start Menu in either Mentor GraphicsLicensing or the Mentor Graphics SDD > PADS<version> > Licensing tools.

b. Select Configuration Using Services.

c. Select the Config Services tab.



d. Fill in the Path to the lmgrd.exe file. The lmgrd.exe is found in the directory whereyou installed the license server software. By default, the location is C:\MentorGraphics\Licensing.

e. Fill in the remaining fields with the information appropriate to your system. Makesure the boxes labeled Use Services and Start Server at Power Up are bothchecked.

Tip: Browsing for the license file only looks for files of type *.lic by default. Change thesearch criteria if the license file name ends in .dat or .txt.

f. Click the Save Service button and click Yes.

2. Start the license server. The license server must be started before it can serve licenses.

a. Invoke LMTOOLS from the Start Menu or by double-clicking on the executable.

b. Select Configuration Using Services.

c. Select the Start/Stop/Reread tab.

d. Verify that the desired license server service is highlighted, then click the StartServer button.

3. Verify the server is running.

a. Invoke LMTOOLS.

b. Select the Server Status tab.

c. Click Perform Status Enquiry.

d. Ensure that the license server reports a status of UP and that there are no errors.

4. On each client computer, define an environment variable to point to the licenseserver. The clients must know how to contact the server in order to check out a license.

a. Navigate to System Properties. Right-click on the My Computer icon and selectProperties or go to Control Panel > System.

b. Go to Environment Variables. Select the Advanced tab and click theEnvironment Variables button.

c. Create or edit the variable MGLS_LICENSE_FILE. Define the variable usingthe port number and host name of the license server. For example: 1700@cipher.

Tip: You can execute the Install License shortcut from the Start Menu at Start >Programs > Mentor Graphics SDD > PADS<version> > Licensing Tools. Select theNetwork license client.



December 2009

Tip: MGLS_LICENSE_FILE can be created as a System Variable, available to all usersthat log in to this system, or it can be created as a User Variable, available only to thecurrent user. A user with Administrator privileges may create a System Variable. Be surethat only one variable points to your license server. Duplicate pointers can slow downperformance and may cause other technical problems.

Step 4: Verifying a workstation can check out a licenseAn application called pcls_ok is used to test license checkout on computers running Windowsoperating systems. Typically, pcls_ok is found from the Start Menu either at Start > Programs> Mentor Graphics Licensing or Start > Programs > Mentor Graphics SDD >PADS<version> > Licensing Tools. If you do not see it there, search the computer harddrivefor the file name pcls_ok.exe. Some tools store this executable inside the tree. This verificationmethod works with both floating and nodelocked uncounted (mobile compute) licenses.

1. Invoke pcls_ok from the Start Menu or by double-clicking on the executable.

2. Test checkout of a specific license. Type the license name pwrshell into the Featurebox and click the Apply button.

Tip: You can identify license names by looking in the license file. The field to the rightof the word INCREMENT is the license name.

3. Verify the license is successfully checked out. A success or failure message isdisplayed. If you receive a success message, that indicates licenses can be checked outsuccessfully from that workstation. If you receive a failure message, click [>>>Details]for more information. At this point, you may want to contact Customer Support or yourlocal sales office for assistance.


Chapter 3Managing Environment Settings

This chapter discusses the following:

• “Setting Environment Variables” on page 27

• “Using the Configurator” on page 29

• “Understanding the Directory Structure” on page 32

• “Managing Multiple Mentor Graphics Releases” on page 33

Setting Environment VariablesThis section contains a description of the environment variables that should be set for each user.Other environment variables that are specific to Mentor Graphics applications are listed inproduct-specific configuration manuals or release notes.

To set environment variables on Windows, go to Start > Settings > Control Panel > System >Advanced > Environment Variables.

• Click New to add a new variable name and value.

• Click Edit to change an existing variable name and value.

Examples of setting the various variables are provided with each environment variable below.

NotePADS installation sets all of the following variables by default, except for the licensingenvironment variables. An exception on the licensing environment variables isMGLS_LICENSE_FILE, which is set automatically if you set up the licensing during theinitial stage of the install.

Setting SDD_HOMESets the environment variable for SDD Release Installations. If the Configurator is installed,you do not need to set the SDD_HOME variable.


Managing Environment SettingsSetting Environment Variables

December 2009

NoteYou are expected to set the SDD_HOME and the MGC_HOME environment variablesbefore invoking the application software. For instructions on setting variables, see“Setting Environment Variables” on page 27.

NoteThe Configurator will set the MGC_HOME and SDD_HOME variables for you.

Setting MGC_HOMESets the environment variable for Mentor Graphics enterprise product installations includingFalcon-based products and ICX releases. If the Configurator is installed, you do not need to setthe MGC_HOME variable.

NoteThe Configurator will set the MGC_HOME and SDD_HOME variables for you.

Setting MGLS_LICENSE_FILE or LM_LICENSE_FILEMentor Graphics supports two licensing environment variables, MGLS_LICENSE_FILE andLM_LICENSE_FILE.

For detailed information on licensing variables, refer to “Using Environment Variables” onpage 19.

NoteUse MGLS_LICENSE_FILE for optimum performance of Mentor Graphics applications.The license file contains the <port>@<host> values. However, some third-party productsmay require LM_LICENSE_FILE.

The Configurator ignores the setting of the LM_LICENSE_FILE and only appends to theMGLS_LICENSE_FILE with the license sources that you specify.

Setting WDIRWDIR (Working DIRectory) is used to store project settings and data and is used in conjunctionwith $SDD_HOME/standard to retain application configuration and project data.

This variable can be edited by the user.

Managing Environment SettingsUsing the Configurator


The following products require the WDIR environment variable to point to a writeable locationin addition to the standard directory from which it reads in the installed tree on all platforms.

• Constraint Editing System (CES)• DxDesigner• ePlanner• ICX Pro Explorer• Quiet Expert

o During PADS standard installation, if you have DxDesigner installed and havepreviously set the WDIR environment variable, the Set WDIR window appears. Youcan accept the current WDIR or specify another path.

NoteIf the WDIR environment variable is set on the target computer, the batch installationoverwrites it with the default setting (the path of the PADS Project plus the standarddirectory in the installation). After batch installation, you can set the variable to adifferent path.

NoteIf DxDesigner is not installed or if it is installed but no WDIR was set, the Set WDIRwindow does not appear.

The PADS installation sets WDIR to the path of the PADS Project plus the standard directory inthe installation. For example: C:\Mentor Graphics\9.0PADS\SDD_HOME\standard.

If WDIR is not set, $HOME/wdir is created and used as the writeable location.

Using the ConfiguratorThe Configurator is a Windows-only application and is used in the situations listed below. Forbest results, all application software should be installed into the same SDD_ROOT.

• The Configurator runs automatically when you install your software. It examines yourenvironment and leads you through a series of dialog boxes. It then sets up yourenvironment based on the selections you have made.

• You run the Configurator manually to switch between product versions or differentapplication flows. Mentor Graphics System Design Division (MGC SDD) tools cancoexist on your computer. When you install a new version of SDD software in yourexisting %SDD_ROOT% directory, a new version of the%SDD_ROOT%\win32\configurator.exe is installed.

• The Configurator keeps track of previous releases that might also be installed in the%SDD_ROOT% directory. At any time you can choose to switch between different



December 2009

versions by running the Configurator to configure your environment for the product andversion you have selected.

• You run the Configurator manually as a “fixup” tool. If you have issues with yoursoftware that you believe may be environment-related, run the Configurator toautomatically establish your environment to match your present software setup.

• The Configurator is run automatically when you uninstall your software.

For additional information about the Configurator and its processes, you can access the help fileby selecting the Help button in the MGC SDD Configurator dialog or by navigating to%SDD_ROOT%\win32\configurator.chm.

Who Can Run the Configurator?Beginning with the 2005 releases, environment variables set by the Configurator are set asSystem variables rather than as User variables. The result of this change is that tool installationsare configured for all users of a given computer. Users who will be installing the tools arerequired to have administrator privileges on the computer; power user privileges are notsufficient.

NoteThe Configurator is an application that examines and sets up your environment enablingyou to switch between releases and flows. (For more information on the Configurator, see“Using the Configurator” on page 29.)

The setting of the SDD_USELOCALENV system variable is optional and determines who canrun the Configurator and programs.

NoteTo use the SDD_USELOCALENV variable functionality, the variable must be setbefore performing an installation.

If you use the SDD_USELOCALENV variable, as Administrator you need to changepermissions on the \MentorGraphics and \PADS Projects directories to give full access rights tothese directories after the software is installed. For example, if an Administrator sets up a PowerUser account they must select the \MentorGraphics and \PADS Projects directories and allowthe Power User full access rights. Failure to perform this step will result in permissions errorswhen the user attempts to run PADS or open files that they don't have permissions to access. Bydefault, Administrator owns the files so a Power User attempting to re-save a sample design orchange a system parameter will see errors.

NoteRunning in non_Administrator mode is supported only for Windows XP.



If you want to run the Configurator and Mentor Graphics SDD programs as Power User or User,set the SDD_USELOCALENV variable prior to performing an installation.

NoteIf you install without setting the SDD_USELOCALENV variable and then want to run asPower User or User, you need to add the variable and then re-install the software. Youcannot run as Power User or User without re-installing the software since the installerconfigures the environment and variables based on this setting.

The following table describes the SDD_USELOCALENV system variable options.

Table 3-1. SDD_USELOCALENV Settings

SDD_USELOCALENV set to:Who can run the Mentor Graphics SDDConfigurator

ADMIN Only the initial installing Administrator is able tosee the Mentor Graphics SDD programs on theirStart menu and execute the programs.

Power Users and any other users cannot run theConfigurator or other programs.

POWER_USER Only the initial installing Administrator is able tosee the Mentor Graphics SDD programs on theirStart menu and execute the programs.

However, all other Administrators and PowerUsers can execute the programs. OtherAdministrators and Power Users have to run theConfigurator to configure their access to theprograms. Users not in these categories cannot runthe programs.

USER Only the initial installing Administrator is able tosee the Mentor Graphics SDD programs on theirStart menu and execute the programs.

All other Administrators, Power Users, and anyother user can execute the programs. The otherusers will have to run the Configurator toconfigure their access to the programs.


Managing Environment SettingsUnderstanding the Directory Structure

December 2009

Understanding the Directory StructureThis section describes the directory structure by providing a general structural overview.

Structural OverviewFigure 3-1 shows how a locally loaded tree might appear in a Windows environment.

Figure 3-1. Simple Tree Structure Example

The MGC_HOME directory exists under the flow root directory, indicated by “9.0PADS” in thefigure above.

The Mentor Graphics Enterprise PCB Software Directory Structure contains the followingdirectory structures:

• SDD_ROOT — Single root directory for Mentor Graphics PCB Software

This directory provides a single root for all Mentor Graphics PCB Softwareinstallations. The SDD_ROOT will contain the appropriate flow root(s). SDD_ROOT isthe same as the installation target.

You can choose to keep complete installs for multiple, different flows in siblingdirectories under SDD_ROOT. On Windows, you can run the Configurator to choosewhich flow you want to use. Remember to re-run the Configurator if you want to revertto a different flow. Your environment settings and menus will be reconfigured to utilizeapplications in the flow that you specify in the Configurator.

CautionAll Mentor Graphics SDD (Systems Design Division) product installs must be installedinto the same SDD_ROOT folder. SDD programs located in different SDD_ROOTfolders may not interoperate properly without special intervention. Refer to theConfigurator help file located at %SDD_ROOT%\win32\configurator.chm forinstructions on switching between flows.

MentorGraphics $SDD_Root

9.0PADS

docs Product docs / InfoHubs

MGC_HOME.ixn

SDD_HOME $SDD_HOME

Flow Root Directory

$MGC_HOME

Managing Environment SettingsManaging Multiple Mentor Graphics Releases


• Flow root — Single directory for a specific SDD product group. The flow root tree,indicated in Figure 3-1 by “9.0PADS”, is the directory containing MGC_HOME andSDD_HOME trees. It exists one level below the SDD_ROOT. The flow root does nothave an associated environment variable.

• MGC_HOME — Directory for Mentor Graphics Enterprise (Falcon-based)installations. These applications will install underC:\MentorGraphics\9.0PADS\MGC_HOME.<vco>, where <vco> is the three letterplatform identifier. In this particular case, vco is “.ixn” for Windows.

This is the default naming convention followed during installation.

NoteExceptions: In general, PADS, ePD and Expedition products software do not useMGC_HOME.

• SDD_HOME — Directory for SDD Release installations. The SDD_HOME variablepoints to the directory in the corresponding flow root depending upon which flow youspecified during the Configurator process. For example,%SDD_HOME%=%SDD_ROOT%\9.0PADS\SDD_HOME

• For example on Windows, you might see C:\MentorGraphics\9.0PADS\SDD_HOMEwhere SDD_ROOT is “C:\MentorGraphics” and the flow root is “9.0PADS.”

Managing Multiple Mentor Graphics ReleasesThe directory structure for Mentor Graphics PCB software allows you to install multiplereleases under one umbrella directory (the recommended install method is to accept the defaultinstallation directories). The following guidelines apply:

• Products distributed on the same CD-ROM interoperate and can be installed in a singletree.

• Mentor Graphics PCB Software may coexist with non-PCB software installed in thesame MGC_HOME directory.


Managing Environment SettingsManaging Multiple Mentor Graphics Releases

December 2009


Chapter 4Managing Mentor Graphics Documentation

This chapter is designed for the system administrator who must set up the documentation. Itdescribes how to setup and install the documentation, and describes the documentationorganization and structure. The chapter is organized as follows:

Understanding the Documentation Tree Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Defining Optional Documentation Environment Variables . . . . . . . . . . . . . . . . . . . . . . 37Setting Variables on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Setting Variables on UNIX/Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Using the Mentor Graphics Documentation System . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Accessing the Mentor Graphics Documentation System . . . . . . . . . . . . . . . . . . . . . . . . . . 39Finding Answers with InfoHub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Browsing the List of Manuals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Custom Tab of the InfoHub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Navigating HTML Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Required Internet Explorer Option with Windows XP SP2 . . . . . . . . . . . . . . . . . . . . . . 50Permanent Workaround . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Temporary Workaround . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Understanding the Documentation TreeStructure

Mentor Graphics typically ships its documentation in the release as packages. Each packagetypically contains a small group of documents that directly support an application. Eachpackage follows the naming convention <prod>_docs.any, where <prod> is an intuitiveacronym that represents the product that the package of manuals document. For MentorGraphics applications that install into an MGC_HOME directory, when you install anapplication, its associated document packages automatically install into the same location bydefault.

The typical Mentor Graphics Documentation System has the following directory structure. Thedocumentation directory is either named docs, doc, or shared. This docs directory is self-contained, in that, all links between documents (PDF and HTML) are relative.

Refer to Figure 4-1 for an illustration of the HTML/PDF-based documentation directorystructure.


Managing Mentor Graphics DocumentationUnderstanding the Documentation Tree Structure

December 2009

Figure 4-1. HTML/PDF-based Documentation Directory Structure

{root of product installation}||-- bin| |-- mgcdocs (UNIX or Linux only)||-- docs|doc|shared| |-- asciidocs| |-- data| |-- htmldocs| | |-- {handleA}| | |-- {handleB}| || |-- infohubs| | |-- index.html| | |-- {ih_handle1}_ih| | |-- {ih_handle2}_ih| || |-- movies| | |-- {handleM}| | |-- {handleM}.html| || |-- pdfdocs| | |-- {handleA}.pdf| | |-- {handleB}.pdf

For the Expedition Enterprise releases, the Mentor Graphics Documentation System has aslightly modified directory structure. The top-level of the documentation installation beginsunder the $SDD_HOME directory. For example:

MentorGraphics ($SDD_ROOT)||-- 2007EE |-- MGC_HOME.{vco} ($MGC_HOME) |-- SDD_HOME ($SDD_HOME)

|-- docs

Table 4-1 lists the naming conventions for common Doc package files.

Table 4-1. Naming Conventions for HTML/PDF-based Doc Tree

Name Description

asciidocs/README_<handle>.txt

An ASCII file that typically contains release notes. Thispractice of shipping ASCII release notes is used by someproducts.

htmldocs/<handle> A unique directory for the HTML documentation equivalent ofthe pdfdocs/<handle>.pdf file. If opening the HTMLdocumentation directly, open the wwhelp.htm file. If yourdocumentation system is PDF and PDF Help topics, you willnot have HTML documentation.

Managing Mentor Graphics DocumentationDefining Optional Documentation Environment Variables


Defining Optional Documentation EnvironmentVariables

Many of the Mentor Graphics applications support an optional set of environment variables tocontrol different aspects of the user’s access to the documentation system. These variables are:

• MGC_DOC_PATH — Specifies an alternate location of the product documentation.The default location for the documentation directory is

<install_dir>/docs | doc | shared.

You set this variable to the full path of a valid Mentor Graphics documentationinstallation (docs | doc | shared) containing infohubs, htmldocs, and pdfdocs sub-directories. Do not include infohubs, htmldocs, or pdfdocs as part of the path value. Forexample:

Windows — Set MGC_DOC_PATH to “C:\MentorGraphics\9.0PADS\docs”

UNIX or Linux — Set MGC_DOC_PATH to /server1/9.0PADS/docs

For more information on the documentation installation structure, refer to “RequiredInternet Explorer Option with Windows XP SP2” on page 50.

• MGC_HTML_BROWSER — Specifies the web browser to use for displaying HTMLdocumentation and is used to override the default order of browser selection. Thisenvironment variable gives you control as to which browser the MGC tool invokeswhen InfoHub, or a help topic, is called. By default, the following browsers are searchedfor in the specified order: FireFox, Mozilla, Netscape, then Internet Explorer. You setthis variable to either the full path of a supported web browser executable, or simply tothe name of the browser executable (if it can be found with the PATH variable). Forexample:

Windows — Set MGC_HTML_BROWSER to “C:\Program Files\MozillaFirefox\firefox.exe”

UNIX or Linux — Set MGC_HTML_BROWSER to “firefox”

infohubs/<handle>_ih A unique directory for the InfoHub information center. Someproducts use the InfoHub in place of a bookcase file.

pdfdocs/<handle>.pdf A unique filename for a PDF manual. Most handles consist of<prod>_<doctype>. For example, the handle of QuickSim IIRelease Notes is qsim_rn.pdf.

Table 4-1. Naming Conventions for HTML/PDF-based Doc Tree

Name Description


Managing Mentor Graphics DocumentationUsing the Mentor Graphics Documentation System

December 2009

• MGC_PDF_READER — Specifies the viewer to use for PDF documentation. You setthis variable to the full path of the Acrobat executable. This variable replaces$MGC_HELP_VIEWER. For example:

Windows — Set MGC_PDF_READER to “C:\Program Files\Adobe\Acrobat7.0\Reader\AcroRd32.exe”

UNIX or Linux — Set MGC_PDF_READER to “/opt/Acrobat7/bin/acroread”

Setting Variables on WindowsTo set environment variables on Windows, select the Start > Settings > Control Panel >System menu item. Next, choose the Advanced tab, then click Environment Variables.Choose one of the following options for user or system variables:

• Click New to add a new variable name and value.

• Click Edit to change an existing variable name and value.

Setting Variables on UNIX/LinuxThe syntax to set an environment variable in Korn and Bourne shells is different than that of aC-Shell. In Korn and Bourne shells, set environment variables as follows:

VARIABLE_NAME=variable_valueexport VARIABLE_NAME

In a C-shell, set an environment variable as follows:

setenv VARIABLE_NAME variable_value

Using the Mentor Graphics DocumentationSystem

The Expedition Enterprise release ships with the new Mentor Graphics Documentation System,which includes the following components:

• InfoHub™ — An embedded product information portal that provides links to all yourlocally installed documentation. The InfoHub also provides a search interface, fromwhich you can search across all your locally installed documents. The search interfacealso enables you to submit a search directly to SupportNet. For tips on using InfoHub,see “Finding Answers with InfoHub” on page 39.

• Help & Manuals — User and Reference manuals, Process guides, and other types ofdocumentation, delivered in both HTML and PDF formats. Mentor Graphics providesthe documentation in HTML and PDF formats to offer you the various features of each



format. The actual content does not vary between the formats. For more information onthe HTML interface, refer to “Navigating HTML Manuals” on page 46.

The Mentor Graphics Documentation System replaces the PDF bookcases and theaccompanying PDF search indexes.

NoteThe Mentor Graphics Documentation System requires a browser and Adobe AcrobatReader. Refer to SupportNet for complete details:

http://supportnet.mentor.com/sysadmin/browser_requirements.cfm

http://supportnet.mentor.com/sysadmin/acrobat_reader.cfm

Note for Acrobat Reader, you do not need to install the Mentor Graphics search indexplug-in to use the Mentor Graphics Documentation System.

Accessing the Mentor Graphics Documentation SystemYou can access the documentation in the following ways:

• Help menu — If the Mentor Graphics application provides a GUI, select Help > Help &Manuals or Help > Documentation. (The actual text of the Help menu may vary.)

• Help button — Many dialog boxes provide a Help button which invokes a browser anddisplays a relevant topic. The topic is provided within the context of a manual.

• Shell command — On UNIX/Linux platforms, enter “mgcdocs” at the prompt or invokea tool with the -Manual invocation switch.

• Start menu — On Windows platforms, select Start > Programs > Mentor Graphicsand navigate to the documentation option. (The actual text of the documentation optionmay vary.)

• File system — Access the Mentor Graphics documentation system directly from the filesystem, without invoking the Mentor Graphics tool. From your product installation, loadthe following file into a browser:

../docs|doc|shared/infohubs/index.html

Finding Answers with InfoHubThe InfoHub is designed to give you quick access to documentation. You can browse the list ofall documentation installed with your product, or submit a search query.

http://supportnet.mentor.com/sysadmin/browser_requirements.cfm

http://supportnet.mentor.com/sysadmin/acrobat_reader.cfm



December 2009

Browsing the List of ManualsThe Help & Manuals tab displays when you invoke the InfoHub. By default, the InfoHubdisplays the alphabetized list of all locally installed documents. You can narrow the display ofmanuals by choosing a scope in the left-hand navigation menu. Double-click on the desiredmanual to display it. See Figures 4-2 and 4-3.

NoteThe manual displays in a separate browser than the InfoHub.

Figure 4-2. Manuals listed in the InfoHub



Figure 4-3. List of Manuals Scoped to a Product Area

Submitting a Search QueryThe InfoHub provides a flexible search interface. You can submit a query to all the locallyinstalled product documentation, to a predefined scope of documentation, or to a subset ofmanuals that you define. You can also submit a query directly to SupportNet. See Figures 4-4and 4-5.



December 2009

Figure 4-4. Flexible Search Interface



Figure 4-5. My Search List for Limiting the Search Query

Search Tips for Local Searches

The search engine for locally installed documentation is limited to keywords. For search tips,click Quick Tips > Search Tips from the menu in the lower-left corner of InfoHub. See Figure4-6.



December 2009

Figure 4-6. Search Tips for Local Searches

Submitting a Search Query Directly to SupportNet

The search engine on SupportNet enables you to submit queries in phrases such as “What is...?”and “How do I...?”. You can submit a natural language search from InfoHub to SupportNet bychoosing “SupportNet” from the “Choose Search” menu. The SupportNet search isautomatically constrained to your chosen product area.

Custom Tab of the InfoHubIn addition to the standard tabs that InfoHub provides, you can add your own tab to theInfoHub. This custom tab can display an URL, or you can create a web page with links toprocess documentation or other content that is specific to your organization. For details onadding a custom tab, click Quick Tips > Adding a Custom Tab to the InfoHub from themenu in the lower-left corner of InfoHub. See Figures 4-7 and 4-8.



Figure 4-7. InfoHub with Custom Tab Displaying an URL



December 2009

Figure 4-8. Custom Tab with Links on a Web Page

Navigating HTML ManualsThe HTML interface for manuals provides the following four navigation methods:

• Table of Contents — A hierarchical presentation of grouped topics.

• Index — A hand-crafted presentation of terminology, enabling you to refine the scopeof the index.

• Search — Essentially the same search interface as the InfoHub, enabling you to refineyour search query.

• My Topics — A tab that enables you to bookmark your favorite topics.



Scoping Navigation in the IndexThe index interface allows you to scope the index entries to a specific book, to all locallyinstalled manuals, to a specific product scope, or to your custom search list. See Figure 4-9.

Figure 4-9. Navigating with the Index Tab

Scoping Navigation in the SearchThe search interface allows you to scope the search to a specific book, to all locally installedmanuals, to a specific product scope, or to your custom search list. You can also submit a searchquery directly to SupportNet. There are also several options accessible from the Options menuthat allow you to refine the presentation of the results list. See Figure 4-10.



December 2009

Figure 4-10. Navigating with the Search Tab

Providing Feedback to Mentor GraphicsWe encourage you to provide feedback on the documentation as you are reading it. Both theHTML and PDF interfaces provide buttons that invoke a feedback form on SupportNet. Theform automatically prefills the manual from which you clicked the Feedback button. SeeFigures 4-11 and 4-12.



Figure 4-11. Feedback Button on HTML Interface


Managing Mentor Graphics DocumentationRequired Internet Explorer Option with Windows XP SP2

December 2009

Figure 4-12. Feedback Bookmark on PDF Interface

Required Internet Explorer Option with WindowsXP SP2

Windows XP Service Pack 2 (SP2) contains security enhancements that directly affect thebehavior of Internet Explorer (IE). If you have installed SP2, IE restricts access to locallyinstalled Mentor Graphics browser-based documentation. When you try to access the Mentor



Graphics InfoHub or other browser-based documentation, you will get the following messagesin IE:

Follow the instructions in the Permanent Workaround to set the required Internet Exploreroption to bypass the restriction. If you do not set the required option, Internet Explorer willprompt you to temporarily bypass the restriction when you attempt to access the documentation.

NoteThis security restriction is exclusive to following conditions:

SP2IElocally installed browser-based documentation.

If the documentation is accessed from a network drive or is served from a web server(HTTP), the restriction does not occur.

NoteFireFox and Netscape do not exhibit this security restriction and are adequate alternativesto Internet Explorer.



December 2009

Permanent WorkaroundWith one option in IE, you can permanently bypass the security restriction and accessthe documentation without errors.

1. In IE, select Tools > Internet Options.

2. Select the Advanced tab.

3. Select Allow active content to run in files on My Computer.

4. Click OK.

Temporary WorkaroundThe following workaround allows you to access the documentation without changing yourInternet Explorer options.

Do not follow these instructions if IE is not your default browser.

1. Launch the InfoHub interface by double-clicking the following file:

<install_dir>/9.0PADS/docs/infohubs/index.html

where <install_dir> is the target directory where you installed the Mentor Graphicsapplication software.

The “Information Bar” message appears.

2. Click OK in the “Information Bar” message.

3. Click the yellow “Information Bar” beneath the URL.

4. Select Allow Blocked Content from the popup menu.

A security warning dialog box displays.

5. Click Yes.

The InfoHub displays properly.

NoteFor more information on Windows XP Service Pack 2, see the Microsoft site:http://www.microsoft.com/technet/prodtechnol/winxppro/maintain/sp2chngs.mspx

http://www.microsoft.com/technet/prodtechnol/winxppro/maintain/sp2chngs.mspx


Chapter 5Troubleshooting

The Mentor Graphics Install program will return errors if the installation procedures cannotcomplete, or if the installation process completed but detected certain problems within theinstallation. For your convenience, some of the more common errors are listed in this chapter.

Hardware and Operating System RequirementsFor information about the hardware and operating system requirements necessary to executeMentor Graphics software, refer to the product-specific documentation or the Mentor GraphicsSupportNet website:

http://supportnet.mentor.com/systemreqs/

Mentor Graphics SupportNetMentor Graphics software support includes software enhancements, technical support, access tocomprehensive online services with SupportNet, and the optional On-Site Mentoring service.For details, see:

http://supportnet.mentor.com/about/

If you have questions about this software release, please log in to SupportNet. You may searchthousands of technical solutions, view documentation, or open a Service Request online at:


If your site is under current support and you do not have a SupportNet login, you may easilyregister for SupportNet by filling out the short form at:

http://supportnet.mentor.com/user/register.cfm

All customer support contact information can be found on our web site at:

http://supportnet.mentor.com/contacts/supportcenters/

http://supportnet.mentor.com/about/

http://www.mentor.com/supportnet/spt_configs/index.html


http://supportnet.mentor.com/user/register.cfm

http://supportnet.mentor.com/contacts/supportcenters/


TroubleshootingTroubleshooting Common Errors

December 2009

Troubleshooting Common ErrorsTable 5-1 lists some of the more common errors encountered during installation.

Table 5-1. Troubleshooting Common Errors

Error # Problem Result Solution

CP0008 The current version of theInstall program on yoursystem is out of date. Thereis a newer version of theInstall program available onthe latest installation media.

You must update yourversion of the MentorGraphics Installprogram from thelatest installationmedia.

Exit the Mentor GraphicsInstall program and refer toeither the web-based“Installation Instructions”on the SupportNetdownload web page, or theCD booklet available withall installation media.

CP00030 The Mentor Graphics Installprogram encountered anerror while trying to readthe startup data.

The Install programwill not proceedfurther.

The installData.xml.gz fileneeds to be in the MentorGraphics Install datadirectory. On UNIX this filename is case sensitive.

IPW112 An error occurred when theInstall program tried toopen a script archive file.

The Installation scriptarchive could not befound, therefore theInstall program willnot proceed.

If you are installing sourcefrom CD-ROM, make surethe Volume 1 CD-ROM isavailable and click Retry.Selecting Cancel willcancel the installation.

IPW113 An error occurred when theInstall program tried toopen a script archive file.

The Installation scriptarchive could not befound, therefore, theInstall program willnot proceed.

If you are installing sourcefrom CD-ROM, make surethe Volume 1 CD-ROM isavailable and click Retry.Selecting Cancel willcancel the installation.

IPW114 A file write error occurred. The Install programcannot write to thespecified file.

The file (or directory thefile is in) may not haveWrite permissions. Verifythat permissions are openon the file/directory andselect Retry to continue theinstallation. SelectingCancel will cancel theinstallation.

IPW116 An error occurred whileattempting to write to a file.

The Install programcould not write to thespecified file andinstallation is beingcancelled.

Verify the path to the file. Ifthe path was correct, contactCustomer Support andprovide them with theDetails and Error #IPW116.

TroubleshootingTroubleshooting Common Problems


Troubleshooting Common ProblemsTable 5-2 shows some frequently encountered problems, with their possible causes andsolutions. For additional help, consult applicable vendor manuals or contact the MentorGraphics SupportCenter.

IPW118 An error occurred whileattempting to write to a file.

The Install programcould not write to thespecified file andinstallation is beingcancelled.

Verify the path to the file. Ifthe path was correct, contactCustomer Support andprovide them with theDetails and Error #IPW118.

IPW122 A file write error occurred. The Install programcannot write to thespecified file.

The file (or directory thefile is in) may not havewrite permissions. Verifythat permissions are openon the file/directory andselect Retry to continue theinstallation. SelectingCancel will cancel theinstallation.

IPW123 A file read error occurred. The Install programcannot read thespecified file.

The file (or directory thefile is in) may not haveRead permissions. Verifythat permissions are openon the file/directory andselect Retry to continue theinstallation. SelectingCancel will cancel theinstallation.

Table 5-2. Troubleshooting Common Problems

Problem PlatformPossibleCause Solution

During ProductRemoval,Product orRelease is notvisible in theInstall program.

UNIXLinuxPC

May not bepointing at theappropriateTargetlocation.

Verify that correct Target location has beenindicated on Product Removal Selectionwindow.

Table 5-1. Troubleshooting Common Errors (cont.)

Error # Problem Result Solution


TroubleshootingTroubleshooting Common Problems

December 2009

Unable to click ina checkbox.

UNIXLinuxPC

The sensitivitysetting foryour mouse isset incorrectlyfor this Javaapplication.

Decrease the sensitivity of your mouse (sothe mouse moves slower) in your ControlPanel. Refer to technote mg48980 inSupportNet.

Unable to installthe MentorGraphics Installprogram in a newdirectory.

UNIXLinuxPC

A version ofthe Installprogramalready exists.

Run setup.exe -force. The-force option enables you to install a newerversion of the Install program to another treeor install an older version of the Installprogram over top of a newer version.

Unable touninstall theMentor GraphicsInstall program.

UNIXLinuxPC

Navigate to the directory where Install.exe islocated.1. Open the bin directory and double-click

on Uninstall.exe. This does not fullyremove all of the Mentor Graphics installprogram, but it does remove the registryentries so that the install program can bere-installed.

2. Delete the install directory. This removesall targets.

Table 5-2. Troubleshooting Common Problems (cont.)

Problem (cont.) PlatformPossibleCause (cont.) Solution (cont.)

1

A B F GDC E H I J K L M N O P Q R S T U V XW Y Z

Managing Mentor Graphics PCB Systems SoftwareDecember 2009

— A —administrator privileges, 30

— B —blank spaces in the license file, 23

— C —Commands

lmreread, 19lmstat, 19lmutil, 19

communication port number, 23Configurator, 29, 30CP00030, 54CP0008, 54Customer Support website, 20

— D —DAEMON, 22

LicensingDAEMON, 21

Dallas Dongle, 21default naming convention for platforms, 33determining what kind of licenses you have, 21DHCP address, 22directory structure, 32document package, 35documentation

document package, 35Internet Explorer Option for Windows XP

Service Pack 2 (SP2), 50dongle, 21Dongles

Dallas Dongle, 21ePD Sentinel Dongle, 21Rainbow Sentinel Dongle, 21USB Dongle, 21

downloading software on UNIX/Linuxplatforms, 7

downloading software on Windows platforms,6

dynamic IP address, 22

— E —editing the license file, 21environment variables

LM_LICENSE_FILE, 19, 28MGLS_LICENSE FILE, 19MGLS_LICENSE_FILE, 19, 23SDD_HOME, 27WDIR, 28

ePD Sentinel Dongle, 21Error #CP0006, 55Ethernet Address, 21Ethernet card, 17Ethernet network interface controller (NIC), 21

— F —FLEXnet

LM_LICENSE_FILE, 19FLEXnet hardware, 17Floating licenses, 17floating licenses

communication port number, 23TCP/IP hostname, 23

Flow root, 33Frequently encountered problems, 55

— H —handle, 37hardware key, 17, 21HOSTID, 21

— I —INCREMENT, 21, 22independent servers, 19install, 33installing

multiple Mentor Graphics releases underone umbrella directory, 33

other products after initial installation, 16the license file on Windows, 22

Index

2December 2009



Internet Explorer Option for Windows XPService Pack 2 (SP2), 50

IPW112, 54IPW113, 54IPW114, 54IPW116, 54IPW118, 55IPW122, 55IPW123, 55IPX/SPX protocol, 23

— L —license file

blank spaces in, 23communication port number, 23path_to_mgcld, 24

license serverIPX/SPX protocol, 23UDP, 23

Licensingcommunication port number, 23configuring on Windows, 20Dallas Dongle, 21determining what kind of licenses you

have, 21DHCP address not supported, 22dongle, 21dynamic IP address not supported, 22editing the license file, 21environment variables, 19ePD Sentinel Dongle, 21Ethernet Address, 21Ethernet card, 17Ethernet netowrk interface controller on

Windows, 21FLEXnet hardware, 17Floating licenses, 17flow overview, 18hardware key, 17, 21HOSTID on Windows, 21INCREMENT, 21independent servers, 19installing the license file on Windows, 22IPX/SPX protocol, 23LM_LICENSE_FILE, 19lmreread command, 19

lmstat command, 19lmutil command, 19MGLS_LICENSE_FILE, 19, 23mobile compute, 17NIC, 21NIC physical address, 21nodelocked licenses, 17Options file, 17ordering licenses, 20overview overview, 17PADS Pink Key, 21Parallel Port Hardware Key, 21path_to_mgcld, 24Rainbow Sentinel Dongle, 21redundant license server configurations, 20semicolon as path separator, 19SERVER, 21TCP/IP, 22TCP/IP hostname, 23UDP, 23USB Dongle, 21USB Port Hardware Key, 21verifying a workstation can check out a

license, 26licensing path separator for independent

servers, 19LM_LICENSE_FILE, 19

setting, 28lmreread command, 19lmstat command, 19lmutil command, 19

— M —managing multiple Mentor Graphics releases,

33MGC_HOME tree, 33MGLS_LICENSE_FILE, 19, 23mobile compute, 17

— N —NIC - Ethernet network interface controller, 21NIC physical address, 21nodelocked licenses, 17

— O —Options file, 17

3Managing Mentor Graphics PCB Systems SoftwareDecember 2009


ordering licenses, 20

— P —PADS Pink Key, 21Parallel Port Hardware Key, 21path separator for independent servers, 19path_to_mgcld, 24PCB Software Directory Structure, 32PDF

document package, 35naming conventions, 36package contents, 36

platform identifier, 33power user privileges, 30

— Q —Quick Install instructions, 7

— R —Rainbow Sentinel Dongle, 21redundant license server configurations, 20

— S —SDD_HOME

setting, 27SDD_HOME tree, 33SDD_USELOCALENV system variable, 30semicolon as path separator, 19SERVER, 21, 22SupportNet website, 53System variables, 30

— T —TCP/IP, 22TCP/IP hostname, 23third-party products, 28Troubleshooting Common Errors, 53

— U —UDP, 23USB Dongle, 21USB Port Hardware Key, 21User variables, 30

— V —Variables

SystemEnvironment

User, 27vco platform identifier, 33verifying a workstation can check out a license,

26

— W —WDIR

setting, 28Windows

communication port number, 23Configurator, 29configuring licensing, 20Dallas Dongle, 21determining what kind of licensing you

have, 21DHCP address not supported, 22dongle, 21dynamic IP address not supported, 22editing the license file, 21ePD Sentinel Dongle, 21Ethernet Address, 21Ethernet network interface controller, 21hardware key, 21HOSTID, 21installing the license file, 22IPX/SPX protocol, 23MGLS_LICENSE_FILE, 23NIC physical address, 21Parallel Port Hardware Key, 21path_to_mgcld in license file, 24Rainbow Sentinel Dongle, 21TCP/IP, 22TCP/IP hostname, 23USB Dongle, 21USB Port Hardware Key, 21verifying a workstation can check out a

license, 26Windows XP Service Pack 2 (SP2)

required Internet Explorer Option, 50

4December 2009



End-User License AgreementThe latest version of the End-User License Agreement is available on-line at:

www.mentor.com/eula

END-USER LICENSE AGREEMENT (“Agreement”)

This is a legal agreement concerning the use of Software (as defined in Section 2) between the company acquiringthe license (“Customer”), and the Mentor Graphics entity that issued the corresponding quotation or, if noquotation was issued, the applicable local Mentor Graphics entity (“Mentor Graphics”). Except for licenseagreements related to the subject matter of this license agreement which are physically signed by Customer and anauthorized representative of Mentor Graphics, this Agreement and the applicable quotation contain the parties'entire understanding relating to the subject matter and supersede all prior or contemporaneous agreements. IfCustomer does not agree to these terms and conditions, promptly return or, if received electronically, certifydestruction of Software and all accompanying items within five days after receipt of Software and receive a fullrefund of any license fee paid.

1. ORDERS, FEES AND PAYMENT.

1.1. To the extent Customer (or if and as agreed by Mentor Graphics, Customer’s appointed third party buying agent) places andMentor Graphics accepts purchase orders pursuant to this Agreement (“Order(s)”), each Order will constitute a contractbetween Customer and Mentor Graphics, which shall be governed solely and exclusively by the terms and conditions of thisAgreement, any applicable addenda and the applicable quotation, whether or not these documents are referenced on theOrder. Any additional or conflicting terms and conditions appearing on an Order will not be effective unless agreed inwriting by an authorized representative of Customer and Mentor Graphics.

1.2. Amounts invoiced will be paid, in the currency specified on the applicable invoice, within 30 days from the date of suchinvoice. Any past due invoices will be subject to the imposition of interest charges in the amount of one and one-halfpercent per month or the applicable legal rate currently in effect, whichever is lower. Prices do not include freight,insurance, customs duties, taxes or other similar charges, which Mentor Graphics will invoice separately. Unless providedwith a certificate of exemption, Mentor Graphics will invoice Customer for all applicable taxes. Customer will make allpayments free and clear of, and without reduction for, any withholding or other taxes; any such taxes imposed on paymentsby Customer hereunder will be Customer’s sole responsibility. Notwithstanding anything to the contrary, if Customerappoints a third party to place purchase orders and/or make payments on Customer’s behalf, Customer shall be liable forpayment under such orders in the event of default by the third party.

1.3. All products are delivered FCA factory (Incoterms 2000) except Software delivered electronically, which shall be deemeddelivered when made available to Customer for download. Mentor Graphics retains a security interest in all productsdelivered under this Agreement, to secure payment of the purchase price of such products, and Customer agrees to sign anydocuments that Mentor Graphics determines to be necessary or convenient for use in filing or perfecting such securityinterest. Mentor Graphics’ delivery of Software by electronic means is subject to Customer’s provision of both a primaryand an alternate e-mail address.

2. GRANT OF LICENSE. The software installed, downloaded, or otherwise acquired by Customer under this Agreement,including any updates, modifications, revisions, copies, documentation and design data (“Software”) are copyrighted, tradesecret and confidential information of Mentor Graphics or its licensors, who maintain exclusive title to all Software and retainall rights not expressly granted by this Agreement. Mentor Graphics grants to Customer, subject to payment of applicablelicense fees, a nontransferable, nonexclusive license to use Software solely: (a) in machine-readable, object-code form; (b) forCustomer’s internal business purposes; (c) for the term; and (d) on the computer hardware and at the site authorized by MentorGraphics. A site is restricted to a one-half mile (800 meter) radius. Customer may have Software temporarily used by anemployee for telecommuting purposes from locations other than a Customer office, such as the employee's residence, an airportor hotel, provided that such employee's primary place of employment is the site where the Software is authorized for use.Mentor Graphics’ standard policies and programs, which vary depending on Software, license fees paid or services purchased,apply to the following: (a) relocation of Software; (b) use of Software, which may be limited, for example, to execution of asingle session by a single user on the authorized hardware or for a restricted period of time (such limitations may be technicallyimplemented through the use of authorization codes or similar devices); and (c) support services provided, including eligibilityto receive telephone support, updates, modifications, and revisions. For the avoidance of doubt, if Customer requests any changeor enhancement to Software, whether in the course of receiving support or consulting services, evaluating Software or

IMPORTANT INFORMATION

USE OF THIS SOFTWARE IS SUBJECT TO LICENSE RESTRICTIONS. CAREFULLY READ THISLICENSE AGREEMENT BEFORE USING THE SOFTWARE. USE OF SOFTWARE INDICATES YOURCOMPLETE AND UNCONDITIONAL ACCEPTANCE OF THE TERMS AND CONDITIONS SET FORTH

IN THIS AGREEMENT. ANY ADDITIONAL OR DIFFERENT PURCHASE ORDER TERMS ANDCONDITIONS SHALL NOT APPLY.

http://www.mentor.com/eula

otherwise, any inventions, product improvements, modifications or developments made by Mentor Graphics (at MentorGraphics’ sole discretion) will be the exclusive property of Mentor Graphics.

3. ESC SOFTWARE. If Customer purchases a license to use development or prototyping tools of Mentor Graphics’ EmbeddedSoftware Channel (“ESC”), Mentor Graphics grants to Customer a nontransferable, nonexclusive license to reproduce anddistribute executable files created using ESC compilers, including the ESC run-time libraries distributed with ESC C and C++compiler Software that are linked into a composite program as an integral part of Customer’s compiled computer program,provided that Customer distributes these files only in conjunction with Customer’s compiled computer program. MentorGraphics does NOT grant Customer any right to duplicate, incorporate or embed copies of Mentor Graphics’ real-time operatingsystems or other embedded software products into Customer’s products or applications without first signing or otherwiseagreeing to a separate agreement with Mentor Graphics for such purpose.

4. BETA CODE.

4.1. Portions or all of certain Software may contain code for experimental testing and evaluation (“Beta Code”), which may notbe used without Mentor Graphics’ explicit authorization. Upon Mentor Graphics’ authorization, Mentor Graphics grants toCustomer a temporary, nontransferable, nonexclusive license for experimental use to test and evaluate the Beta Codewithout charge for a limited period of time specified by Mentor Graphics. This grant and Customer’s use of the Beta Codeshall not be construed as marketing or offering to sell a license to the Beta Code, which Mentor Graphics may choose not torelease commercially in any form.

4.2. If Mentor Graphics authorizes Customer to use the Beta Code, Customer agrees to evaluate and test the Beta Code undernormal conditions as directed by Mentor Graphics. Customer will contact Mentor Graphics periodically during Customer’suse of the Beta Code to discuss any malfunctions or suggested improvements. Upon completion of Customer’s evaluationand testing, Customer will send to Mentor Graphics a written evaluation of the Beta Code, including its strengths,weaknesses and recommended improvements.

4.3. Customer agrees that any written evaluations and all inventions, product improvements, modifications or developments thatMentor Graphics conceived or made during or subsequent to this Agreement, including those based partly or wholly onCustomer’s feedback, will be the exclusive property of Mentor Graphics. Mentor Graphics will have exclusive rights, titleand interest in all such property. The provisions of this Subsection 4.3 shall survive termination of this Agreement.

5. RESTRICTIONS ON USE.

5.1. Customer may copy Software only as reasonably necessary to support the authorized use. Each copy must include allnotices and legends embedded in Software and affixed to its medium and container as received from Mentor Graphics. Allcopies shall remain the property of Mentor Graphics or its licensors. Customer shall maintain a record of the number andprimary location of all copies of Software, including copies merged with other software, and shall make those recordsavailable to Mentor Graphics upon request. Customer shall not make Software available in any form to any person otherthan Customer’s employees and on-site contractors, excluding Mentor Graphics competitors, whose job performancerequires access and who are under obligations of confidentiality. Customer shall take appropriate action to protect theconfidentiality of Software and ensure that any person permitted access does not disclose or use it except as permitted bythis Agreement. Log files, data files, rule files and script files generated by or for the Software (collectively “Files”)constitute and/or include confidential information of Mentor Graphics. Customer may share Files with third partiesexcluding Mentor Graphics competitors provided that the confidentiality of such Files is protected by written agreement atleast as well as Customer protects other information of a similar nature or importance, but in any case with at leastreasonable care. Standard Verification Rule Format (“SVRF”) and Tcl Verification Format (“TVF”) mean MentorGraphics’ proprietary syntaxes for expressing process rules. Customer may use Files containing SVRF or TVF only withMentor Graphics products. Under no circumstances shall Customer use Software or allow its use for the purpose ofdeveloping, enhancing or marketing any product that is in any way competitive with Software, or disclose to any third partythe results of, or information pertaining to, any benchmark. Except as otherwise permitted for purposes of interoperabilityas specified by applicable and mandatory local law, Customer shall not reverse-assemble, reverse-compile, reverse-engineer or in any way derive from Software any source code.

5.2. Customer may not sublicense, assign or otherwise transfer Software, this Agreement or the rights under it, whether byoperation of law or otherwise (“attempted transfer”), without Mentor Graphics’ prior written consent and payment ofMentor Graphics’ then-current applicable transfer charges. Any attempted transfer without Mentor Graphics’ prior writtenconsent shall be a material breach of this Agreement and may, at Mentor Graphics’ option, result in the immediatetermination of the Agreement and licenses granted under this Agreement. The terms of this Agreement, including withoutlimitation the licensing and assignment provisions, shall be binding upon Customer’s permitted successors in interest andassigns.

5.3. The provisions of this Section 5 shall survive the termination of this Agreement.

6. SUPPORT SERVICES. To the extent Customer purchases support services for Software, Mentor Graphics will provideCustomer with available updates and technical support for the Software which are made generally available by Mentor Graphicsas part of such services in accordance with Mentor Graphics’ then current End-User Software Support Terms located athttp://supportnet.mentor.com/about/legal/.

http://supportnet.mentor.com/about/legal/

7. LIMITED WARRANTY.

7.1. Mentor Graphics warrants that during the warranty period its standard, generally supported Software, when properlyinstalled, will substantially conform to the functional specifications set forth in the applicable user manual. MentorGraphics does not warrant that Software will meet Customer’s requirements or that operation of Software will beuninterrupted or error free. The warranty period is 90 days starting on the 15th day after delivery or upon installation,whichever first occurs. Customer must notify Mentor Graphics in writing of any nonconformity within the warranty period.For the avoidance of doubt, this warranty applies only to the initial shipment of Software under the applicable Order anddoes not renew or reset, by way of example, with the delivery of (a) Software updates or (b) authorization codes or alternateSoftware under a transaction involving Software re-mix. This warranty shall not be valid if Software has been subject tomisuse, unauthorized modification or improper installation. MENTOR GRAPHICS’ ENTIRE LIABILITY ANDCUSTOMER’S EXCLUSIVE REMEDY SHALL BE, AT MENTOR GRAPHICS’ OPTION, EITHER (A) REFUND OFTHE PRICE PAID UPON RETURN OF SOFTWARE TO MENTOR GRAPHICS OR (B) MODIFICATION ORREPLACEMENT OF SOFTWARE THAT DOES NOT MEET THIS LIMITED WARRANTY, PROVIDEDCUSTOMER HAS OTHERWISE COMPLIED WITH THIS AGREEMENT. MENTOR GRAPHICS MAKES NOWARRANTIES WITH RESPECT TO: (A) SERVICES; (B) SOFTWARE WHICH IS LICENSED AT NO COST; OR (C)BETA CODE; ALL OF WHICH ARE PROVIDED “AS IS.”

7.2. THE WARRANTIES SET FORTH IN THIS SECTION 7 ARE EXCLUSIVE. NEITHER MENTOR GRAPHICS NORITS LICENSORS MAKE ANY OTHER WARRANTIES EXPRESS, IMPLIED OR STATUTORY, WITH RESPECT TOSOFTWARE OR OTHER MATERIAL PROVIDED UNDER THIS AGREEMENT. MENTOR GRAPHICS AND ITSLICENSORS SPECIFICALLY DISCLAIM ALL IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FORA PARTICULAR PURPOSE AND NON-INFRINGEMENT OF INTELLECTUAL PROPERTY.

8. LIMITATION OF LIABILITY. EXCEPT WHERE THIS EXCLUSION OR RESTRICTION OF LIABILITY WOULD BEVOID OR INEFFECTIVE UNDER APPLICABLE LAW, IN NO EVENT SHALL MENTOR GRAPHICS OR ITSLICENSORS BE LIABLE FOR INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES (INCLUDINGLOST PROFITS OR SAVINGS) WHETHER BASED ON CONTRACT, TORT OR ANY OTHER LEGAL THEORY, EVENIF MENTOR GRAPHICS OR ITS LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. INNO EVENT SHALL MENTOR GRAPHICS’ OR ITS LICENSORS’ LIABILITY UNDER THIS AGREEMENT EXCEEDTHE AMOUNT PAID BY CUSTOMER FOR THE SOFTWARE OR SERVICE GIVING RISE TO THE CLAIM. IN THECASE WHERE NO AMOUNT WAS PAID, MENTOR GRAPHICS AND ITS LICENSORS SHALL HAVE NO LIABILITYFOR ANY DAMAGES WHATSOEVER. THE PROVISIONS OF THIS SECTION 8 SHALL SURVIVE THETERMINATION OF THIS AGREEMENT.

9. LIFE ENDANGERING APPLICATIONS. NEITHER MENTOR GRAPHICS NOR ITS LICENSORS SHALL BE LIABLEFOR ANY DAMAGES RESULTING FROM OR IN CONNECTION WITH THE USE OF SOFTWARE IN ANYAPPLICATION WHERE THE FAILURE OR INACCURACY OF THE SOFTWARE MIGHT RESULT IN DEATH ORPERSONAL INJURY. THE PROVISIONS OF THIS SECTION 9 SHALL SURVIVE THE TERMINATION OF THISAGREEMENT.

10. INDEMNIFICATION. CUSTOMER AGREES TO INDEMNIFY AND HOLD HARMLESS MENTOR GRAPHICS ANDITS LICENSORS FROM ANY CLAIMS, LOSS, COST, DAMAGE, EXPENSE OR LIABILITY, INCLUDINGATTORNEYS’ FEES, ARISING OUT OF OR IN CONNECTION WITH CUSTOMER’S USE OF SOFTWARE ASDESCRIBED IN SECTION 9. THE PROVISIONS OF THIS SECTION 10 SHALL SURVIVE THE TERMINATION OFTHIS AGREEMENT.

11. INFRINGEMENT.

11.1. Mentor Graphics will defend or settle, at its option and expense, any action brought against Customer in the United States,Canada, Japan, or member state of the European Union which alleges that any standard, generally supported Softwareproduct infringes a patent or copyright or misappropriates a trade secret in such jurisdiction. Mentor Graphics will pay anycosts and damages finally awarded against Customer that are attributable to the action. Customer understands and agreesthat as conditions to Mentor Graphics’ obligations under this section Customer must: (a) notify Mentor Graphics promptlyin writing of the action; (b) provide Mentor Graphics all reasonable information and assistance to settle or defend theaction; and (c) grant Mentor Graphics sole authority and control of the defense or settlement of the action.

11.2. If a claim is made under Subsection 11.1 Mentor Graphics may, at its option and expense, (a) replace or modify Software sothat it becomes noninfringing, or (b) procure for Customer the right to continue using Software, or (c) require the return ofSoftware and refund to Customer any license fee paid, less a reasonable allowance for use.

11.3. Mentor Graphics has no liability to Customer if the claim is based upon: (a) the combination of Software with any productnot furnished by Mentor Graphics; (b) the modification of Software other than by Mentor Graphics; (c) the use of other thana current unaltered release of Software; (d) the use of Software as part of an infringing process; (e) a product that Customermakes, uses, or sells; (f) any Beta Code; (g) any Software provided by Mentor Graphics’ licensors who do not provide suchindemnification to Mentor Graphics’ customers; or (h) infringement by Customer that is deemed willful. In the case of (h),Customer shall reimburse Mentor Graphics for its reasonable attorney fees and other costs related to the action.

11.4. THIS SECTION IS SUBJECT TO SECTION 8 ABOVE AND STATES THE ENTIRE LIABILITY OF MENTORGRAPHICS AND ITS LICENSORS AND CUSTOMER’S SOLE AND EXCLUSIVE REMEDY WITH RESPECT TOANY ALLEGED PATENT OR COPYRIGHT INFRINGEMENT OR TRADE SECRET MISAPPROPRIATION BYANY SOFTWARE LICENSED UNDER THIS AGREEMENT.

12. TERM.

12.1. This Agreement remains effective until expiration or termination. This Agreement will immediately terminate upon noticeif you exceed the scope of license granted or otherwise fail to comply with the provisions of Sections 2, 3, or 5. For anyother material breach under this Agreement, Mentor Graphics may terminate this Agreement upon 30 days written notice ifyou are in material breach and fail to cure such breach within the 30 day notice period. If a Software license was providedfor limited term use, such license will automatically terminate at the end of the authorized term.

12.2. Mentor Graphics may terminate this Agreement immediately upon notice in the event Customer is insolvent or subject to apetition for (a) the appointment of an administrator, receiver or similar appointee; or (b) winding up, dissolution orbankruptcy.

12.3. Upon termination of this Agreement or any Software license under this Agreement, Customer shall ensure that all use of theaffected Software ceases, and shall return it to Mentor Graphics or certify its deletion and destruction, including all copies,to Mentor Graphics’ reasonable satisfaction.

12.4. Termination of this Agreement or any Software license granted hereunder will not affect Customer’s obligation to pay forproducts shipped or licenses granted prior to the termination, which amounts shall immediately be payable at the date oftermination.

13. EXPORT. Software is subject to regulation by local laws and United States government agencies, which prohibit export ordiversion of certain products, information about the products, and direct products of the products to certain countries and certainpersons. Customer agrees that it will not export Software or a direct product of Software in any manner without first obtainingall necessary approval from appropriate local and United States government agencies.

14. U.S. GOVERNMENT LICENSE RIGHTS. Software was developed entirely at private expense. All Software is commercialcomputer software within the meaning of the applicable acquisition regulations. Accordingly, pursuant to US FAR 48 CFR12.212 and DFAR 48 CFR 227.7202, use, duplication and disclosure of the Software by or for the U.S. Government or a U.S.Government subcontractor is subject solely to the terms and conditions set forth in this Agreement, except for provisions whichare contrary to applicable mandatory federal laws.

15. THIRD PARTY BENEFICIARY. Mentor Graphics Corporation, Mentor Graphics (Ireland) Limited, Microsoft Corporationand other licensors may be third party beneficiaries of this Agreement with the right to enforce the obligations set forth herein.

16. REVIEW OF LICENSE USAGE. Customer will monitor the access to and use of Software. With prior written notice andduring Customer’s normal business hours, Mentor Graphics may engage an internationally recognized accounting firm toreview Customer’s software monitoring system and records deemed relevant by the internationally recognized accounting firmto confirm Customer’s compliance with the terms of this Agreement or U.S. or other local export laws. Such review may includeFLEXlm or FLEXnet (or successor product) report log files that Customer shall capture and provide at Mentor Graphics’request. Customer shall make records available in electronic format and shall fully cooperate with data gathering to support thelicense review. Mentor Graphics shall bear the expense of any such review unless a material non-compliance is revealed. MentorGraphics shall treat as confidential information all information gained as a result of any request or review and shall only use ordisclose such information as required by law or to enforce its rights under this Agreement. The provisions of this section shallsurvive the termination of this Agreement.

17. CONTROLLING LAW, JURISDICTION AND DISPUTE RESOLUTION. The owners of the Mentor Graphics intellectualproperty rights licensed under this Agreement are located in Ireland and the United States. To promote consistency around theworld, disputes shall be resolved as follows: This Agreement shall be governed by and construed under the laws of the State ofOregon, USA, if Customer is located in North or South America, and the laws of Ireland if Customer is located outside of Northor South America. All disputes arising out of or in relation to this Agreement shall be submitted to the exclusive jurisdiction ofPortland, Oregon when the laws of Oregon apply, or Dublin, Ireland when the laws of Ireland apply. Notwithstanding theforegoing, all disputes in Asia (except for Japan) arising out of or in relation to this Agreement shall be resolved by arbitration inSingapore before a single arbitrator to be appointed by the Chairman of the Singapore International Arbitration Centre (“SIAC”)to be conducted in the English language, in accordance with the Arbitration Rules of the SIAC in effect at the time of thedispute, which rules are deemed to be incorporated by reference in this section. This section shall not restrict Mentor Graphics’right to bring an action against Customer in the jurisdiction where Customer’s place of business is located. The United NationsConvention on Contracts for the International Sale of Goods does not apply to this Agreement.

18. SEVERABILITY. If any provision of this Agreement is held by a court of competent jurisdiction to be void, invalid,unenforceable or illegal, such provision shall be severed from this Agreement and the remaining provisions will remain in fullforce and effect.

19. MISCELLANEOUS. This Agreement contains the parties’ entire understanding relating to its subject matter and supersedes allprior or contemporaneous agreements, including but not limited to any purchase order terms and conditions. Some Softwaremay contain code distributed under a third party license agreement that may provide additional rights to Customer. Please seethe applicable Software documentation for details. This Agreement may only be modified in writing by authorizedrepresentatives of the parties. All notices required or authorized under this Agreement must be in writing and shall be sent to theperson who signs this Agreement, at the address specified below. Waiver of terms or excuse of breach must be in writing andshall not constitute subsequent consent, waiver or excuse.

Rev. 090402, Part No. 239301

Date post:	30-Jun-2021
Category:	Documents
Upload:	others
View:	12 times
Download:	1 times