IBM Rational Developer for Power Systems Software V8.5

Installation Guide

Overview

For more information about the product, visit the IBM Rational Developer for Power Systems Software home page at http://www.ibm.com/software/rational/products/rdp/.

IBM Installation Manager

IBM Installation Manager does more than install packages; it helps you keep track of what you have installed, determine what is available for you to install, and organize installation directories.

IBM Installation Manager includes six wizards that make it easy to maintain packages through their life cycles:

1. The Install wizard walks you through the installation process. You can install a package by simply accepting the defaults, or you can modify the default settings to create a custom installation. Before you install, you are provided with a complete summary of your selections throughout the wizard. Using the wizard you can install one or more packages at one time.
2. The Update wizard will search for available updates to packages that you have installed. An update might be a released fix, a new feature, or a new version of the product. Details of the contents of the update are provided in the wizard. You can choose whether to apply an update.
3. The Manage Licenses wizard helps you set up the licenses for your packages. Use this wizard to change your trial license to a full license.
4. The Roll Back wizard enables you to revert to a previous version of a package.
5. The Uninstall wizard will remove a package from your computer. You can uninstall more than one package at a time.
6. With the Modify wizard you can modify certain elements of a package that you have already installed. During the first installation of the package, you select the features that you want to install. If you find later that you require other features, you can use the modify packages wizard to add them to your package. You can also remove features and add or remove languages.

For more information about IBM Installation Manager, visit the IBM Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1r5/index.jsp.

IBM Rational Software Delivery Platform

Installation requirements

Hardware requirements

The following are hardware requirements for installing:

Software requirements

IBM i System

• IBM i 5.4, 6.1 or 7.1 with the following installed:
  • 5722WDS option 60 for 5.4
  • 5761WDS option 60 for 6.1
  • 5770WDS option 60 for 7.1
• IBM Rational Developer for Power Systems Software V8.5 support for the IBM i release will end when that IBM i release officially ends service, or when IBM Rational Developer for Power Systems Software V8.5 officially ends service.
• Some components will need additional program temporary fixes (PTFs).

  To find more information about any required Power Systems server PTFs:

  1. Open the Remote System Explorer perspective if it is not already open. The name of the current perspective is shown in the top left corner of the title bar for the Window. To open the Remote System Explorer perspective select Window -> Open Perspective -> Other and select Remote System Explorer from the list.
  2. Create a connection to your IBM i by expanding New Connection and double-clicking on IBM i.
  3. Expand your new connection and right click on IBM i Objects. Select Verify Connection from the menu. This displays a dialog that shows which required PTFs are already installed on the system and which ones are missing.
• IBM i is needed only if the programming objects are located on the IBM i or the applications contain backend code on the IBM i.
• To compile RPG, COBOL, C, C++, CL, or DDS on the IBM i using the Remote System Explorer (RSE), the compilers must be installed.

AIX System

• AIX V5.3 subject to the following limitations:
  • Must be TL 7 or higher for base IBM Rational Developer for Power Systems Software (AIX editions) support and only if there is an Extended Service Agreement
  • Must be TL 12 or higher if using the Performance Advisor
• AIX V6.1 subject to the following limitations:
  • Must be TL 5 or higher if using the Performance Advisor
• AIX V7.1
• IBM Rational Developer for Power Systems Software V8.5 support for the AIX release will end when that AIX release officially ends service, or when IBM Rational Developer for Power Systems Software V8.5 officially ends service.
• AIX is needed only if the programming objects are located on AIX or the applications contain backend code on AIX.
• To compile C, C++, or COBOL on AIX using the tooling, the appropriate compiler must be installed.
  1. IBM COBOL for AIX V4.1.1, 4.1, or 3.1
  2. IBM XL C/C++ for AIX V12.1, 11.1, 10.1, or 9.0
• Additional setup is required for the tooling to access the AIX system. Refer to the Installation tasks for AIX section for details.

Linux on Power System

• Red Hat Enterprise Linux (RHEL) Server 5 (Update 5 or higher) for IBM Power, Red Hat Enterprise Linux (RHEL) Server 6 for IBM Power, SUSE Linux Enterprise Server (SLES) 10 (SP3 or higher) for IBM Power, or SUSE Linux Enterprise Server (SLES) 11 (SP1 or higher) for IBM Power
• IBM Rational Developer for Power Systems Software V8.5 support for the Linux release will end when that Linux release officially ends service, or when IBM Rational Developer for Power Systems Software V8.5 officially ends service.
• Linux is needed only if the programming objects are located on Linux or the applications contain backend code on Linux.
• To compile C, or C++ on Linux using the tooling, the appropriate compiler must be installed.
  1. IBM XL C/C++ for Linux V12.1, 11.1, or 10.1
  2. GNU C/C++ compiler, 4.3 or higher
• Additional setup is required for the tooling to access the Linux system. Refer to the Installation tasks for Linux on Power section for details.

Client Operating system

The following operating systems are supported for this product:

