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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Platform Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 4
Ordering Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
Installing and Configuring Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
Obtaining the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
Downloading Software From SupportNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Preparing to Install From a CD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6 6
Installing the Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
Installing a Patch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting MGC_HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10 12
Uninstalling or Removing or Moving Pyxis Software . . . . . . . . . . . . . . . . . . . . . . . . . . .
13
Uninstalling or Removing Pyxis Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moving Pyxis Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13 14
Viewing Pyxis Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14
Support Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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
3
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 a re installing Mentor Graphics software for the first time, you are en couraged to review Chapter 2, “Installing Pyxis Software.” Mentor Graphics products for this release require Red Hat E nterprise 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 ope rating 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 Supp ortNet 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 “
” 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:
4
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 co ntains all of the files needed to run the Pyxis applications following installation. For example: /...//_/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 / _ /pyxis_home, you should interpret this to mean that the following directory is created: / _ /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 a nd 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
5
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
The install program will create the following directory structure: /_/pyxis_home
For example, your target might look like: /usr2/mgc
6
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: /_/. 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
6. Change directories to the location that will contain the Install program executable. $ cd
7. Copy the Install program executable appropriate for your operating system from the CD to the using the following command: $ cp -r /cdrom/pyxis__.exe .
8. Add executable permission to the copied .exe file using the following command: chmod +x / pyxis__.exe
9. Execute the Install executable in the shell in the current directory: pyxis__. exe $ /
The Mentor Graphics Quick Install program displays the licensing agreemen t. 10. Read the licensing agreement and click "I agree to the above license agreement"; click Next.
Pyxis Installation Instructions, v10.2
7
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 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 loca tion. 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: VCD__ /
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:
The target path is the location in which you want to install the release. See the following example of a target location . If you enter the Target location as: /usr2/ mgc
8
Pyxis Installation Instructions, v10.2
Installing the Software
In the directory, the product root is: _/ pyxis_home In this case, MGC_HOME should be set to: /_/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/” 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 Pyx is
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 /VCD__ /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
9
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 loca tion. 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 $ cd
2. Download an Install program executable appropriate for your operating system from the Pyxis website to the . The downloaded file n ame should be similar to the following: pyxis_ xxxxxxxxx_.exe
10
Pyxis Installation Instructions, v10.2
Installing the Software Note
If only the Pyxis SW is being patched, there will only be one execu table installer, the one mentioned above. If the Pyxis Custom Router is patched, there will be a separate executable installer, “pyxis_router_pxxxxxxxxx_.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: pyxis_xxxxxxxxx _ .exe $ /
The Mentor Graphics Quick Install program displays the licensing agreemen t. 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 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: /VCD_xxxxxxxxx _
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 . If your $MGC_HOME = /vX.Y_/pyxis_home, then:
Pyxis Installation Instructions, v10.2
11
Installing the Software
The Target location to enter is: The "product root" is: _/ 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= pyxis_home / _/ $ export MGC_HOME
In a C Shell: % setenv MGC_HOME 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 yo u 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: $ /VCD__ /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: /_ + Pyxis Documentation - Release: /_ 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 / /_
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