PyxisTM

Installation Instructions
for the Pyxis Custom Design Platform
Software Version v10.2

1990-2012 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.72023(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: supportnet.mentor.com/
Send Feedback on Documentation: supportnet.mentor.com/doc_feedback_form

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 thirdparty 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/trademarks.
End-User License Agreement: You can print a copy of the End-User License Agreement from:
www.mentor.com/eula.

Mentor Graphics Application Software

Mentor Graphics Application Software

Planning Your Software Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Platform Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Ordering Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing and Configuring Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Obtaining the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Downloading Software From SupportNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preparing to Install From a CD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing the Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing a Patch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting MGC_HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4
4
4
5
5
6
6
6
8
10
12

Uninstalling or Removing or Moving Pyxis Software . . . . . . . . . . . . . . . . . . . . . . . . . . .

Uninstalling or Removing Pyxis Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Moving Pyxis Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Pyxis Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Support Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13
13
14
14
16

Mentor Graphics provides key system documentation in PDF on this CD for additional
reference while loading software. Refer to the following manuals:

Pyxis Release Highlights

Licensing Mentor Graphics Software
Managing Mentor Graphics Pyxis Software

Pyxis Installation Instructions, v10.2

Planning Your Software Configuration

Planning Your Software Configuration

In this document, reference is made to the MGC tree. This is the installation directory
location that will contain all the files to run your Mentor Graphics software.
Note
The stand-alone Pyxis Plot client-server configuration application is no longer supported
beginning in the v10.1 release. However, Pyxis Plot printing capabilities are
automatically installed as part of the Pyxis software tree and are available in the Pyxis
Layout and Pyxis Schematic tools.
The Managing Mentor Graphics Pyxis Software manual (manage_sw_pyxis.pdf), provided on
this CD and on SupportNet, provides planning and installation information. If you are installing
Mentor Graphics software for the first time, you are encouraged to review Chapter 2, Installing
Pyxis Software.
Mentor Graphics products for this release require Red Hat Enterprise Linux 4/5/6 x86/x86-64,
or SLES 10 / SLES 11 x86/x86-64 as the platform configuration. For more information on
configuration requirements and product availability for these operating systems, visit the
Mentor Graphics SupportNet website at http://supportnet.mentor.com.

Configuration Information
This section lists supported configuration information about hardware and operating system
requirements for systems running Mentor Graphics software. Be aware that platform vendors
may release hardware and operating system changes after publication of this document. For the
most current list of supported configurations, refer to the Mentor Graphics SupportNet web site
at: http://supportnet.mentor.com/systemreqs/
Platform O/S

Platform Hardware

RHEL 4, 5 and 6 x86/x86-64,

SLES 10 and 11 x86/x86-64

Any Red Hat Tier 1 supported hardware listed at:

https://hardware.redhat.com

Platform Information
In the following installation instructions, the <platform> designation is used to identify the
platform extension that you should expect to see in your download files. Use the following table
to determine the correct platform designator for your platform:

Configuration

Platform

Linux RHEL 4, 5, and 6 x86

SuSE Linux Enterprise Server 10 and 11 x86

rhelx86linux

Pyxis Installation Instructions, v10.2

Ordering Licenses

Configuration

Platform

Linux RHEL 4,5 and 6 x86-64

SuSE Linux Enterprise Server 10 and 11 x86-64

linux_x86_64

This document refers to the MGC software tree and to the $MGC_HOME location. Both of
these references identify the directory location that contains all of the files needed to run the
Pyxis applications following installation. For example:
/.../<target_dir>/<release>_<platform>/pyxis_home

When you see the version string vX.Y in the instructions below, you should substitute the actual
version of the software that you are installing in place of the x placeholders. For example, if
you are installing the v10.2 release, and the instructions state that the Install program creates the
directory <target_dir>/<version>_<platform>/pyxis_home, you should interpret this to mean
that the following directory is created: <target_dir>/<version>_<platform>/pyxis_home.

Ordering Licenses
New users must order software licenses prior to installing Mentor Graphics software. To order
licenses, contact your local Mentor Graphics sales office. They can provide you with
information on the number of node-locked and floating licenses your company purchased and
any current license sever configurations you may have. You must provide them with:

Any new license server configuration

The host ID numbers of client and license server workstations for node-locked licenses
The host ID number of the license server workstation for all floating licenses

Existing customers are reminded that your licensing report is available at the Customer Support
website (http://www.mentor.com/ebase).
Note
The Customer Support website requires a login and password. To register and obtain a
password, go to http://supportnet.mentor.com/user/register. If you have difficulties,
email [email protected].

Installing and Configuring Licensing

All Mentor Graphics products require licensing to be installed and configured properly before
invoking and operating them. It is recommended that licensing be installed before installing
applications. For more licensing information, refer to the Download tab on SupportNet or the
release_documents directory at the top level of the CD for the following documents:

Chapter 1, Licensing in the Managing Mentor Graphics Pyxis Software manual,

/release_documents/manage_sw_pyxis.pdf

Pyxis Installation Instructions, v10.2

Obtaining the Software

Licensing Mentor Graphics Software manual for detailed licensing information for the
system administrator, /release_documents/mgc_licen.pdf

License Administration Manual /release_documents/flexnet_admin.pdf

Obtaining the Software

You can obtain the Pyxis software from SupportNet or a CD sent to you from Mentor Graphics.
Following the instructions in either of these two sections, then continue to the section
Installing and Configuring Licensing on page 5.
Note
It is recommended that licensing be installed before installing applications.

Downloading Software From SupportNet

To download Pyxis software, please log in to SupportNet.
1. Find the product that you want, and choose the appropriate release in the Current
Recommended Releases section on the Overview tab.
2. Follow the instructions on screen.

Preparing to Install From a CD

You must use the install program from this CD to install the Mentor Graphics products. Older
versions of the Install tool will not work.
1. If you are installing a new Mentor Graphics tree, create a directory for the software:
Note
If you are updating an existing tree, go to Step 2.

$ mkdir <target_dir>

The install program will create the following directory structure:

<target_dir>/<version>_<platform>/pyxis_home

For example, your target <target_dir> might look like:

/usr2/mgc

Pyxis Installation Instructions, v10.2

Obtaining the Software

Note
When you install Pyxis Custom Router as a stand-alone, non-Pyxis installation, it is
installed as the separate directory structure similar to pyxis_home (outside of the
MGC_home tree) at:
<target_dir>/<version>_<platform>/<pyxis_router/<version>.
2. Insert the volume of the Application Software CD for your operating system into the CD
device.
3. If necessary, as root, create a mount point for the CD device:
$ mkdir /cdrom

For Linux:
$ mkdir -p /mnt/cdrom

4. As root, use the command in the following table to mount the CD and retrieve the Install
program. If your CD device is not at the default location, specify the appropriate
pathname.
O/S

Use These UNIX Commands

Linux

$ mount -t iso9660 /dev/cdrom /mnt/cdrom

* If running vold daemon, the CD is automatically mounted.

5. Create the directory that you want to contain the Install program executable
$ mkdir <install_dir>

6. Change directories to the location that will contain the Install program executable.
$ cd <install_dir>

7. Copy the Install program executable appropriate for your operating system from the CD
to the <install_dir> using the following command:
$ cp -r /cdrom/pyxis_<version>_<platform>.exe .

8. Add executable permission to the copied .exe file using the following command:
chmod +x <install_dir>/pyxis_<version>_<platform>.exe

9. Execute the Install executable in the shell in the current directory:

$ <install_dir>/pyxis_<version>_<platform>.exe

The Mentor Graphics Quick Install program displays the licensing agreement.
10. Read the licensing agreement and click "I agree to the above license agreement"; click
Next.

Pyxis Installation Instructions, v10.2

Installing the Software

The Mentor Graphics Quick Install program prompts you to enter the destination
location for the Install program.
11. Enter the destination location for the Install program in the Selection field using the
<install_dir> you created above.
12. Click OK.
The Mentor Graphics Quick Install extracts the Install program and data; when the
extraction finishes, the Mentor Graphics Install window displays.
See the section, Installing the Software, to complete product installation.

Installing the Software

1. In the Mentor Graphics Install window, click Install Products.
2. Read the Mentor Graphics Licensing Agreement and click Agree to accept.
Caution
It is strongly recommended that you DO NOT move or rename an installed software tree
from its originally installed location. The Mentor Install Program (MIP) cannot validate,
update, or patch the tree if it has been moved. The ideal solution would be to uninstall the
MGC_HOME tree first and then reinstall it in the new location. Moving an installed tree
using the operating system also invalidates location map paths used for the MGC
standard libraries. If a tree has been moved in this manner, these paths will need to be
updated within the MGC location map template located at
$MGC_HOME/shared/etc/appl/base/mgc_map_template. This location map is generated
as part of the installation process and is used by Pyxis to provide access to these libraries.
The MGC standard libraries are located within $MGC_HOME/mgc_icstd_lib.
3. In the Source field of the Source and Target window, enter the path to the source for
your installation and click Next.
The source path should be:
<install_dir>/VCD_<version>_<platform>

4. In the Target field of the Source and Target window, enter the path to the target
destination for your installation and click Next.
The target path should be:
<target_dir>

The target path is the location in which you want to install the release. See the following
example of a target location <target_dir>.
If you enter the Target location as: /usr2/mgc

Pyxis Installation Instructions, v10.2

Installing the Software

In the <target_dir> directory, the product root is:

<version>_<platform>/pyxis_home
In this case, MGC_HOME should be set to:
<target_dir>/<version>_<platform>/pyxis_home
The releases and patches have the product root built into them and cannot be
changed.
Because of this, the "Target" location for your installation should be the path up to
but not including the product root.
Note
If you install the stand-alone Pyxis Router, install it in the same manner as shown in this
section. Note that the installed directory will be:
.../pyxis_router/<version> instead of .../pyxis_home.
5. In the Product Selection window, click the drop-down arrow in the Select the
product(s) for the chosen platform field and select the platform you want to install.
6. Select the object(s) or release to install and click Next.
Note: Selecting the Pyxis release will install all objects in it: Pyxis SW and Pyxis
Documentation. If you do not want to install the entire release, select only those objects
you want to install.
7. Using the Confirm Selections window, confirm the product selections and click Install.
8. Click Done in the Installing Products window when installation is complete.
9. Click Verify Installation on the Mentor Graphics Install Program Home window.
10. Select the Release installation to verify and click Verify.
11. Using the Results window, confirm that all products passed verification and click Done.
12. Click Exit to close the Mentor Graphics Install window.
13. Click Exit to close the Mentor Graphics Quick Install window.
Tip: If you want to install Pyxis documentation after you have exited the Install
program, you do not need to run the install executable you ran earlier. Instead, do the
following:
$ cd <install_dir>/VCD_<version>_<platform>/install
$ install

The Install program invokes and you can select the Pyxis Documentation item as
described in the previous instructions.
Note: After install is complete, you may have to unmount the CD to remove it from the
drive:

Pyxis Installation Instructions, v10.2

Installing the Software

$ eject cd

(For vold)

Installing a Patch
These instructions provide steps for downloading and installing any patch that is compatible
with an Pyxis vX.Y release. Please refer to the README file for the specific patch you are
installing for information on patch compatibility and content. The patch README file can be
downloaded from the same location as the patch software and will have the following naming
convention:
README_pyxis_pxxxxxxxxx.txt
Where xxxxxxxxx denotes the nine digit number of the patch you are installing such as
201001001.
Caution
It is strongly recommended that you DO NOT move or rename an installed software tree
from its originally installed location. The Mentor Install Program (MIP) cannot validate,
update, or patch the tree if it has been moved. The ideal solution would be to uninstall the
MGC_HOME tree first and then reinstall it in the new location. Moving an installed tree
using the operating system also invalidates location map paths used for the MGC
standard libraries. If a tree has been moved in this manner, these paths will need to be
updated within the MGC location map template located at
$MGC_HOME/shared/etc/appl/base/mgc_map_template. This location map is generated
as part of the installation process and is used by Pyxis to provide access to these libraries.
The MGC standard libraries are located within $MGC_HOME/mgc_icstdlib.
To install and verify a patch using the Mentor Graphics Install program, perform the following
steps:
1. Change directories to the location in which you want to place the Install program
executable.
This location could be the same location in which you originally installed the vX.Y
Install program executable.
If the location does not yet exist, create the directory first using the following UNIX
shell command: mkdir <install_dir>
$ cd <patch_install_dir>

2. Download an Install program executable appropriate for your operating system from the
Pyxis website to the <install_dir>. The downloaded file name should be similar to the
following:
pyxis_ xxxxxxxxx_<platform>.exe

10

Pyxis Installation Instructions, v10.2

Installing the Software

Note
If only the Pyxis SW is being patched, there will only be one executable installer, the one
mentioned above. If the Pyxis Custom Router is patched, there will be a separate
executable installer, pyxis_router_pxxxxxxxxx_<platform>.exe. The Pyxis Custom
Router will be installed adjacent to any previously installed versions as a complete install,
instead of as an overlay when the Pyxis SW is patched.
3. Execute the Install executable in the shell in the current directory:
$ <patch_install_dir>/pyxis_xxxxxxxxx_<platform>.exe

The Mentor Graphics Quick Install program displays the licensing agreement.
4. Read the licensing agreement and click "I agree to the above license agreement; click
Next.
The Mentor Graphics Quick Install program prompts you to enter the destination
location for the Install program.
5. Enter the destination location for the Install program in the Selection field using the
<install_dir> location from above.
6. Click OK.
The Mentor Graphics Quick Install extracts the Install program and data and, when
finished, displays the Mentor Graphics Install window.
Tip: After the Mentor Graphics Install program invokes, instructions for performing
each of the following tasks are available in the online help accessed from the Help
menu.
7. Click Install Products on the Mentor Graphics Install Home window.
8. Read the Mentor Graphics Licensing Agreement and click Agree to accept.
9. In the Source field of the Source and Target window, enter the path to the source for
your installation data and click Next.
The source path should be:
<patch_install_dir>/VCD_xxxxxxxxx_<platform>

10. In the Target field of the Source and Target window, enter the path to the target
destination for your installation (this is just above the product root) and click Next.
The target path (above product root) should be the same location in which you installed
the original vX.Y release: See the following example of the target location
<target_dir>.
If your $MGC_HOME = <target_dir>/vX.Y_<platform>/pyxis_home, then:

Pyxis Installation Instructions, v10.2

11

Installing the Software

The Target location to enter is: <target_dir>

The "product root" is: <version>_<platform>/pyxis_home
The releases and patches have the "product root" built into them and cannot be
changed.
Because of this, the "Target" location for your installation should be the path up to
but not including the "product root".
11. In the Product Selection window, click the drop-down arrow in the Select the
product(s) for the chosen platform field and select the platform you want to install.
Note: Only the product being patched is listed. To be sure that you are selecting the
correct product, verify that the icon to the right of the product name you are patching
shows a check signifying that it is already installed.
12. Select the object(s) or release to install and click Next.
Note: Selecting the Pyxis release will install all objects in the patch.
13. Using the Confirm Selections window, confirm the product selections and click Install.
14. Click Done in the Installing Products window when installation is complete.
15. Click Verify Installation on the Mentor Graphics Install Home window.
16. Select the release installation you want to verify and click Verify.
17. Using the Results window, confirm that all products passed verification and click Done.
18. Click Exit to close the Mentor Graphics Install window, and then click Exit to close the
Mentor Graphics Quick Install window.

Setting MGC_HOME
The MGC_HOME environment variable must be set to the location of your Mentor Graphics
tree before invoking Mentor Graphics products. To set MGC_HOME, do the following:
1. In a Bourne or Korn shell:
$ MGC_HOME=
<target_dir>/<version>_<platform>/pyxis_home
$ export MGC_HOME

In a C Shell:
% setenv MGC_HOME
<target_dir>/<version>_<platform>/pyxis_home

2. Verify that MGC_HOME is set:

$ echo $MGC_HOME

12

Pyxis Installation Instructions, v10.2

Uninstalling or Removing or Moving Pyxis Software

3. Add $MGC_HOME/bin to the PATH variable so that you can invoke the Mentor
Graphics application commands without typing the full pathname. In a Bourne or Korn
Shell:
$ PATH=$MGC_HOME/bin:$PATH
$ export PATH

In a C Shell:
% setenv PATH ${MGC_HOME}/bin:${PATH}

Uninstalling or Removing or Moving Pyxis

Software
Due to a limitation with the Mentor Install Program (MIP) uninstall capability, if you want to
remove a part or all of an MIP-installed MGC software tree, we strongly recommend that you
follow these steps to uninstall all products from the MGC_HOME tree. Then, you can reinstall
only the products you need.

Uninstalling or Removing Pyxis Software

1. Invoke the Mentor Graphics Install program using the following command:
$ <install_dir>/VCD_<version>_<platform>/install/install

2. Select the Products > Remove Products menu item.

3. Select all the products within a given release tree.
For example:
+ Pyxis SW - Release: <target_dir>/<version>_<platform>
+ Pyxis Documentation - Release: <target_dir>/<version>_<platform>
4. Click Next.
5. Click Remove.
6. When MSI is done removing the products, click Exit to exit the MSI install program.
7. Remove the remainder of the release tree using the following UNIX command in a shell:
$ rm -rf /<target_dir>/<version>_<platform>

Pyxis Installation Instructions, v10.2

13

Viewing Pyxis Documentation

Moving Pyxis Software

Caution
It is strongly recommended that you DO NOT move or rename an installed software tree
from its originally installed location. The Mentor Install Program (MIP) cannot validate,
update, or patch the tree if it has been moved.
Moving an installed tree using the operating system invalidates location map paths used for the
MGC standard libraries. If a tree has been moved in this manner, perform one of the following
tasks:
1. Uninstall the MGC_HOME tree first and then reinstall it in the new location. This is the
recommended solution.
OR
2. Update the location map paths within the MGC location map template located at
$MGC_HOME/shared/etc/appl/base/mgc_map_template. This location map is
generated as part of the installation process and is used by the Pyxis to provide access to
these libraries. The MGC standard libraries are located within
$MGC_HOME/mgc_icstdlib.

Viewing Pyxis Documentation

In addition to Mentor Graphics application software, the CD-ROM and SupportNet contain
documentation in both HTML and PDF format. The application viewing format is HTML; a
Mentor Graphics supported browser is required. Refer to the following URL for a list of
supported browsers and required browser settings:
http://supportnet.mentor.com/help/browser_requirements.cfm
Note
As part of the installation, you must also update your PATH environment variable with
the path to the browser executable.

To access documentation from the application, select Help from the application menu
bar.

To view Mentor Graphics documentation in PDF format, you must install Adobe
Acrobat Reader.
You can download a free compatible version of the Adobe Acrobat Reader at the
following URL:
http://supportnet.mentor.com/sysadmin/acrobat_reader.cfm

14

Pyxis Installation Instructions, v10.2

Viewing Pyxis Documentation

Note
If you have installed previous versions of Acrobat Reader or Exchange and made them
available through the PATH environment variable, users may be unable to access online
help. You must install Acrobat Reader 5.0 or a later version and edit the PATH variable
to replace the existing entry with the pathname to the Reader install directory.

Pyxis Installation Instructions, v10.2

15

Support Information

Support Information
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/

16

Pyxis Installation Instructions, v10.2