• Microsoft® Windows® XP Professional in 32-bit mode
• Microsoft Windows Server 2008 Standard and Enterprise Edition in 32-bit and 64-bit mode
• Microsoft Windows 7 Professional, Enterprise and Ultimate Edition in 32-bit and 64-bit mode
• Microsoft Windows Server 2008 R2 Standard and Enterprise Edition
• Red Hat Enterprise Linux (RHEL) Desktop 5 x86-32 and x86-64
• Red Hat Enterprise Linux (RHEL) Desktop 6 x86-32 and x86-64
  • Note: a workaround is required to install Installation Manager on RHEL 6.0 (64-bit). See Technote 1459143 Unable to install Installation Manager on RHEL 6.0 (64-bit).
• SUSE Linux Enterprise Desktop (SLED) 11 x86-32
• Ubuntu 10.04 LTS x86-32 and x86-64
  • Note: 64-bit JVM is not supported for Ubuntu 10.04 x86-64.

Other software requirements

Some features of IBM Rational Developer for Power Systems Software V8.5, such as the IBM i Web Services and Java™ Tools feature require additional software.

Refer to the Features section for details.

User privileges requirements

• Your user ID must not contain double-byte characters.
• For administrator installs:
  • For Windows, the user privileges required for install tasks and to start the launchpad depend on the version of Windows on your computer:
    • For Windows 7, 2008, and later versions, you must log in to the Administrator account (or run as Administrator; right-click the program file or shortcut and select Run as Administrator).
    • For other supported Windows versions, you must have a user ID that belongs to the Administrators group.
  • For Linux®, you must log in as a user with root authority for install tasks and to start the launchpad. The product can then be run as non-root.

Planning to install

Installation scenarios

The following are some of the factors that might determine your installation scenario:

• The format and method by which you access your installation files (for example, from DVD or files downloaded from IBM Passport Advantage®).
• The location for your installation (for example, you can install the product onto your own workstation, or make the installation files available to your enterprise)
• The type of installation (for example, you can use the IBM Installation Manager GUI, or install silently).
• The mode of installation (for example, administrator or non-administrator).

These are the typical installation scenarios you might follow:

• Installing from the DVD.
• Installing from a downloaded electronic image.
• Installing from a repository on an HTTP or HTTPS Web server.

Note that in the latter two scenarios you can choose to run the IBM Installation Manager program in silent mode to install IBM Rational Developer for Power Systems Software V8.5. For details on running IBM Installation Manager in silent mode, see Installing silently.

Note also that you can install updates at the same time that you install the base product package.

Note that to install IBM Rational Developer for Power Systems Software V8.5 as a non-administrator, you must manually run the userinst program in the InstallerImage_platform folder from the DVD or electronic image instead of running the launchpad program. The userinst program provides the same functionality as the launchpad program.

Installing from DVD

In this installation scenario, you have the DVD that contains the product package files, and typically you are installing IBM Rational Developer for Power Systems Software V8.5 on your own workstation. See Installing Rational Developer for Power Systems Software from DVD: task overview for an overview of the steps.

Installing from a downloaded electronic image on your workstation

In this scenario, you have downloaded the installation files from either IBM Passport Advantage or IBM's Entitled software support site and you will install IBM Rational Developer for Power Systems Software V8.5 on your own workstation. See Installing IBM Rational Developer for Power Systems Software V8.5 from an electronic image: task overview for an overview of the steps.

Installing from a repository on an HTTP or HTTPS Web server

This scenario is the fastest method for installing the product on a network and is different from the shared-drive installation. To place product package files for IBM Rational Developer for Power Systems Software V8.5 on an HTTP or HTTPS Web server, you must use IBM Packaging Utility, a utility application, to copy the installation files in a package format that you can use to install IBM Rational Developer for Power Systems Software V8.5 directly from an HTTP or HTTPS Web server. This utility is provided with IBM Rational Developer for Power Systems Software V8.5. The directory on the HTTP or HTTPS Web server that contains the package is called a repository. See Installing Rational Developer for Power Systems Software V8.5 from a repository on an HTTP or HTTPS Web server: task overview and Placing IBM Rational Developer for Power Systems Software V8.5 on an HTTP Web server: task overview for an overview of the steps.

Deciding which features to install

When you install the IBM Rational Developer for Power Systems Software V8.5 product package by using IBM Installation Manager, the installation wizard displays the features in the available product package. From the features list, you can select which to install. A default set of features is selected for you (including any required features). IBM Installation Manager automatically enforces any dependencies between features and prevents you from clearing any required features.

If you select any non-English language during the installation, all languages are installed. For components from other groups that do not translate into the same set, a mix of English and translated content may appear.

Features

Upgrade and coexistence considerations

Offering coexistence considerations

Some products are designed to coexist and share function when they are installed in the same package group. A package group is a location where you can install one or more software products or packages. When you install each package, you select whether you want to install the package into an existing package group, or whether you want to create a new one. IBM Installation Manager will block products that are not designed to share or do not meet version tolerance and other requirements. If you want to install more than one product at a time, the products must be able to share a package group.

At the time of release, the following products will share function when installed into a package group:

• IBM Rational Application Developer, V8.5
• IBM Rational Business Developer, V8.5
• IBM Rational Software Architect for WebSphere Software, V8.5
• IBM Rational Developer for System z®, V8.5
• IBM Rational Developer for System z Enterprise Edition, V8.5
• IBM Rational Team Concert client, V4.0 and V3.0.1
• IBM Rational Host Access Transformation Services, V8.5
• IBM WebSphere Application Server Developer Tools for Eclipse, V8.5
• IBM Web Development Extension For Power Systems Software, V8.5

