PGI 2014.10编译器资料.pdf
PGDBG Installation Guide Version 2014 PGI Compilers and Tools TABLE OF CONTENTS Chapter 1. Release 2014 Introduction.................................................................................................................................1 1.1. Product Overview........................................................................................................................................................ 1 1.1.1. PGI Remote and PGI Local Debugging Comparison..........................................................................................1 1.2. Release Components.................................................................................................................................................. 2 1.2.1. Co-installation Requirements...............................................................................................................................2 1.3. Supported Operating Systems.................................................................................................................................... 2 1.4. Java Runtime Environment (JRE)...............................................................................................................................4 1.5. Product Support...........................................................................................................................................................4 Chapter 2. Installation Overview..........................................................................................................................................6 2.1. Before You Begin........................................................................................................................................................ 6 2.2. PGI Network Installations............................................................................................................................................ 7 Chapter 3. PGDBG Installations on Linux.......................................................................................................................... 8 3.1. Prepare to Install PGDBG on Linux............................................................................................................................8 3.2. PGI Installations on Linux - gcc Compiler Requirements......................................................................................... 10 3.2.1. gcc Compiler Availability....................................................................................................................................10 3.3. Installation Steps for Linux........................................................................................................................................11 Chapter 4. Installations on OS X.......................................................................................................................................14 4.1. System Configuration to Enable Debugger ‘Attach’..................................................................................................14 4.2. Installation Steps for Apple OS X............................................................................................................................. 15 4.3. End-user Environment Settings on OS X................................................................................................................. 16 Chapter 5. Installations on Microsoft Windows............................................................................................................... 17 5.1. Preparing to Install on Windows............................................................................................................................... 17 5.2. Installation Steps for Windows..................................................................................................................................17 5.3. Windows Firewall and PGI Debugging..................................................................................................................... 18 5.3.1. Automatic Additions to Windows Firewall Exceptions List................................................................................ 18 Chapter 6. Contact Information......................................................................................................................................... 19 PGDBG Installation Guide ii LIST OF FIGURES Figure 1 Local Debugging Licensing ....................................................................................................................................2 Figure 2 Remote Debugging Licensing ................................................................................................................................2 Figure 3 PGDBG Installation Overview ................................................................................................................................7 Figure 4 Linux Installation Overview .................................................................................................................................... 9 PGDBG Installation Guide iii PGDBG Installation Guide iv Chapter 1. RELEASE 2014 INTRODUCTION Welcome to Release 2014 of the PGDBG® for 32-bit and 64-bit x86-compatible processor-based workstations, servers, and clusters running versions of the Linux, Apple OS X, and Microsoft Windows operating systems. This installation information applies to the PGDBG installation package available from The Portland Group. 1.1. Product Overview PGDBG is licensed software available from The Portland Group. You must agree to an End-User License Agreement when you install the software. PGDBG supports debugging programs running on local and remote systems. The PGI license keys that enable PGDBG to debug must be located on the same system where the program you want to debug is running. Local debugging If you want to debug a program running on the system where you have launched PGDBG, you are doing local debugging and you need license keys on that local system. Remote debugging If you want to debug a program running on a system other than the one on which PGDBG is launched, you are doing remote debugging and you need license keys on the remote system. The remote system also needs an installed copy of PGI Workstation, PGI Server, or PGI CDK. 1.1.1. PGI Remote and PGI Local Debugging Comparison The PGDBG install package includes the PGDBG debugger. It supports debugging applications locally as well as on a system other than the one on which PGDBG is installed. Figure 1 illustrates local debugging and its license key requirements. PGDBG Installation Guide 1 Release 2014 Introduction Figure 1 Local Debugging Licensing Figure 2 illustrates remote debugging and its license key requirements. Figure 2 Remote Debugging Licensing 1.2. Release Components Release 2014 of PGDBG includes PGI’s multi-thread graphical debugger. 1.2.1. Co-installation Requirements If the program to be debugged is running on the same system as PGDBG all you need to debug locally are valid license keys. If the program to be debugged is running on a different system than PGDBG, then either PGI Workstation, PGI Server, or PGI CDK must be installed on that remote system and valid license keys must be in placed there. The remote system must be running a Linux operating system. The license required to launch PGDBG on your local system (before beginning a remote debug session) is freely available from PGI. 1.3. Supported Operating Systems PGDBG supports Linux, Windows, and Apple operating systems: PGDBG Installation Guide 2 Release 2014 Introduction ‣ Linux Most Linux operating systems with GLIBC 2.3.4 and above: RHEL 4.8+, including RHEL 6.5 Fedora 4+, including Fedora 20 SuSE 9.3+, including SuSE 13.1 SLES 10+, including SLES 11 SP 3 Ubuntu 8.04+, including Ubuntu 13.10 ‣ Version differences in some operating system components may cause difficulties, but often these can be overcome with minor adjustments to the PGI software installation or operating system environment. Windows Windows XP 32/64-bit and newer, including Windows 8.1 and Windows Server 2012. Starting January 2015, PGI releases will no longer include support for Windows XP, Windows Server 2003, or Windows Server 2008. ‣ Apple OS X versions 10.6 (Snow Leopard) and newer, including 10.9 (Mavericks). www.pgroup.com/support/install.htm lists any new operating system distributions that may be explicitly supported by PGDBG. If your operating system is newer than any of the operating systems in the preceding list, the installation may still be successful. Linux ‣ ‣ Linux operating systems with support for x64 compatible processors are designated 64-bit. These are the only distributions on which the 64-bit versions of the PGI compilers and tools will fully install. If you attempt to install the 64-bit/32-bit Linux version on a system running a 32-bit Linux distribution, only the 32-bit PGI compilers and tools are installed. Most modern operating systems include support for Intel Hyper-threading (HT). Further, most modern Linux distributions support the Native Posix Threads Library (NPTL). Parallel executables generated using the OpenMP and auto-parallelization features of the PGI compilers will automatically make use of NPTL on distributions where it is available. In addition, the PGDBG debugger is capable of debugging executables built using either NPTL or earlier pthread implementations. Many modern multi-socket AMD Opteron processor-based servers use a NUMA (Non-Uniform Memory Access) architecture in which the memory latency from a given processor to a given portion of memory can vary. Newer Linux distributions, including SuSE 9/10 and SLES 9/10, include NUMA libraries that can be leveraged by a compiler and associated runtime libraries to optimize placement of data in memory. PGDBG Installation Guide 3 Release 2014 Introduction Windows PGI 2014 for Windows supports most of the features of the 32-bit and 64-bit versions for linux86 and linux86-64 environments. If you attempt to install the 64-bit Windows version on a system running 32-bit Windows, the installation fails. OS X PGI 2014 for OS X supports most of the features of the 32-bit and 64-bit versions for linux86 and linux86-64 environments. Except where noted in PGI documentation, the PGI compilers and tools on OS X function identically to their Linux counterparts. 1.4. Java Runtime Environment (JRE) The PGI debugger uses Java SE 6. On 64-bit systems PGDBG uses a 64-bit JRE; on 32-bit systems it uses a 32-bit JRE. The correct JRE is important because PGDBG makes calls to native code, which must be of compatible "bitness" to function properly. 1.5. Product Support All new PGI licenses include free PGI Subscription Service during the money-back guarantee period. The PGI Subscription Service provides support and other benefits including: ‣ Ongoing technical support by electronic mail. Support requests may be sent in a number of ways: ‣ ‣ ‣ By electronic mail to trs@pgroup.com Faxed to +1-503-682-2637 By using the online support request form available at www.pgroup.com/support/support_request.php ‣ ‣ ‣ Phone support is not currently available. Release upgrades for licensed product(s) at no additional cost, except for any administrative fee that may apply. Notification by email when maintenance releases occur and are available for electronic download and installation. Full license fee credits on Product upgrades, except for any administrative fee that may apply. "Product upgrades" refer to exchanging one Product license for a more expensive Product license, and is not the same as a Version or Release upgrade previously referenced. PGDBG Installation Guide 4 Release 2014 Introduction ‣ Full license fee credits on user-count upgrades, except for any administrative fee that may apply. Important To continue receiving these benefits after the money-back guarantee period days, you can purchase an extension to your PGI Service Subscription. Extensions are available in yearly increments. Contact sales@pgroup.com if you would like information regarding the subscription service for the PGI products you have purchased. PGDBG Installation Guide 5 Chapter 2. INSTALLATION OVERVIEW This section provides an overview of the steps required to successfully install PGDBG. The remaining sections provide the details of each of the steps. Licensing was covered in Release 2014 Introduction. PGDBG Installations on Linux describes how to install PGDBG in a generic manner on Linux, Installations on OS X describes how to install on an OS X system, and Installations on Microsoft Windows describes how to install on a Windows system. 2.1. Before You Begin Before you begin the installation, it is advantageous to understand the flow of the installation process. There are two stages of the process: ‣ ‣ Prepare to install – verifying that you have all the required information and software. Install the software – installing the software appropriate for your operating system. The following illustration provides a high-level overview of the PGI installation process. PGDBG Installation Guide 6 Installation Overview Figure 3 PGDBG Installation Overview For more complete information on these steps and the specific actions to take for your operating system, refer to the corresponding sections in this guide. 2.2. PGI Network Installations Linux On Linux, PGDBG may be installed locally on each machine on a network or it may be installed once on a shared file system available to each machine. If you select the second method, then after the first installation you can run a simple script on each machine in the group to add each new platform to the family of machines using the common installation. For more information on network installations, refer to PGDBG Installations on Linux. OS X and Windows On OS X and Windows, PGDBG must be installed locally on each machine. A network installation using a shared file system is not supported. PGDBG Installation Guide 7 Chapter 3. PGDBG INSTALLATIONS ON LINUX This section describes how to install PGDBG in a generic manner on a Linux system. It covers local and network installs. ‣ ‣ ‣ For installations on 32-bit x86 systems, the PGI installation script installs only the linux86 versions of PGDBG. For installations on 64-bit x64 systems running a linux86-64 execution and development environment, the PGI installation script installs the linux86-64 version of PGDBG. If the 32-bit gcc development package is already installed on the x64 system, the 32-bit linux86 PGDBG is also installed. The 32-bit and 64-bit PGDBG have the same command names, and the environment you target by default (linux86-64 or linux86) depends on the version of PGDBG that comes first in your path settings. 3.1. Prepare to Install PGDBG on Linux In preparation for installing PGDBG on Linux, first study the overview of the Linux installation process illustrated in Figure 4. For Linux installations, each user needs to set their environment variables properly to access the software, as described in section 4.4, End-user Environment Settings on Linux. In a typical local installation, the default installation base directory is /opt/pgi. PGDBG Installation Guide 8 PGDBG Installations on Linux Figure 4 Linux Installation Overview Network Installations: If you choose to perform a network installation, you should specify: ‣ ‣ A shared file system for the installation base directory. A second directory name that is local to each of the systems where PGDBG will be used. This directory selection approach allows a network installation to support a network of machines running different versions of Linux. To Prepare for the Installation: ‣ Bring up a shell command window on your system. The installation instructions assume you are using csh, sh, ksh, bash, or some compatible shell. If you are using a shell that is not compatible with one of these shells, appropriate modifications are necessary when setting environment variables. PGDBG Installation Guide 9 PGDBG Installations on Linux ‣ ‣ Verify you have enough free disk space for the PGI installation. ‣ The uncompressed installation package requires 70 MB of free disk space. ‣ The linux86 platform requires up to 77 MB of free disk space. ‣ The linux86-64 platform requires up to 77 MB of free disk space. To debug 32-bit applications on 64-bit Linux systems, the 32-bit ncurses libraries must be installed. The name of this package varies across the Linux distributions, but it contains a file with a name like libncurses.so.5. 3.2. PGI Installations on Linux - gcc Compiler Requirements On Linux systems, PGDBG needs the gcc tool chain (ld,as,ar) and gcc libraries and header files to be compatible with your version of Linux. Therefore, to successfully install on a Linux system, the system must already have gcc compilers installed. ‣ ‣ To successfully install the 64-bit PGDBG, gcc 64-bit compilers must be present and in the user's path. To successfully install the 32-bit PGDBG, gcc 32-bit compilers must be present and in the user's path. 32-bit Linux systems can only have 32-bit gcc compilers. ‣ To successfully install the 32-bit PGDBG on a 64-bit Linux system, gcc 32-bit compilers must be present and in the user's path. 3.2.1. gcc Compiler Availability To determine if 32-bit or 64-bit gcc compilers are installed on the system, do the following: 1. Create a hello.c program. #include