Managing Mentor Graphics IE3D™

Software

15.0 Installation and Licensing

© 1992-2010 Mentor Graphics Corporation

All rights reserved.

This document contains information that is proprietary to Mentor Graphics Corporation. The original recipient of this
document may duplicate this document in whole or in part for internal business purposes only, provided that this entire
notice appears in all copies. In duplicating any part of this document, the recipient agrees to make every reasonable
effort 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 make
changes in specifications and other information contained in this publication without prior notice, and the
reader should, in all cases, consult Mentor Graphics to determine whether any changes have been
made.

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

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

MENTOR GRAPHICS SHALL NOT BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR
CONSEQUENTIAL 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 OF
SUCH DAMAGES.

RESTRICTED RIGHTS LEGEND 03/97

U.S. Government Restricted Rights. The SOFTWARE and documentation have been developed entirely
at 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 the
restrictions 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 - Restricted
Rights 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.2210
Website: www.mentor.com
SupportNet: www.mentor.com/supportnet
Send Feedback on Documentation: www.mentor.com/supportnet/documentation/reply_form.cfm

TRADEMARKS: The trademarks, logos and service marks ("Marks") used herein are the property of
Mentor Graphics Corporation or other third parties. No one is permitted to use these Marks without the
prior 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 to
indicate 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.
 Table of Contents