IBM Rational Developer for Power Systems Software V8.5 does not support installation into a package group that contains one of the following products:

• IBM Rational Developer for System i®, V7.1
• IBM Rational Developer for i, V7.5
• IBM Rational Developer for Power Systems Software, V7.5
• IBM Rational Developer for Power Systems Software, V7.6
• IBM Rational Developer for Power Systems Software, V8.0
• IBM WebSphere Development Studio Client for System i, V7.0
• IBM WebSphere Development Studio Client for System i Advanced Edition, V7.0
• IBM WebSphere Developer for System z, V7.0
• IBM Rational Developer for System z, V7.5
• IBM Rational Developer for System z, V7.6

Any number of eligible products can be installed into a package group. When a product is installed, its function is shared with all of the other products in the package group. If you install a development product and a testing product into one package group, when you start either of the products, you have both the development and testing functionality available to you in your user interface. If you add a product with modeling tools, all of the products in the package group will have the development, testing, and modeling functionality available.

If you install a development product and later purchase a development product with increased functionality and add that product to the same package group, the additional function will be available in both products. If you uninstall the product with the greater functionality, the original product remains.

Installation repositories

If the launchpad is used to start IBM Installation Manager, the repository information is passed to Installation Manager. If the IBM Installation Manager is started directly, you must specify an installation repository that contains the product packages that you want to install. See Setting repository preferences in IBM Installation Manager.

Some organizations bundle and host their own product packages on their intranet. For information about this type of installation scenario, see Installing from a repository on an HTTP or HTTPS Web server. Your system administrators will need to provide you with the correct URL.

By default, IBM Installation Manager uses an embedded URL in each Rational software development product to connect to a repository server over the Internet. IBM Installation Manager then searches for the product packages as well as new features.

Setting repository preferences in IBM Installation Manager

Before you begin

Before starting the installation process, be sure to obtain the installation package repository URL from your administrator.

About this task

To add, edit, or remove a repository location in IBM Installation Manager:

1. Start IBM Installation Manager.
2. On the Start page of IBM Installation Manager, click File -> Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and whether they are accessible.
3. On the Repositories page, click Add Repository.
4. In the Add repository window, type the URL of the repository location or browse to it and set a file path.
5. Click OK. If you provided an HTTPS or restricted FTP repository location, then you will be prompted to enter a user ID and password. The new or changed repository location is listed. If the repository is not accessible, a red x is displayed in the Accessible column.
6. Click OK to exit.

What to do next

For IBM Installation Manager to search the default repository locations for the installed packages, ensure the preference Search service repositories during installation and updates on the Repositories preference page is selected. This preference is selected by default.

Package groups and the shared resource directory

Package groups

During the installation process, you must specify a package group for the IBM Rational Developer for Power Systems Software V8.5 package. A package group represents a directory in which packages share resources with other packages in the same group. When you install the IBM Rational Developer for Power Systems Software V8.5 package using IBM Installation Manager, you can create a new package group or install it into an existing package group. (Some packages might not be able to share a package group, in which case the option to use an existing package group will be disabled.)

Note that when you install multiple packages at the same time, all the packages are installed into the same package group.

A package group is assigned a name automatically; however, you choose the installation directory for the package group.

After you create the package group by successfully installing a product package, you cannot change the installation directory. The installation directory contains files and resources specific to the IBM Rational Developer for Power Systems Software V8.5 product package installed into that package group. Resources in the product package that can potentially be used by other package groups are placed in the shared resources directory.

Shared resources directory

The shared resources directory is the directory where installation artifacts are located so that they can be used by one or more product package groups.

Preinstallation tasks

1. Confirm that your system meets the requirements described in the section Installation requirements.
2. Confirm that your user ID meets the required access privileges for installing the product. See User privileges requirements.
3. Read the section Planning to install and give particular attention to the topic Upgrade and coexistence considerations.

Installation tasks for AIX

The following sections provide an overview of the installation process for setting up and configuring the target AIX development system. You can access detailed instructions from links in the main steps.

This operation will only have to be done once for any AIX server that you wish to target for developing your applications.

AIX Server preinstallation tasks

1. Confirm that your system meets the software requirements described in the section Software requirements.
2. Confirm that your AIX user ID has root access.
3. The runtime for this tooling depends on the 32-bit IBM Java 1.5 JRE or JDK being installed on the server. The required fileset, Java5.sdk is on the AIX installation media and can be installed via "installp -aXgd /cdrom/usr/sys/inst.images Java5.sdk"
   1. For more information, refer to the IBM Java download page.

AIX Server install tasks

