Rational Purifyplus for Linux Installation Guide Preface
Rational Software Corporation®
Rational® PurifyPlus for Linux Installation Guide
VERSION: 2003.06.00
PART NUMBER: 800-026276-000
UNIX
[email protected] http://www.rational.com
Legal Notices ©2001-2003, Rational Software Corporation. All rights reserved. Any reproduction or distribution of this work is expressly prohibited without the prior written consent of Rational. Part Number: 800-026276-000 Version Number: 2003.06.00 Rational, Rational Software Corporation, the Rational logo, Rational Developer Network, AnalystStudio, , ClearCase, ClearCase Attache, ClearCase MultiSite, ClearDDTS, ClearGuide, ClearQuest, ClearTrack, Connexis, e-Development Accelerators, DDTS, Object Testing, Object-Oriented Recording, ObjecTime, ObjecTime Design Logo, Objectory, PerformanceStudio, PureCoverage, PureDDTS, PureLink, Purify, Quantify, Rational Apex, Rational CRC, Rational Process Workbench, Rational Rose, Rational Suite, Rational Suite ContentStudio, , Rational Summit, Rational Visual Test, Rational Unified Process, RUP, RequisitePro, ScriptAssure, SiteCheck,SiteLoad, SoDA, TestFactory, TestFoundation, TestStudio, TestMate, VADS, and XDE, among others, are trademarks or registered trademarks of Rational Software Corporation in the United States and/or in other countries. All other names are used for identification purposes only, and are trademarks or registered trademarks of their respective companies. Portions covered by U.S. Patent Nos. 5,193,180 and 5,335,344 and 5,535,329 and 5,574,898 and 5,649,200 and 5,675,802 and 5,754,760 and 5,835,701 and 6,049,666 and 6,126,329 and 6,167,534 and 6,206,584. Additional U.S. Patents and International Patents pending. U.S. GOVERNMENT RIGHTS. All Rational software products provided to the U.S. Government are provided and licensed as commercial software, subject to the applicable license agreement. All such products provided to the U.S. Government pursuant to solicitations issued prior to December 1, 1995 are provided with “Restricted Rights” as provided for in FAR, 48 CFR 52.227-14 (JUNE 1987) or DFARS, 48 CFR 252.227-7013 (OCT 1988), as applicable. WARRANTY DISCLAIMER. This document and its associated software may be used as stated in the underlying license agreement. Except as explicitly stated otherwise in such license agreement, and except to the extent prohibited or limited by law from jurisdiction to jurisdiction, Rational Software Corporation expressly disclaims all other warranties, express or implied, with respect to the media and software product and its documentation, including without limitation, the warranties of merchantability, non-infringement, title or fitness for a particular purpose or arising from a course of dealing, usage or trade practice, and any warranty against interference with Licensee’s quiet enjoyment of the product. Third Party Notices, Code, Licenses, and Acknowledgements Portions Copyright ©1992-1999, Summit Software Company. All rights reserved. Microsoft, the Microsoft logo, Active Accessibility, Active Client, Active Desktop, Active Directory, ActiveMovie, Active Platform, ActiveStore, ActiveSync, ActiveX, Ask Maxwell, Authenticode, AutoSum, BackOffice, the BackOffice logo, bCentral, BizTalk, Bookshelf, ClearType, CodeView, DataTips, Developer Studio, Direct3D, DirectAnimation, DirectDraw, DirectInput, DirectX, DirectXJ, DoubleSpace, DriveSpace, FrontPage, Funstone, Genuine Microsoft Products logo, IntelliEye, the IntelliEye logo, IntelliMirror, IntelliSense, J/Direct, JScript, LineShare, Liquid Motion, Mapbase, MapManager, MapPoint, MapVision, Microsoft Agent logo, the Microsoft eMbedded Visual Tools logo, the Microsoft Internet Explorer logo, the Microsoft Office Compatible logo, Microsoft Press, the Microsoft Press logo, Microsoft QuickBasic, MS-DOS, MSDN, NetMeeting, NetShow, the Office logo, Outlook, PhotoDraw, PivotChart, PivotTable, PowerPoint, QuickAssembler, QuickShelf, RelayOne, Rushmore, SharePoint, SourceSafe, TipWizard, V-Chat, VideoFlash, Virtual Basic, the Virtual Basic logo, Visual C++, Visual C#, Visual FoxPro, Visual InterDev, Visual J++, Visual SourceSafe, Visual Studio, the Visual Studio logo, Vizact, WebBot, WebPIP, Win32, Win32s, Win64, Windows, the Windows CE logo, the Windows logo, Windows NT, the Windows Start logo, and XENIX, are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or in other countries. Sun, Sun Microsystems, the Sun Logo, Ultra, AnswerBook 2, medialib, OpenBoot, Solaris, Java, Java 3D, ShowMe TV, SunForum, SunVTS, SunFDDI, StarOffice, and SunPCi, among others, are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Purify is licensed under Sun Microsystems, Inc., U.S. Patent No. 5,404,499. Licensee shall not incorporate any GLOBEtrotter software (FLEXlm libraries and utilities) into any product or application the primary purpose of which is software license management. BasicScript is a registered trademark of Summit Software, Inc. Design Patterns: Elements of Reusable Object-Oriented Software, by Erich Gamma, Richard Helm, Ralph Johnson and John Vlissides. Copyright © 1995 by Addison-Wesley Publishing Company, Inc. All rights reserved. Additional legal notices are described in the legal_information.html file that is included in your Rational software installation. Installation Guide Contents
Preface...... vii Audience ...... vii Contacting Rational Technical Publications ...... vii Other Resources...... vii Contacting Rational Customer Support ...... viii Before You Install ...... 1 Upgrading Rational PurifyPlus for Linux ...... 1 Installing Mixed Versions of Rational Products ...... 1 Licensing PurifyPlus for Linux...... 1 Requesting your Permanent or TLA License Key...... 2 Administrator Privileges ...... 2 Hardware and Software Requirements ...... 2 Installing on UNIX ...... 5 Using the rs_install Script ...... 5 Before You Start the rs_install Script ...... 5 Installing from the CD-ROM Image ...... 6 Questions and Answers about rs_install...... 7 After You Install...... 9 Launching the Product ...... 9 To Run the Graphical User Interface ...... 9 License Variable ...... 10 Accessing the Online Documentation ...... 11 Browsing the Online Documentation ...... 11 Troubleshooting...... 11 Installation Issues ...... 12 Software Errors...... 12 Documentation Problems ...... 12 Uninstalling Rational PurifyPlus for Linux ...... 13 Removing the Product...... 13
v vi Rational PurifyPlus for Linux Installation Guide Preface
Welcome to Rational PurifyPlus for Linux. This installation guide contains information to help you install the products, including the steps you need to take both before and after installation. PurifyPlus for Linux is a complete solution for runtime analysis on Linux platforms: it delivers memory leak detection, memory and performance profiling as well as code coverage and runtime tracing.
Audience
This guide is intended for Rational software users who are installing PurifyPlus for Linux, such as system administrators, application developers, quality assurance managers, and quality assurance testers. To install and use the products, you should be familiar with the selected Windows or UNIX platform and its conventions.
Contacting Rational Technical Publications
To send feedback about documentation for Rational products, please send e-mail to our technical publications department at [email protected].
Other Resources
All manuals are available online, either in HTML or PDF format. The online manuals are on the PurifyPlus for Linux CD and are installed with the product.
For more information about Rational Software technical publications, see: http://www.rational.com/documentation.
For more information on training opportunities, see the Rational University Web site: http://www.rational.com/university.
vii Contacting Rational Customer Support
When contacting Rational Customer Support, please be prepared to supply the following information:
About you:
❑ Name, title, e-mail address, telephone number
About your company:
❑ Company name and company address
About the product:
❑ Product name and version number (see Help > About menu) Example: 2003.06.00.xxx.xxx, plus the internal build number zzz.yyy.
❑ What components of the product you are using
About your development environment:
❑ Operating system and version number (for example: Linux Red Hat 7.2)
❑ Target compiler, operating system and microprocessor.
About your problem:
❑ Your service request number (if you are calling about a previously reported problem)
❑ A summary description of the problem, related errors, and how it was made to occur
❑ Please state how critical your problem is
❑ Any files that can be helpful for the technical support to reproduce the problem (project, workspace, test scripts, source files). Formats accepted are .zip and compressed tar (.tar.Z or .tar.gz) If your organization has a designated, on-site support person, please try to contact that person before contacting Rational Customer Support. You can obtain technical assistance by sending e-mail to just one of the e-mail addresses cited below. E-mail is acknowledged immediately and is usually answered within one working day of its arrival at Rational. When sending an e-mail, place PurifyPlus for Linux in the subject line, and include a description of your problem in the body of your message. Note: When sending e-mail concerning a previously-reported problem, please include in the subject field: “[SR#
viii Rational PurifyPlus for Linux Installation Guide Sometimes Rational technical support engineers will ask you to fax information to help them diagnose problems. You can also report a technical problem by fax if you prefer. Please mark faxes "Attention: Customer Support" and add your fax number to the information requested above.
Your Address Telephone E-mail Location
North Rational Software, (800) 433-5444 [email protected] America 18880 Homestead Road, Cupertino, CA 95014
Europe, Rational Software, +31 (0) 20-454-6200 [email protected] Middle East, Beechavenue 30, Africa 1119 PV Schiphol-Rijk, The Netherlands
Asia Pacific Rational Software +61 2-9419-0111 [email protected] Corporation Pty Ltd, Level 13, Tower A, Zenith Centre, 821 Pacific Highway, Chatswood NSW 2067, Australia
Preface ix x Rational PurifyPlus for Linux Installation Guide Before You Install 1
This chapter explains the tasks you must perform before you install Rational PurifyPlus for Linux on a desktop or client.
Upgrading Rational PurifyPlus for Linux
A new version of PurifyPlus for Linux can be installed alongside one or several previous versions. In this case, any shortcut icons installed in your window environment will need updating.
Installing Mixed Versions of Rational Products
In most cases, you cannot run mixed versions of Rational products on the same computer. Please ensure that all your Rational software is currently at version 2003.06.00.
Licensing PurifyPlus for Linux
When you purchase PurifyPlus for Linux, you purchase a specific number of licenses to use the product. Rational Software issues you a license key for the product that corresponds to the type and number of licenses you purchased. You must have a license key installed and configured to run a Rational product. Your license administrator may have already requested the permanent or evaluation license keys. Consult with your license administrator about which license keys you need for your Rational products. PurifyPlus for Linux comes with a temporary license to get you started. You then request a permanent or TLA license key from Rational Software at http://www.rational.com/accountlink and install it to ensure continued use of the products. The startup license key and other licensing information is available from the License Key Certificate included in the product packaging. This product uses the Rational License Key Administrator to manage product licenses. For more information on license key administration, see the License Management Guide online manual.
1 Requesting your Permanent or TLA License Key To request a permanent or TLA license key, go to the following Web site and follow the instructions provided there: http://www.rational.com/accountlink
Administrator Privileges
To install Rational PurifyPlus for Linux, you must have Administrator privileges on the local system.
Hardware and Software Requirements
The following tables provide the recommendations and requirements for operating Rational PurifyPlus for Linux on your desktop. Table 1 Hardware and Software Requirements
Item Requirements and Recommendations
Operating System Linux Red Hat 7.2, 7.3 and 8.0 Linux SuSE 8.1 Note For Linux, our product is dynamically linked with the following libc libraries: RedHat: libc.so.6 => /lib/i686/libc.so.6 => libc-2.2.4.so Suse: libc.so.6 => /lib/libc.so.6
Hardware 256 MB RAM is the recommended minimum; more memory generally improves responsiveness. 800 X 600 X 256-color video resolution, or higher; high color or true color recommended Mouse or pointing device
Disk Space 140 MB free disk space (minimum installation) Swap space: 2 x physical memory
2 Rational PurifyPlus for Linux Installation Guide Item Requirements and Recommendations
Language Support You can install Rational products on these international operating systems: Simplified or Traditional Chinese Dutch, French German Hebrew Italian Japanese Korean Swedish All displays, menus, controls, wizards, reports, and user documentation are in U.S. English.
If you have a Traditional Chinese, Dutch, Hebrew, or Korean operating system, enter data (such as path names) in U.S. English or the ASCII character set.
If you have a Simplified Chinese, French, German, Italian, Japanese, or Swedish operating system, enter data in U.S. English or the native language character set. Regional date, time, currency, and numbering conventions are also supported for both input and output.
Rational Documentation Adobe Acrobat Reader 4.x or higher to read online PDF files. Download the free Adobe Acrobat Reader from www.adobe.com. A Java and Javascript-enabled browser to access the online HTML documentation. Netscape 7.0 or later recommended. Download Netscape from www.netscape.com.
Integrations with 3rd Party Rational ClearCase 2003.06.00 Development Applications Rational ClearQuest 2003.06.00
Chapter 1 - Before You Install 3 4 Rational PurifyPlus for Linux Installation Guide Installing on UNIX 2
Use the Rational rs_install script for initial and upgrade installations of Rational products on UNIX platforms. This chapter explains how the rs_install script can help you install Rational PurifyPlus for Linux.
Using the rs_install Script
For environments where more than one user is using the product, install the main files on a centralized server.
Before You Start the rs_install Script The following general requirements are necessary to run the rs_install Script on the system.
Read the relevant Release Notes file on the product CD for the latest installation notes before running the installation process: ReleaseNotes/pplx-rn2003.06.00.htm
Stop all applications before you begin the installation.
Make certain that the system meets the minimum requirements and the correct operating system.
Any registered user on the system may install the product.
Users must have a native compiler registered in their PATH environment, such as gcc or a native C or C++ compiler.
5 Installing from the CD-ROM Image
This section describes a typical installation of from the CD-ROM. The rs_install script guides you through the software installation. Note: Interrupting an installation that is in progress may leave your system in an indeterminate state. If you try to cancel the execution of the rs_install script while the installation is in progress, you are asked to confirm that you want to exit from the incomplete installation.
To install PurifyPlus for Linux from a CD-ROM image: 1 Log in to the local machine on which you want to install the product. 2 Place the product CD in the CD-ROM drive and mount the CD-ROM. See the instructions for your particular CD-ROM drive and operating system for details. Note: On Linux systems the CD-ROM may be automatically mounted. 3 From a shell, change directory to the mounted CD-ROM device. For example: % cd /cdrom 4 Run the rs_install installation program: % rs_install The rs_install program prompts you through the installation process, providing detailed instructions along with default settings. The defaults appear in brackets (for example: [2]). To accept the default, press ENTER. 5 After you install your license key, the rs_install program reminds you that you must configure your server to automatically restart the license server when it reboots. The rs_install program gives you instructions for doing this. For any license-related issues, please refer to the License Management Guide, provided with the product. 6 Change to the following directory:
6 Rational PurifyPlus for Linux Installation Guide Questions and Answers about rs_install Below are the answers to some common questions about the rs_install program.
Can I rerun parts of the installation? Yes. The rs_install program provides commands that enable you to rerun specific sections of the installation as needed.
Do I have to reenter my license server information each time I install a product? No. You only need to enter this information once. The rs_install program saves the information you enter about yourself and about the machine to be used as the license server for your Rational Software product licenses in two text files: an rs_install.defaults file that contains information about you and your license server, and a file, that records product-specific information. The rs_install program reports the location of these files when you quit the program. The next time you run rs_install, the program uses the saved configuration information.
Do I need to install all my licenses on one server? No. You are not required to use all of your allowed licenses for a single-license server. You can install a product at another site and configure a license server at that site to serve the remaining licenses in your Rational Software account.
Which type of product license key should I install? If you already have your permanent or TLA license key, you can install it right away. You can also request a permanent license key at: http://www.rational.com/accountlink Otherwise, select the startup or evaluation license to get started using the product. Note: To ensure uninterrupted use of your Rational Software product, you should install your permanent or TLA license key as soon as possible.
Can I import existing user names from an earlier installation of the product installed with Named User licensing? Yes. If you installed the product previously under FLEXlm, the user names are imported automatically when you run rs_install. If you installed the product under PureLA License Administrator, rs_install asks you if you want to import the existing users.purela file, and also permits you to edit the imported user names.
How do I proceed if I already have other Rational product licenses installed on my server? You must add the new licenses to your current Rational product license file. To do this, specify the current Rational license file as the license file name instead of using the default.
Chapter 2 - Installing on UNIX 7 How do I get updates for the rs_install program and for the Rational products? You can get updates from within the rs_install program, though you must be running the program on a machine that has network access. The rs_install program’s Licensing Options screen lets you select an item to download the latest version of rs_install (in which case rs_install replaces itself and restarts using the new version) or get product updates.
8 Rational PurifyPlus for Linux Installation Guide After You Install 3
This chapter explains how to start using Rational PurifyPlus for Linux. It includes the following topics:
Launching the Product
Accessing the Online Documentation
Troubleshooting
Launching the Product
PurifyPlus for Linux can be used either in a graphical environment or through a command line interface. When using the product for the first time, the graphical user interface (GUI) provides a convenient way to access all PurifyPlus for Linux features.
To Run the Graphical User Interface The binaries are located in the following directory:
9 2 Type the following command to start the product graphical user interface: studio To simplify the execution of PurifyPlus for Linux, you can add the script file parameters to your .profile account parameters. Alternatively, the following script configures the environment and launches PurifyPlus for Linux in sh or bash shells:
License Variable The environment variable RSU_LICENSE_MAP is used by Rational Products for some advanced licensing features. In some cases, PurifyPlus for Linux may produce an error message such as: License manager: RSU Licensing WARNING: Couldn’t open map file from $RSU_LICENSE_MAP: ./NIX If this error occurs, use one of the following work arounds: Unset the variable manually for the current shell. For bash, this command would be: unset RSU_LICENSE_MAP Alternatively, launch the PurifyPlus for Linux tool from within a script, which might be: #!/bin/bash if [ -z $RSU_LICENSE_MAP -o -r $RSU_LICENSE_MAP ] then launch_tool else unset RSU_LICENSE_MAP launch_tool fi
10 Rational PurifyPlus for Linux Installation Guide Accessing the Online Documentation
The entire documentation set for PurifyPlus for Linux is provided as a full-featured online help system:
If this is the first time you are using PurifyPlus for Linux, take the time to complete the relevant Online Tutorial. This provides a quick and practical approach to using the product.
The User Guide provides online help and information about testing and monitoring your software in PurifyPlus for Linux.
The Reference Manual provides advanced information about the test script languages used by PurifyPlus for Linux as well as command line usage. These documents were designed to be viewed on a latest generation Java and Javascript enabled Web browser. Netscape 6.0 or later is strongly recommended. Both environments provide contextual help from within the application, a full-text search facility, and direct navigation through the Table of Contents and Index panes on the left-hand side of the Help window.
Browsing the Online Documentation Before opening the online documentation, ensure that your Web browser has Java and Javascript support options enabled. In your Web browser, locate and open the following file:
Troubleshooting
If you encounter any problems with the software, try the following suggestions before you call Rational Customer Support for help.
Chapter 3 - After You Install 11 Installation Issues If the installation procedure fails:
Stop all applications before you begin the installation.
Change to a standard VGA video driver while Rational Setup is running, or disable video features such as virtual screens or screen switching.
Change to a standard mouse driver or disable special mouse features that perform tasks such as leaving pointer trails or changing pointer sizes.
Software Errors If PurifyPlus for Linux fails to run, try any of the following suggestions:
Check that the environment variables such as $TESTRTDIR are correctly set. If not, refer to the installation instructions, or set the environment variables manually. See the Reference Manual for a list of required environment variables.
For any license-related issues, please refer to the License Management Guide manual provided with the relevant product.
Documentation Problems If the Online Documentation fails to display correctly:
Ensure that you have the latest supported version of a browser that supports Java, Javascript and frames, such as Netscape 6 or later. Check that you have enabled Java support in the browser.
When using an X terminal, ensure that the DISPLAY parameters are correctly set.
Try starting the web browser before launching the online Help from PurifyPlus for Linux.
12 Rational PurifyPlus for Linux Installation Guide Uninstalling Rational PurifyPlus for Linux 4
This chapter explains how to remove Rational PurifyPlus for Linux 2003.06.00 from your computer.
Removing the Product
To remove the product from a UNIX platform, simply delete the relevant installation directory: rm -rf
13 14 Rational PurifyPlus for Linux Installation Guide