Chapter 1
Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Types of Licenses Available . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Configuring Licensing on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Identifying the License Server(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Ordering Your Mentor Graphics Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Installing the Licensing Software on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Editing the License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Ensuring Proper System Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Installing Floating and Nodelocked Counted Licenses on Linux. . . . . . . . . . . . . . . . . . . . 15
Starting the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Verifying the License Server is Working . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Pointing Clients to the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Verifying a Client Can Check Out a License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Configuring Licensing on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Determining What Kind of Licenses You Need . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Installing Mobile Compute Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Installing Floating and Nodelocked Counted Licenses on Windows . . . . . . . . . . . . . . . . . 32

Chapter 2
Installing Mentor Graphics Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Before You Begin Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Downloading Software on Windows Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Quick Install for Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Downloading Software on Linux Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Quick Install for Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Installing Other Products After Initial Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Installing the Install Program to an Alternative Location . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Configuring the Remote Computer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Installing Licensing on the Local Computer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Configuring the Local Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Uninstalling Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Chapter 3
Managing Environment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Understanding the Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Structural Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Setting Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Setting SDD_ROOT (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Setting SDD_HOME (is this applicable?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Setting IE3D_HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Setting MGC_HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Managing Mentor Graphics IE3D Software, V15.0 3

 Table of Contents

Setting MGLS_LICENSE_FILE or LM_LICENSE_FILE . . . . . . . . . . . . . . . . . . . . . . . . 57

Managing Multiple Mentor Graphics Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Chapter 4
Managing Mentor Graphics Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Understanding the Documentation Tree Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Defining Optional Documentation Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . 61
Setting Variables on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Setting Variables on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Using the Mentor Graphics Documentation System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Accessing the Mentor Graphics Documentation System . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Finding Answers with PDF Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Required Internet Explorer Option with Windows XP SP2 . . . . . . . . . . . . . . . . . . . . . . . . . 64
Permanent Workaround . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Temporary Workaround . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Chapter 5
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Mentor Graphics SupportNet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Troubleshooting OpenGL Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Troubleshooting Common Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Troubleshooting Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Troubleshooting X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Appendix
Printing Mentor Graphics Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Printing IE3DLynx Products Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Printing a PDF Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Printing from Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Printing from Linux Using MainWin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Using the Visual MainWin Control Panel to Configure Printers . . . . . . . . . . . . . . . . . . . . 80
Setting Up Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
End-User License Agreement

4 Managing Mentor Graphics IE3D Software, V15.0

 Chapter 1
Licensing

Note
Mentor Graphics® recommends installing licensing before installing application
software.

This chapter contains the following sections:

• “Types of Licenses Available” on page 6

• “Configuring Licensing on Linux” on page 9
o “Identifying the License Server(s)” on page 11
o “Ordering Your Mentor Graphics Licenses” on page 11
o “Installing the Licensing Software on Linux” on page 12
o “Editing the License File” on page 13
o “Ensuring Proper System Configuration” on page 15
o “Installing Floating and Nodelocked Counted Licenses on Linux” on page 15
o “Starting the License Server” on page 16
o “Verifying the License Server is Working” on page 19
o “Pointing Clients to the License Server” on page 20
o “Verifying a Client Can Check Out a License” on page 22
• “Configuring Licensing on Windows” on page 22
o “Determining What Kind of Licenses You Need” on page 22
o “Installing Mobile Compute Licenses” on page 25
o “Installing Floating and Nodelocked Counted Licenses on Windows” on page 32

Mentor Graphics software uses the Mentor Graphics licensing system to administer software
licenses. This software is based on FlexNet™ licensing and uses the FlexNet license file format.
If your network already contains software from other vendors that are licensed using FlexNet,
you can integrate Mentor Graphics licenses into your current licensing strategy.

Managing Mentor Graphics IE3D Software, V15.0 5

Licensing
Types of Licenses Available

The software and related documentation, which is enabled by the authorization code(s) and
licensed to you for the period set forth in the authorization code(s), is subject to license
restrictions.

Installation of the authorization code(s) and use of the enabled software, indicates your
complete and unconditional acceptance of the terms and conditions set forth in the
License Agreement between you and Mentor Graphics Corporation.

If you do not have a signed agreement with Mentor Graphics Corporation, the terms of our
standard End User License Agreement apply. You can view the agreement at the end of this
manual.

For more detailed information about FlexNet, refer to the License Administration Guide. This
manual is available in PDF format as part of the documentation set shipped on the application
CD, or you can view it on SupportNet:

http://supportnet.mentor.com/

For more detailed information about planning for licensing, customizing licensing, and other
basic licensing administration activities, refer to the Licensing Mentor Graphics Software
manual available in the release_documents directory on the CD-ROM or from SupportNet.

Types of Licenses Available

Note
Mentor Graphics issues Authorization Code Files that are referred to here as license files.

Mentor Graphics sells the following kinds of licenses based on platform type:

• For Linux systems:

o Floating Licenses
o Nodelocked Counted Licenses
• For Windows systems:
o Floating Licenses
o Nodelocked Counted Licenses
o Mobile Compute (nodelocked uncounted) Licenses

6 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Types of Licenses Available

Nodelocked counted licenses

Nodelocked counted licenses can be issued for both Linux and Windows systems.

• Are locked to a specific piece of hardware, either an Ethernet card, a UNIX hostid, or a
hardware key.
• These devices provide a unique identifier for the license.
• The software runs only on the system that has that particular piece of hardware installed.
• In order for the nodelocked counted licenses to work, the licenses must be served from
the computer whose hostid matches that listed on the SERVER line in the license file.
• The license file contains both a SERVER and a DAEMON line and the quantity on each
INCREMENT line is greater than zero (0).
• A license server is required. The license server tracks how many licenses are available
and how many are currently in use. Optionally, license servers can be configured to
allow access to only certain groups or individuals (via the Options file).
• Note that the way you can differentiate between floating and nodelocked counted is that
nodelocked counted licenses also have a HOSTID field on each INCREMENT line.
• These licenses are available on Linux and Windows.
Below is an example of a Nodelocked counted license:

SERVER put_server_name_here 00AE4701ED4A 1717

DAEMON mgcld path_to_mgcld
INCREMENT wgpcb mgcld 2010.050 31-may-2010 1 682D2158600DF8EBDDE1 \
VENDOR_STRING=4636BC99 HOSTID=FLEXID=6-a4833590 SN=9898970 SIGN2="01B7 \
671B 9016 B850 460F 9A92 9BA6 29C2 7769 F3FD 6E55 890B D84E 1C2C 5071 \
171824 97 A2D7 A83D E1BE C3FA C2EB 1A15 1001 A28B 35AD B6C7 D0ED 124B \
F394"

Installation of nodelocked counted licenses are described in the following sections:

• On Linux platforms, see “Installing Floating and Nodelocked Counted Licenses on

Linux” on page 15.
• On Windows platforms, see “Installing Floating and Nodelocked Counted Licenses on
Windows” on page 32.

Managing Mentor Graphics IE3D Software, V15.0 7

Licensing
Types of Licenses Available

Mobile Compute (nodelocked uncounted):

Mobile compute licenses are issued for Windows systems only.

• The license file contains no SERVER or DAEMON lines and the quantity on each
INCREMENT line is zero (0). Note that zero does not mean that there are no licenses
available; it is simply the identifier of this special kind of license.
• A license server is not required.
• These licenses are locked to a particular piece of hardware (ethernet address or FLEXID
hardware key) and the hardware needs to be installed and working for the licenses to
work.
Installation of mobile compute licenses is described in “Installing Mobile Compute Licenses”
on page 25.

8 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Linux

Configuring Licensing on Linux

Mentor Graphics provides floating and nodelocked counted licenses for products running in the
Linux environment.

This section explains how to setup and use floating and nodelocked counted licenses. It covers:

• “Identifying the License Server(s)” on page 11

• “Ordering Your Mentor Graphics Licenses” on page 11
• “Installing the Licensing Software on Linux” on page 12
• “Editing the License File” on page 13
• “Ensuring Proper System Configuration” on page 15
• “Installing Floating and Nodelocked Counted Licenses on Linux” on page 15
• “Starting the License Server” on page 16
• “Verifying the License Server is Working” on page 19
• “Pointing Clients to the License Server” on page 20
• “Verifying a Client Can Check Out a License” on page 22
Figure 1-1 illustrates the basic licensing configuration flow for Linux Platforms.

Managing Mentor Graphics IE3D Software, V15.0 9

Licensing
Configuring Licensing on Linux

Figure 1-1. Basic Licensing Flow for Linux Platforms

This figure illustrates the Identifying the License Server(s)

1
basic steps for configuring
licensing on Linux
platforms. Ordering Your Mentor Graphics Licenses
2

NOTE: Mentor Graphics Installing the Licensing Software on

recommends installing 3 Linux
licensing before installing
application software.
4 Editing the License File

Ensuring Proper System Configuration

5

6 Installing Floating and Nodelocked

Counted Licenses on Linux

7 Starting the License Server

8 Verifying the License Server is Working

9 Pointing Clients to the License Server

7 Verifying a Client Can Check Out a

10
License

10 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Linux

Identifying the License Server(s)

Determine which machine(s) you will use as license servers, and determine their host IDs.

Mentor Graphics licenses are administered by one or more workstations that function as license
servers. A license server stores the license file, contains a local copy of the licensing software,
and runs the license daemon. A license server must be accessible from any workstation running
a Mentor Graphics application using basic TCP/IP communication protocols.

License servers can be configured to operate independently or in a redundant group of three. If

your site is large and you usually have many people using Mentor Graphics applications
simultaneously, you might have several multiple independent servers, several groups of
redundant servers, or a combination of the two types.

For more information on determining the types of licensing servers you have, refer to “Planning
for Licensing” in the Licensing Mentor Graphics Software manual available from the
release_documents directory on the CD-ROM or from SupportNet.

Ordering Your Mentor Graphics Licenses

Note
Mentor Graphics issues Authorization Code Files that are referred to here as license files.

At this point you should know what type of licenses you need and what machine will serve as
your license server.

New customers should order new licenses; existing customers can download a copy of your
current licenses.

• If you are ordering new licenses

New users must order software licenses prior to using Mentor Graphics software. To
order licenses, contact your local Mentor Graphics sales office. The sales office can
provide you with information on any licenses your company purchased and any current
license sever configurations you may have. When purchasing new licenses, you need to
provide the sales office with:
o Any new license server configuration information
o The hostID(s) of client and license server computers for nodelocked licenses
o The hostID(s) of the license server computers for all floating licenses

Managing Mentor Graphics IE3D Software, V15.0 11

Licensing
Configuring Licensing on Linux

Tip: To determine your hostID:

On UNIX: $ /bin/hostid returns a hostID similar to: 80c80cc9
On Linux: /sbin/ifconfig eth0 returns a hostID similar to : WHaddr
00:40:05:16:E5:25

• If you want to download a copy of your current licenses

Existing customers can download a copy of their current licenses or view Licensing
reports at the Customer Support website:
http://supportnet.mentor.com/myaccount/index.cfm?fa=user.licenses

Note
The Customer Support website requires a login and password.
To register and obtain a password, go to
http://supportnet.mentor.com/user/register.cfm
If you have difficulties, email csd_registration@mentor.com. Use
http://supportnet.mentor.com/user/forgot_password.cfm
for assistance if you are registered but have forgotten your password.

Installing the Licensing Software on Linux

1. Click the URL below to access the licensing download page on SupportNet:
http://supportnet.mentor.com/member/licensing

2. Scroll to the bottom of the Licensing Agreement and select I Agree.

3. From the list of Licensing Software, select MGLS for the appropriate Linux platform.
4. Copy the downloaded file to the directory where the Licensing Software is to be
installed and navigate to the location. NOTE: A sub-directory will be created.
5. Unzip the file using the "gzip -d" command.
For example (RH Linux, FlexNet v11.6.1):
gzip -d mgls_v9-1_2-4-0.ixl.tar.gz

NOTE: After unzipping, the ".gz" suffix will no longer appear on the original file. For
example: mgls_v9-1_2-4-0.ixl.tar
6. Untar the resulting file using the "tar -xvf" command. For example:
tar -xvf mgls_v9-1_2-4-0.ixl.tar

A sub-directory for MGLS is created. For example: mgls_v9-1_2-4-0.ixl. Inside this

sub-directory the lmgrd and FlexNet utilities can be found in the "bin" directory and the
mgcld (Mentor Graphics vendor daemon) in the "lib" directory.

12 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Linux

Note
Licensing software is also available in this software distribution. Select the License
Server product during the software installation process.

Editing the License File

In the previous procedure, you ordered your Mentor Graphics licensing. Mentor Graphics
provides a license file that contains some placeholder information. You need to edit the license
file to provide information for your configuration before you are able to use the license file.

The following is an example of a Linux floating license file. The license file contains both a
SERVER and a DAEMON line and the quantity on each INCREMENT line is greater than zero
(0).
SERVER hood 77446B53 1717
DAEMON mgcld /Mentor/MGC_HOME.ss5/pkgs/mgls/lib/mgcld
INCREMENT wgascentlx mgcld 2010.050 31-may-2010 4 5D1720DB8156471920C3 \
VENDOR_STRING=D5806CD3 SN=9220623 SIGN2="06A4 B296 2311 52F6 DEB6 7D60 \
C0CF 1FD6 9133 A59D 4E37 00D7 EC0A F614 3F00 1938 08EE 7554 7ED0 421A \
BABD 2859 20AA A2C2 42EE 0D95 852D 1153 AB00 B9DD"
INCREMENT wgascentl2 mgcld 2010.050 31-may-2010 4 AD0780ABB7C879028876 \
VENDOR_STRING=2ED26BB6 SN=9220621 SIGN2="1C99 1A24 9878 FFC6 721E F84B \
C18B 09E9 CB76 6AF8 76CD 975E 94ED 6D05 057B 0617 7CE2 35D9 F9C4 5D75 \
2807 E581 D51B 6D13 8B12 D45D 531F EE4D 8542 B01D"
INCREMENT wgpcb mgcld 2010.050 31-may-2010 4 7DE7905B502576265F63 \
VENDOR_STRING=61CC3270 SN=9220669 SIGN2="1DA7 47BE F0B2 DC21 226E CEF0 \
3E33 4CBA 83C7 C1F0 FE67 21B0 FAA7 7D95 6DD7 107E 0FEF 30B8 AECA 8DB5 \
8B06 5F10 6DBE D3CF 2BBE 1CC5 6EA4 866C FDBE 51F3"

You will edit the license file on the license server. Do the following:

1. Save your licenses in a file on your local harddrive. If the license file was sent as an
attachment to email, detach the file and save it to a directory which will permit you to
make edits to the file. If the licensing information is embedded in an email, copy the
contents of the email to a file you are permitted to edit. Edit the file to remove any email
header information. The license file must
• be plain-text only
• have a name that does not contain any spaces
• end in .dat, .lic or .txt
There are no restrictions on where you put the license file; however, you should keep a
copy of each file in a safe location for backup purposes.
2. Determine the hostname of the license server computer. Find this value with the
hostname command:
% hostname
hood

Managing Mentor Graphics IE3D Software, V15.0 13

Licensing
Configuring Licensing on Linux

Alternatively, you may use the uname -a command.

a. Check the SERVER line of the provided license file. The third field in the SERVER
line (“77446B53” in the example) is the hostID of the computer you previously
selected as the license server. This information must match the hostID of the actual
computer that you use as your license server.

Tip: The third field of the SERVER line should never be edited. If it is incorrect, then the
licenses need to be regenerated with the correct hostID. Editing this field invalidates your
licenses.

If Mentor Graphics licensing software is loaded on the system, you can verify the
hostID with the lmhostid command. This command is typically found in the same
directory as lmgrd. If the value reported is the same as the third field of the SERVER
line, then the license file is for that computer.
Edit the SERVER entry in the license file with the correct license server host name.
If you are administering licenses using a redundant server configuration, you must
supply the host name for each license server in your configuration. For example:
Before: SERVER put_server_name_here 77446B53 1717
After: SERVER hood 77446B53 1717
b. If necessary, change the server port entry in the license file from the default value of
1717 to an open port on your system.
If you are using a redundant server configuration, you must do this for each server
listed in the license file that cannot use port 1717.
c. If you are using a redundant server configuration, copy the license file to the other
license servers in your configuration.
If you are using a single server configuration, skip this step.
Redundant license servers each require a local copy of the same license file. Ensure
that the correct hostname information has been provided on all three SERVER lines
in each file.
d. Edit the DAEMON line to include the path to the vendor daemon mgcld. The
DAEMON line shows where the Mentor Graphics licensing software (or vendor
daemon) resides.
Ensure the licensing software is installed on the local harddrive of the computer
which will be running the license software. You must use the absolute path to the
daemon. An absolute pathname begins with a '/' (slash); presently, FlexNet does not
allow you to use an environment variable in this pathname. If you want, add the path
to the daemon options file to the DAEMON line. For example,
Before: DAEMON mgcld path_to_mgcld

14 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Linux

After: DAEMON mgcld /Mentor/MGC_HOME.ss5/pkgs/mgls/lib/mgcld

3. Check that the INCREMENT lines do not have trailing spaces. This is sometimes
caused by electronic mail formatting. However, trailing spaces are not allowed within
the license file.
Mentor Graphics recommends that you not modify the INCREMENT lines. Notice that
each INCREMENT line has several key words and can continue on multiple lines with
the “ \ ” used as the line continuation character. INCREMENT lines cannot continue on
multiple lines without the line continuation character.
SERVER hood 77446B53 1717
DAEMON mgcld /Mentor/MGC_HOME.ss5/pkgs/mgls/lib/mgcld
INCREMENT wgascentlx mgcld 2010.050 31-may-2010 4 5D1720DB8156471920C3 \
VENDOR_STRING=D5806CD3 SN=9220623 SIGN2="06A4 B296 2311 52F6 DEB6 7D60 \
C0CF 1FD6 9133 A59D 4E37 00D7 EC0A F614 3F00 1938 08EE 7554 7ED0 421A \
BABD 2859 20AA A2C2 42EE 0D95 852D 1153 AB00 B9DD"
INCREMENT wgascentl2 mgcld 2010.050 31-may-2010 4 AD0780ABB7C879028876 \
VENDOR_STRING=2ED26BB6 SN=9220621 SIGN2="1C99 1A24 9878 FFC6 721E F84B \
C18B 09E9 CB76 6AF8 76CD 975E 94ED 6D05 057B 0617 7CE2 35D9 F9C4 5D75 \
2807 E581 D51B 6D13 8B12 D45D 531F EE4D 8542 B01D"
INCREMENT wgpcb mgcld 2010.050 31-may-2010 4 7DE7905B502576265F63 \
VENDOR_STRING=61CC3270 SN=9220669 SIGN2="1DA7 47BE F0B2 DC21 226E CEF0 \
3E33 4CBA 83C7 C1F0 FE67 21B0 FAA7 7D95 6DD7 107E 0FEF 30B8 AECA 8DB5 \
8B06 5F10 6DBE D3CF 2BBE 1CC5 6EA4 866C FDBE 51F3"

At this point, your license file should be ready to use. Make a copy of your license file and
move it to a secure location. If you are replacing an existing license file, save the old file for
historical reference.

Ensuring Proper System Configuration

You need to ensure that the proper networking components are installed and configured
correctly.

In order for Mentor Graphics Licensing software to work correctly, workstation hardware and
operating system versions must be at a level adequate to support the current versions of
software. For hardware and operating system information, refer to your application’s
configuration information.

Also, you must configure TCP/IP on your network for licensing to work properly.

Installing Floating and Nodelocked Counted Licenses on

Linux
This section explains how to set up and use these types of licenses. Both require that you create
a license file. An environment variable, MGLS_LICENSE_FILE or LM_LICENSE_FILE, is
required on the client side, but may be provided by a registry value (on Windows).

Managing Mentor Graphics IE3D Software, V15.0 15

Licensing
Configuring Licensing on Linux

Floating Licenses (Server Required)

Requirements:

• Install licensing on the computer that will act as the license server for the application
software. The computer does not have to be a network server. You do not need to install
the application software on the license server.
• Make sure the computer you use for a license server has a static IP address on the
network. MGLS does not support DHCP or dynamic IP addresses.
• Make sure the license server computer and the client computers support TCP/IP.
A license file requires a server if it contains lines that start with the words SERVER and
DAEMON, and each INCREMENT line has a quantity greater than zero. The licenses in the
example below require a license server. In this example, the expiration date is 31-may-2010 and
the quantity for each license is 4.
SERVER hood 77446B53 1717
DAEMON mgcld /Mentor/MGC_HOME.ss5/pkgs/mgls/lib/mgcld
INCREMENT wgascentlx mgcld 2010.050 31-may-2010 4 5D1720DB8156471920C3 \
VENDOR_STRING=D5806CD3 SN=9220623 SIGN2="06A4 B296 2311 52F6 DEB6 7D60\
C0CF 1FD6 9133 A59D 4E37 00D7 EC0A F614 3F00 1938 08EE 7554 7ED0 421A \
BABD 2859 20AA A2C2 42EE 0D95 852D 1153 AB00 B9DD"
INCREMENT wgascentl2 mgcld 2010.050 31-may-2010 4 AD0780ABB7C879028876 \
VENDOR_STRING=2ED26BB6 SN=9220621 SIGN2="1C99 1A24 9878 FFC6 721E F84B \
C18B 09E9 CB76 6AF8 76CD 975E 94ED 6D05 057B 0617 7CE2 35D9 F9C4 5D75 \
2807 E581 D51B 6D13 8B12 D45D 531F EE4D 8542 B01D"
INCREMENT wgpcb mgcld 2010.050 31-may-2010 4 7DE7905B502576265F63 \
VENDOR_STRING=61CC3270 SN=9220669 SIGN2="1DA7 47BE F0B2 DC21 226E CEF0 \
3E33 4CBA 83C7 C1F0 FE67 21B0 FAA7 7D95 6DD7 107E 0FEF 30B8 AECA 8DB5 \
8B06 5F10 6DBE D3CF 2BBE 1CC5 6EA4 866C FDBE 51F3"

Nodelocked Counted Licenses (Server Required)

These licenses are locked to a specific piece of hardware, either an Ethernet card or a hardware
key. These devices provide a unique identifier for the license. The software will run only on the
system that has that particular piece of hardware installed. As with floating licenses, the license
file contains both a SERVER and a DAEMON line and the quantity on each INCREMENT line
is greater than zero (0); a license server is required. Additionally, each INCREMENT line has a
HOSTID field which specifies the hardware to which the license is locked. The license can only
be checked out by the computer with the corresponding HOSTID. These licenses are available
on Linux and Windows.

To install either the Floating or Nodelocked Counted licenses, copy the license file to a place
where the software can use it.

Starting the License Server

If you are a new customer starting the License Server for the first time, follow the instructions in
this section for New Customers starting the License Server.

16 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Linux

If you are an existing customer, you might need to upgrade your license server with this IE3D
15.0 release if your existing license server version is not compatible with IE3D 15.0. Follow the
instructions in Upgrading your license server software.

New Customers starting the License Server

Once you have placed the license file in your chosen location, you should be able to start the
license server. Mentor Graphics recommends using a log file, especially when starting a new
server. The log file provides troubleshooting information helpful for resolving technical
problems.

1. Find lmgrd to start the server. The lmgrd is normally found in one of two locations:
$MGC_HOME/pkgs/mgls/bin

Or, it can be found in the same directory as mgcld.

2. Start the server with this command:
lmgrd -c <path_to_the_license_file> -log <path_to_the_log_file>

For example:
/Mentor/pkgs/mgls/bin/lmgrd -c /licenses/mentor.lic -log \
/licenses/mentor.log

Tip: Ensure that you provide an actual filename for the log file. Problems may occur if
you only specify a directory when using the -log switch. You may store the log file
anywhere; however, storing the file in the same directory as the license file makes it
easier to cross-check information between the two when troubleshooting.

3. Press Enter and the prompt displays.

Upgrading your license server software

With the IE3D 15.0 release, both the lmgrd and mgcld must be version 11.6.1 or newer. If the
version of either is older on your license server, it is important that you upgrade.

1. Check the debug log file to ensure the version of the lmgrd and mgcld daemons is now
11.6.1.

Note
After the comments at the top of the debug log file, you can see version information for
both the lmgrd and mgcld, as shown in the example below.

For example:

16:44:08 (lmgrd) FlexNet Licensing (v11.6.1.0 build 66138 i86_re3) started

on starship (linux) (3/2/2010)

Managing Mentor Graphics IE3D Software, V15.0 17

Licensing
Configuring Licensing on Linux

16:44:08 (lmgrd) Copyright (c) 1988-2008 Acresso Software Inc. All Rights
Reserved.
16:44:08 (lmgrd) US Patents 5,390,297 and 5,671,412.
16:44:08 (lmgrd) World Wide Web: http://www.acresso.com
16:44:08 (lmgrd) License file(s): /opt/mgc_licensing/license.txt
16:44:08 (lmgrd) lmgrd tcp-port 1717
16:44:08 (lmgrd) Starting vendor daemons ...
16:44:08 (lmgrd) Started mgcld (internet tcp_port 49405 pid 14286)

2. If the results in the debug logfile show a version of lmgrd and mgcld older than 11.6.1,
copy the downloaded FlexNet v11.6.1 licensing package mgls_v9-1_2-4-0-ss5-tar.gz
from the download directory to the current directory.
For example:
# cp /tmp/mgls_v9-1_2-4-0-ss5-tar.gz /apps/mgc

3. Run the gzip -d command to unzip the archive.

For example:
# gzip -d mgls_v9-1_2-4-0-ss5-tar.gz

4. Use the tar -xvf command to extract the contents of mgls_v9-1_2-4-0-ss5-tar to the
current directory.
For example:
# tar -xvf mgls_v9-1_2-4-0-ss5-tar
x mgls_v9-1_2-4-0.ss55_0-5-0, 0 bytes, 0 tape blocks
x mgls_v9-1_2-4-0.ss5/bin, 0 bytes, 0 tape blocks
x mgls_v9-1_2-4-0.ss5/lmdown, 1390344 bytes, 2716 tape blocks

5. Bring down the license manager (lmgrd) using the lmdown command. The -c switch is
used to direct lmdown to the location of the license file. Answer Yes to shutdown the
license server.
For example:
# /apps/mgc/mgls/bin/lmdown -c /apps/mgc/license.dat

6. Optionally, and if applicable, remove the old mgls symbolic link using the rm command
and create the new mgls symbolic link to the mgls_v9-1_2-4-0.ss5 directory, using the
ln -s command.
For example:
# ln -s mgls_v9-1_2-4-0.ss5 mgls

7. Restart the license manager (lmgrd). The following is an example of starting the lmgrd
manually using the lmgrd command from the /apps/mgc/mgls/bin directory:
# /apps/mgc/mgls/bin/lmgrd -c /apps/mgc/license.dat -log /apps/mgc/debug.log

18 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Linux

8. Check the debug log file to ensure the version of the lmgrd and mgcld daemons is now
11.6.1.

Note
After the comments at the top of the debug log file, you can see version information for
both the lmgrd and mgcld, as shown in the example below.

For example:
16:44:08 (lmgrd) FlexNet Licensing (v11.6.1.0 build 66138 i86_re3) started
on starship (linux) (3/2/2010)
16:44:08 (lmgrd) Copyright (c) 1988-2008 Acresso Software Inc. All Rights
Reserved.
16:44:08 (lmgrd) US Patents 5,390,297 and 5,671,412.
16:44:08 (lmgrd) World Wide Web: http://www.acresso.com
16:44:08 (lmgrd) License file(s): /opt/mgc_licensing/license.txt
16:44:08 (lmgrd) lmgrd tcp-port 1717
16:44:08 (lmgrd) Starting vendor daemons ...
16:44:08 (lmgrd) Started mgcld (internet tcp_port 49405 pid 14286)

Verifying the License Server is Working

Verify the license server is working by issuing the following command:

lmstat -a -c <path_to_license_file>

For example:
/Mentor/pkgs/mgls/bin/lmstat -a -c /licenses/mentor.lic

Note
If you do not set LM_LICENSE_FILE, you must use the -c switch.

Managing Mentor Graphics IE3D Software, V15.0 19

Licensing
Configuring Licensing on Linux

The following text shows example output from running the above command:

lmstat - Copyright (c) 1989-2008 Acresso Software Inc. All Rights

Reserved.
Flexible License Manager status on Tue 3/2/2010 16:49
License server status: 1717@starship
License file(s) on starship: /user/dniwa/tmp/license.txt:
starship: license server UP (MASTER) v11.6
Vendor daemon status (on starship):
mgcld: UP v11.6
Feature usage info:
Users of wgascentlx: (Total of 4 licenses issued; Total of 0 licenses in
use)
Users of wgpcb: (Total of 4 licenses issued; Total of 0 licenses in use)
Users of wgascentl2: (Total of 4 licenses issued; Total of 0 licenses in
use)

Pointing Clients to the License Server

In the previous procedure, you started a license server. In this next step, you point client
computers to the license server.

Client computers find licenses via an environment variable. Either MGLS_LICENSE_FILE or

LM_LICENSE_FILE may be used.

On Linux, when MGLS_LICENSE_FILE is set, Mentor Graphics tools do not use

LM_LICENSE_FILE. All mgcld licenses that you want to access must be included in the value
of MGLS_LICENSE_FILE. Other vendor’s tools are not affected and will read their own
variables or LM_LICENSE_FILE as usual.

When pointing to a license server, the recommended format is port@host.

The “port” is the port number through which the license server communicates. The port number
is the last field of information on the SERVER line in the license file. In the following example,
the port number is 1717:

SERVER hood 77446B53 1717

The “host” is the hostname of the license server. This can be obtained by looking at the second
field of information on the SERVER line in the license file, or by running the uname -a
command on the license server. In the example SERVER line above, the hostname is “hood”.

Tip: The hostname used in the environment variable should be an exact match for the
hostname in the license file. If the license file uses the fully qualified domain name, the
environment variable should as well. If it does not, the variable should not either.

In this example, the correct environment variable value is:

1717@hood

20 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Linux

To configure licensing on a client workstation, complete the following steps:

Note
You must complete this procedure for each shell you perform the steps in. You must
either repeat the steps for each shell or place the steps in the shell startup script.

1. Set user environment variables to find the licensing software, and set user environment
variables for the application to find the license file.
Each user must set the MGLS_LICENSE_FILE or LM_LICENSE_FILE variable to
point to the license file location
MGLS_LICENSE_FILE is the recommended variable for Mentor Graphics products,
however, you can use either MGLS_LICENSE_FILE or LM_LICENSE_FILE on client
workstations to allow applications invoked on those workstations to use a license file
not stored in the default location or to point to one or more license servers.
MGLS_LICENSE_FILE and LM_LICENSE_FILE have the same syntax.
On Linux, use a colon (:) to separate independent license sources. For example:
license_file_pathname1:license_file_pathnameN:port@host1:port@hostN

On Windows, use a semicolon (;) rather than a colon (:) as the path separator for
independent servers. For example:
license_file_pathname1;license_file_pathnameN;port@host1;port@hostN

Bourne shell:
% MGLS_LICENSE_FILE=<port>@<host>
% export MGLS_LICENSE_FILE

C-shell:
% setenv MGLS_LICENSE_FILE <port>@<host>

2. Validate the server environment.

Use lmstat to check that the server is up and a feature is available.
$ lmstat -a [-c license_file]

This command reports the server and daemon status and the product usage. For options
and more information on lmstat, refer to the Licensing Mentor Graphics Software
manual available from the release_documents directory on the CD-ROM or from
SupportNet. If you do not set LM_LICENSE_FILE, you must use the -c switch.

Managing Mentor Graphics IE3D Software, V15.0 21

Licensing
Configuring Licensing on Windows

Tip: MGLS_LICENSE_FILE can be created as a System Variable (defined as port@host

or path to the license file), available to all users that log in to this system, or it can be
created as a User Variable, available only to the current user. A user with Administrator
privileges may create a System Variable. Be sure that only one variable points to your
license file. Duplicate pointers and unreachable servers can slow down performance and
may cause other technical problems.

Verifying a Client Can Check Out a License

On Linux, use mgls_ok to verify a client can check out a specific license feature.

For example:

hypsun% $MGC_HOME/bin/mgls_ok wgascentlx

checking availability of "wgascentlx"
license granted through "wgascentlx"

Configuring Licensing on Windows

This section applies to Windows-based workstations and servers.

Note
You must use an account with administrator privileges to install PCLS.

Note
You must install the licensing software on each machine that will run a license server.

This section explains how to setup and use mobile compute, floating and nodelocked counted
licenses. It covers:

• “Determining What Kind of Licenses You Need” on page 22

• “Installing Mobile Compute Licenses” on page 25
• “Installing Floating and Nodelocked Counted Licenses on Windows” on page 32

Determining What Kind of Licenses You Need

Note
Mentor Graphics issues Authorization Code Files that are referred to here as license files.

22 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

Mentor Graphics provides three different types of licenses for products running in the Windows
environment.

• Floating licenses require a license server in operation somewhere on the network.

• Nodelocked counted licenses require a license server.
• Mobile compute (nodelocked uncounted) licenses are issued to a specific workstation
and require no server.
This section explains how to set up and use these types of licenses. All three require that you
create a license file. An environment variable, MGLS_LICENSE_FILE or
LM_LICENSE_FILE, is required, but may be provided by a registry value.

Floating Licenses (Server Required)

Requirements:

• You must log on with administrator privileges or contact the network administrator to
install the PCLS software for you.
• Install licensing on the computer that will act as the license server for the application
software. The computer does not have to be a network server. You do not need to install
the application software on the license server.
• Make sure the computer you use for a license server has a static IP address on the
network. MGLS does not support DHCP or dynamic IP addresses.
• Make sure the license server computer and the client computers support TCP/IP.
A license file requires a server if it contains lines that start with the words SERVER and
DAEMON, and each INCREMENT line has a quantity greater than zero. These licenses are
available on Linux and Windows. The licenses in the example below require a license server. In
this example, the expiration date is 31-may-2010 and the quantity for each license is 4.
SERVER umbrella 00188BCCD07C 1717
DAEMON mgcld C:\MentorGraphics\Licensing\mgcld.exe
INCREMENT wgascentlx mgcld 2010.050 31-may-2010 4 5D1720DB8156471920C3 \
VENDOR_STRING=D5806CD3 SN=9220623 SIGN2="06A4 B296 2311 52F6 DEB6 7D60\
C0CF 1FD6 9133 A59D 4E37 00D7 EC0A F614 3F00 1938 08EE 7554 7ED0 421A \
BABD 2859 20AA A2C2 42EE 0D95 852D 1153 AB00 B9DD"
INCREMENT wgascentl2 mgcld 2010.050 31-may-2010 4 AD0780ABB7C879028876 \
VENDOR_STRING=2ED26BB6 SN=9220621 SIGN2="1C99 1A24 9878 FFC6 721E F84B \
C18B 09E9 CB76 6AF8 76CD 975E 94ED 6D05 057B 0617 7CE2 35D9 F9C4 5D75 \
2807 E581 D51B 6D13 8B12 D45D 531F EE4D 8542 B01D"
INCREMENT wgpcb mgcld 2010.050 31-may-2010 4 7DE7905B502576265F63 \
VENDOR_STRING=61CC3270 SN=9220669 SIGN2="1DA7 47BE F0B2 DC21 226E CEF0 \
3E33 4CBA 83C7 C1F0 FE67 21B0 FAA7 7D95 6DD7 107E 0FEF 30B8 AECA 8DB5 \
8B06 5F10 6DBE D3CF 2BBE 1CC5 6EA4 866C FDBE 51F3"

Nodelocked Counted Licenses (Server Required)

These licenses are locked to a specific piece of hardware, either an Ethernet card or a hardware
key. These devices provide a unique identifier for the license. The software will run only on the

Managing Mentor Graphics IE3D Software, V15.0 23

Licensing
Configuring Licensing on Windows

system that has that particular piece of hardware installed. The license file contains both a
SERVER and a DAEMON line and the quantity on each INCREMENT line is greater than zero
(0); a license server is required. Nodelocked counted licenses have a HOSTID field in each
INCREMENT line that identifies which computer can check out a license. These licenses are
available on Linux and Windows.

Mobile Compute (nodelocked uncounted) Licenses (No Server Required)

A license file does not require a server if it does not contain lines that start with the words
SERVER or DAEMON, and the quantity listed for each INCREMENT is zero. The quantity is
found immediately to the right of the expiration date of the license. Note that zero does not
mean that there are no licenses available; it is simply the identifier of this special kind of
license.

An example is provided below of mobile compute (nodelocked uncounted) licenses. The

expiration date is these examples is 31-may-2010 and the quantity is 0.

INCREMENT wgpcb mgcld 2010.050 31-may-2010 0 CD3C5492F864C20E2B93 \

VENDOR_STRING=EE778099 HOSTID=00123f73217c SN=22370442 SIGN2="0243 \
DA2D AE13 C286 5746 A4D2 74C8 BBE4 2937 B3C1 8C00 77DC 33DA 5C97 5E92 \
187F D4BD 52D8 EE32 AF1F 44C2 3BD1 FFF2 536E 6DE0 F770 39AE 9ADD 0F9C \
328C"
INCREMENT wgascentlx mgcld 2010.050 31-may-2010 0 0DFC645298D1CDCD52A3 \
VENDOR_STRING=108566EB HOSTID=00123f73217c SN=22370441 SIGN2="0675 \
4EDA F15B CCE1 F3F8 AA71 DB47 8C37 0BAF 75C9 D22D C9DA F50C BD96 E645 \
000D C5D3 B788 2CAC ED47 93F1 0417 3F24 D7FD CBAC 5C21 4CB2 BA53 806D \
A673"
INCREMENT wgascentl2 mgcld 2010.050 31-may-2010 0 ED6CA43294A94829CFDC \
VENDOR_STRING=53CB880A HOSTID=00123f73217c SN=22370440 SIGN2="1083 \
CBEC C9C7 8203 4772 9449 B4A1 753A B2D2 6EEB 7CC1 41F8 7984 310E 9B79 \
1155 6686 209D C0F0 E1AE 32C9 4C13 DE00 FD44 29F4 8B54 7A88 2DAE 06C2 \
7CEF"

Mobile compute (nodelocked uncounted) licenses are issued to a unique system identifier,
either the Ethernet address or an ID provided by a hardware key (dongle). The HOSTID field
may appear different from the example depending on the type of identifier specified when the
features were generated. Figure 1-1 lists several types of HOSTIDs.

Table 1-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 or Rainbow

HOSTID=FLEXID=6-a6309832 Sentinel Dongle
USB Port Hardware Key HOSTID=FLEXID=9-36a6dfd6 Aladdin USB
Dongle

24 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

Table 1-1. Example HOSTIDs (cont.)

Type Example HOSTID Description
Ethernet Address HOSTID=000cf41a42bc NIC physical
address
If you require assistance with this step, contact Customer Support or consult SupportNet.

Installing Mobile Compute Licenses

Mentor Graphics provides mobile compute (or nodelocked uncounted) licenses for Windows
systems.

Figure 1-2 illustrates the basic flow for installing and configuring mobile compute licenses.

This section covers how to setup and use mobile compute licenses. It covers:

• “Ordering Your Mentor Graphics Licenses” on page 26

• “Verifying the License File” on page 27
• “Ensuring Licensing Environment Variable Points to License File” on page 28
• “Ensuring Proper System Configuration” on page 29
• “Downloading and Installing PCLS and Mobile Compute Licenses” on page 29
• “Installing Hardware Key Device Drivers” on page 30
• “Verifying a Workstation Can Check Out a License” on page 31

Managing Mentor Graphics IE3D Software, V15.0 25

Licensing
Configuring Licensing on Windows

Figure 1-2. Basic Flow for Installing Mobile Compute Licenses

This figure illustrates the Ordering Your Mentor Graphics

1 Licenses
basic steps for installing and
configuring mobile compute
licenses on Windows Verifying the License File
platforms. 2

3 Ensuring Licensing Environment

NOTE: Mentor Graphics Variable Points to License File
recommends installing
licensing before installing
application software. 4 Ensuring Proper System
Configurationt

5 Downloading and Installing PCLS

and Mobile Compute Licenses

6 Installing Hardware Key Device

Drivers

7 Verifying a Workstation Can

Check Out a License

Ordering Your Mentor Graphics Licenses

Note
Mentor Graphics issues Authorization Code Files that are referred to here as license files.

At this point you should know what type of licenses you need.

To order and receive Mentor Graphics Licenses:

1. New users must order software licenses prior to using Mentor Graphics software. To
order licenses, contact your local Mentor Graphics sales office. The sales office can
provide you with information on any licenses your company purchased and any current
license sever configurations you may have. When purchasing new licenses, you need to
provide the sales office with:
o Any new license server configuration information

26 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

o The hostID(s) of client and license server computers for nodelocked licenses
o The hostID(s) of the license server computers for all floating licenses

Tip: To determine your hostID:

On Windows: ipconfig/all returns a Physical Address similar to: 00087441c4eb (remove
the hyphens for the hostID)

Licensing reports are available for existing customers at the Customer Support website:
http://supportnet.mentor.com/myaccount/index.cfm?fa=user.licenses

Note
The Customer Support website requires a login and password.
To register and obtain a password, go to
http://supportnet.mentor.com/user/register.cfm
If you have difficulties, email csd_registration@mentor.com. Use
http://supportnet.mentor.com/user/forgot_password.cfm
for assistance if you are registered but have forgotten your password.

2. Save your licenses in a file on your local harddrive. If the license file was sent as an
attachment to email, detach the file and save it to a directory which will permit you to
make edits to the file. If the licensing information is embedded in an email, copy the
contents of the email to a file you are permitted to edit. Edit the file to remove any email
header information. The license file must
• be plain-text only
• not contain any spaces
• end in .dat, .lic or .txt
There are no restrictions on the name of the file or where you put it; however, you
should keep a copy of each file in a safe location for backup purposes.

Verifying the License File

In the previous procedure, you ordered your Mentor Graphics licensing and saved it to a file on
your local harddrive. No editing is required with mobile compute licenses. In fact, editing these
licenses is not recommended and may invalidate your licenses.

The following is an example of a mobile compute license file. The license file does not contain
SERVER or DAEMON lines and the quantity on each INCREMENT line is zero (0).

INCREMENT wgpcb mgcld 2010.050 31-may-2010 0 CD3C5492F864C20E2B93 \

VENDOR_STRING=EE778099 HOSTID=00123f73217c SN=22370442 SIGN2="0243 \
DA2D AE13 C286 5746 A4D2 74C8 BBE4 2937 B3C1 8C00 77DC 33DA 5C97 5E92 \
187F D4BD 52D8 EE32 AF1F 44C2 3BD1 FFF2 536E 6DE0 F770 39AE 9ADD 0F9C \

Managing Mentor Graphics IE3D Software, V15.0 27

Licensing
Configuring Licensing on Windows

328C"
INCREMENT wgascentlx mgcld 2010.050 31-may-2010 0 0DFC645298D1CDCD52A3 \
VENDOR_STRING=108566EB HOSTID=00123f73217c SN=22370441 SIGN2="0675 \
4EDA F15B CCE1 F3F8 AA71 DB47 8C37 0BAF 75C9 D22D C9DA F50C BD96 E645 \
000D C5D3 B788 2CAC ED47 93F1 0417 3F24 D7FD CBAC 5C21 4CB2 BA53 806D \
A673"
INCREMENT wgascentl2 mgcld 2010.050 31-may-2010 0 ED6CA43294A94829CFDC \
VENDOR_STRING=53CB880A HOSTID=00123f73217c SN=22370440 SIGN2="1083 \
CBEC C9C7 8203 4772 9449 B4A1 753A B2D2 6EEB 7CC1 41F8 7984 310E 9B79 \
1155 6686 209D C0F0 E1AE 32C9 4C13 DE00 FD44 29F4 8B54 7A88 2DAE 06C2 \
7CEF"

To verify your license file, do the following:

1. Open the license file in a text editor (for example, NotePad or WordPad).
2. Determine the hostid of the computer. Find this value with the hostname command:
C:\> ipconfig /all
The command returns something similar to the following:
Windows 2000 IP Configuration
Host Name ......:MACHINENAME
Node Type ......:Hybrid
IP Routing Enabled..:No

Ethernet adapter Local Area Connection

DNS Suffix ......:domain.com
Description .....:Intel(R) PRO/100
Physical Address...:00-08-74-41-c4-eb
DHCP Enabled ....:Yes
Autoconf Enabled...:Yes
IP Address......:141.11.11.150
Subnet Mask.....:255.255.255.0

In the above example, the hostid of the system is found in the Ethernet adapter section of
the information returned from the ipconfig command. The hostid is the Physical
Address, without the hyphens: 00087441c4eb. This hostid indicates the machine to which
the license is locked. There is no license server dependency with the mobile compute
license. Uncounted licenses are not valid for usage via Microsoft Remote Desktop or
Terminal Server sessions.
3. Make sure the correct hostid is present for every INCREMENT string.
4. Save and Close the license file. Keep a copy of the license file in a safe location for
backup purposes.

Ensuring Licensing Environment Variable Points to License File

1. Navigate to System Properties. Right-click on the My Computer icon and select
Properties or go to Control Panel > System.
2. Go to Environment Variables. Select the Advanced tab and click the Environment
Variables button.

28 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

3. Check the variable MGLS_LICENSE_FILE. If you have mobile compute (nodelocked

uncounted) licenses, define the variable as the path to the license file starting with the
drive letter and ending with the license file name. For example: C:\flexlm\license.dat

Tip: MGLS_LICENSE_FILE can be created as a System Variable (defined as the path to

the license file), available to all users that log in to this system, or it can be created as a
User Variable, available only to the current user. A user with Administrator privileges
may create a System Variable. Be sure that only one variable points to your license file.
Duplicate pointers can slow down performance and may cause other technical problems.

4. Click OK and OK to save and close your new Properties setting.

Ensuring Proper System Configuration

You need to ensure that the proper networking components are installed and configured
correctly.

In order for Mentor Graphics Licensing software to work correctly, workstation hardware and
operating system versions must be at a level adequate to support the current versions of
software. For hardware and operating system information, refer to your application’s
configuration information.

Also, you must configure TCP/IP on your network for licensing to work properly.

Downloading and Installing PCLS and Mobile Compute Licenses

1. Click the URL below to access the licensing download page on SupportNet:
http://supportnet.mentor.com/member/licensing

2. Scroll to the bottom of the Licensing Agreement and select I Agree.

3. From the list of Licensing Software, select PCLS for Windows.
4. Save the download file to a temporary location on the license server hard drive.
5. Using WinZip, unzip the download and run the setup.exe contained therein.
After the Mentor Graphics Licensing installation is launched, the Welcome to Licensing
screen appears
6. Click Next. The Choose Destination Location screen appears.
The default (and recommended) installation location for the Mentor Graphics licensing
software is C:\MentorGraphics\Licensing.
7. Click Next. The installation progress bar appears followed by the Configure Licensing
screen.

Managing Mentor Graphics IE3D Software, V15.0 29

Licensing
Configuring Licensing on Windows

8. The default Typical configuration box is selected. Do one of the following:

• If you are not installing hardware key device drivers, click Next and OK when
license setup is complete.
• If you are installing hardware key device drivers, click the Custom configuration
box. Proceed to “Installing Hardware Key Device Drivers” on page 30.

Installing Hardware Key Device Drivers

At this point, you are still in the process of installing PCLS on your computer. It is while still in
the PCLS install mode that you can install hardware key device drivers. This is an optional step.

1. In the Select configuration options dialog box, check 2. Load hardware key device
driver(s).

Note
Hardware keys are optional hardware identifiers. The following steps only need to be
completed if you are using a hardware key.

Mentor Graphics provides hardware keys, also known as dongles. A hardware key is a
device you plug into your parallel printer port or into your USB port. It provides a
unique host identification (host ID) for the licensing system.
A hardware key is not necessarily required to run Mentor Graphics software. Hardware
keys can be used as a HOSTID provider for any of the three types of licenses (floating,
nodelocked counted, and mobile compute), or you don’t have to use a hardware key at
all.

Note
You must have administrator privileges to install hardware key drivers.

Caution
Mentor Graphics assumes no liability for hardware damage related to the use of hardware
keys. “Hot-swapping” hardware keys is not recommended.

2. Click Next.
Several windows will display consecutively. Click OK on all of them. The restart
information dialog appears only if the dongle/hardware key drivers were installed.
3. Click OK when license setup is complete.
4. Reboot your machine.

30 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

For more information on loading hardware key device drivers and hardware keys, refer
to the Licensing Mentor Graphics Software manual available from the
release_documents directory on the CD-ROM or from SupportNet.

Verifying a Workstation Can Check Out a License

An application called pcls_ok is used to test license checkout on computers running Windows
operating systems. Typically, pcls_ok is found from the Start Menu at Start > Programs >
Mentor Graphics Licensing. If you do not see it there, search the computer harddrive for the
file name pcls_ok.exe. This verification method works with all types of Mentor Graphics
provided 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 into the Feature box and click
the Apply button.

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

3. Verify the license is successfully checked out. A success or failure message is displayed.
If you receive a success message, that indicates licenses can be checked out successfully
from that workstation. If you receive a failure message, click [>>>Details] for more
information. At this point, you may want to search the Knowledgebase or open a Service
Request on SupportNet.

Managing Mentor Graphics IE3D Software, V15.0 31

Licensing
Configuring Licensing on Windows

Installing Floating and Nodelocked Counted Licenses on

Windows
Mentor Graphics provides floating and nodelocked counted licenses for Windows systems.

Figure 1-2 illustrates the basic flow for installing and configuring floating and nodelocked
counted licenses.

This section covers how to setup and use floating and nodelocked counted licenses. It covers:

• “Identifying the License Servers” on page 34

• “Ordering Your Mentor Graphics Licenses” on page 34
• “Ensuring System Configuration is Correct” on page 35
• “Downloading the PC Licensing Software from SupportNet” on page 36
• “Finding the Hostname of the Server Computer” on page 36
• “Editing the License File” on page 36
• “Creating the License Manager Service in LMTOOLS” on page 37
• “Installing Floating and Nodelocked Counted Licenses” on page 38
• “Starting the License Server” on page 38
• “Verifying License Server is Working” on page 39
• “Pointing Clients to the License Server” on page 39
• “Verifying a Computer Can Check Out a License” on page 40

32 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

Figure 1-3. Basic Flow for Installing Floating/Nodelocked Counted Licenses

This figure illustrates the Identifying the License Servers

1
basic steps for installing and
configuring floating and
nodelocked counted licenses 2 Ordering Your Mentor Graphics
on Windows platforms. Licenses

3 Ensuring System Configuration is

Correct
NOTE: Mentor Graphics
recommends installing
4 Downloading the PC Licensing
licensing before installing Software from SupportNet
application software.

5 Finding the Hostname of the

Server Computer

6 Editing the License File

7 Creating the License Manager

Service in LMTOOLS

8 Installing Floating and

Nodelocked Counted Licenses

9 Starting the License Server

10 Verifying
Working
License Server is

11 Pointing Clients to the License

Server

12 Verifying a Computer Can Check

Out a License

Managing Mentor Graphics IE3D Software, V15.0 33

Licensing
Configuring Licensing on Windows

Identifying the License Servers

Determine which machine(s), if any, you will use as license servers and determine their host
IDs.

Mentor Graphics licenses are administered by one or more workstations that function as license
servers. A license server stores the license file, contains a local copy of the licensing software,
and runs the license daemon. A license server must be accessible from any workstation running
a Mentor Graphics application using basic TCP/IP communication protocols.

License servers can be configured to operate independently or in a redundant group of three. If

your site is large and you usually have many people using Mentor Graphics applications
simultaneously, you might have several multiple independent servers, several groups of
redundant servers, or a combination of the two types.

For more information on determining the types of licensing servers you have, refer to “Planning
for Licensing” in the Licensing Mentor Graphics Software manual available from the
release_documents directory on the CD-ROM or from SupportNet.

Ordering Your Mentor Graphics Licenses

Note
Mentor Graphics issues Authorization Code Files that are referred to here as license files.

At this point you should know what type of licenses you need and what machine will serve as
your license server.

1. New customers should order new licenses; existing customers can download a copy of
your current licenses.
• If you are ordering new licenses
New users must order software licenses prior to using Mentor Graphics software. To
order licenses, contact your local Mentor Graphics sales office. The sales office can
provide you with information on any licenses your company purchased and any
current license sever configurations you may have. When purchasing new licenses,
you need to provide the sales office with:
o Any new license server configuration information
o The hostID(s) of client and license server computers for nodelocked licenses
o The hostID(s) of the license server computers for all floating licenses

34 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

Tip: To determine your hostID:

On Windows: ipconfig/all returns a Physical Address similar to: 00087441c4eb (remove
the hyphens for the hostID)

• If you want to download a copy of your current licenses

Existing customers can download a copy of their current licenses or view Licensing
reports at the Customer Support website:
http://supportnet.mentor.com/myaccount/index.cfm?fa=user.licenses

Note
The Customer Support website requires a login and password.
To register and obtain a password, go to
http://supportnet.mentor.com/user/register.cfm
If you have difficulties, email csd_registration@mentor.com. Use
http://supportnet.mentor.com/user/forgot_password.cfm
for assistance if you are registered but have forgotten your password.

2. Save your licenses in a file on your local harddrive. If the license file was sent as an
attachment to email, detach the file and save it to a directory which will permit you to
make edits to the file. If the licensing information is embedded in an email, copy the
contents of the email to a file you are permitted to edit. Edit the file to remove any email
header information. The license file must
• be plain-text only
• have a name that does not contain any spaces
• end in .dat, .lic or .txt
There are no restrictions on the name of the file or where you put it. It is good practice to
keep a copy of each file in a safe location for backup purposes.

Ensuring System Configuration is Correct

Ensure that the proper networking components are installed and configured correctly.

In order for Mentor Graphics Licensing software to work correctly, workstation hardware and
operating system versions must be at a level adequate to support the current versions of
software. For hardware and operating system information, refer to your application’s
configuration information.

Also, you must configure TCP/IP on your network for licensing to work properly.

Managing Mentor Graphics IE3D Software, V15.0 35

Licensing
Configuring Licensing on Windows

Downloading the PC Licensing Software from SupportNet

1. Click the URL below to access the licensing download page on SupportNet:
http://supportnet.mentor.com/member/licensing

2. Scroll to the bottom of the Licensing Agreement and select I Agree.

3. From the list of Licensing Software, select PCLS for Windows.
4. Save the download file to a temporary location on the license server hard drive.
5. Extract the download and run the setup.exe contained therein.
After the Mentor Graphics Licensing installation is launched, the Welcome to Licensing
screen appears
6. Click Next. The Choose Destination Location screen appears.
7. The default (and recommended) installation location for the Mentor Graphics licensing
software is C:\MentorGraphics\Licensing. Click Next. The installation progress bar
appears followed by the Configure Licensing screen. The default Typical configuration
box is selected.
8. Click Next.
Several windows will display consecutively. Click OK on all of them.
9. Click OK when license setup is complete. It is not necessary to reboot your computer.

Finding the Hostname of the Server Computer

1. Click the Start > All Programs > Mentor Graphics Licensing > lmtools. The
LMTOOLS screen appears.
2. Select the System Settings tab.
3. Highlight the Computer/Hostname field with the mouse. Type Ctrl-C to save the value
(so you can paste it into the license file).

Editing the License File

1. Now, open the license file. Scroll past the header section and locate the line that begins
with SERVER.
SERVER put_server_name_here 00188BCCD07C 1717
DAEMON mgcld path_to_mgcld

36 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

INCREMENT wgascentlx mgcld 2010.050 31-may-2010 4 5D1720DB8156471920C3 \

VENDOR_STRING=D5806CD3 SN=9220623 SIGN2="06A4 B296 2311 52F6 DEB6 7D60\
C0CF 1FD6 9133 A59D 4E37 00D7 EC0A F614 3F00 1938 08EE 7554 7ED0 421A \
BABD 2859 20AA A2C2 42EE 0D95 852D 1153 AB00 B9DD"
INCREMENT wgascentl2 mgcld 2010.050 31-may-2010 4 AD0780ABB7C879028876 \
VENDOR_STRING=2ED26BB6 SN=9220621 SIGN2="1C99 1A24 9878 FFC6 721E F84B \
C18B 09E9 CB76 6AF8 76CD 975E 94ED 6D05 057B 0617 7CE2 35D9 F9C4 5D75 \
2807 E581 D51B 6D13 8B12 D45D 531F EE4D 8542 B01D"
INCREMENT wgpcb mgcld 2010.050 31-may-2010 4 7DE7905B502576265F63 \
VENDOR_STRING=61CC3270 SN=9220669 SIGN2="1DA7 47BE F0B2 DC21 226E CEF0 \
3E33 4CBA 83C7 C1F0 FE67 21B0 FAA7 7D95 6DD7 107E 0FEF 30B8 AECA 8DB5 \
8B06 5F10 6DBE D3CF 2BBE 1CC5 6EA4 866C FDBE 51F3"

2. Highlight the put_server_name_here field with the mouse and type Ctrl-V to paste the
hostname that was copied from LMTOOLS. Take note of the completed SERVER line.
For example:
Before:
SERVER put_server_name_here 00188BCCD07C 1717
After:
SERVER umbrella 00188BCCD07C 1717

3. Verify the port number. The fourth field of the SERVER line is the communication port
number. The default value is 1717. This number can be set to any other port number
which is currently not in use.

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

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

SERVER umbrella 00188BCCD07C TCP:1717

4. The path_to_mgcld must be replaced with the location of the mgcld file, which is found
in the folder where the licensing software is installed. For example:
Before:
DAEMON mgcld path_to_mgcld
After:
DAEMON mgcld C:\MentorGraphics\Licensing\mgcld.exe

Take note of the completed DAEMON line.

5. Select File > Save to save the license file and close the text editor window.

Creating the License Manager Service in LMTOOLS

1. Click the Start > All Programs > Mentor Graphics Licensing > lmtools. The
LMTOOLS screen appears.
2. In the LMTOOLS window, Service/License File tab, click Configuration using
Services radio button, if it isn’t already selected.
3. Select the Config Services tab.

Managing Mentor Graphics IE3D Software, V15.0 37

Licensing
Configuring Licensing on Windows

4. Select the Service Name text box and change the name as desired. For example: Mentor
license service.

Installing Floating and Nodelocked Counted Licenses

1. Click the Start > All Programs > Mentor Graphics Licensing > lmtools. The
LMTOOLS screen appears.
2. In the LMTOOLS window, select the Browse button beside the field named Path to the
lmgrd.exe file.

Note
By default this folder should be the location where the licensing software was installed. If
not, navigate to the location. The default location is C:\MentorGraphics\Licensing.

3. Select lmgrd.exe and click the Open button.

4. On the Config Services window, click the Browse button beside the field named Path to
the license file.
5. Navigate to the location of the license file. On the Open window, change Files of type:
to All Files (*.*).
6. Select the license file and click the Open button.
7. On the Config Services window, select the field named Path to the debug log file and
type the path to a log file. This file doesn’t exist yet (it gets created when the service is
started). An example log file name is: C:\MentorGraphics\license.log.
8. Select the Use Services check box.
9. To ensure the license manager service starts again after a reboot, select the Use Services
and Start Server at Power Up check boxes.
10. Save the license manager service by clicking the Save Service button.
11. Click Yes to confirm the save.

Starting the License Server

1. Click the Start > All Programs > Mentor Graphics Licensing > lmtools. The
LMTOOLS screen appears.
2. In the LMTOOLS window, select the Start/Stop/Reread tab.
3. Click the Start Server button to start the license manager service. The Server Start
Successful message should appear (in the bottom left of screen).

38 Managing Mentor Graphics IE3D Software, V15.0

 Licensing
Configuring Licensing on Windows

Verifying License Server is Working

1. Click the Start > All Programs > Mentor Graphics Licensing > lmtools. The
LMTOOLS screen appears.
2. In the LMTOOLS window, select the Server Status tab.
3. Click the Perform Status Enquiry button. The first section of the output identifies the
port@host value which clients should set in their MGLS_LICENSE_FILE environment
variable. For example:
1717@umbrella
A little further down the output, the license server UP v11.6.1 message indicates the
lmgrd (FlexNet daemon) is up and running, and in this case the version is 11.6.1. For
example:
umbrella: license server UP v11.6.1
A little further down, the Feature usage info: section lists the status of all the features in
the license file.

Pointing Clients to the License Server

Note
The following steps are for use with Floating and Nodelocked Counted licenses only.
They do not apply to Mobile Compute licenses.

On each client computer, define an environment variable to point to the license server. The
clients must have a pointer to the server in order to check out a license.

Note
A computer can be a server and a client: you can run applications on the same system
where you run the license service. If this is the case, you still need to perform the
following steps to define the license file variable.

1. Navigate to System Properties. Right-click on the My Computer icon and select

Properties or go to Control Panel > System.
2. Go to Environment Variables. Select the Advanced tab and click the Environment
Variables button.
3. Create or edit the variable MGLS_LICENSE_FILE. Define the variable using the port
number and host name of the license server. For example: 1717@umbrella.
4. Select OK a couple of times to get back to the Properties window or Control Panel. No
reboot is required.

Managing Mentor Graphics IE3D Software, V15.0 39

Licensing
Configuring Licensing on Windows

Tip: MGLS_LICENSE_FILE can be created as a System Variable, available to all users

that log in to this system, or it can be created as a User Variable, available only to the
current user. A user with Administrator privileges may create a System Variable. Be sure
that only one variable points to your license server. Duplicate pointers and unreachable
servers can slow down performance and may cause other technical problems.

Verifying a Computer Can Check Out a License

An application called pcls_ok is used to test license checkout on computers running Windows
operating systems. Typically, pcls_ok is found from the Start Menu at Start > Programs >
Mentor Graphics Licensing. If you do not see it there, search the computer harddrive for the
file name pcls_ok.exe. This verification method works with all types of Mentor Graphics
provided 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 into the Feature box and click
the Apply button.

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

3. Verify the license is successfully checked out. A success or failure message is displayed.
If you receive a success message, that indicates licenses can be checked out successfully
from that workstation. If you receive a failure message, click [>>>Details] for more
information. At this point, you may want to search the Knowledgebase or open a Service
Request on SupportNet.

40 Managing Mentor Graphics IE3D Software, V15.0

 Chapter 2
Installing Mentor Graphics Software

This chapter covers the following:

• “Before You Begin Installation” on page 41

• “Downloading Software on Windows Platforms” on page 42
• “Quick Install for Windows” on page 43
• “Downloading Software on Linux Platforms” on page 45
• “Quick Install for Linux” on page 45
• “Installing Other Products After Initial Installation” on page 47
• “Installing the Install Program to an Alternative Location” on page 47
• “Uninstalling Products” on page 51

Before You Begin Installation

The following are pre-requisites to the Mentor Graphics product installation.

1. Order software licenses (authorization codes) from Mentor Graphics. Licensing should
be installed prior to installing application software.

Note
To make full use of the Install program’s automatic product selection by licenses, set up
your software licensing environment before running the Install program. For additional
information, refer to “Licensing” on page 5.

2. Check system requirements. For current system requirements, refer to the Release
Highlights document. These documents are located in the release_documents directory
on the application CD-ROM or from SupportNet. Additionally, the following website on
SupportNet lists all supported system configurations:
http://supportnet.mentor.com/systemreqs/

3. The IE3D 15.0 release uses the Microsoft Visual C++ 2008 compilers which have a
runtime compatibility requirement. During installation of IE3D 15.0, your system is
automatically checked to see if it meets these requirements. If not, the Microsoft Visual
C++ 2008 SP1 Redistribution software will be installed.

Managing Mentor Graphics IE3D Software, V15.0 41

Installing Mentor Graphics Software
Downloading Software on Windows Platforms

In some cases, this will require your system be rebooted. If a reboot is required, a
message appears where you must click OK. Installation cannot be successfully
completed until after a reboot has occurred. Once the system has been rebooted, you
must restart the Mentor Installation Program and continue your installation of IE3D
15.0.

Tip: You can avoid this potential reboot by pre-installing the Microsoft Visual C++ 2008
SP1 Redistribution package before you install the IE3D 15.0 release.

Note
If you are performing batch or third party distributed installations of IE3D 15.0, it is
strongly recommended that you install the Microsoft Visual C++ 2008 Redistributable
package on all systems first, reboot, and then install the IE3D 15.0 release.

The Microsoft Visual C++ 2008 Redistributable package may be obtained two ways:
• From Microsoft:
http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-
4AB7-A40D-3802B2AF5FC2&displaylang=en
• From the IE3D 15.0 installation source by running the following program:
<Installation Source>/ /sdd_redist.ixn/win32/vcredist_x86.exe

Downloading Software on Windows Platforms

Note
SupportNet stores some of your download history. If you have previously downloaded
the software, SupportNet may not prompt you for all the steps in the procedure below,
such as step 8.

Note
The following instructions use WinZip as the extraction utility. If you use a different
extraction utility, make appropriate selections to ensure that the directory structure of the
Mentor Graphics software is preserved.

1. Create a IE3D download directory on your computer. Change to that directory.

2. Using a web browser, log on to Mentor Graphics SupportNet.
3. In the My Products field, select IE3D SI.
4. In the CHOOSE FLOW field, select the name of the PCB flow release you use.

42 Managing Mentor Graphics IE3D Software, V15.0

 Installing Mentor Graphics Software
Quick Install for Windows

If you do not use a Mentor Graphics PCB design flow, click the “PCB - Vendor-Ind”
option.
5. Click the Downloads tab.
6. In the SELECT RELEASE field, select IE3D SI 15.0 and click the button.
7. In the Selected Release field, select IE3D SI 15.0 to start the download process. A new
web browser window opens.
8. Read the Software Terms and Conditions and click I Agree at the bottom before
downloading the software.
9. In the Product Download window, select the FTP Download button associated with the
platform-specific version of the IE3D 15.0 release you want to download.
10. In Windows Explorer, right-click the .zip file.
11. From the pop-up menu, select Extract to...
12. Navigate to the folder to uncompress to.
13. Select Use folder names and click Extract.
The data are extracted to the selected location.
14. Close WinZip when extraction completes.
15. Follow the instructions listed in Quick Install for Windows.

Quick Install for Windows

Note
By default, the Install Program is installed to C:\MentorGraphics\Install on Windows. If
you need to install the Install Program to an alternative location, see “Installing the Install
Program to an Alternative Location” on page 47.

1. Navigate to the directory where you downloaded the release to. Double-click setup.exe
to start the install program.
Alternatively, if you are installing from DVD/CD ROM, insert the disc into your drive.
If the installation does not automatically start, select Start > Run, specify the DVD/CD
ROM drive letter and install executable (for example D:\setup.exe) and click OK.

Note
You must have Administrator privileges to install the software products from DVD/CD
ROM on Windows systems.

Managing Mentor Graphics IE3D Software, V15.0 43

Installing Mentor Graphics Software
Quick Install for Windows

Note
We highly recommend that you stop all other programs before installing Mentor
products.

Tip: After the Mentor Install Program invokes, instructions for performing each of the
following tasks are available in the online help.

2. In the Mentor Graphics Install window, click Install Products. The Source and Target
screen displays.
3. Specify the source location by typing the source path in the source location field or click
Search to select the source directory. The default source location is the path where you
invoked setup.exe in Windows. Valid source directories display as gold-colored folders.
4. Type the target path in the target location field or click Browse to select the target
directory.
Restriction: Do not use spaces in the path Other Mentor Graphics software and other
features do not accept spaces in the target path.
5. Click Next to display the Product Selection screen.
6. Select the products to install by selecting the appropriate check boxes. The products that
have previously been installed at the target folder will display a “target” icon to the right
of the product name.
7. Click Next to display the License Agreement screen.
8. Read the licensing agreement and click Agree to accept. The Confirm Selections screen
displays.
9. Confirm the product selections by clicking Install.

Caution
Some software installations launch post-installation processes that may include separate
dialogs and command shells. Do not dismiss these dialogs or shells; they will either
complete automatically or certain dialogs will require input. If any reboot requests occur
during the installation process (other than the one specific to the Microsoft Visual C++
2008 compilers), respond No.

Caution
If you choose to run verification on the install, run it immediately after installation and
prior to running any of the products as the products can modify the installed files. These
modified files could return unsatisfactory installation verification results.

10. Click Done when the installation is complete.

44 Managing Mentor Graphics IE3D Software, V15.0

 Installing Mentor Graphics Software
Downloading Software on Linux Platforms

Downloading Software on Linux Platforms

Note
SupportNet stores some of your download history. If you have previously downloaded
the software, SupportNet may not prompt you for all the steps in the procedure below.

1. Create a IE3D download directory on your computer. Change to that directory.

2. Using a web browser, log on to Mentor Graphics SupportNet.
3. In the My Products field, click IE3D SI.
4. In the CHOOSE FLOW field, select the name of the PCB flow release you use.
If you do not use a Mentor Graphics PCB design flow, click the “PCB - Vendor-Ind”
option.
5. Click the Downloads tab.
6. In the SELECT RELEASE field, select IE3D SI 15.0 and click the button.
7. In the Selected Release field, click IE3D SI 15.0 to start the download process. A new
web browser window opens.
8. Read the Software Terms and Conditions and click I Agree at the bottom before
downloading the software.
9. In the Product Download window, select the FTP Download button associated with the
platform-specific version of the IE3D 15.0 release you want to download.
10. Untar the file. For example:
# tar -xvf _ESDM.rhel4.tar
11. Follow the instructions listed in Quick Install for Linux.

Quick Install for Linux

Note
By default, the Install Program is installed to $HOME/mgc/install.<vco> on Linux.
<vco> is “ixl” for Linux. If you need to install the Install Program to an alternative
location, see “Installing the Install Program to an Alternative Location” on page 47.

1. If installing from CD-ROM, follow the instructions here to mount the CD-ROM. If
installing from a downloaded Release, proceed to Step 2.
Begin by mounting the CD-ROM.
To mount the CD-ROM on Linux or Solaris, do the following:

Managing Mentor Graphics IE3D Software, V15.0 45

Installing Mentor Graphics Software
Quick Install for Linux

a. Insert the Volume 1 CD into the CD-ROM drive.

b. If necessary, create a mount point (directory) for your CD-ROM device.
c. Mount the CD-ROM. The following table shows command-line examples for the
supported operating systems. Substitute the SCSI address for the value of "x".
Table 2-1. Mounting Commands by Operating System
Operating System Use These UNIX Commands...
Linux mount -t iso9660 /dev/cdrom /mnt/cdrom
2. Invoke install.<vco>. Where vco equals the three-character platform identification of
the platform you are installing to. <vco> is “ixl” for Linux.
For example: /cdrom/install.ixl

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

3. In the Mentor Graphics Install window, click Install Products. The Source and Target
screen displays.
4. Specify the source location by typing the source path in the source location field or click
Search to select the source directory. The default source location is the path where you
invoked install.ixl.
Type the target path in the target location field or click Browse to select the target
directory.
Click Next to display the Product Selection screen.
5. Select the products to install by selecting the appropriate check boxes. The products that
have previously been installed at the target folder will display a “target” icon to the right
of the product name.
6. Click Next to display the License Agreement screen.
7. Read the licensing agreement and click Agree to accept. The Confirm Selections screen
displays.
8. Confirm the product selections by clicking Install.
9. Click Done when the installation is complete.

Caution
If you choose to run verification on the install, run it immediately after installation and
prior to running any of the products as the products can modify the installed files once
they have been invoked. These modified files could return unsatisfactory installation
verification results.

46 Managing Mentor Graphics IE3D Software, V15.0

 Installing Mentor Graphics Software
Installing Other Products After Initial Installation

Installing Other Products After Initial Installation

Additional products may be installed after you have performed the initial product installation.
Simply invoke the Install program and proceed with the instructions provided earlier in this
chapter.

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

On Linux systems, navigate to the directory where the Install program is located and run the
Install program (install.<vco>). <vco> is “ixl” for Linux.

Installing the Install Program to an Alternative

Location
To select a different install location for the Install program, do the following:

On Windows systems, the default location is C:\MentorGraphics\Install. To change the

location:

Launch the Install program from a shell using setup.exe with the -msiloc switch. For
example:
setup.exe -msiloc C:\alternatePath

This installs the Mentor Graphics Install program to C:\alternatePath instead of

C:\MentorGraphics\Install.

Tip: If you run into a situation where you already have the Install program installed and
need to either install a newer version or install to a new location, you can force the install
by using the command setup.exe -force. The -force option enables you to install a newer
version of the Install program to another location or install an older version of the install
program over the top of a newer version.

On Linux systems, the default location is $HOME/mgc/install.<vco>. <vco> is “ixl” for Linux .
To change the location:

Run the install.<vco> quickinstall executable with the -msiloc /path-to-target/Install

switch. For example: ./install.ss5 -msiloc /export/MentorGraphics/Install
The command install.<vco> installs the Mentor Graphics Install program on your
system. Running the “install.vco -help” provides usage information:
# ./install.<vco> -help
Usage: ./install.<vco> [-help] [-msiloc] [-v] [-b file]

Managing Mentor Graphics IE3D Software, V15.0 47

Installing Mentor Graphics Software
Installing the Install Program to an Alternative Location

Usage: install.hpu [-help] [-src file/dir] [-tgt dir] [-quicksource file/dir] [-msiloc
path] [-version] [-force] [-silent] [-noexecute] [-nosplash] [-batch file] [-batchverify
file/dir] [-batchremove file/dir] [-input file]

where:

-help — Displays the usage information

-src <file/dir> — Uses the specified file/directory as the installation source
-tgt <dir> — Uses the specified directory as the installation target
-quicksource <file/dir> — Uses the specified file/directory as the installation
source in quickinstall mode
-msiloc <dir> — Defines the alternate location where MSI will be installed
(usual location $HOME/mgc)
-version — Displays the version information
-force — Forces installation of this version of MSI regardless of the existing
version
-silent — Runs batch in silent mode (use with -batch)
-noexecute — Allows installation of MSI but inhibits invocation of MSI
-nosplash — Suppresses splash screen at startup
-batch <file> — Performs installation in batch mode using the specified file
-batchverify <file/dir> — Performs verify in batch mode using the specified
file/directory
-batchremove <file/dir> — Performs removal in batch mode using the specified
file/directory
-input <file> — Sets MSI parameters according to the values in the specified
file.
Alternatively, on Linux, if you “unset HOME” before running install.<vco>, you are
prompted for a location to load the install software.

Tip: If you run into a situation where you already have the Install program installed and
need to either install a newer version or install to a new location, you can force the install
by using the command install.<vco> -force. The -force option enables you to install a
newer version of the Install program to another location or install an older version of the
Install program over top of a newer version.

Configuring the Remote Computer

To configure the remote computer:

1. On the remote computer, install IE3DLynx software and configure the licensing.

48 Managing Mentor Graphics IE3D Software, V15.0

 Installing Mentor Graphics Software
Installing the Install Program to an Alternative Location

2. Share the installation directory containing the docs and SDD_HOME directories so that
other computers on the network can access it. We recommend that you share the
directory with read-only permissions.
Example: Share the directory C:\MentorGraphics\<latest_release>.
Requirement: Log in with administrator privileges to share directories.

Installing Licensing on the Local Computer

Advanced floating license users who do not want to install licensing on the local computer can
manually set the MGLS_LICENSE_FILE or LM_LICENSE_FILE environment variable to
indicate the license file location. For information about setting the MGLS_LICENSE_FILE or
LM_LICENSE_FILE environment variable, see the Licensing chapter in this book, or refer to
the Licensing Environment Variables section in the Licensing Mentor Graphics Software
manual. This manual is available in the release_documents folder of the CD/web download and
on SupportNet.

Prerequisites
• Order and receive your Mentor Graphics licenses.
• For floating license users, install and start the floating license server before performing
the following instructions.

Procedure
To install licensing on the local computer:

1. If downloading the software from SupportNet:

a. Download the IE3DLynx software to a <release_name> folder on your computer.
b. Navigate to the directory where you downloaded the release to. Double-click
setup.exe to start the install program.
Alternatively, if you are installing from CD-ROM, insert the CD into your CD-ROM
drive. If the installation does not automatically start, select Start > Run, specify the CD-
ROM drive and install executable (for example D:\setup.exe) and click OK.
2. Click Install Products, review the license agreement and click Agree, select the paths
and click Next, clear all the check boxes, select the License Server check box and click
Next, and then click Install. The Welcome to Licensing dialog box opens.
3. Click Next.
4. If MGLS is not currently installed, the Choose Destination Location dialog box opens.
Accept the default location and click Next.
5. In the Configure Licensing dialog box, do one of the following:

Managing Mentor Graphics IE3D Software, V15.0 49

Installing Mentor Graphics Software
Installing the Install Program to an Alternative Location

• If you use node-locked licensing, click Typical. Type or browse to the license file
Mentor Graphics sent to you.
• If you use floating licensing, click Custom. In the Select configuration options
dialog box, select the 3. Define product license locations check box, and then click
Next. The Define product license location dialog box opens. Type the license
location(s) into the box and click Next.
6. To finish license configuration, perform any instructions that appear.
7. Run pcls_ok to verify the IE3DLynx features can be checked out.
a. Start menu > All Programs > Mentor Graphics Licensing > pcls_ok.
b. Type into the Feature box an INCREMENT name contained in the license file, such
as hyplsw or hypbsw, and then click Apply.

Configuring the Local Computer

To configure the local computer:

1. Create a local working directory and sub-directory named “hypfiles.”

Example: C:\IE3DLynx_local\hypfiles.
2. Create a shortcut that points to IE3DLynx application files on the remote computer by
doing the following:
a. Using Windows Explorer, navigate to the remote IE3DLynx application directory
that you shared in step 2 that contains bsw.exe, for example,
\\server1\MentorGraphics\ \SDD_HOME\IE3DLynx.
b. Right-click on bsw.exe and click Create Shortcut.
When the remote directory has read-only sharing permissions, Windows writes the
shortcut to the desktop on the local computer.
3. Specify the location of the bsw.ini file on the local computer by doing one of the
following:
• Append a command-line option to the shortcut you created in step b.
See also: Appending a Command-Line Option to the Shortcut
• Define the IE3DLynx_INI application environment variable.
See also: Setting Environment Variables
4. Specify the location of the IE3DLynx documentation by defining the documentation
environment variable.
See also: Defining Optional Documentation Environment Variables

50 Managing Mentor Graphics IE3D Software, V15.0

 Installing Mentor Graphics Software
Uninstalling Products

5. To run IE3DLynx, double-click the IE3DLynx shortcut on the desktop of the local
computer.

Appending a Command-Line Option to the Shortcut

To append a command-line option to the shortcut on the local computer's desktop:

1. Right-click on the shortcut and click Properties.

2. Click in the Target box, press <END>, and then do one of the following:
• If the shortcut points to the IE3DLynx application, type
-inif:<drive_letter>:\<local_working_directory>\bsw.ini
• If the shortcut points to the IE3DLynx tutorial, type
-inif:<drive_letter>:\<local_working_directory>\bsw_demo.ini
Example: If the remote shared directory is \\server1\IE3DLynx_remote and the local
working directory is C:\IE3DLynx_local, then the target line is:
\\server1\IE3DLynx_remote\bsw.exe -inif:C:\IE3DLynx_local\bsw.ini
Requirement: If <local_working_directory> contains spaces, enclose all of the text
related to the -inif command line switch with double quotes.
3. In the Start in box, type the local working directory.
4. Close the dialog box.

Uninstalling Products
To remove any or all products installed with the Mentor Graphics Install program:

On Windows systems, do the following:

1. From the Start Menu, select Settings > Control Panel > Add or Remove Programs.
2. Select Mentor Graphics Products. This launches the Install program in Remove mode
automatically where you can select the products to remove.
3. Select from:
• Sort by Target — Choose this sort option to list all targets you have installed to.
• Sort by Product — Choose this sort option to list all installed products.
4. Select individual, multiple, or Select All products to be removed.
5. Click Next to proceed to the Confirm Removal Selection window.
6. Click Remove.
The Install Program will offer to remove itself after the last product is removed.

Managing Mentor Graphics IE3D Software, V15.0 51

Installing Mentor Graphics Software
Uninstalling Products

7. Click Done.
On Linux systems, do the following:

1. Navigate to the directory where the Install program is located. The directory defaults to
$HOME/mgc/install.<vco> where <vco> is the platform. <vco> is “ixl” for Linux.
2. Invoke mgc_install. The Mentor Graphics Install dialog box opens.
3. Double-click setup.exe.
4. Select Products > Remove Products.
5. Select from:
• Sort by Target — Choose this sort option to list all targets you have installed to.
• Sort by Product — Choose this sort option to list all installed products.
6. Select individual, multiple, or Select All products to be removed.
7. Click Next to proceed to the Confirm Removal Selection window.
8. Click Remove.
9. Click Done.

52 Managing Mentor Graphics IE3D Software, V15.0

 Chapter 3
Managing Environment Settings

This chapter includes the following sections:

• “Understanding the Directory Structure” on page 53

o “Structural Overview” on page 53
• “Setting Environment Variables” on page 55
o “Setting SDD_ROOT (Optional)” on page 55
o “Setting SDD_HOME (is this applicable?)” on page 55
o “Setting IE3D_HOME” on page 56
o “Setting MGC_HOME” on page 56
o “Setting MGLS_LICENSE_FILE or LM_LICENSE_FILE” on page 57
“Managing Multiple Mentor Graphics Releases” on page 58

Understanding the Directory Structure

This section provides a general structural overview of a Mentor Graphics PCB tools installation.

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

Figure 3-1. Simple Tree Structure Example

MentorGraphics $SDD_Root

2010IE3D Flow Root Directory

docs Product docs / InfoHubs

SDD_HOME $SDD_HOME

IE3DLynx $IE3D_HOME (32 bit)

Managing Mentor Graphics IE3D Software, V15.0 53

Managing Environment Settings
Understanding the Directory Structure

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

• SDD_ROOT — Single root directory for Mentor Graphics PCB Software

This directory provides a single root for all Mentor Graphics PCB Software
installations. The SDD_ROOT contains the appropriate flow root(s). SDD_ROOT is the
same as the installation target.
You can choose to keep complete installs for multiple, different flows in sibling
directories under SDD_ROOT. On Windows, you can run the Configurator to choose
which flow you want to use. Remember to re-run the Configurator if you want to revert
to a different flow. Your environment settings and menus will be reconfigured to utilize
applications in the flow that you specify in the Configurator. On UNIX, you will need to
manually change your $MGC_HOME and/or $SDD_HOME environment variables to
switch between flows.

Note
This information applies to major releases only. Service Pack installations that are
installed into the same SDD_ROOT as a major release will overwrite the existing
version.

Caution
All Mentor Graphics SDD (Systems Design Division) product installs must be installed
into the same SDD_ROOT folder. SDD programs located in different SDD_ROOT
folders may not interoperate properly without special intervention. Refer to the
Configurator help file located at %SDD_ROOT%\win32\configurator.chm for
instructions on switching between flows.

• Flow Root Directory — Single directory for a specific release. The flow root tree,
indicated in Figure 3-1 by “ ”, is the directory containing MGC_HOME and
SDD_HOME trees. It exists one level below the SDD_ROOT. The flow root directory
does not have an associated environment variable.
• SDD_HOME — Directory for some Mentor Graphics tool installations. The
SDD_HOME variable points to the corresponding directory in the flow root according
to which flow you want to run.
For example on Windows, you might see C:\MentorGraphics\ \SDD_HOME where
SDD_ROOT is “C:\MentorGraphics” and the flow root is “ ”.

UNIX
Set SDD_HOME before invoking application software.

54 Managing Mentor Graphics IE3D Software, V15.0

 Managing Environment Settings
Setting Environment Variables

• IE3D_HOME — Directory containing IE3DLynx executable files. The directory name

depends on the operating system:
o “IE3DLynx” for 32-bit operating systems
o “IE3DLynx64” for 64-bit operating systems

Note
You do not need to set System Variable on Windows computers.

Setting Environment Variables

This 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 in
product-specific configuration manuals or release notes.

To set environment variables on Windows, go to Start > Settings > Control Panel > System >
Advanced > Environment Variables > (User variables area | System variables area)

• 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 on Linux are provided with each environment variable
below.

Setting SDD_ROOT (Optional)

This variable is the main directory for all Mentor Graphics PCB Software installations. It is the
same location as the target directory selected during the installation process.

It is not necessary to set this variable unless you have other non-PCB Mentor Graphics software
that needs to find PCB software applications.

For example, for Linux:

Bourne or Korn Shell:

$MGC_HOME=”$SDD_ROOT”/<flow_root>/MGC_HOME.vco
$export MGC_HOME
C-Shell:
% setenv MGC_HOME “$SDD_ROOT”/<flow_root>/MGC_HOME.vco

Setting SDD_HOME (is this applicable?)

Sets the environment variable that locates some Mentor Graphics product installations including
Expedition and DxDesigner.

Managing Mentor Graphics IE3D Software, V15.0 55

Managing Environment Settings
Setting Environment Variables

You are expected to set the SDD_HOME environment variable before invoking the application
software.

%SDD_HOME%=%SDD_ROOT%\ \SDD_HOME

For example:

C:\MentorGraphics\ \SDD_HOME

Note
The Configurator sets the SDD_HOME environment variable for you.

Setting IE3D_HOME
To enable Mentor Graphics flow releases to interact with IE3DLynx on Linux or UNIX
computers, set the System Variable (what is it called )environment variable on the computer
with the flow release software. For example, you might do this when exporting LineSim
schematics from Expedition.

Note
You do not need to set IE3D_HOME on Windows computers.

You are expected to set the IE3D_HOME environment variable before invoking the application
software.

Bourne or Korn Shell:

$HYP_HOME=”$SDD_HOME”/IE3DLynx
$export IE3D_HOME
C-Shell:
% setenv HYP_HOME “$SDD_HOME”/ie3dlynx

Setting MGC_HOME
The environment variable that locates some Mentor Graphics product installations.

You are expected to set the MGC_HOME environment variables before invoking the
application software.

For example:

Note
The Configurator sets the MGC_HOME environment variable for you.

56 Managing Mentor Graphics IE3D Software, V15.0

 Managing Environment Settings
Setting Environment Variables

Setting MGLS_LICENSE_FILE or LM_LICENSE_FILE

Mentor Graphics supports two licensing environment variables, MGLS_LICENSE_FILE and
LM_LICENSE_FILE.

Note
MGLS_LICENSE_FILE should be used as the default licensing environment variable for
Mentor Graphics products.

You are encouraged to use MGLS_LICENSE_FILE for optimum performance of Mentor

Graphics applications. Only Mentor Graphics software recognizes MGLS_LICENSE_FILE;
software from other vendors that use FlexNet will ignore it and use their own custom variable or
LM_LICENSE_FILE instead. Using MGLS_LICENSE_FILE to point only to licenses for your
Mentor Graphics tools speeds the license checkout process and other licensing-related activity.
The standard FlexNet Licensing commands such as lmutil, lmstat and lmreread do not
recognize the MGLS_LICENSE_FILE variable. Those commands should be explicitly pointed
to the license location using a “-c” switch.

For example, in DOS the command is: lmutil lmstat -c %MGLS_LICENSE_FILE%

MGLS_LICENSE_FILE and LM_LICENSE_FILE have the same syntax.

On Linux, use a colon (:) to separate independent license sources. For example:

license_file_pathname1:license_file_pathnameN:port@host1:port@hostN

On Windows, use a semicolon (;) rather than a colon (:) as the path separator for independent
servers. For example:

license_file_pathname1;license_file_pathnameN;port@host1;port@hostN

Bourne shell:

% MGLS_LICENSE_FILE=<port>@<host>
% export MGLS_LICENSE_FILE

C-shell:

% setenv MGLS_LICENSE_FILE <port>@<host>

LM_LICENSE_FILE is the FlexNet Licensing standard environment variable used by the

license server and application to determine the location of license data files.
LM_LICENSE_FILE is the FlexNet default, although MGLS_LICENSE_FILE is the
recommended variable. You can use LM_LICENSE_FILE on client workstations to allow
applications invoked on those workstations to use a license file not stored in the default location
or to point to one or more license servers.

Managing Mentor Graphics IE3D Software, V15.0 57

Managing Environment Settings
Managing Multiple Mentor Graphics Releases

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

On Linux, when MGLS_LICENSE_FILE is set, Mentor Graphics tools do not use

LM_LICENSE_FILE. All mgcld licenses that you want to access must be included in the value
of MGLS_LICENSE_FILE. Other vendor’s tools are not affected and will read their own
variables or LM_LICENSE_FILE as usual.

In some environments, you may combine the FlexNet licensing information for several vendors
into a single license file. The default locations is:

• Windows — C:\flexlm\license.dat
For additional information on these variables or redundant license server configurations, refer to
the Licensing Mentor Graphics Software manual available from the release_documents
directory on the CD-ROM or from SupportNet.

Managing Multiple Mentor Graphics Releases

The directory structure for Mentor Graphics PCB software allows you to install multiple
releases under one umbrella directory (the recommended install method is to accept the default
installation directories). The following guidelines apply:

• Products distributed on the same CD-ROM interoperate and can be installed in a single
target location.
• Mentor Graphics PCB Software may co-exist with non-PCB software installed in the
same MGC_HOME directory.

58 Managing Mentor Graphics IE3D Software, V15.0

 Chapter 4
Managing Mentor Graphics Documentation

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

• “Understanding the Documentation Tree Structure” on page 59

• “Defining Optional Documentation Environment Variables” on page 61
o “Setting Variables on Windows” on page 62
o “Setting Variables on Linux” on page 62
“Using the Mentor Graphics Documentation System” on page 62

o “Accessing the Mentor Graphics Documentation System” on page 63

o “Finding Answers with PDF Documentation” on page 63
• “Required Internet Explorer Option with Windows XP SP2” on page 64
o “Permanent Workaround” on page 65
o “Temporary Workaround” on page 65

Understanding the Documentation Tree

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

The typical Mentor Graphics Documentation System has the following directory structure. The
documentation 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 directory

structure.

Managing Mentor Graphics IE3D Software, V15.0 59

Managing Mentor Graphics Documentation
Understanding the Documentation Tree Structure

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

{root of product installation}

|
|-- bin
| |-- mgcdocs (Linux only)
|
|-- docs|doc|shared
| |-- asciidocs
| |-- data
| |-- infohubs
| | |-- {ih_handle1}_ih
| | |-- {ih_handle2}_ih
| |
| |-- movies
| | |-- {handleM}
| | |-- {handleM}.html
| |
| |-- pdfdocs
| | |-- {handleA}.pdf
| | |-- {handleB}.pdf

For the IE3D releases, the Mentor Graphics Documentation System has a slightly modified
directory structure. The top-level of the documentation installation begins under the
$SDD_HOME directory. For example:

MentorGraphics ($SDD_ROOT)
|
|--
|-- docs
|-- SDD_HOME ($SDD_HOME)

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_ An ASCII file that typically contains release notes. This
<handle>.txt practice of shipping ASCII release notes is used by some
products.
htmldocs/<handle> A unique directory for the HTML documentation equivalent of
the pdfdocs/<handle>.pdf file. If opening the HTML
documentation directly, open the wwhelp.htm file. If your
documentation system is PDF and PDF Help topics, you will
not have HTML documentation.
infohubs/<handle>_ih A unique directory for the InfoHub information center. Some
products 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 II
Release Notes is qsim_rn.pdf.

60 Managing Mentor Graphics IE3D Software, V15.0

 Managing Mentor Graphics Documentation
Defining Optional Documentation Environment Variables

Defining Optional Documentation Environment

Variables
Many of the Mentor Graphics applications support an optional set of environment variables to
control 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 documentation
installation (docs | doc | shared) containing infohubs, htmldocs, and pdfdocs sub-
directories. Do not include infohubs, htmldocs, or pdfdocs as part of the path value. For
example:
Windows — Set MGC_DOC_PATH to “C:\MentorGraphics\ \docs”
Linux — Set MGC_DOC_PATH to /server1/ /docs
For more information on the documentation installation structure, refer to “Required
Internet Explorer Option with Windows XP SP2” on page 64.
• MGC_HTML_BROWSER — Specifies the web browser to use for displaying HTML
documentation and is used to override the default order of browser selection. This
environment variable gives you control as to which browser the MGC tool invokes
when InfoHub, or a help topic, is called. By default, the following browsers are searched
for in the specified order: Firefox, Mozilla, Netscape, then Internet Explorer. You set
this variable to either the full path of a supported web browser executable, or simply to
the name of the browser executable (if it can be found with the PATH variable). For
example:
Windows — Set MGC_HTML_BROWSER to “C:\Program Files\Mozilla
Firefox\firefox.exe”
Linux — Set MGC_HTML_BROWSER to “firefox”
• MGC_PDF_READER — Specifies the viewer to use for PDF documentation. You set
this 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\Acrobat
7.0\Reader\AcroRd32.exe”
Linux — Set MGC_PDF_READER to “/opt/Acrobat7/bin/acroread”

Managing Mentor Graphics IE3D Software, V15.0 61

Managing Mentor Graphics Documentation
Using the Mentor Graphics Documentation System

Setting Variables on Windows

To 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 Linux

The syntax to set an environment variable in Korn and Bourne shells is different than that of a
C-Shell. In Korn and Bourne shells, set environment variables as follows:

VARIABLE_NAME=variable_value
export VARIABLE_NAME

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

setenv VARIABLE_NAME variable_value

Using the Mentor Graphics Documentation

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

• Help & Manuals — User and Reference manuals, Process guides, and other types of
documentation, delivered in both HTML and PDF formats. Mentor Graphics provides
the 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 on
the HTML interface, refer to “Finding Answers with PDF Documentation” on page 63.

Note
The Mentor Graphics Documentation System requires a browser and Adobe Acrobat
Reader. 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 index
plug-in to use the Mentor Graphics Documentation System.

62 Managing Mentor Graphics IE3D Software, V15.0

 Managing Mentor Graphics Documentation
Using the Mentor Graphics Documentation System

Accessing the Mentor Graphics Documentation System

You 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.)
• Shell command — On Linux platforms, enter “mgcdocs” at the prompt or invoke a tool
with the -Manual invocation switch.
• Start menu — On Windows platforms, select Start > Programs > Mentor Graphics
and navigate to the documentation option. (The actual text of the documentation option
may vary.)
• File system — Access the Mentor Graphics documentation system directly from the file
system, without invoking the Mentor Graphics tool. From your product installation, load
the following file into a browser:
../docs|doc|shared/infohubs/index.html

Finding Answers with PDF Documentation

The PDF directory is designed to give you quick access to documentation. You can browse the
list of all documentation installed with your product, or submit a search query using Acrobat
Reader.

1. Launch the Acrobat Reader

2. Choose Find > Search
3. In the Search window select "In the current PDF document" or "All PDF Documents in".
If you use "All PDF Documents in" select the directory (Figure 4-1 on page 60).
4. Select other options:
o Whole words only
o Case-Sensitive
o Include Bookmarks
o Include Comments
5. Type in the word or phrase in the "What word or phrase would you like to search for?"
search field. Use "Browse for Location" selection as needed.
6. Click the Search button.

Managing Mentor Graphics IE3D Software, V15.0 63

Managing Mentor Graphics Documentation
Required Internet Explorer Option with Windows XP SP2

Required Internet Explorer Option with Windows

XP SP2
Windows XP Service Pack 2 (SP2) contains security enhancements that directly affect the
behavior of Internet Explorer (IE). If you have installed SP2, IE restricts access to locally
installed Mentor Graphics browser-based documentation. When you try to access the Mentor
Graphics InfoHub or other browser-based documentation, you will get the following messages
in IE:

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

Note
This security restriction is exclusive to following conditions:

SP2
IE
locally 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.

64 Managing Mentor Graphics IE3D Software, V15.0

 Managing Mentor Graphics Documentation
Required Internet Explorer Option with Windows XP SP2

Note
FireFox and Netscape do not exhibit this security restriction and are adequate alternatives
to Internet Explorer.

Permanent Workaround
With one option in IE, you can permanently bypass the security restriction and access
the 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 Workaround
The following workaround allows you to access the documentation without changing your
Internet 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>/ /docs/infohubs/index.html

where <install_dir> is the target directory where you installed the Mentor Graphics
application 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.

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

Managing Mentor Graphics IE3D Software, V15.0 65

Managing Mentor Graphics Documentation
Required Internet Explorer Option with Windows XP SP2

66 Managing Mentor Graphics IE3D Software, V15.0

 Chapter 5
Troubleshooting

This section covers some frequently encountered problems, with their possible causes and
solutions. This section includes:

• “Mentor Graphics SupportNet” on page 67

• “Troubleshooting OpenGL Problems” on page 68 (is this used?)
• “Troubleshooting Common Errors” on page 70
• “Troubleshooting Common Problems” on page 72
• “Troubleshooting X” on page 74

Mentor Graphics SupportNet

Mentor Graphics software support includes software enhancements, technical support, access to
comprehensive 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 search
thousands of technical solutions, view documentation, or open a Service Request online at:

http://supportnet.mentor.com/

If your site is under current support and you do not have a SupportNet login, you may easily
register 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/

Managing Mentor Graphics IE3D Software, V15.0 67

Troubleshooting
Troubleshooting OpenGL Problems

Troubleshooting OpenGL Problems

IE3DLynx requires OpenGL library 1.1 or newer to display 3-D results in the PowerScope and
Eye Density Viewer. If OpenGL is unavailable to the PowerScope, for example, it displays the
message “Failed to run PowerScope: OpenGL is not installed.”

This problem can result from the following conditions:

• You are running IE3DLynx on a computer without OpenGL. See “Checking for
OpenGL” on page 68 and “Installing OpenGL” on page 68.
• You use a remote display from the Linux computer to another computer or remote
viewing software (such as VNC viewer) that does not natively support OpenGL. See
“Workaround for Remote Display” on page 69.

Checking for OpenGL

OpenGL is supported natively on Windows, but is not always available on Linux.

To check for OpenGL on a Linux computer, do the following:

1. In the command shell used to run IE3DLynx, run the following command:
xdpyinfo

A long list results.

2. Below the “number of extensions” string in the list, look for GLX. For example:
number of extensions: 32
BIG-REQUESTS
DOUBLE-BUFFER
DPMS
GLX
LBX

If GLX is present, it is already installed on the computer and available to the display.
If GLX is not present, it could be installed but not active for the current display. To
verify, attach to the :0 display with VNC Viewer or other remote display software and
run step 1 again.

Installing OpenGL
One way to install OpenGL, is to get the Mesa 3D graphics library. The software package is
available as a free download from http://www.mesa3d.org/. The software must be compiled for
your system. Perform the directions included with the package to build and install the Stand-
alone/Xlib mode libraries. This builds a libGL.so and several other libraries and puts them in the
directory specified by the INSTALL_DIR environment variable. Put the new libraries in a

68 Managing Mentor Graphics IE3D Software, V15.0

 Troubleshooting
Troubleshooting OpenGL Problems

separate directory, such as /usr/local/lib, so that similar libraries provided by the operating
system in /usr/lib are not overwritten by these new files.

Once the libraries are installed, modify the user environment to point to this new location before
the vncserver is started. This is done by adding the location of the Mesa 3D libraries to the
beginning of the LD_LIBRARY_PATH variable.

For example in a csh:

setenv LD_LIBRARY_PATH /usr/local/mesa73/lib:/lib:/usr/lib

vncserver

This causes the vncserver process to use the Mesa 3D libraries instead of the operating system
supplied ones so that the OpenGL capability is provided to the vncserver process when needed
by the application being displayed remotely.

Workaround for Remote Display

This workaround uses remote desktop settings to use OpenGL libraries located on the remote
computer to display 3-D results on the local computer.

If the procedure below does not work, you may have to install OpenGL on the local computer.
See “Installing OpenGL” on page 68.

Procedure
1. On the remote computer, select System | Applications > Preferences > Remote
Desktop.
The Remote Desktop Preferences dialog box opens.
2. Select Allow other users to view your desktop.
3. Select Allow other users to control your desktop.
4. Optionally, enable a password and disable the “Ask you for confirmation” option.
5. Save your changes.
Result: OpenGL is active in the connection.
6. With VNC Viewer or other remote display software, attach to the :0 display.

Managing Mentor Graphics IE3D Software, V15.0 69

Troubleshooting
Troubleshooting Common Errors

Troubleshooting Common Errors

Table 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 the You must update your Exit the Mentor Graphics
Install program on your version of the Mentor Install program and refer to
system is out of date. There Graphics Install either the web-based
is a newer version of the program from the “Installation Instructions”
Install program available on latest installation on the SupportNet
the latest installation media. media. download web page, or the
CD booklet available with
all installation media.
CP00030 The Mentor Graphics Install The Install program The installData.xml.gz file
program encountered an will not proceed needs to be in the Mentor
error while trying to read further. Graphics Install data
the startup data. directory (it may have been
moved or renamed). Best to
reinstall the latest Mentor
Install Program.
IPW112 An error occurred when the The Installation script If you are installing from
IPW113 Install program tried to archive could not be CD-ROM, make sure the
open a script archive file. found, therefore the Volume 1 CD-ROM is
Install program will available and click Retry.
not proceed. Selecting Cancel will
cancel the installation.
IPW114 A file write error occurred. The Install program One of two things could be
cannot write to the causing this:
specified file. 1. The file (or directory the
file is in) may not have
write permissions.
Verify that permissions
are open on the
file/directory and select
Retry to continue the
installation. Selecting
Cancel will cancel the
installation.
2. The disk may be full.

70 Managing Mentor Graphics IE3D Software, V15.0

 Troubleshooting
Troubleshooting Common Errors

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

Error # Problem Result Solution
IPW116 An error occurred while The Install program Check for the following:
attempting to write to a file. could not write to the • Ensure write
specified file and permissions are
installation is being available
cancelled. • Check that the disk is
not full
• Verify the path to the
file. If the path was
correct, contact
Customer Support and
provide them with the
details and error
#IPW116.
IPW118 An error occurred while The Install program Check for the following:
attempting to write to a file. could not write to the • Ensure write
specified file and permissions are
installation is being available
cancelled. • Check that disk is not
full
• Verify the path to the
file. If the path was
correct, contact
Customer Support and
provide them with the
details and error
#IPW118.
IPW122 A file write/read error The Install program One of two things could be
IPW123 occurred. cannot write/read to causing this:
the specified file. 1. The file (or directory the
file is in) may not have
write permissions.
Verify that permissions
are open on the
file/directory and select
Retry to continue the
installation. Selecting
Cancel will cancel the
installation.
2. Disk may be full.

Managing Mentor Graphics IE3D Software, V15.0 71

Troubleshooting
Troubleshooting Common Problems

Troubleshooting Common Problems

Table 5-2 shows some frequently encountered problems, with their possible causes and
solutions. For additional help, consult applicable vendor manuals or consult SupportNet.

Table 5-2. Troubleshooting Common Problems

Possible
Problem Platform Cause Solution
During Product Linux May not be Verify the correct Target location is included
Removal, Windows pointing at the in the Product Removal Selection window. If
Product or appropriate not, exit the Remove Products function.
Release is not Target Select Tools > Set Target List and add the
visible in the location. appropriate Target location. Select Done.
Install program. Now, select Products > Remove Products
and proceed with product removal.
Unable to click in Linux The sensitivity Decrease the sensitivity of your mouse (so
a checkbox. Windows setting for the mouse moves slower) in your Control
your mouse is Panel.
set incorrectly
for this Java
application.

Unable to install Linux A version of Run setup.exe -force. The -force option
an older version Windows the Install enables you to install a newer version of the
of the Mentor program Install program to another location or install
Graphics Install already exists. an older version of the Install program over
program over a top of a newer version.
newer version.
Unable to install Linux A version of Run setup.exe -msiloc. The -msiloc option
MIP to an Windows the Install enables you to install the Mentor Install
alternate program program to an alternate location.
location. already exists.

72 Managing Mentor Graphics IE3D Software, V15.0

 Troubleshooting
Troubleshooting Common Problems

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

Possible
Problem (cont.) Platform Cause (cont.) Solution (cont.)
When trying to Linux There are not You may need to increase the number of
run ICX Pro enough semaphores available for the operating
Explorer or semaphores system. To check the current settings, run
DxDesigner, get available. the following command (as root):
the following /sbin/sysctl -a | grep kernel.sem
error in console: The default value is 'kernel.sem = 250 32000
32 128'. However, there may be other factors
sem_lock- such as third-party applications or the
>semop->op_op: number of users on the system that could
Invalid argument make the default settings inadequate. To
make a temporary increase to the number of
semaphores, run the following command: #
echo "2048 40000 32 32000" >
/proc/sys/kernel/sem
This will temporarily increase the number of
semaphores and allow you to try the new
settings to verify they work. NOTE: This
method does not make the settings
permanent. Assuming the new values work
you can make them permanent by modifying
the /etc/sysctl.conf file. Add the following
line: kernel.sem = 2048 40000 32 32000 The
command '/sbin/sysctl -p' will re-read the
sysctl.conf file and make the changes
available immediately without rebooting.
These values are now the new default when
the system boots up. Consult vendor
documentation for specific information
about what your application requires.

Managing Mentor Graphics IE3D Software, V15.0 73

Troubleshooting
Troubleshooting X

Troubleshooting X
Table 5-3 shows some frequently encountered problems, with their possible causes and
solutions. For additional help, consult your X vendor manuals or consult SupportNet.

Table 5-3. Troubleshooting X Display/X Host Setup

Problem Platform Possible Cause Solution
“Can’t open display” or Linux No value set for Set the DISPLAY
similar message received on the DISPLAY environment variable.
attempt to execute first environment
remote client. variable. In a Bourne or Korn shell,
type:

DISPLAY=
<your_X_display_name>:0.0

export DISPLAY
Linux DISPLAY Reset the DISPLAY
environment environment variable so it
variable lacking includes the “:0.0” syntax.
“:0”
Linux Display machine Run xhost command. Refer
Windows not permitting to the xhost(1) manual page
access. for workstations and the
vendor’s documentation for
terminals and PCs.
Linux X display’s name Add name to host database.
Windows not known to X
host.
Linux For ICX and From the desktop , enable
TAU, TCP TCP connections.
connections for X 1. Edit
are not enabled. /etc/X11/gdm/gdm.conf
and change the line that
reads:
#DisallowTCP=true to
Disallow TCP=false
2. Reboot
“Out of memory,” “no Linux Not enough swap Increase the swap space on
swap,” or “No space left on space on the X the X host and reboot, if
device” message received. host to invoke the necessary.
application.

74 Managing Mentor Graphics IE3D Software, V15.0

 Troubleshooting
Troubleshooting X

Table 5-3. Troubleshooting X Display/X Host Setup (cont.)

Problem (cont.) Platform Possible Cause Solution (cont.)
The X display cannot run an Linux Many possible Contact your X vendor.
xterm or other generic X causes.
command on the X host.
The X host cannot bring up Linux May be Refer to the appropriate
a Mentor Graphics application setup. Mentor Graphics
application. application manual(s).
Failed to connect server. Linux For XtremePCB, Disable the firewall. Search
XDS error: Socket Windows the firewall is SupportNet for information
connection failed to address enabled. on disabling the firewall.
XtremeDesignClient has Linux For XtremePCB, Disable the firewall. Search
failed to start Windows the firewall is SupportNet for information
enabled. on disabling the firewall.

Managing Mentor Graphics IE3D Software, V15.0 75

Troubleshooting
Troubleshooting X

76 Managing Mentor Graphics IE3D Software, V15.0

 Appendix
Printing Mentor Graphics Documentation

This chapter describes how to print Mentor Graphics documentation. The chapter is organized
as follows:

• “Printing IE3DLynx Products Documentation” on page 77

o “Printing a PDF Document” on page 78
o “Printing from Online Help” on page 78
• “Printing from Linux Using MainWin” on page 79
o “Using the Visual MainWin Control Panel to Configure Printers” on page 80
o “Setting Up Printers” on page 80

Printing IE3DLynx Products Documentation

IE3DLynx uses HTML and PDF as the main documentation formats. A process guide in PDF
provides conceptual information on typical workflows through the software tools. You can
obtain a hardcopy version of any process guide or online help using the associated printing
capabilities.

Documentation appears in a documentation directory in this release. You can access the PDF
documentation using an InfoHub. In a browser, open the following file:

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

SupportNet also contains the latest versions of IE3DLynx documentation, along with
TechNotes and AppNotes.

Managing Mentor Graphics IE3D Software, V15.0 77

Printing Mentor Graphics Documentation
Printing IE3DLynx Products Documentation

Printing a PDF Document

Use the following steps to print a process guide in PDF:

1. In a browser, open the file:

<install_dir>/ /docs/infohubs/index.html
2. Select a document from the list within the Help and Manuals tab and click the PDF
button for that list. The document you selected opens in the Adobe Acrobat Reader.
3. Click File > Print in Adobe Acrobat Reader to display the Print dialog box. Print the
entire document or specific pages using settings in this dialog box.
4. Click OK to submit the print job you specified to the print queue.

Printing from Online Help

Use the following procedures to print online help topics or print an individual help topic:

1. Open a Mentor Graphics application.

2. Select the Help menu in toolbar, then choose the Contents or Help Topics menu item.
The Table of Contents displays topics organized by category in the Contents tab.
3. Click the Book icon or the category name to print all topics within a category. The
category highlights.
4. Click Print to display the Print dialog box.
5. Select a valid printer in the Name field and specify the number of copies to print.

Tip: In WinHelp 4.0, a book icon indicates that topics are available within that category.

6. Click Properties to customize the print characteristics. For example, for duplex
printing, select the duplex printing option.
7. Click OK to submit a job to the print queue containing all topics within that category.
The help window displays the topics that are submitted to the print queue. Click Cancel
in the Print Topic information box to stop the print job and remove it from the printer
queue.
8. Click Cancel to dismiss the online help window.

78 Managing Mentor Graphics IE3D Software, V15.0

 Printing Mentor Graphics Documentation
Printing from Linux Using MainWin

To print all help:

1. Right-click the top-level heading, and then select Print or use the Print option from the
popup that displays.
2. Select Print the selected heading and all subtopics and select OK.

To print a specific heading:

1. Right-click a lower-level heading, and then select Print.
2. Select Print the selected heading and all subtopics and select OK.

To print a single topic:

1. Right-click a topic, and then select Print.
2. Select Print the selected topic and then select OK.

Printing from Linux Using MainWin

Printer configuration processes for Linux are different from Windows. The print setup/print
dialogs are identical to Windows with the exception of the Properties menu options. Solaris,
HP-UX and Linux require the configuration utility “MWCONTROL” for new printer
configuration.

Note
Only PostScript printers are supported. When printing to some printers that support
Adobe PostScript Emulation, the printer may output an error that reads:

“Offending Command = ~Error = nametype : undefined”.

To correct this problem, set an environment variable:

MWPOSTSCRIPT_LEVEL1=true

The printing environment on Linux is accomplished by a “default” setup, or may require user
definitions within the application-specific MWCONTROL utility. Registry information that is
similar to the Windows Registry is supported.

Caution
You MUST use the Visual MainWin Control Panel to configure printers for this release.
MWCONTROL is the utility behind the Visual MainWin Control Panel. The interface
contains applets used to configure the application and the system settings required by the
application.

Managing Mentor Graphics IE3D Software, V15.0 79

Printing Mentor Graphics Documentation
Printing from Linux Using MainWin

The printer settings are stored in the current user and machine settings portion of the registry,
depending on the parameters affected.

Requirement: If only one system printer is configured with Admintools, the File > Print
dialog printer specification “Generic Postscript” will print to the system “default” printer. The
generic postscript printer options within the MWCONTROL interface may require editing the
print command line lpr; rm %s.

Using the Visual MainWin Control Panel to Configure

Printers
1. Change the directory to $SDD_HOME/common/<platform>/bin/.
2. Type the following command at the UNIX command line:
sddmwcontrol

sddmwcontrol is a wrapper script used to setup the environment and then launch
MWCONTROL. The Visual MainWin Control Panel appears.

Setting Up Printers
The Visual MainWin Control Panel Printers applet is similar to the Windows Printers applet.
However, unlike Windows, when setting up a printer you do not map an actual printer for use
with your application. Instead, you map a print request to a proper print command on your
Linux host.

Requirement: PostScript Printer Description (PPD) files describe how to use the special
features for a specific PostScript printer. To take advantage of your printer’s specific features,
you need the PPD file. Most printer vendors provide PPD files for their printers.

For your convenience, Visual MainWin Control Panel supplies a large subset of the PPD files
that are included with Windows. In addition, a PPD file for generic PostScript printers, which
should allow you to print on any PostScript printer, is also provided. The Visual MainWin
Printers applet includes an Add Printer wizard.

To add a printer using the Add Printer Wizard:

1. Launch the Visual MainWin Control Panel.

2. Double-click Printers to open the MainWin Printers applet.
3. Double-click Add New Printer to start the Add New Printer wizard, and then click
Next.

80 Managing Mentor Graphics IE3D Software, V15.0

 Printing Mentor Graphics Documentation
Printing from Linux Using MainWin

Figure 5-1. Adding a Printer

1
Launch Visual
MainWin
Control Panel.

2
Double-click
Printers.

3
Double-click
Add New
Printer.

4. Specify the UNIX printer to which you want to print (Figure 5-2). A list of the printers
defined on the UNIX host appears. If the printer you want to add is on the list, select it.
To add a printer that does not appear on the list, type the UNIX name of the printer in the
UNIX printer text box. The printer name should be keyed using the same printer name
as used in the System Print Manager or Admintools Interface.

Figure 5-2. Identify UNIX Printer

4
Specify the
UNIX printer.

Managing Mentor Graphics IE3D Software, V15.0 81

Printing Mentor Graphics Documentation
Printing from Linux Using MainWin

The list of printers is extracted from the /etc/printcap file, which contains a list of all
printers on the network to which your UNIX host has access. The printcap file is used on
UNIX platforms as the central location for specifying printers. It is configured and
maintained by the system administrator. If your system does not have the printcap file
and there are no printers listed, then you should manually add the UNIX name of the
printer.

Note
Some UNIX operating systems do not support /etc/printcap files. Solaris and HP-UX
support /etc/printers.conf.

5. Confirm the print command, and click Next.

The default print command for the selected printer appears in the Print Command text
box (Figure 5-3). Usually, the default command is the one you should use. You may
need to modify the command depending on the UNIX OS the system is running.
The lpr -P <printername>; rm %s command may need to be modified to lp -d
<printername>; rm %s. The lp and lpr UNIX print commands sometimes reside in a
directory other than /bin and the <path> may need to be added to the command line. For
example:
/usr/ucb/lpr -P <printername>; rm %s
The UNIX print command lp should work with all UNIX OS systems.
If you manually added a UNIX name in the previous step, the print command will
automatically use that name.

Figure 5-3. Print Command Dialog

5
Confirm the
Print command.

82 Managing Mentor Graphics IE3D Software, V15.0

 Printing Mentor Graphics Documentation
Printing from Linux Using MainWin

6. Select the manufacturer and model of your printer as shown in Figure 5-4, and then click
Next. If, however, you have your own PPD file, then click Choose File to locate your
PPD file. After entering the file’s full pathname, click OK.
If you use your own PPD file, you must have write permission to the directory
/MentorGraphics/ /common/<OS Type>/mw502/system/ppd.

Figure 5-4. Choose PPD File Dialog

6
Select the
manufacturer
and model of
your printer.

7. Specify a name for the printer, and then click Next.

The Add Printer wizard provides a default printer name, which may be modified in the
Printer Name text box. The Printer Description text box has the same functionality as on
Windows.
8. Decide whether you want this printer to be your default printer, and then click Next.
This Default Printer page will not appear in the wizard if this is the first printer you are
setting up. When you add another printer, then you will choose your default printer.
9. Decide whether or not to print a test page, and then click Next.
Printing a test page (same as in Windows) supplies you with various information, such
as the features of the added printer.
10. Verify the information you specified in the Add Printer wizard is correct. If you are
satisfied with the settings, click Finish. Otherwise, click Back to change the settings.
The printer you added now appears in the list of printers. These printers will now show
in the File > Print Setup and File > Print dialogs.

Managing Mentor Graphics IE3D Software, V15.0 83

Printing Mentor Graphics Documentation
Printing from Linux Using MainWin

Figure 5-5. Verify Printer Information

10
Verify
information
is correct.

84 Managing Mentor Graphics IE3D Software, V15.0

 End-User License Agreement
The latest version of the End-User License Agreement is available on-line at:
www.mentor.com/eula

IMPORTANT INFORMATION

USE OF ALL SOFTWARE IS SUBJECT TO LICENSE RESTRICTIONS. CAREFULLY READ THIS

LICENSE AGREEMENT BEFORE USING THE PRODUCTS. USE OF SOFTWARE INDICATES
CUSTOMER’S COMPLETE AND UNCONDITIONAL ACCEPTANCE OF THE TERMS AND
CONDITIONS SET FORTH IN THIS AGREEMENT. ANY ADDITIONAL OR DIFFERENT PURCHASE
ORDER TERMS AND CONDITIONS SHALL NOT APPLY.

END-USER LICENSE AGREEMENT (“Agreement”)

This is a legal agreement concerning the use of Software (as defined in Section 2) and hardware (collectively
“Products”) between the company acquiring the Products (“Customer”), and the Mentor Graphics entity that
issued the corresponding quotation or, if no quotation was issued, the applicable local Mentor Graphics entity
(“Mentor Graphics”). Except for license agreements related to the subject matter of this license agreement which
are physically signed by Customer and an authorized 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. If Customer does not agree to these terms and conditions, promptly return
or, in the case of Software received electronically, certify destruction of Software and all accompanying items
within five days after receipt of Software and receive a full refund of any license fee paid.

1. ORDERS, FEES AND PAYMENT.

1.1. To the extent Customer (or if agreed by Mentor Graphics, Customer’s appointed third party buying agent) places and
Mentor Graphics accepts purchase orders pursuant to this Agreement (“Order(s)”), each Order will constitute a contract
between Customer and Mentor Graphics, which shall be governed solely and exclusively by the terms and conditions of this
Agreement, any applicable addenda and the applicable quotation, whether or not these documents are referenced on the
Order. Any additional or conflicting terms and conditions appearing on an Order will not be effective unless agreed in
writing 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 such
invoice. Any past due invoices will be subject to the imposition of interest charges in the amount of one and one-half
percent 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 state separately in the applicable
invoice(s). Unless timely provided with a valid certificate of exemption or other evidence that items are not taxable, Mentor
Graphics will invoice Customer for all applicable taxes including, but not limited to, VAT, GST, sales tax and service tax.
Customer will make all payments free and clear of, and without reduction for, any withholding or other taxes; any such
taxes imposed on payments by Customer hereunder will be Customer’s sole responsibility. If Customer appoints a third
party to place purchase orders and/or make payments on Customer’s behalf, Customer shall be liable for payment under
Orders placed by such third party in the event of default.
1.3. All Products are delivered FCA factory (Incoterms 2000), freight prepaid and invoiced to Customer, except Software
delivered electronically, which shall be deemed delivered when made available to Customer for download. Mentor
Graphics retains a security interest in all Products delivered under this Agreement, to secure payment of the purchase price
of such Products, and Customer agrees to sign any documents that Mentor Graphics determines to be necessary or
convenient for use in filing or perfecting such security interest. Mentor Graphics’ delivery of Software by electronic means
is subject to Customer’s provision of both a primary and 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, trade
secret and confidential information of Mentor Graphics or its licensors, who maintain exclusive title to all Software and retain
all rights not expressly granted by this Agreement. Mentor Graphics grants to Customer, subject to payment of applicable
license fees, a nontransferable, nonexclusive license to use Software solely: (a) in machine-readable, object-code form (except
as provided in Subsection 5.2); (b) for Customer’s internal business purposes; (c) for the term of the license; and (d) on the
computer hardware and at the site authorized by Mentor Graphics. A site is restricted to a one-half mile (800 meter) radius.
Customer may have Software temporarily used by an employee for telecommuting purposes from locations other than a
Customer office, such as the employee's residence, an airport or 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 a single session by a single user on the authorized hardware or for
a restricted period of time (such limitations may be technically implemented through the use of authorization codes or similar
devices); and (c) support services provided, including eligibility to receive telephone support, updates, modifications, and
revisions. For the avoidance of doubt, if Customer requests any change or enhancement to Software, whether in the course of
 receiving support or consulting services, evaluating Software, performing beta testing or otherwise, any inventions, product
improvements, modifications or developments made by Mentor Graphics (at Mentor Graphics’ 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’ Embedded
Software Channel (“ESC”), Mentor Graphics grants to Customer a nontransferable, nonexclusive license to reproduce and
distribute 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. Mentor
Graphics does NOT grant Customer any right to duplicate, incorporate or embed copies of Mentor Graphics’ real-time operating
systems or other embedded software products into Customer’s products or applications without first signing or otherwise
agreeing 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 not
be used without Mentor Graphics’ explicit authorization. Upon Mentor Graphics’ authorization, Mentor Graphics grants to
Customer a temporary, nontransferable, nonexclusive license for experimental use to test and evaluate the Beta Code
without charge for a limited period of time specified by Mentor Graphics. This grant and Customer’s use of the Beta Code
shall not be construed as marketing or offering to sell a license to the Beta Code, which Mentor Graphics may choose not to
release 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 under
normal conditions as directed by Mentor Graphics. Customer will contact Mentor Graphics periodically during Customer’s
use of the Beta Code to discuss any malfunctions or suggested improvements. Upon completion of Customer’s evaluation
and 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 to maintain Beta Code in confidence and shall restrict access to the Beta Code, including the methods and
concepts utilized therein, solely to those employees and Customer location(s) authorized by Mentor Graphics to perform
beta testing. Customer agrees that any written evaluations and all inventions, product improvements, modifications or
developments that Mentor Graphics conceived or made during or subsequent to this Agreement, including those based
partly or wholly on Customer’s feedback, will be the exclusive property of Mentor Graphics. Mentor Graphics will have
exclusive rights, title and 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 all
notices and legends embedded in Software and affixed to its medium and container as received from Mentor Graphics. All
copies shall remain the property of Mentor Graphics or its licensors. Customer shall maintain a record of the number and
primary location of all copies of Software, including copies merged with other software, and shall make those records
available to Mentor Graphics upon request. Customer shall not make Products available in any form to any person other
than Customer’s employees and on-site contractors, excluding Mentor Graphics competitors, whose job performance
requires access and who are under obligations of confidentiality. Customer shall take appropriate action to protect the
confidentiality of Products and ensure that any person permitted access does not disclose or use it except as permitted by
this Agreement. Customer shall give Mentor Graphics written notice of any unauthorized disclosure or use of the Products
as soon as Customer learns or becomes aware of such unauthorized disclosure or use. Except as otherwise permitted for
purposes of interoperability as specified by applicable and mandatory local law, Customer shall not reverse-assemble,
reverse-compile, reverse-engineer or in any way derive any source code from Software. Log files, data files, rule files and
script files generated by or for the Software (collectively “Files”), including without limitation files containing Standard
Verification Rule Format (“SVRF”) and Tcl Verification Format (“TVF”) which are Mentor Graphics’ proprietary syntaxes
for expressing process rules, constitute or include confidential information of Mentor Graphics. Customer may share Files
with third parties, excluding Mentor Graphics competitors, provided that the confidentiality of such Files is protected by
written agreement at least as well as Customer protects other information of a similar nature or importance, but in any case
with at least reasonable care. Customer may use Files containing SVRF or TVF only with Mentor Graphics products. Under
no circumstances shall Customer use Software or Files or allow their use for the purpose of developing, enhancing or
marketing any product that is in any way competitive with Software, or disclose to any third party the results of, or
information pertaining to, any benchmark.
5.2. If any Software or portions thereof are provided in source code form, Customer will use the source code only to correct
software errors and enhance or modify the Software for the authorized use. Customer shall not disclose or permit disclosure
of source code, in whole or in part, including any of its methods or concepts, to anyone except Customer’s employees or
contractors, excluding Mentor Graphics competitors, with a need to know. Customer shall not copy or compile source code
in any manner except to support this authorized use.
5.3. Customer may not assign this Agreement or the rights and duties under it, or relocate, sublicense or otherwise transfer the
Products, whether by operation of law or otherwise (“Attempted Transfer”), without Mentor Graphics’ prior written
consent and payment of Mentor Graphics’ then-current applicable relocation and/or transfer fees. Any Attempted Transfer
without Mentor Graphics’ prior written consent shall be a material breach of this Agreement and may, at Mentor Graphics’
option, result in the immediate termination of the Agreement and/or the licenses granted under this Agreement. The terms
 of this Agreement, including without limitation the licensing and assignment provisions, shall be binding upon Customer’s
permitted successors in interest and assigns.
5.4. The provisions of this Section 5 shall survive the termination of this Agreement.

6. SUPPORT SERVICES. To the extent Customer purchases support services, Mentor Graphics will provide Customer updates
and technical support for the Products, at the Customer site(s) for which support is purchased, in accordance with Mentor
Graphics’ then current End-User Support Terms located at http://supportnet.mentor.com/about/legal/.

7. AUTOMATIC CHECK FOR UPDATES; PRIVACY. Technological measures in Software may communicate with servers
of Mentor Graphics or its contractors for the purpose of checking for and notifying the user of updates and to ensure that the
Software in use is licensed in compliance with this Agreement. Mentor Graphics will not collect any personally identifiable data
in this process and will not disclose any data collected to any third party without the prior written consent of Customer, except to
Mentor Graphics’ outside attorneys or as may be required by a court of competent jurisdiction.

8. LIMITED WARRANTY.
8.1. Mentor Graphics warrants that during the warranty period its standard, generally supported Products, when properly
installed, will substantially conform to the functional specifications set forth in the applicable user manual. Mentor
Graphics does not warrant that Products will meet Customer’s requirements or that operation of Products will be
uninterrupted 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 an Order and does not
renew or reset, for example, with the delivery of (a) Software updates or (b) authorization codes or alternate Software under
a transaction involving Software re-mix. This warranty shall not be valid if Products have been subject to misuse,
unauthorized modification or improper installation. MENTOR GRAPHICS’ ENTIRE LIABILITY AND CUSTOMER’S
EXCLUSIVE REMEDY SHALL BE, AT MENTOR GRAPHICS’ OPTION, EITHER (A) REFUND OF THE PRICE
PAID UPON RETURN OF THE PRODUCTS TO MENTOR GRAPHICS OR (B) MODIFICATION OR
REPLACEMENT OF THE PRODUCTS THAT DO NOT MEET THIS LIMITED WARRANTY, PROVIDED
CUSTOMER HAS OTHERWISE COMPLIED WITH THIS AGREEMENT. MENTOR GRAPHICS MAKES NO
WARRANTIES WITH RESPECT TO: (A) SERVICES; (B) PRODUCTS PROVIDED AT NO CHARGE; OR (C) BETA
CODE; ALL OF WHICH ARE PROVIDED “AS IS.”
8.2. THE WARRANTIES SET FORTH IN THIS SECTION 8 ARE EXCLUSIVE. NEITHER MENTOR GRAPHICS NOR
ITS LICENSORS MAKE ANY OTHER WARRANTIES EXPRESS, IMPLIED OR STATUTORY, WITH RESPECT TO
PRODUCTS PROVIDED UNDER THIS AGREEMENT. MENTOR GRAPHICS AND ITS LICENSORS
SPECIFICALLY DISCLAIM ALL IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE AND NON-INFRINGEMENT OF INTELLECTUAL PROPERTY.

9. LIMITATION OF LIABILITY. EXCEPT WHERE THIS EXCLUSION OR RESTRICTION OF LIABILITY WOULD BE

VOID OR INEFFECTIVE UNDER APPLICABLE LAW, IN NO EVENT SHALL MENTOR GRAPHICS OR ITS
LICENSORS BE LIABLE FOR INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES (INCLUDING
LOST PROFITS OR SAVINGS) WHETHER BASED ON CONTRACT, TORT OR ANY OTHER LEGAL THEORY, EVEN
IF MENTOR GRAPHICS OR ITS LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN
NO EVENT SHALL MENTOR GRAPHICS’ OR ITS LICENSORS’ LIABILITY UNDER THIS AGREEMENT EXCEED
THE AMOUNT RECEIVED FROM CUSTOMER FOR THE HARDWARE, SOFTWARE LICENSE OR SERVICE GIVING
RISE TO THE CLAIM. IN THE CASE WHERE NO AMOUNT WAS PAID, MENTOR GRAPHICS AND ITS LICENSORS
SHALL HAVE NO LIABILITY FOR ANY DAMAGES WHATSOEVER. THE PROVISIONS OF THIS SECTION 9 SHALL
SURVIVE THE TERMINATION OF THIS AGREEMENT.

10. HAZARDOUS APPLICATIONS. CUSTOMER ACKNOWLEDGES IT IS SOLELY RESPONSIBLE FOR TESTING ITS
PRODUCTS USED IN APPLICATIONS WHERE THE FAILURE OR INACCURACY OF ITS PRODUCTS MIGHT
RESULT IN DEATH OR PERSONAL INJURY (“HAZARDOUS APPLICATIONS”). NEITHER MENTOR GRAPHICS
NOR ITS LICENSORS SHALL BE LIABLE FOR ANY DAMAGES RESULTING FROM OR IN CONNECTION WITH
THE USE OF MENTOR GRAPHICS PRODUCTS IN OR FOR HAZARDOUS APPLICATIONS. THE PROVISIONS OF
THIS SECTION 10 SHALL SURVIVE THE TERMINATION OF THIS AGREEMENT.

11. INDEMNIFICATION. CUSTOMER AGREES TO INDEMNIFY AND HOLD HARMLESS MENTOR GRAPHICS AND
ITS LICENSORS FROM ANY CLAIMS, LOSS, COST, DAMAGE, EXPENSE OR LIABILITY, INCLUDING
ATTORNEYS’ FEES, ARISING OUT OF OR IN CONNECTION WITH THE USE OF PRODUCTS AS DESCRIBED IN
SECTION 10. THE PROVISIONS OF THIS SECTION 11 SHALL SURVIVE THE TERMINATION OF THIS
AGREEMENT.

12. INFRINGEMENT.
12.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 Product
acquired by Customer hereunder infringes a patent or copyright or misappropriates a trade secret in such jurisdiction.
Mentor Graphics will pay costs and damages finally awarded against Customer that are attributable to the action. Customer
understands and agrees that as conditions to Mentor Graphics’ obligations under this section Customer must: (a) notify
Mentor Graphics promptly in writing of the action; (b) provide Mentor Graphics all reasonable information and assistance
 to settle or defend the action; and (c) grant Mentor Graphics sole authority and control of the defense or settlement of the
action.
12.2. If a claim is made under Subsection 12.1 Mentor Graphics may, at its option and expense, (a) replace or modify the Product
so that it becomes noninfringing; (b) procure for Customer the right to continue using the Product; or (c) require the return
of the Product and refund to Customer any purchase price or license fee paid, less a reasonable allowance for use.
12.3. Mentor Graphics has no liability to Customer if the action is based upon: (a) the combination of Software or hardware with
any product not furnished by Mentor Graphics; (b) the modification of the Product other than by Mentor Graphics; (c) the
use of other than a current unaltered release of Software; (d) the use of the Product as part of an infringing process; (e) a
product that Customer makes, uses, or sells; (f) any Beta Code or Product provided at no charge; (g) any software provided
by Mentor Graphics’ licensors who do not provide such indemnification 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.
12.4. THIS SECTION 12 IS SUBJECT TO SECTION 9 ABOVE AND STATES THE ENTIRE LIABILITY OF MENTOR
GRAPHICS AND ITS LICENSORS FOR DEFENSE, SETTLEMENT AND DAMAGES, AND CUSTOMER’S SOLE
AND EXCLUSIVE REMEDY, WITH RESPECT TO ANY ALLEGED PATENT OR COPYRIGHT INFRINGEMENT
OR TRADE SECRET MISAPPROPRIATION BY ANY PRODUCT PROVIDED UNDER THIS AGREEMENT.

13. TERMINATION AND EFFECT OF TERMINATION. If a Software license was provided for limited term use, such license
will automatically terminate at the end of the authorized term.
13.1. Mentor Graphics may terminate this Agreement and/or any license granted under this Agreement immediately upon written
notice if Customer: (a) exceeds the scope of the license or otherwise fails to comply with the licensing or confidentiality
provisions of this Agreement, or (b) becomes insolvent, files a bankruptcy petition, institutes proceedings for liquidation or
winding up or enters into an agreement to assign its assets for the benefit of creditors. For any other material breach of any
provision of this Agreement, Mentor Graphics may terminate this Agreement and/or any license granted under this
Agreement upon 30 days written notice if Customer fails to cure the breach within the 30 day notice period. Termination of
this Agreement or any license granted hereunder will not affect Customer’s obligation to pay for Products shipped or
licenses granted prior to the termination, which amounts shall be payable immediately upon the date of termination.
13.2. Upon termination of this Agreement, the rights and obligations of the parties shall cease except as expressly set forth in this
Agreement. Upon termination, Customer shall ensure that all use of the affected Products ceases, and shall return hardware
and either return to Mentor Graphics or destroy Software in Customer’s possession, including all copies and
documentation, and certify in writing to Mentor Graphics within ten business days of the termination date that Customer no
longer possesses any of the affected Products or copies of Software in any form.

14. EXPORT. The Products provided hereunder are subject to regulation by local laws and United States government agencies,
which prohibit export or diversion of certain products and information about the products to certain countries and certain
persons. Customer agrees that it will not export Products in any manner without first obtaining all necessary approval from
appropriate local and United States government agencies.

15. U.S. GOVERNMENT LICENSE RIGHTS. Software was developed entirely at private expense. All Software is commercial
computer software within the meaning of the applicable acquisition regulations. Accordingly, pursuant to US FAR 48 CFR
12.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 which
are contrary to applicable mandatory federal laws.

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

17. REVIEW OF LICENSE USAGE. Customer will monitor the access to and use of Software. With prior written notice and
during Customer’s normal business hours, Mentor Graphics may engage an internationally recognized accounting firm to
review Customer’s software monitoring system and records deemed relevant by the internationally recognized accounting firm
to confirm Customer’s compliance with the terms of this Agreement or U.S. or other local export laws. Such review may include
FLEXlm 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 the
license review. Mentor Graphics shall bear the expense of any such review unless a material non-compliance is revealed. Mentor
Graphics shall treat as confidential information all information gained as a result of any request or review and shall only use or
disclose such information as required by law or to enforce its rights under this Agreement. The provisions of this Section 17
shall survive the termination of this Agreement.

18. CONTROLLING LAW, JURISDICTION AND DISPUTE RESOLUTION. The owners of certain Mentor Graphics
intellectual property licensed under this Agreement are located in Ireland and the United States. To promote consistency around
the world, disputes shall be resolved as follows: excluding conflict of laws rules, this Agreement shall be governed by and
construed under the laws of the State of Oregon, USA, if Customer is located in North or South America, and the laws of Ireland
if Customer is located outside of North or South America. All disputes arising out of or in relation to this Agreement shall be
submitted to the exclusive jurisdiction of the courts of Portland, Oregon when the laws of Oregon apply, or Dublin, Ireland when
the laws of Ireland apply. Notwithstanding the foregoing, all disputes in Asia arising out of or in relation to this Agreement shall
be resolved by arbitration in Singapore 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 the dispute, 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 Nations Convention on Contracts for the International Sale of Goods does not apply to this Agreement.

19. 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 full
force and effect.

20. MISCELLANEOUS. This Agreement contains the parties’ entire understanding relating to its subject matter and supersedes all
prior or contemporaneous agreements, including but not limited to any purchase order terms and conditions. Some Software
may contain code distributed under a third party license agreement that may provide additional rights to Customer. Please see
the applicable Software documentation for details. This Agreement may only be modified in writing by authorized
representatives of the parties. Waiver of terms or excuse of breach must be in writing and shall not constitute subsequent
consent, waiver or excuse.

Rev. 100615, Part No. 246066