1. Confirm that your AIX user ID has root access.
2. In the product image there is a directory called disk1/AIXServerRuntime. In this directory are installp filesets. They need to be copied to a directory on the target AIX system. They can be installed by anyone who has root access on the target AIX server using the "installp" or "smitty installp" AIX commands. For example: "installp -agXd <directory_with_installp_filesets> all"
3. By default a daemon will start to run at port 8050. This port is used by the tooling to communicate with the AIX system. To configure a different port, you can edit the $port variable of the /opt/IBM/RDPower/8.5/rse/daemon.pl script.
4. To restart the daemon, an administrator will need to first kill the daemon and then restart it via the "telinit q" command.
5. To make the connection secure using SSL, the server needs to be configured as follows:
   1. You need to use keytool (provided by the java SDK) to generate a key pair (public and associated private key). The following command can be used to do this, given an aliasname, keystorename and a password: "keytool -genkey -alias <aliasname> -validity 3650 -keystore <keystorename> -storepass <password> -keypass <password>"
   2. After using keytool to generate a keystore, you need to edit the ssl.properties file in the /opt/IBM/RDPower/8.5/rse directory.

Installation tasks for Linux on Power

The following sections provide an overview of the installation process for setting up and configuring the target Linux development system. You can access detailed instructions from links in the main steps.

This operation will only have to be done once for any Linux server that you wish to target for developing your applications.

Linux Server preinstallation tasks

1. Confirm that your system meets the software requirements described in the section Software requirements.
2. Confirm that your Linux user ID has root access.
3. The runtime for this tooling depends on the 32-bit IBM Java 1.5 JRE or JDK being installed on the server. The required RPM package, ibm-java2-ppc-jre (or ibm-java2-ppc-sdk) can be installed via "rpm -ivh ibm-java2-ppc-jre*rpm" command.
   1. For more information, refer to the IBM Java download page.

Linux Server install tasks

1. Confirm that your Linux user ID has root access.
2. In the product image there is a directory called disk1/PowerLinuxServerRuntime. In this directory are RPM packages. They need to be copied to the target Linux system. They can be installed by anyone who has root access on the target Linux server using the "rpm" Linux utility commands (eg. rpm -ivh *.rpm). Please note, in case where JDK instead of JRE is installed, the dependency check option of RPM command needs to be disabled (--nodeps) when installing the server runtime packages (e.g. rpm -ivh *rpm --nodeps).
3. By default a daemon will start to run at port 8050. This port is used by the tooling to communicate with the Linux system. To configure a different port, you can edit the $port variable of the /opt/IBM/RDPower/8.0/rse/daemon.pl script.
4. To restart the daemon, an administrator will need to first kill the daemon and then restart it via the "telinit q" command.
5. To make the connection secure using SSL, the server needs to be configured as follows:
   1. You need to use keytool (provided by the java SDK) to generate a key pair (public and associated private key). The following command can be used to do this, given an aliasname, keystorename and a password: "keytool -genkey -alias <aliasname> -validity 3650 -keystore <keystorename> -storepass <password> -keypass <password>"
   2. After using keytool to generate a keystore, you need to edit the ssl.properties file in the /opt/IBM/RDPower/8.0/rse directory.

Installation tasks

The following sections provide an overview of the installation scenarios that are described in the section Installation scenarios. You can access detailed instructions from links in the main steps.

Installing Rational Developer for Power Systems Software from DVD: task overview

About this task

The following are the general steps for installing from DVD:

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Insert the installation media into your drive.
3. If autorun is enabled on your system, the Rational Developer for Power Systems Software launchpad program automatically opens. If autorun is not enabled, start the launchpad program. Refer to Starting the launchpad program for details.
4. Start the installation of Rational Developer for Power Systems Software from the launchpad. For details, see Starting an installation from the launchpad program.

Installing IBM Rational Developer for Power Systems Software V8.5 from an electronic image: task overview

About this task

The following are the general steps for installing IBM Rational Developer for Power Systems Software V8.5 from an electronic installation image:

1. Ensure that your workstation has sufficient space to store both the files you must download and the extracted installation image. You can download the installation image from either IBM Passport Advantage or IBM's Entitled Software Support site. Refer to Hardware requirements.
2. Download all required parts for the product image to a temporary directory.
3. Extract the installation image from the downloaded file and verify that the installation image is complete. See Verifying and extracting electronic images for details.
4. Continue with the steps in Installing from an electronic image below.

Installing from an electronic image

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Start the launchpad program. Refer to Starting the launchpad program for details.
3. Start the installation of IBM Rational Developer for Power Systems Software V8.5 from the Launchpad. For details, see Starting an installation from the launchpad program.
4. Follow the instructions in the Install wizard to complete the installation. For complete details, see Installing IBM Rational Developer for Power Systems Software V8.5 by using the Installation Manager GUI.

Installing Rational Developer for Power Systems Software V8.5 from a repository on an HTTP or HTTPS Web server: task overview

Before you begin

These steps assume the repository containing the package for IBM Rational Developer for Power Systems Software V8.5 has been created on the HTTP or HTTPS Web server.

About this task

To install the IBM Rational Developer for Power Systems Software V8.5 package from a repository on an HTTP or HTTPS server:

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Install IBM Installation Manager. Refer to Managing IBM Installation Manager. In this scenario, for example, the IBM Installation Manager installation files are available from a shared drive.
3. Start IBM Installation Manager. Refer to Starting IBM Installation Manager for details.
4. Set the URL of the repository containing the package of IBM Rational Developer for Power Systems Software V8.5 as a repository preference in IBM Installation Manager. See Setting repository preferences in IBM Installation Manager.
5. Start the Install wizard in IBM Installation Manager and follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Rational Developer for Power Systems Software V8.5 by using the Installation Manager GUI.

Placing IBM Rational Developer for Power Systems Software V8.5 on an HTTP Web server: task overview

About this task

To prepare IBM Rational Developer for Power Systems Software V8.5 for installation from a repository located on an HTTP Web server:

1. Ensure that your HTTP or HTTPS Web server has sufficient disk space to store the product package. Refer to Hardware requirements.
2. Ensure that your workstation has sufficient disk space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements
3. Download all required parts for the product image from IBM Passport Advantage to a temporary directory on your workstation.
4. Extract the installation image from the downloaded files into another temporary directory on your workstation and verify that the installation image is complete. See Verifying and extracting electronic images for details.
5. Install on your workstation the IBM Packaging Utility.
6. Using the Packaging Utility, copy the IBM Rational Developer for Power Systems Software V8.5 product package.
7. Copy the output of the Packaging Utility to an HTTP or HTTPS Web server.
8. Copy the installation files for IBM Installation Manager from product disk1 to a shared drive.
9. Instruct users in your organization to install IBM Installation Manager.
10. Provide users the URL for the repository that contains the IBM Rational Developer for Power Systems Software V8.5 product package you created earlier.

Verifying and extracting electronic images

About this task

If you select the Download Director option for downloading the installation files, the Download Director applet automatically verifies the completeness of each file that it processes.

Extracting the downloaded files

About this task

Extract the compressed files to a root directory (for example, on Windows, this could be C:\RDPower). After the files are extracted, they look like this:

• C:\RDPower\disk1

Installing from the launchpad program

About this task

Use the launchpad program to start the installation of IBM Rational Developer for Power Systems Software V8.5 in the following cases:

• Installing from the product DVD
• Installing from an electronic image

By starting the installation process from the launchpad program, IBM Installation Manager is automatically installed if it is not already on your computer, and it starts preconfigured with the location of the repository that contains the IBM Rational Developer for Power Systems Software V8.5 package. If you install and start Installation Manager directly, then you must set repository preferences manually.

To install from the launchpad:

1. Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.
2. Start the launchpad program. See Starting the launchpad program.
3. Start the installation of IBM Rational Developer for Power Systems Software V8.5. See Starting an installation from the launchpad program.

What to do next

Follow the instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Rational Developer for Power Systems Software V8.5 by using the Installation Manager GUI.

Starting the launchpad program

Before you begin

Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.

About this task

If you are installing from a DVD and autorun is enabled on your workstation, then the IBM Rational Developer for Power Systems Software V8.5 launchpad starts automatically when you insert the installation DVD into your DVD drive. If you are installing from an electronic image, or if autorun is not configured on your workstation, then you must start the launchpad program manually.

To start the launchpad program:

1. Insert the DVD of IBM Rational Developer for Power Systems Software V8.5 into your DVD drive.
2. If autorun is enabled on your system, the IBM Rational Developer for Power Systems Software launchpad program automatically opens. If autorun is not enabled on your system, or if you are installing from an electronic image, you need to run the launchpad program manually. The launchpad program is located in the root directory of the DVD or located in the root directory of the extracted installation image of the downloaded file for the first installation disk.
   • For Windows: Run launchpad.exe
   • For Linux: Run ./launchpad.sh

Starting an installation from the launchpad program

1. Start the launchpad program.
2. If you have not done so already, read the release information by clicking Release notes.
3. You should see 5 install options displayed on the launchpad. When you are ready to begin the installation, click on any of the 5 install options.
   • Install RPG and COBOL Development Tools for i feature
   • Install C and C++ Development Tools for AIX feature
   • Install C and C++ Development tools for Linux feature
   • Install COBOL Development Tools for AIX feature
   • Install all features
   The appropriate feature is selected by default in Installation Manager depending on the install option, selected from the launchpad.
4. If IBM Installation Manager is not detected on your system or if an older version is already installed, when the installation wizard start, it lists both the IBM Installation Manager V1.5.2 and IBM Rational Developer for Power Systems Software for installation. If IBM Installation Manager V1.5.2 is already installed, only IBM Rational Developer for Power Systems Software V8.5 will be shown.
5. Follow the instructions in the wizard to complete the installation of IBM Installation Manager and IBM Rational Developer for Power Systems Software. Refer to Installing IBM Installation Manager for more information.

Installing IBM Rational Developer for Power Systems Software V8.5 by using the Installation Manager GUI

1. From the IBM Installation Manager Start page, click Install.
   Note:
   If a new version of Installation Manager is found, you are prompted to confirm that you want to install it before you can continue. Click OK to proceed. Installation Manager automatically installs the new version, stops, restarts, and resumes.
2. The Install wizard lists all the packages found in the repositories that IBM Installation Manager searched. If two versions of a package are discovered, only the most recent, or recommended, version of the package is displayed.
   • To display all versions of any package found by IBM Installation Manager, check Show all versions.
   • To return to the display of only the recommended packages, un-check Show all versions.
3. Click the IBM Rational Developer for Power Systems Software V8.5 package to display its description in the Details pane.
4. To search for updates to the IBM Rational Developer for Power Systems Software V8.5 package, click Check for Other Versions and Extensions.
   Note:
   For Installation Manager to search the predefined IBM update repository locations for the installed packages, the preference Search the linked repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default. Internet access is also required.
   Installation Manager searches for updates at the predefined IBM update repository for the product package. It also searches any repository locations that you have set. A progress indicator shows the search is taking place. You can install updates at the same time that you install the base product package.
5. If updates for the IBM Rational Developer for Power Systems Software V8.5 package are found, then they will be displayed in the Installation Packages list on the Install Packages page below their corresponding product. Only recommended updates are displayed by default.
   • To view all updates found for the available packages, check Show all versions.
   • To display a package description under Details, click on the package name. If additional information about the package is available, such as a readme file or release notes, a More info link is included at the end of the description text. Click the link to display the additional information in a browser. To fully understand the package you are installing, review all information beforehand.
6. Select the IBM Rational Developer for Power Systems Software V8.5 package and any updates to the package that you want to install. Updates that have dependencies are automatically selected and cleared together. Click Next to continue.
   Note:
   If you install multiple packages at the same time, then all the packages will be installed into the same package group.
7. On the pre-requisites page, read the antivirus warning message displayed on the screen and follow the instructions, if applicable. Click Next to continue.
8. On the Licenses page, read the license agreement for the selected package.

   If you selected more than one package to install, there might be a license agreement for each package. On the left side of the License page, click each package version to display its license agreement. The package versions that you selected to install (for example, the base package and an update) are listed under the package name.

   1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
   2. Click Next to continue.
9. If you are installing Rational product for the first time, type the path for the shared resources directory in the Shared Resources Directory field on the Location page, or accept the default path. The shared resources directory contains resources that can be shared by one or more package groups. Click Next to continue.
   Important:
   You can specify the shared resources directory only the first time that you install a package. Use your largest disk for this to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
10. On the Location page, create a new package group to install the IBM Rational Developer for Power Systems Software V8.5 package into, or use an existing package group. A package group represents a directory in which packages share resources with other packages in the same group. To create a new package group:
    1. Click Create a new package group.
    2. Type the path for the installation directory for the package group. The name for the package group is created automatically.
    3. Select the bit mode (32bit or 64bit) of the installation.
       Note:
       If your operating system is 64-bit, you can either select 64-bit or 32-bit to install the product in the corresponding bit mode. Refer to the client operating system section in Software requirements for details on supported platforms.
    4. Click Next to continue.
11. On the Features page under Languages, select the languages for the package group. The corresponding national language translations for the user interface and documentation for the IBM Rational Developer for Power Systems Software 8.5 product package will be installed.
12. In the Features page where you select features for installation, the IBM i® Web Services and Java Tools or WebSphere JAX-WS Web service runtime feature might be disabled. If this happens, it means that the features that this feature depends on have not been installed yet. If this feature is disabled, you can continue your installation of IBM Rational Developer for Power Systems Software V8.5 without it. After the required features have been installed, use the Modify Packages option in the IBM Installation Manager to add this feature. Refer to Features for details.

    On the Summary page, review your choices before installing the IBM Rational Developer for Power Systems Software V8.5 package. If you want to change the choices that you made on previous pages, click Back and make your changes. When you are satisfied with your installation choices, click Install to install the package.

13. On the help system configuration page, read the instructions on screen and select one of the following options. Click Next to continue.
    • Access help from the Web
    • Download help and access content locally
    • Access help from a server on your intranet
14. When the installation process is complete, a message confirms the success of the process.
    1. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. Click Finish to launch the selected package. The Install Package wizard closes and you are returned to the Start page of Installation Manager.

Installing silently

About this task

You can install the IBM Rational Developer for Power Systems Software V8.5 product package by running Installation Manager in silent installation mode. When you run Installation Manager in silent mode, the user interface is not available; instead, Installation Manager uses a response file to input the commands that are required to install the product package. You can also install Installation Manager silently using the Installation Manager installer. You can then use the installer to silently install product packages.

For more detailed information about silent installation, visit the IBM Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1r5/index.jsp.

Starting IBM Rational Developer for Power Systems Software V8.5

About this task

To start IBM Rational Developer for Power Systems Software V8.5 from a command-line:

• For Windows:product_installation_directory\eclipse.exe -product com.ibm.rational.rdpower.product.ide
• For Linux:./product_installation_directory/eclipse -product com.ibm.rational.rdpower.product.ide

Managing licenses

About this task

IBM Rational Developer for Power Systems Software V8.5 comes with a permanent license for the product level and trial license for the either RPG and COBOL Development Tools for i feature, C and C++ Development Tools for AIX feature, C and C++ Development Tools for Linux feature, or COBOL Development Tools for AIX feature. If you are installing the software for the first time or want to extend a license to continue using the specific feature, you can activate licensing for the feature by importing a license activation kit using the Manage Licenses wizard. Using the Manage Licenses wizard, you can also enable Floating license enforcement for offerings with trial or permanent licenses to use floating license keys from a license server.

For more information on license activation and managing licenses for your Rational® product, see http://www.ibm.com/support/docview.wss?uid=swg21250404

Importing a license activation kit

Before you begin

If you have not purchased an activation kit, you must do this first. If you have purchased a product or a product activation kit, insert the appropriate DVD or download the activation kit from IBM Passport Advantage to an accessible workstation. The activation kit is packaged as a .zip file containing a Java archive (.jar) file. The .jar file contains the permanent license key and must be imported to activate your product.

About this task

To import an activation kit .jar file and enable the new license key, complete the following steps:

1. Start IBM Installation Manager.
2. On the main page, click Manage Licenses.
3. Select either RPG and COBOL Development Tools for i feature, C and C++ Development Tools for AIX feature, C and C++ Development Tools for Linux feature, or COBOL Development Tools for AIX feature and click Import Activation Kit.
4. Click Next. Details for the selected package are shown, including the current license kind and the product version range of the license.
5. Browse to the path on the media DVD or download location for the activation kit; then select the appropriate Java archive (JAR) file and click Open.
6. Click Next. The Summary page displays the target install directory for the activation kit, the product the new license applies to, and version information.
7. Click Finish.

Results

The product activation kit with its permanent license key is imported to the product. The Manage Licenses wizard indicates whether the import is successful.

Activating floating licenses

Before you begin

Before activating Floating license enforcement, you must obtain the license server connection information from your administrator. For details on license server, see http://www.ibm.com/support/docview.wss?uid=swg21250404

About this task

To activate floating licenses as the license type for specified packages and configure license server connections, complete the following steps:

1. Start IBM Installation Manager.
2. On the main page, click Manage Licenses.
3. On the Manage License page, select either RPG and COBOL Development Tools for i, C and C++ Development Tools for AIX, C and C++ Development Tools for Linux, or COBOL Development Tools for AIX, select the Configure Floating license support option and Click Next
4. On the Licenses page, read the license agreement for the selected package. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements and click Next to continue.
5. On the Floating License Support page, select the Enable Floating license enforcement and configure one or more license server connections:
   1. Click an empty field in the Servers table or click the Add button.
   2. If your administrator provided you with information for a redundant server environment, click the Redundant Server button. Fields for the primary, secondary, and tertiary server names and ports appear.
   3. Enter the host name of the license server in the Name field.
   4. Enter a value in the Port field for environments where a firewall is used. Do not assign a value to this port unless your administrator instructs you to do so.
   5. For redundant server environments, enter the names and ports (if required) for the secondary and tertiary servers.
   6. You can click the Test Connection button to confirm that the connection information is correct and that the server is
   7. Click OK.
6. Click Next.
7. Configure the license usage order for your shell shared or custom packages. The order of licenses in the list determines the order in which your package attempts to obtain access to license keys for a given licensed package.
8. Click Finish.

What to do next

Now, when you start the activated product, a connection is created to the license server to obtain a license key from the pool of available floating license keys.

Viewing license information for installed product packages

About this task

To view license information, complete the following steps:

1. Start IBM Installation Manager.
2. On the Start page, click Manage Licenses.

Results

The package vendor, current license types, and expiration dates are displayed for each installed product package.

Modifying installations

Before you begin

By default, Internet access is required unless the repository preferences points to a local update site. See the Installation Manager help for more information.

About this task

To modify an installed product package:

1. From the Start page of the IBM Installation Manager, click the Modify icon.
2. In the Modify wizard, select the installation location for the IBM Rational Developer for Power Systems Software V8.5 product package that you would like to modify and click Next.
3. On the Modify page, under Languages, select the languages for the package group, then click Next. The corresponding national language translations for the user interface and documentation for the packages will be installed. Note that your choices apply to all packages installed under this package group.
4. On the Features page, select the package features that you want to install or remove.
   1. To learn more about a feature, click the feature and review the brief description under Details.
   2. If you want to see the dependency relationships between features, select Show Dependencies. When you click a feature, any features that depend on it and any features that are its dependents are shown in the Dependencies window. As you select or exclude features in the packages, Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
5. When you are finished selecting features, click Next.
6. On the Summary page, review your choices before modifying the installation package, and then click Modify.
7. Optional: When the modification process completes, click View Log File to see the complete log.

Updating IBM Rational Developer for Power Systems Software V8.5

Before you begin

By default, Internet access is required unless your repository preferences points to your local update site.

Each installed package has the location embedded for its default IBM update repository. For IBM Installation Manager to search the IBM update repository locations for the installed packages, the preference Search service repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default.

See the IBM Installation Manager help for more information.

About this task

To find and install product package updates:

1. From the Start page of the Installation Manager, click Update.
2. If a new release or an update of IBM Installation Manager is found, you must continue with the installation of the new release or update. Follow the instructions in the wizard to complete the installation or update of Installation Manager.
3. In the Update wizard, select the location of the package group where the IBM Rational Developer for Power Systems Software V8.5 product package you want to update is installed or select the Update All check box, and then click Next. IBM Installation Manager searches for updates in its repositories and the predefined update sites for IBM Rational Developer for Power Systems Software V8.5. A progress indicator shows the search is taking place.
4. If updates for a package are found, then they are displayed in the Updates list on the Update Packages page below their corresponding package. Only recommended updates are displayed by default. Click Show all to display all updates found for the available packages.
   1. To learn more about an update, click the update and review its description under Details.
   2. If additional information about the update is available, a More info link will be included at the end of the description text. Click the link to display the information in a browser. Review this information before installing the update.
5. Select the updates that you want to install or click Select Recommended to restore the default selections. Updates that have a dependency relationship are automatically selected and cleared together.
6. Click Next to continue.
7. On the Licenses page, read the license agreements for the selected updates. On the left side of the License page, the list of licenses for the updates you selected is displayed; click each item to display the license agreement text.
   1. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements.
   2. Click Next to continue.
8. On the Summary page, review your choices before installing the updates.
   1. If you want to change the choices you made on previous pages, click Back, and make your changes.
   2. When you are satisfied, click Update to download and install the updates. A progress indicator shows the percentage of the installation completed.
   Note:
   During the update process, Installation Manager might prompt you for the location of the repository for the base version of the package. If you installed the product from DVDs or other media, they must be available when you use the update feature.
9. Optional: When the update process completes, a message that confirms the success of the process is displayed near the top of the page. Click View log file to open the log file for the current session in a new window. You must close the Installation Log window to continue.
10. Click Finish to close the wizard.

Reverting updates to previous versions

Uninstalling IBM Rational Developer for Power Systems Software V8.5

About this task

To uninstall the packages:

1. Close the programs that you installed using IBM Installation Manager.
2. On the Start page, click Uninstall.
3. On the Uninstall Packages page, select the IBM Rational Developer for Power Systems Software V8.5 product package that you want to uninstall. Click Next.
4. On the Summary page, review the list of packages that will be uninstalled and then click Uninstall. The Complete page is displayed after the uninstallation finishes.
5. Click Finish to exit the wizard.

Managing IBM Installation Manager

About this task

This section deals with some common tasks relating to IBM Installation Manager. For more information, see the IBM Installation Manager online help or the IBM Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1r5/index.jsp.

Installing IBM Installation Manager

About this task

If you start the installation of your product from the launchpad program, then the installation of IBM Installation Manager is started automatically if it is not already installed on your workstation. (For more information on this process, refer to Installing from the launchpad program.) In other cases, you must manually start the installation of IBM Installation Manager.

To start the installation of IBM Installation Manager manually:

1. Run install from the InstallerImage_platform folder on the first installation disk.
2. Click Next on the Install Packages page.
3. Review the license agreement on the License Agreement page and select I accept the terms in the license agreement to accept. Click Next.
4. Click the Browse button on the Location page to change the installation location if required. Click Next.
5. Click Install on the Summary page. When the installation process is complete, a message confirms the success of the process.
6. Click Finish. IBM Installation Manager opens.

Starting IBM Installation Manager

About this task

IBM Installation Manager should be started from the launchpad program. Doing so starts IBM Installation Manager with a configured repository preference and selected IBM Rational Developer for Power Systems Software V8.5 packages. If you start IBM Installation Manager directly, then you must set a repository preference and choose product packages manually. For more information, see Planning to install.

To start IBM Installation Manager manually:

• For Windows: Select Start -> All Programs -> IBM Installation Manager -> IBM Installation Manager.
• For Linux: Change to Installation Manager directory/eclipse and run IBMIM

Uninstalling IBM Installation Manager

About this task

To uninstall IBM Installation Manager complete the following steps:

• For Windows:
  1. Click Start -> Control Panel.
  2. In the Control Panel window, click Add or Remove Programs.
  3. In the Add or Remove Programs window, select IBM Installation Manager and click Remove.
  4. In the Add or Remove Programs dialog box, click Yes to continue with the removal.
• For Linux:
  1. Open a terminal window and change to the /var/ibm/InstallationManager/uninstall directory; then run ./uninstall
  2. In the IBM Installation Manager Uninstall Packages wizard, click Next ; then click Uninstall .

IBM Packaging Utility

Use this utility to perform the following tasks:

• Generate a new repository for product packages.
• Copy product packages to a new repository. You can copy multiple product packages into a single repository, thereby creating a common location for your organization from which product packages can be installed using IBM Installation Manager.
• Delete product packages from a repository.

IBM Packaging Utility software is located on the Enterprise Deployment CD. If you want to place a repository that contains an IBM Rational Developer for Power Systems Software V8.5 product package on a Web server that will be available over HTTP or HTTPS, you must use IBM Packaging Utility to copy the product package of IBM Rational Developer for Power Systems Software V8.5 into the repository.

Refer to the online help for IBM Packaging Utility for full instructions about using the tool.

Notices

© Copyright IBM Corporation 2012. All rights reserved.

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this documentation in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this documentation. The furnishing of this documentation does not give you any license to these patents. You can send license inquiries, in writing, to:

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

• developerWorks®
• DPI®
• i5/OS®
• IBM i
• AIX®
• IBM
• iSeries®
• OS/400®
• Passport Advantage
• Power Systems™
• Power Systems Software™
• pSeries®
• Rational
• System i
• Tivoli®
• WebSphere
• z/OS®
• zSeries®

Adobe® is a trademark of Adobe Systems Incorporated in the United States, other countries, or both.

Intel is a trademark of Intel Corporation in the United States, other countries, or both.

Java is a trademark of Sun Microsystems, Incorporated in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

Pentium® is a trademark of Intel Corporation in the United States, other countries, or both.

Other company, product or service names, may be trademarks or service marks of others.