IBM Rational Developer for z Systems Version 9.5.1

Installation Guide

GI11-8297-14

Contents

Note: Before using this information, be sure to read the general information under Notices.

Fifteenth edition (Decmber, 2015)

This edition applies to IBM® Rational® Developer for z Systems™ (program number 5724-T07) and to all subsequent releases and modifications until otherwise indicated in new editions.

Order publications by phone or fax. IBM Software Manufacturing Solutions takes publication orders between 8:30 a.m. and 7:00 p.m. eastern standard time (EST). The phone number is (800) 879-2755. The fax number is (800) 445-9269. Faxes should be sent Attn: Publications, 3rd floor.

You can also order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below.

IBM welcomes your comments. You can send your comments by mail to the following address:

IBM Corporation
Attn: Information Development Department 53NA
Building 501 P.O. Box 12195
Research Triangle Park NC 27709-2195.
USA

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

© Copyright IBM Corporation 2000, 2015

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

About this book

This installation guide provides instructions for installing and uninstalling IBM Rational Developer for z Systems.

This document contains information about the following tasks:

The following names are used in this manual:
  • IBM Rational Developer for z Systems is called Developer for z Systems
  • IBM Rational Developer for z Systems Common Access Repository Manager is called Common Access Repository Manager, abbreviated to CARMA
Note: The configuration information in this document is for IBM Rational Developer for z Systems Version 9.5.1.

For the most up-to-date versions of this document, see the IBM Rational Developer for z Systems Installation Guide (GI11-8297) available at http://www-05.ibm.com/e-business/linkweb/publications/servlet/pbi.wss?CTY=US&FNC=SRX&PBL=GI11-8297.

For the most up-to-date versions of the complete documentation, including installation instructions, white papers, podcasts, and tutorials, see the library page of the IBM Rational Developer for z Systems website (http://www-01.ibm.com/software/sw-library/en_US/products/Z964267S85716U24/).

Who should read this book

This book is intended for programmers who are installing and configuring Developer for z Systems client on their workstations. To use this book, you must be familiar with the Microsoft Windows operating system, the Red Hat Linux operating system, the SUSE Linux operating system, or the Ubuntu operating system.

Where to find more information about Developer for z Systems

This document does not contain information about using Developer for z Systems. For that information, see the online IBM Knowledge Center.

For information about product problems and limitations, see the rdz951_releasenotes.html file located in the RDz951_QSandDocumentation\releasenotes\en\ directory of the IBM Rational Developer for z Systems Quick Start e-image.

For updated documentation and troubleshooting information, see the Library page of the Developer for z Systems website: http://www-01.ibm.com/software/sw-library/en_US/products/Z964267S85716U24/?S_CMP=rnav.

Preinstallation tasks

About this task

Before you install the product, complete the following steps:
  1. Confirm that your system meets the requirements that are described in the Developer for z Systems hardware and software requirements including prerequisites and co-requisites, see the System Requirements tab on the Developer for z Systems website.
  2. Confirm that your user ID meets the following access privileges for installing the product.
    • Your user ID must not contain double-byte characters.
    • To install for all users of the system, you must have an ID that belongs to the Administrators group. If you do not have Administrator privileges, you can only install for the current user.
  3. Read the Planning to install section.
  4. Upgrade Rational License Key Server to version 8.1.2 or higher.
    Note: If you use floating licenses for IBM Rational Developer for z Systems (including token licenses), you must upgrade the license key server to Rational License Key Server, Version 8.1.2 or higher, before installing the product. Rational License Key Server, Version 8.1.2 or higher can be used with earlier versions of the product. For information about how to upgrade from version 7.1 or earlier versions of Rational License Key Server to version 8.1.2 or higher, see Migrating to Rational Common Licensing (http://www-01.ibm.com/support/knowledgecenter/SSSTWP_8.1.4/com.ibm.rational.license.doc/topics/t_migrate_rational.html).
  5. Before installing or uninstalling, disable antivirus and malware detection software.
    Note: Some antivirus and malware detection software occasionally locks certain files, especially .dll files. The locking interferes with installation and uninstallation operations. When .dll or other files are locked by these programs, installation and uninstallation operations fail with errors indicating that files could not be removed.

Planning to install

Read all of the topics in this section before attempting to install any of the product features. Many problems can be avoided by proper planning and understanding the key aspects of the installation process before actually beginning installation.

Installation methods

You can install Developer for z Systems by using several methods.

These are some factors that might determine the installation method that you use:

  • Whether you are installing onto your own workstation, or making the installation files available to your enterprise.
  • Whether you are installing by using the Installation Manager GUI, or installing silently.

These are the typical installation methods that you might use:

  • Installing from a downloaded electronic image on your workstation
  • Installing from an electronic image on a shared drive
  • Installing from a repository on an HTTP server
Note: You can run the Installation Manager program in silent mode. For details on running Installation Manager in silent mode, see Silent installation.

Using electronic images

Extracting electronic images

If you download the installation files from IBM Passport Advantage®, you must extract the electronic images from the compressed files for Developer for z Systems and any bundled offerings you want to install before you can begin the installation. Developer for z Systems electronic images are packaged as .zip files.

Note: Extracting the electronic images to a directory with spaces in the name may cause the product launchpad to not work correctly.

Installing from a downloaded electronic image on a workstation

With this method, you have downloaded the installation files from IBM Passport Advantage and you will install Developer for z Systems on your own workstation. For an overview of the steps, see Overview: Installing Developer for z Systems from an electronic image on your workstation .

Installing from an electronic image on a shared drive

With this method, you will place the electronic image on a shared drive so that users in your enterprise can access the installation files for Developer for z Systems from a single location. For an overview of the steps, see Overview: Installing Developer for z Systems from an electronic image on a shared drive .

Installing from a repository on an HTTP server

This method provides an alternative way to install across a network. This method is different from using an electronic image on a shared drive because, to place installation files for Developer for z Systems on an HTTP Web server, you must use a utility application called IBM Packaging Utility which is provided with the Developer for z Systems installation media on the Rational Enterprise Deployment disc. IBM Packaging Utility is used to copy the installation files in a package format that can be used for installing Developer for z Systems directly from an HTTP Web server. The directory on the HTTP Web server that contains the package is called a repository. The same repository can also be used for other offerings, and for future service updates. For an overview of the steps, see Overview: Installing Developer for z Systems from a repository on a HTTP Web server and Overview: Placing Developer for z Systems on an HTTP web server.

Feature installation

You can customize the Developer for z Systems installation by the features and bundled offerings to install. The Developer for z Systems launchpad provides you with the option of a guided installation or an expert installation.

For more information about the Rational Developer for z Systems launchpad program, see Installing Developer for z Systems by using the launchpad program.

Installation Manager automatically enforces any dependencies between features so that all of the required features are selected.

Note: After you finish installing the package, you can still add or remove features from the installation by running the Modify Packages wizard in Installation Manager. For more information, see Modifying installed packages.

Features for Rational Developer for z Systems

The following table shows the features of Developer for z Systems that you can choose to install. For information about the available features of other offerings that are bundled with Developer for z Systems, see the documentation for those offerings.

Table 1. Rational Developer for z Systems features
Feature Description
System z® Integrated Development Environment (required) Provides an interactive, workstation-based environment where you can connect to a mainframe and develop mainframe-based applications in COBOL, PL/I, Assembler, C/C++, and Java™.
Code Review (required) Inspects the code for compliance with rules and best practices. Code review highlights potential problems and recommends code changes for improved quality.
Line-Level Code Coverage (required) Provides the tools to measure and report on test coverage of an application. Reports indicate which source code lines have been tested and which lines remain to be tested.
System z Code Generators Provides design tools and wizards that you can use to rapidly create System z application code skeletons and logic from UML models or user-provided input.
IBM z/OS® Automated Unit Testing Framework (zUnit) Provides a code-driven unit testing framework for Enterprise COBOL and PL/I. The IBM z/OS Automated Unit Testing Framework (zUnit) provides an automated solution for executing and verifying Enterprise COBOL and PL/I unit test cases that are written using the zUnit framework.
SCLM Developer Toolkit Provides tools to access and work with source code managed by Software Configuration and Library Manager (SCLM).
CA Endevor Software Change Manager Provides tools to access and work with source code managed by CA Endevor® Software Change Manager.
Enterprise Service Tools for CICS® (including Service Component Architecture) Enterprise Service Tools for CICS provide an integrated set of tools that support modern application architectures and the transformation and reuse of existing CICS application processes. The tools support generation of Web service descriptions and service flow processing artifacts directly to a z/OS system, including CICS TS and the CICS Service Flow Runtime. Enterprise Service Tools quickly enable the move towards service-oriented architecture (SOA).
BMS Screen Designer Enables you to visually create and modify Basic Mapping Support (BMS) map sets. It is designed for CICS developers who are familiar with terminal-based tools (for example, SDF II) or GUI-based tools, such as the BMS editor included with VA COBOL.
CICS Code Generators Provides design tools and wizards that you can use to create CICS Transaction Server application code skeletons and logic from UML models or user-provided input, for example, using UML models or database schema definitions to generate CICS transactions which provide Create, Read, Update, and Delete interfaces to DB2® tables.
Enterprise Service Tools for IMS™ Provides an integrated set of tools that support modern application architectures and the transformation and reuse of existing IMS application processes. The tools support the generation of Web service descriptions and processing artifacts directly to a z/OS system, including the IMS SOAP Gateway and IMS information 2.0 applications. Enterprise Service Tools are designed to enable the move towards service-oriented architecture (SOA).
MFS Screen Designer Enables you to create and modify Message Format Service (MFS) message and format files. Many Information Management System (IMS) programs are based on MFS, which is an IMS Transaction Manager environment facility that formats messages to and from terminal devices.
IMS Code Generators Provides code snippets that you can use to add common programming objects to IMS application code.
Data Tools Provides relational database tools to work with tables, table views, and filters. With these tools, you can create physical database models by reverse engineering database tables or by using DDL scripts. You can also use the tools to create SQL statements, DB2 routines (such as stored procedures and user-defined functions), and several types of files, including SQLJ, SQL DDL, and XML files.
System z Stored Procedures
Note: This feature is being depricated.
Enables you to create and test DB2 stored procedures written in COBOL, PL/I, Java, or SQL, and deploy them directly to a z/OS system.
System z Debugger (required) Provides a workstation-based interface to IBM Debug Tool, facilitating remote debug sessions with applications executing on a z/OS System. Note: This feature requires that you have a license for IBM Debug Tool.
Integrated Debugger Provides a source level debugger that enables the user to step through a program, monitor and modify variables, set breakpoints during or before a debug session, and inspect program memory. In addition, the debugger capability includes automated management of connections, and uses workstation processors that enable faster processing of debug information.
Common Access Repository Manager (CARMA) Provides a unified interface and set of services for accessing z Systems-based source control management tools. CARMA also provides a generic graphical user interface (GUI) client that you can use as a framework for accessing and interfacing with custom source control management systems.

Media requirements

You can match references to physical discs with references to electronic image directories as shown in the following table.
Table 2. Disc name and electronic image references
Disc Name Electronic Image Directory Name
IBM Rational Developer for z Systems Setup disc
  • RDz951_Setup
IBM Rational Developer for z Systems Installation disc
  • RDz951\disk1
IBM Rational Team Concert™ Client 6.0 Installation disc
  • RTC60\disk1
IBM Rational Team Concert Integration for z Systems Installation disc
  • RDz951_RTCz\disk1
IBM Rational Developer for z Systems z/OS Installation disc
  • RDz951_zOS_SMPE
IBM Rational Developer for z Systems zLinux RSE Installation disc
  • RDz951_RSE
IBM Rational Developer for z Systems Quick Start and Documentation disc
  • RDz951_QSandDocumentation
IBM Rational Developer for z Systems Activation disc
  • RDz951_Activation
To install Developer for z Systems on the workstation, you must have access to the following media:
  • Developer for z Systems electronic image
    After you have downloaded the Developer for z Systems images from Passport Advantage and expanded them, the following directories apply to installing Developer for z Systems on the workstation:
    • RDz951_Setup
    • RDz951\disk1
To install the required z Systems components on the System z remote system, you must have access to the following media:
  • Developer for z Systems electronic image:
    After you have downloaded the Developer for z Systems images from Passport Advantage and expanded them, the following directories apply to installing required software on the z Systems remote system:
    • RDz951_zOS_SMPE
For instructions on installing the host code, see the installation configuration documentation in the related product directory:
  • RDz951_zOS_SMPE for z/OS systems
  • RDz951_RSE

Media for additional offerings

In addition to the Developer for z Systems media, you might have additional installation media for other offerings that are bundled with Developer for z Systems.

To install the Rational Team Concert Integration extension, you must have access to the following media:

Hardware and software requirements

For a complete listing of the Developer for z Systems hardware and software requirements including prerequisites and co-requisites, see the System Requirements tab on the Developer for z Systems website.

IBM Installation Manager

IBM Installation Manager is a program that installs Developer for z Systems and other packages on your workstation. It also updates, modifies, and uninstalls these and other packages that you install. A package can be a product, a group of components, or a single component that is designed to be installed with the Installation Manager.

For the most current information about the IBM Installation Manager, see the Installation Manager product documentation.

Installation Manager is an installation management tool that has several time-saving features. It helps you install, update, modify, and uninstall product packages on your computer. It keeps track of what you are about to install, as well as what you have already installed and what is available for you to install. It searches for updates so that you know that you are installing the latest version of a package. It also provides tools for managing licenses for the packages it installs, and for updating and modifying packages.

For information about how to deploy Developer for z Systems to many users, see the information available in the Enterprise installation articlessection of the Installation Manager product documentation.

Use the six wizards in Installation Manager to maintain a package through its lifecycle, as follows:
  • The Install wizard walks you through the installation process. You can install a package by accepting the defaults, or you can change the default settings to customize an installation. Before you install a package, you see a summary of your selections throughout the wizard. Using the wizard, you can install one or more packages at one time.
  • The Update wizard searches 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 decide whether to apply an update.
  • With the Modify wizard, you can change certain elements of a package that you have installed. During the first installation of the package, you select the features to install. If you require other features later, you can use the Modify wizard to add the features. You can also remove features.
  • The Manage Licenses wizard helps you set up the licenses for your packages. Use this wizard to change a trial license to a full license, to set up the servers for floating licenses, and to select the type of license to use for each package.
  • The Import wizard adds packages that were installed by using installation tools other than Installation Manager to the list of installed packages.

    Installation Manager tracks the products that it installs, including selectable features and maintenance updates for products. Earlier versions of some products that can be installed with Installation Manager might have been installed with different installation technology. Installation Manager must import information about existing installations of these products before Installation Manager can modify and update the products.

    Note: This wizard is available only after Installation Manager detects a package in a repository that requires this feature.
  • The Roll Back wizard enables you to revert to a previous version of a package.
  • The Uninstall wizard removes a package from your computer. You can uninstall more than one package at a time.

Installing Installation Manager

About this task

IBM Installation Manager is typically installed automatically as part of the Developer for z Systems installation process.

If you need to install IBM Installation Manager by itself, without installing Developer for z Systems, you can find the installation files:
  • On the downloaded an electronic image, in the RDz951_Setup\InstallerImage_platform directory
You can install Installation Manager directly from the installation media, or copy the InstallerImage_platform directory to a shared location where it can be accessed by others.
  1. Change to the InstallerImage_platform directory.
  2. To install as administrator for all of the users on the system, run the following command:

    install.exe

    install

    To install as a non-administrator for the current user only, run the following command:

    userinst.exe

    userinst

  3. On the first page of the Install Packages wizard, click Check for Other Versions and Extensions to install the latest available version. If a newer version is available, it is automatically selected for installation. Click Next.
  4. On the Licenses page, read the license agreements for IBM Installation Manager. If you agree to the terms of all of the license agreements, click I accept the terms in the license agreements and then click Next.
  5. On the Location page, in the Installation Manager Directory field, type the path for the directory where Installation Manager must be installed or accept the default path. Then click Next.
  6. On the Summary page, review your choices before starting the installation process. To change your selections, click Back to return to the previous pages. When you are satisfied with your selections, click Install.
You can also silently install Installation Manager by doing these steps:
  1. Open a command prompt or terminal window and change to the InstallerImage_platform directory (where platform is the platform on which you are installing).
  2. To install silently as administrator for all of the users on the system, run the following command:

    installc.exe -acceptLicense

    installc -acceptLicense

    To install as a non-administrator for the current user only, run the following command:

    userinstc.exe -acceptLicense

    userinstc -acceptLicense

    Note: By providing the -acceptLicense command line option, you indicate that you accept the terms of the IBM Installation Manager license agreement.

Starting Installation Manager

About this task

IBM Installation Manager is installed and started automatically when you start the Developer for z Systems installation.

If you need to start Installation Manager manually to update, modify, roll back, or uninstall packages following the installation, do these steps:

  1. Open the Start menu from the Taskbar.
    • For an administrator installation, click All Programs > IBM Installation Manager > IBM Installation Manager.
    • For a non-administrator installation, click All Programs > My IBM Installation Manager > IBM Installation Manager
  1. Open a terminal window.
  2. Go to the Installation Manager install directory/eclipse directory.
  3. Run this command: ./IBMIM

Uninstalling Installation Manager

About this task

Note: You cannot uninstall IBM Installation Manager until all of the packages have been uninstalled.
The IBM Installation Manager must be uninstalled using the Add or Remove Programs panel.
  1. Open the Start menu from the Taskbar.
  2. Select Control Panel > Add or Remove Programs > IBM Installation Manager.
  3. Click Remove and follow the on-screen instructions.
Do these steps to uninstall Installation Manager:
  1. Open a terminal window.
  2. Run the following command: /var/ibm/InstallationManager/uninstall/uninstall.

Using Installation Manager

Installation repositories

Installable offerings, or packages, are stored in locations called repositories, which can be on an HTTP Web server, shared network drive, physical discs, or a local workstation. Installation Manager retrieves packages from these repositories to install them on your system.

When you launch the installation of Developer for z Systems from the launchpad program, the necessary repository information is passed to Installation Manager automatically. Anytime you start Installation Manager manually from the Windows Start menu, you must specify the repositories that contain the packages to be installed. Enter the repository details in the Installation Manager repository preferences so that Installation Manager knows where to look for them. For more details, see Setting repository preferences in Installation Manager.

Some organizations might bundle and host their own product packages within their intranet. For this type of business case scenario, see Installing from a repository on an HTTP server. Your system administrators must provide you with the correct URL.

By default, IBM Installation Manager uses an embedded URL in each package that you install to connect to a repository server through the Internet and search for installable packages, such as service updates and new features.

Setting repository preferences in Installation Manager

About this task

When you start the installation of Developer for z Systems from the launchpad program, the necessary repository information is automatically passed to Installation Manager. However, if you start Installation Manager manually from the Windows Start menu, for example to install packages from a repository located on a Web server, you must add the repository location in the Installation Manager preferences before you can install the package. Adding the repository locations is done on the Repositories panel of the Preferences window in Installation Manager. By default, Installation Manager uses an embedded URL in each Rational software development product to connect to a repository server through the Internet and search for installable packages, updates, and new features. Your organization could require you to redirect the repository to use intranet sites.

Note: Before starting the installation process, be sure to obtain the installation package repository URL from your administrator.
To add, edit, or remove a repository location in Installation Manager, take the following steps:
  1. Start Installation Manager.
  2. On the Start page of Installation Manager, click File > Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and if they are accessible.
  3. On the Repositories page, click Add Repository.
  4. On the Add repository window, enter the URL of the repository location or browse to it and enter a file path, and then click OK. The new or changed repository location is listed. If the repository is not accessible, a red x is displayed in the Accessible column.
  5. Click OK to exit.

Package groups and the shared resource directory

When you install Developer for z Systems with IBM Installation Manager, you must choose a package group and a shared resource directory.

Package groups

During the installation process, you must specify a package group for Developer for z Systems and any other bundled offerings you are installing. A package group represents a directory in which the packages share resources with other packages in the same group. This is known as shell sharing. When you install Developer for z Systems and any bundled offerings with Installation Manager, you can create a new package group or install the packages 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 is not available.)

Note: Under most circumstances, when you install multiple packages at the same time, all of 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 package, you cannot change the installation directory for the package group. The installation directory contains files and resources that are specific to the packages installed into that package group. Other resources in the packages that can potentially be shared by other package groups are placed in the shared resources directory.

Shared resources directory

The shared resources directory is the directory where resources that can be shared by different packages, potentially in different package groups, are stored. Using a common location for these resources allows Installation Manager to install only one copy of each of these resources, thus conserving disk space, rather than installing separate copies of the same resources when they are used by multiple packages.

Important: You can specify the shared resources directory only once: the first time that you install a package. For best results, use the largest drive for this directory. You cannot change the directory location later unless you uninstall all of the packages.

Installing Developer for z Systems

Installation tasks summary

The following sections provide an overview of the various installation methods you might use when installing Developer for z Systems.

Overview: Installing Developer for z Systems from an electronic image on your workstation

About this task

The general steps for installing from an electronic installation image are these:
  1. Ensure that your workstation has sufficient space to store both the files that you must download from IBM Passport Advantage, the extracted installation image, and the offerings that you plan to install.
    Note:

    For a complete listing of the Developer for z Systems hardware and software requirements including prerequisites and co-requisites, see the System Requirements tab on the Developer for z Systems website.

  2. Download all of the required parts for Developer for z Systems and any bundled offerings to install from IBM Passport Advantage to a temporary directory.
  3. Extract the installation image from the compressed files that you downloaded and verify that the installation image is complete. See Extracting electronic images for details.
  4. Continue with the steps inInstalling from an electronic image.

Installing from an electronic image

About this task
Do these steps:
  1. Complete the pre-installation steps that are listed in Preinstallation tasks.
  2. Start the launchpad program by running the following command from the root of the RDz951_Setup directory:

    launchpad.exe

    launchpad.sh

    For details, see Installing Developer for z Systems.

    Note: If your operating system is Windows 7 or Windows 8 and you are installing the product for all users, then you must run launchpad.exe as administrator.
  3. Click Install Rational Developer for z Systems.
  4. Decide whether to do an expert installation or a guided installation of Developer for z Systems. A guided installation uses an installation wizard to help you decide which features to install. An expert installation starts with the most common features selected and asks you for the features to install. For details, see Installing Developer for z Systems.
  5. To install Developer for z Systems and any bundled offerings, follow the on-screen instructions in the IBM Installation Manager Install Packages wizard. For details, see Installing Rational Developer for z Systems by using Installation Manager.
  6. Configure the licenses for Developer for z Systems and any bundled offerings that you installed as needed. If you have a trial license and must configure a term or permanent license, or if you want to configure floating licenses, do so now. See Managing licenses for details.
  7. Install the additional software included with Developer for z Systems. For more information, see Installing additional software.

Overview: Installing Developer for z Systems from an electronic image on a shared drive

About this task

In this scenario, you will place the electronic image on a shared drive so that users in your enterprise can access the installation files for Developer for z Systems and any bundled offerings from a single location. Installing from a shared drive is also useful when you need to install silently on many user systems. Do these steps to place the installation image on a shared drive:
  1. Ensure that the shared drive has sufficient disk space to store both the files that you must download from IBM Passport Advantage and the extracted installation image.
    Note:

    For a complete listing of the Developer for z Systems hardware and software requirements including prerequisites and co-requisites, see the System Requirements tab on the Developer for z Systems website.

  2. Download all of the required parts for Developer for z Systems and any bundled offerings from IBM Passport Advantage to a temporary directory on the shared drive.
    Note: You can instead download the parts to your workstation and copy only the extracted installation image to the shared drive.
  3. Extract the installation image from the downloaded files to a directory on the shared drive that can be accessed by everyone. Verify the installation image is complete. See Extracting electronic images for details.
To install Developer for z Systems interactively from the installation files on the shared drive, do these steps:
  1. Change to the RDz951_Setup directory on the shared drive containing the installation image.
  2. Follow the steps in Installing from an electronic image to install Developer for z Systems and any bundled offerings.

For information about installing silently by using a shared electronic image, see Silent installation.

Overview: Installing Developer for z Systems from a repository on a HTTP Web server

About this task

In this scenario, the product packages are retrieved by the IBM Installation Manager from an HTTP Web server.

These steps assume the repository containing the packages for Developer for z Systems and any bundled offerings has been created on the HTTP Web server. For details on copying the installation packages to an HTTP Web server, see Overview: Placing Developer for z Systems on an HTTP web server.

To install the Developer for z Systems package from a repository on an HTTP server, take the following steps:
  1. Complete the pre-installation steps listed in Preinstallation tasks.
  2. Install IBM Installation Manager. See Installing Installation Manager.
  3. Start Installation Manager. For details, see Starting Installation Manager.
  4. Add the URL of the repository containing the Rational Developer for z Systems package to the repository preference in Installation Manager. See Setting repository preferences in Installation Manager.
  5. Click Install to start the Install Packages wizard in Installation Manager, and follow the on-screen instructions to complete the installation.
  6. Configure the licenses for Developer for z Systems and any bundled offerings you installed as needed. If you have a trial license and need to configure a term or permanent license, or if you want to configure floating licenses, do so now. See Managing licenses for details.
  7. Install additional software included with IBM Rational Developer for z Systems. For more information, see Installing additional software.

Overview: Placing Developer for z Systems on an HTTP web server

You can place the Developer for z Systems install package, and the other offering packages, on an HTTP web server by using the IBM Packaging Utility to create an installation repository. You might choose this method if you have several different offerings or service updates that must be placed in a single repository in addition to the Developer for z Systems offering and its bundled offerings. You can use this repository to install interactively or silently.

Note: Though you can install silently from a repository on an HTTP web server, such a server is not required for silent installations.

To place packages on an HTTP web server, you use the IBM Packaging Utility to create a new installation repository or copy to an existing repository. For detailed instructions on installing and using IBM Packaging Utility, see the Installation Manager product documentation. Managing packages with Packaging Utility contains the most current information.

After you have created the repository, do these steps:

  1. Provide the users in your enterprise with the URL of the installation repository. Users can point to the repository and install without having the installation media on their systems.
  2. Use the repository for silent installations. For details on running silent installations, see Silent installation.

Installing Developer for z Systems by using the launchpad program

The Developer for z Systems launchpad program provides you with a single location to view release information and begin the installation process.

Use the launchpad program to start the installation of Developer for z Systems in the following cases:
  • You are installing from an electronic image on your workstation.
  • You are installing from an electronic image on a shared drive.

When you start the installation from the launchpad program, IBM Installation Manager is launched with the necessary repository location information automatically configured. This automatic configuration frees you from having to set the repository location manually in the Installation Manager preferences.

On the Install IBM Rational Developer for z Systems panel of the launchpad, you can decide to install for all of the users (which requires you to have administrator access) or only for the current user. Then, you click one of the provided links to start a guided installation or an expert installation.

You can choose to do an expert installation rather than selecting a guided installation. Selecting an expert installation launches the Developer for z Systems installation with the most common features and bundled offerings selected by default.

Note: No matter which installation option you select from the launchpad program, you can always customize the set of features to be installed by selecting and deselecting additional features on the Features panel in Installation Manager.
To start the Developer for z Systems installation from the launchpad program as an administrator, do these steps:
  1. Complete the preinstallation tasks that are described in Preinstallation tasks, if you have not done so already.
  2. n Open the RDz951_Setup directory.
  3. Start the launchpad program by running the following command from the RDz951_Setup directory:
    • : launchpad.exe
    • : launchpad.sh
  4. Read the Welcome information about the Welcome panel and, to see the available documentation, select Product documentation on the left and click the links.
  5. To install IBM Rational Developer for z Systems, click Install IBM Rational Developer for z Systems on the left. If you are installing for all of the users, click the Install for all users radio button. If you are installing only for the current user, click the Install for the current user radio button.
  6. Specify the kind of installation to use.
    1. To start a guided installation of IBM Rational Developer for z Systems, click Start guided installation. On the Developer for z Systems installation wizard, select the features to install by selecting the corresponding boxes. Then, to continue the guided (or custom) installation, click the link at the bottom of the panel .
    2. To start an expert installation of IBM Rational Developer for z Systems, click Start expert installation.
  7. IBM Installation Manager is launched to install Developer for z Systems and any specified bundled offerings. To complete the installation, follow the prompts in the Install Packages wizard. For more details, see Installing Rational Developer for z Systems by using Installation Manager.

Installing Rational Developer for z Systems by using Installation Manager

About this task

When you launch the Developer for z Systems installation from the launchpad program (see Installing Developer for z Systems by using the launchpad program), IBM Installation Manager starts and the Install Packages wizard is displayed. The following steps guide you through using the Install Packages wizard of Installation Manager to install Developer for z Systems.

Procedure

  1. The first panel of the wizard displays a list of the packages that are available for installation. The available packages include Developer for z Systems and any bundled offerings that are recommended based on your selections from the launchpad. For more details about the launchpad program, see Installing Developer for z Systems by using the launchpad program. The available bundled offerings vary, depending on the edition of Developer for z Systems that you purchased.
  2. If prompted to update IBM Installation Manager to a newer version, to install the update immediately, click Yes, or to install the newer version later, click No. If you click Yes, Installation Manager updates itself and prompts you for to restart it. Click OK to restart Installation Manager.
    Note: You must have version 6.0 (or later) of Rational Team Concert Server installed in order to connect using the Rational Team Concert version 6.0 client.
  3. On the Licenses panel, read the license agreement for the selected packages. Each package to be installed has a license agreement. Click each package name to display the corresponding license agreement.
    1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
    2. To continue, click Next.
  4. On the Location panel, if you do not have any other packages already installed on the system, specify the location to use for the shared resources directory. In the Shared Resources Directory field, enter the path of the shared resources directory to use. If you are also installing Installation Manager with Developer for z Systems, in the Installation Manager Directory field, enter the location to install Installation Manager . Select a location on the largest drive for the shared resources directory, because it will be used by every package that you install using Installation Manager, and it cannot be changed after the first package is installed. If you already have one or more packages installed on your system, Installation Manager displays the location of the shared resources directory, but you cannot select or change the location.
    Note: To change the location of the shared resources directory at a later time, you must uninstall all of the packages and then re-install them, specifying a new shared resources directory.

    When you have finished making your selections, click Next.

  5. On the next Location panel, specify whether to create a new package group to contain the Developer for z Systems package, or to use an existing package group on the system. When you install packages into the same package group, they share a common workbench, and the functionality from the different packages is combined in that workbench. This is known as shell sharing. Packages that are installed into different package groups do not share a workbench and are kept separate from each other. When you have finished making your selections, click Next.
    • To create a new package group for Rational Developer for z Systems, click Create a new package group. Enter the installation directory to use for the new package group. This directory is where resources are stored which are specific to the packages installed in the package group. Each package group you create on the system has a separate installation directory. This directory is different from the shared resources directory, where resources are installed that can be shared by packages in different package groups. Click Next.
      Note: If you are installing on a 64-bit operating system, you can choose whether to create a 32-bit or 64-bit package group by selecting the corresponding radio button below the Installation Directory field. If you select the 32-bit package group, the installed packages run in 32-bit mode. You cannot change the bit mode of an existing package group after it has been created. Some software packages may support only 32-bit or 64-bit modes and can only be installed into a package group configured for the same architecture.
    • To install Developer for z Systems into an existing package group, click Use an existing package group. Then, select the package group into which to install Developer for z Systems. Click Next. If the selected package group is not compatible with Developer for z Systems, you are prompted to select a compatible package group or to create a new package group.
  6. On the next Location panel, specify whether to extend an existing Eclipse IDE already installed on the system, adding the functionality in the packages that you are installing. To select this option, you must have Eclipse Version 4.4.2 that uses IBM Java Development Kit (JDK) version 1.7 or later.
    • To use the Eclipse IDE and JDK that are packaged with Developer for z Systems instead of extending an existing one, click Next.
    • To extend an existing Eclipse IDE, select Extend an existing Eclipse. In the Eclipse IDE field, specify the location of the folder containing the Eclipse executable file (eclipse.exe for Windows systems and eclipse for Linux systems.) The Eclipse IDE JVM field displays the Java Virtual Machine (JVM) for the IDE that you specified. Click Next.
  7. On the Features page, under Translations, select the languages to install for this package group. The user interface and documentation for Developer for z Systems is installed in that language.
    Note: Your choices apply to all of the packages that are installed in this package group.
    Note: In this release of Developer for z Systems, selecting any of the available languages results in the national language translations for all of the languages being installed.
  8. On the next Features page, select the features to install for Developer for z Systems and any bundled offerings that you are installing. If you are doing a guided installation, a set of features is selected by default based on your responses to the questions in the installation wizard. To view a description of a feature, click the name of that feature. The feature description is displayed in the Details section at the bottom of the panel. For more information about the available features of Rational Developer for z Systems, see Feature installation. For information about the available features of the offerings that are bundled with Rational Developer for z Systems, see the documentation for those offerings.

    When you have finished selecting the features to install, click Next.

  9. On the z/OS connection panel, optionally configure a remote z/OS connection that is created the first time that you launch the Developer for z Systems workbench using a new workspace. Developer for z Systems connects to the server to automatically retrieve the workbench configuration settings. This automatic retrieval can help you roll out common configuration settings to multiple users without having to configure each client separately.

    For more information about this feature, see "Push-to-client considerations" in the Developer for z Systems Host Configuration Reference Guide (SC14-7290).

    By default, the z/OS connection configuration is disabled. If you do not want to configure a z/OS connection, clear the Configure my z/OS connection now check box and click Next. To enable this feature and enter the z/OS connection settings, do these steps:

    1. Select the Configure my z/OS connection now check box.
    2. Enter the host name of the Rational Developer for z Systems server in the Host name field.
    3. In the Connection name field, enter a name to be used for this connection in the Developer for z Systems Remote Systems view.
    4. Select either userid/password or certificate for the server authentication method.
    5. Enter the daemon port of the Developer for z Systems server in the Daemon port field.
    6. Click Next. The z/OS connection will be configured the first time that you launch the Developer for z Systems workbench by using a new workspace.
  10. On the Summary panel, review your choices before you begin the installation. To change the choices you made on the previous panels, click Back and make the changes. When you are satisfied with the installation choices, click Install. The installation begins and a progress indicator shows the percentage of the installation complete.
  11. When the installation process is complete, a message confirms the success of the installation.

    To view the installation log file for the current session, click View log file.

  12. If necessary, configure the licensing for Developer for z Systems and other bundled offerings that you installed through the Manage License panel in Installation Manager. This step could include configuring floating license support or installing product activation kits to install permanent or term license keys. For more details, see Managing licenses.

Silent installation

About this task

You can install Developer for z Systems in silent mode. When you run Installation Manager in silent mode, its user interface is not available; instead, you use a response file to supply the commands required to install the package.

Running Installation Manager in silent mode is helpful because you can use a batch process to install, update, modify, and uninstall packages through scripts.

These are the three main tasks for silent installation:
  1. If you are planning to install silently on multiple systems, copy the installation image to a location on a shared drive or server.
  2. Create the response file.
  3. Run Installation Manager in silent install mode.

The following sections explain the task of copying the installation image to a shared drive or server. For the most current information about the remaining tasks (creating response files and running Installation Manager in silent mode to install the package), see the Installation Manager product documentation.

The Working in silent mode topic provides detailed information about these topics.

Copying the installation image to a shared drive or server

About this task

If you are planning to install silently on multiple systems, copy the installation image to a location on a shared drive where other systems in the intranet can access it.

To copy the installation image from an electronic image to a shared location, do these steps:
  1. Extract each of the compressed files that you downloaded for Developer for z Systems and any bundled offerings that are to be made available for silent installations to the shared location where the image is to be stored. Alternatively, extract the compressed files on the local system and copy the extracted files and directories to the shared location.
  2. In the shared location, verify that you now have these files:
    1. The root of the shared directory has these directories:
      • RDz951_Setup
      • RDz951
      • One directory for each bundled offering that you are making available for silent installations.
    2. The RDz951 directories, and the directory for each bundled offering that you copied to the shared location has one or more diskN directories, one for each installation disc for the product.
After you have verified the directory structure of the shared installation image you are ready to create a response file and install silently.

Alternatively, copy the installation image to a repository on an HTTP Web server and use the repository to install silently. To create a repository, use the IBM Packaging Utility. For more details, see Overview: Placing Developer for z Systems on an HTTP web server.

Post-installation tasks

Configuring the help content

The default for help delivery draws content from the web dynamically. With this remote help, you always have the latest content available from within the product. If you are not going to use remote help to access the help content from the web, you must install the help content locally.

For additional information about installing and configuring help, see Configuring help content for Eclipse client applications.

To install the help content locally, see one of these topics:

Enabling context-sensitive help for EXEC CICS, EXEC SQL, and EXEC DLI statements

Enabling context-sensitive help for EXEC CICS, EXEC SQL, and EXEC DLI statements requires access to the IMS and CICS product documentation.

The online versions of the product documentation is available at:

CICS: http://www-01.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/welcomePage/welcomePage.html

IMS: http://www-01.ibm.com/support/knowledgecenter/SSEPH2/welcome

The IMS and CICS product documentation can also be installed locally or on an intranet server. For information about obtaining, installing, and initializing the IMS product documentation, see Installing and initializing the Information Management Software for z/OS Solutions (IMS) product documentation. For information about obtaining, installing, and initializing the CICS product documentation, see Installing and initializing the CICS Transaction Server Version product documentation

Installing and initializing the Information Management Software for z/OS Solutions (IMS) product documentation

The Information Management Software for z/OS Solutions product documentation is available and installable for Microsoft Windows Professional systems. The installable product documentation can run on a local system or on an intranet Windows system.

The Information Management for z/OS Solutions product documentation DVD (SK5T-7377) can be ordered from the IBM Publication Center for a low cost. The installable product documentation is available only in English and might not be available for ordering in your country or region. To order the Information Management for z/OS Solutions product documentation DVD:
  1. Go to the IBM Publications website.
  2. Select your country, region, or language from the drop-down menu, and click Go.
  3. On the next page, select Search for publications.
  4. On the Quick Publications Center search page, enter SK5T-7377 in the Publication number field, and click Go.

After you receive the IMS product documentation DVD and complete the install, follow the instructions provided in the documentation for obtaining the latest updates.

Note: When you install the IMS product documentation, you can install only the latest DB2 and IMS topics. These topics are the only topics that you need to enable context-sensitive help for EXEC SQL and EXEC DLI statements.
Note: The IMS product documentation is available only for Microsoft Windows systems. If you are using Linux systems, use the online version of the product documentation or install the product documentation on a Microsoft Windows server that you can access on the intranet.

To enable context-sensitive help for EXEC SQL and EXEC DLI statements, go where you installed the product documentation and initialize the documentation by running IC_start.bat. This routine initializes the product documentation on the 8801 port. The documentation must be initialized on the 8801 port to ensure that the help information can be found by context-sensitive help.

Note: Initializing the IMS product documentation initialization using the shortcuts in the Start menu results in a random assignment of a port number. If you use the shortcuts provided in the Start menu, context-sensitive help cannot locate and display the appropriate documentation.

To open the IMS product documentation, run IC_start.bat and use a browser to link to http://127.0.0.1:8801/help/index.jsp.

Installing and initializing the CICS Transaction Server Version product documentation

The CICS Transaction Server Version product documentation can run in Microsoft Windows, Linux, and AIX environments. A package is provided for each platform on the IBM Publications Center. Each package contains all of the Eclipse code and CICS documentation that is required to run the product documentation on a workstation or a server.

To download the CICS product documentation:

  1. Go to the IBM publications center website: http://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss.
  2. Click Search for publications and enter the appropriate publication number:
    SK4T-2664 	CICS Transaction Server Version for AIX
    SK4T-2665 	CICS Transaction Server Version for Linux
    SK4T-2666 	CICS Transaction Server Version for Windows
  3. Download the product documentation package.
  4. Extract the package and follow the instructions in the readme file to install the product documentation. Each package is compressed as a .zip file. The .zip file contains the correct compressed file format for Linux, AIX, and z/OS systems.

After you have installed the product documentation, follow the instructions provided in the documentation for obtaining the latest updates.

To enable context-sensitive help for EXEC CICS statements, go where you installed the product documentation and initialize the documentation by running IC_start.bat. To open the CICS product documentation, either run help_cd_start.bat, or run IC_start.bat and use a browser to link to http://127.0.0.1:9999/help/index.jsp.

Managing licenses

Licensing for the installed IBM software and customized packages is administered by using the Manage Licenses wizard in IBM Installation Manager. The Manage Licenses wizard displays license information and can be used to configure the licenses for each of the installed packages.

Trial licenses that are provided with some of the Rational products expire 30 to 90 days after installation. You must activate your product to use it after the expiration date. Using the Manage Licenses wizard, you can upgrade the trial versions of an offering to a licensed version by importing a product activation kit. 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 managing licenses for your Rational product, see the Rational licensing support page at http://www-306.ibm.com/software/rational/support/licensing/.

Authorized User License

An IBM Rational Authorized User license permits a single, specific individual to use a Rational software product. Purchasers must obtain an Authorized User license for each individual user who accesses the product in any manner. An Authorized User license cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.

For example, if you purchase one Authorized User license, you can assign that license to one specific individual, who can then use the Rational software product. The Authorized User license does not entitle a second person to use that product at any time, even if the licensed individual is not actively using it.

Floating license

An IBM Rational Floating license is a license for a single software product that can be shared among multiple team members; however, the total number of concurrent users cannot exceed the number of floating licenses that you purchase. For example, if you purchase one floating license for a Rational software product, any user in your organization can use the product at any given time. Another person who wants to access the product must wait until the current user logs off.

To use floating licenses, you must obtain floating license keys and install them on Rational License Server. The server responds to end-user requests for access to the license keys; it grants access to the number of concurrent users that matches the number of licenses the organization purchased.

Note: If you use floating licenses for IBM Rational Developer for z Systems (including token licenses), before installing the product you must upgrade the license key server to Rational License Key Server, Version 8.1.2 or later. Rational License Key Server, Version 8.1.2 or later can be used with earlier versions of the product. For information about how to upgrade from Version 7.1 or an earlier Rational License Key Server to version 8.1.2 or later, see Migrating to Rational Common Licensing (http://www-01.ibm.com/support/knowledgecenter/SSSTWP_8.1.4/com.ibm.rational.license.doc/topics/t_migrate_rational.html).

Token license

The token-based license model means that you can buy a certain number of token licenses. If you use a Rational tool that checks out a FEATURE that is token-based, the FEATURE line in the license file specifies the number of tokens that are checked out.

Token-based licenses can only be used with floating licenses. They cannot be used for authorized user license.

Note: If you use floating licenses for IBM Rational Developer for z Systems (including token licenses), before installing the product you must upgrade the license key server to Rational License Key Server, Version 8.1.2 or later. Rational License Key Server, Version 8.1.2 or later can be used with earlier versions of the product. For information about how to upgrade from Version 7.1 or an earlier Rational License Key Server to Version 8.1.2 or later, see Migrating to Rational Common Licensing (http://www-01.ibm.com/support/knowledgecenter/SSSTWP_8.1.4/com.ibm.rational.license.doc/topics/t_migrate_rational.html).

For more details about token licensing, contact your local IBM marketing representative.

License enablement

If you are installing a Rational software product for the first time or want to extend a license to continue using the product, you can enable the licensing for the product in two ways.

Licenses for Rational Software Development Platform offerings are enabled in the following two ways:
  • Importing a product activation kit
  • Enabling Rational Common Licensing to obtain access to floating license keys
Note: Trial licenses that are provided with some of the Rational products expire 30 to 90 days after installation. You must activate the product to use it after the expiration date.

Activation kits

Product activation kits contain permanent or term license keys for the trial Rational product. You purchase the activation kit, download the activation kit .zip file to a local computer, and then import the activation kit .jar file to enable the license for the product. Use IBM Installation Manager to import the activation kit to the product.

Floating license enforcement

Optionally, obtain floating license keys, install IBM Rational License Server, and enable Floating license enforcement for the product. Floating license enforcement provides the following benefits:
  • License compliance enforcement across the organization
  • Fewer license purchases
  • Serve license keys for IBM Rational Team Unifying and Software Development Platform desktop products from the same license server

For more information on obtaining activation kits and Floating licenses, see Purchasing licenses.

Viewing license information for installed packages

About this task

You can review license information for the installed packages, including license types and expiration dates, from IBM Installation Manager.

To view license information, do these steps:
  1. Start IBM Installation Manager.
  2. On the main page, click Manage Licenses.

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

Importing a product activation kit

About this task

To install a permanent or term license key, import the activation kit from the download location or the product media by using IBM Installation Manager.

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 disc or download the activation kit from IBM Passport Advantage to an accessible workstation. The activation kit is packaged as a Java archive (.jar) file. The .jar file contains the permanent license key and must be imported to activate the product.

To import the activation kit .jar and enable the new license key, do these steps:
  1. Start IBM Installation Manager.
  2. On the main page, click Manage Licenses.
  3. Select a package and click the Import Activation Kit button.
  4. Click Next. Details for the selected package are shown, including the current license kind and the version range of the license.
  5. Browse to the path on the media disc or download location for the activation kit, 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.

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

Enabling floating licenses

About this task

If your team environment supports floating license enforcement, you can enable floating licenses for the product and configure a connection to obtain access to floating license keys.

Before enabling the floating license enforcement, obtain the license server connection information from your administrator. For details on license server, license key, and Rational Common Licensing administration, see the IBM Rational License Management Guide.

To enable floating licenses as the license type for specified packages and configure license server connections:
  1. In the IBM Installation Manager for the Rational Software Development Platform, click File > Open > Manage Licenses.
  2. Select a version of a package and then click Configure Floating license support. Click Next.
  3. Click Enable Floating license enforcement.
  4. Configure one or more license server connections, as follows:
    1. Click an empty field in the Servers table or click Add.
    2. If your administrator provided you with information for a redundant server environment, click Redundant Server. Fields for the primary, secondary, and tertiary server names and ports are displayed.
    3. Enter the host name of the license server in the Name field.
    4. (Optional) 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. (Optional) To confirm that the connection information is correct and that the server is available, click Test Connection.
    7. Click OK.
  5. Click Next.
  6. (Optional) Configure the license usage order for the shell shared or custom packages. The order of licenses in the list determines the order in which the package attempts to obtain access to license keys for a given licensed package. Click Finish.

The Manage Licenses wizard indicates whether the floating licenses configuration is successful.

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

Purchasing licenses

About this task

You can purchase new licenses if the current product license is about to expire or if you want to acquire additional product licenses for team members.

To purchase licenses and enable the product, complete these steps:
  1. Determine the type of license you want to purchase.
  2. Go to ibm.com® or contact your IBM sales representative to purchase the product license. For details, visit the IBM Web page on How to buy software.
  3. Depending on the type of license you purchase, use the Proof of Entitlement you receive and enable your product by doing one of these steps:
    • If you purchase Authorized User licenses for the product, go to Passport Advantage and follow the instructions for downloading the product activation kit file. After you have downloaded the activation kit, import the product activation .jar file by using Installation Manager.
    • If you purchase Floating licenses for the product, click the link to the IBM Rational Licensing and Download site, log in (IBM registration is required), and select the link to connect to the IBM Rational License Key Center. Then, use your Proof of Entitlement to obtain floating license keys for the license server.

      Optionally, go to Passport Advantage to download the activation kit for your product. After importing the activation kit, you can optionally switch from a floating to a permanent license type if you use your PC offline for long periods.

To import the activation kit or enable floating license support for the product, use the Manage Licenses wizard in IBM Installation Manager.

Silently installing and configuring licenses

You can import product licenses and configure floating license support silently, just like you can install packages silently. You must generate a response file to be used by IBM Installation Manager to configure the licenses. For details on recording a response file and running silent installations, see Silent installation. When recording a response file, use the Manage Licenses panel to import an activation kit or configure floating license support before you exit Installation Manager. The necessary information for performing these tasks silently are written in the response file.

Increasing the number of file handles on Linux computers

For best product performance, increase the number of file handles to more than the default of 1024 handles.

Before you begin

Important: Before you work with a Rational product, increase the number of file handles. Most Rational products use more than the default limit of 1024 file handles for a process. A system administrator might need to make this change.

About this task

CAUTION:
Ensure that you complete the following steps correctly. If this procedure is not completed correctly, your computer will not start.

To increase the number of file handles on a Linux computer, complete these steps:

Procedure

  1. Log in as root. If you do not have root access, obtain it.
  2. Change to the etc directory.
    Attention: If you increase the number of file handles in the next step, do not leave an empty initscript file on the computer. If you do so, the computer will not start the next time that you restart it.
  3. Use the vi editor to edit the initscript file in the etc directory. If this file does not exist, type vi initscript to create it.
  4. On the first line, type ulimit -n 4096. The number chosen, 4096, is significantly larger than 1024, which is the default on most Linux computers.
    Important: Do not set the number of handles too high, because doing so can negatively impact system-wide performance.
  5. On the second line, type eval exec "$4".
  6. Make sure to complete steps 4 and 5, and then save and close the file.
  7. Optional: Restrict the number of handles that are available to users or groups by modifying the limits.conf file in the etc/security directory. If you do not have this file, consider using a smaller number in step 4 (for example, 2048) so that most users have a reasonably low limit on the number of open files that are allowed for each process. Doing this step is less important if you use a relatively low number in step 4. However, if you set a high number in step 4 and you do not establish limits in the limits.conf file, computer performance can be significantly reduced.
    The following sample limits.conf file restricts all of the users, and then sets different limits for others afterwards. This sample assumes that you set handles to 8192 in step 4.
    *      soft nofile 1024
    *      hard nofile 2048
    root    soft nofile 4096
    root    hard nofile 8192
    user1   soft nofile 2048
    user1 hard nofile 2048   

    The "*" in the example sets the limits for all of the users first. These limits are lower than the limits that follow. The root user has a higher number of allowable handles open, while the number available to user1 is between the two. Before making changes, make sure that you read and understand the documentation contained in the limits.conf file.

Additional configuration requirements for Linux operating systems

If you use a Linux operating system, ensure that your computer meets the requirements listed in this topic.

32-bit xulrunner package requirement on 64-bit systems

If you installed Developer for z Systems in a 32-bit package group on a Linux 64-bit system, you must install the 32-bit version of the xulrunner package. If the package is not installed, you might see the following error message when you run the product:

   org.eclipse.swt.SWTError: No more handles
	 [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)]
The 32-bit xulrunner package can often be found and installed by using the package manager installed with the Linux distribution. (For example, you might use YUM on Red Hat Linux or YaST on SUSE Linux.) Alternatively, download the 32-bit xulrunner RPM from the update site for the Linux distribution, the 32-bit Linux distribution discs (if the discs are available), or another RPM package distribution source, and install it by using the rpm command. For example:
rpm -Uvh <xulrunner module name>

Environment variable might need to be set for Firefox or Mozilla browsers

You might need to set the environment variable MOZILLA_FIVE_HOME to the folder containing the Firefox or Mozilla installation. For example, setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5.

If you do not set this environment variable, when you run the product you might see the following error message:
org.eclipse.swt.SWTError: No more handles 
   [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)]

Firefox browsers must be dynamically linked

To support the SWT browser widget, the Firefox browser must be dynamically linked, which means that it should not be downloaded from mozilla.org but compiled from source. This is typically the case when the Firefox browser is provided as part of the distribution (that is, it is in a place such as /usr/lib/firefox).

One way to ensure that this is true is to see if it is the browser that is pointed at by /etc/gre.conf. The purpose of this gre.conf file is to point at an embeddable browser.

If the browser is not dynamically linked, you might see the following error message when you run the product:
org.eclipse.swt.SWTError: No more handles
   (java.lang.UnsatisfiedLinkError: 
   /home/n0002466/.eclipse/ibm.software.development.platform_7.0.0
   /configuration/org.eclipse.osgi/bundles/267/1/.cp/libswt-mozilla-gtk-3236.so
   (libxpcom.so: cannot open shared object file: No such file or directory))
    SUSE Linux might require a fix for invisible text problem.))

SUSE Linux might require a fix for invisible text problem

If the operating system is SUSE Linux Enterprise Desktop 10 SP1 or SUSE Linux Enterprise Server 10 SP1, you might need the following operating system update to resolve the problem of text not being displayed in some editors:
http://support.novell.com/techcenter/psdb/44ab155e3202595389c101e6cf7e20f2.html

Starting Rational Developer for z Systems

About this task

You can start Developer for z Systems from the Windows desktop environment or the command-line interface, as follows:
  • To start IBM Rational Developer for z Systems from the Windows Start menu, click Start > All Programs > [package group name] > IBM Rational Developer for z Systems > IBM Rational Developer for z Systems.
  • To start IBM Rational Developer for z Systems on a Linux system, click the IBM Rational Developer for z Systems shortcut from the application shortcut menu in the desktop environment.
  • To start Developer for z Systems from a command line, type product installation directory\eclipse.exe .
  • To start Developer for z Systems from a command line, type product installation directory/eclipse.

Modifying installed packages

Before you begin

To modify an installation, you might need access to the original installation media and update media. For more information, see the Installation Manager help.
Note: Before modifying the installation, close all of the programs that were installed using Installation Manager.

About this task

The IBM Installation Manager Modify Packages can be used to change the content of the installed packages by adding or removing features. This facility is available only for those packages that have been installed by using the IBM Installation Manager.

Note: You cannot modify the Eclipse location or JVM.

Procedure

To modify an installed package, do these steps:

  1. From the main panel of Installation Manager, click the Modify Packages icon.
  2. On the Modify Packages panel, select the package group that contains the packages to modify. If you need help in determining what packages are installed, click Cancel, then click File > View Installed Packages. The package groups and packages that are installed on the system are displayed. When you are ready, click Modify Packages again, select the package group, and click Next.
  3. On the Languages panel, select or clear any languages to add or remove, and click Next.
  4. On the Features panel, the currently installed features are already selected. Select any additional features that are to be installed, or clear any of the installed features that are to be removed. When you have finished making your selections, click Next.
  5. On the Summary panel, review your choices before you begin modifying the installation. To change the choices you made on previous panels, click Back and make your changes. When you are satisfied with your choices, click Modify to make the specified changes. The modification process begins and a progress indicator shows you the percentage of the process completed.
  6. After the Complete page displays the results, see the complete installation log by clicking View Log File.

Updating installed packages

Before you begin

Before updating, close all of the programs that were installed using Installation Manager.

About this task

You can use IBM Installation Manager to install product updates and new features for any of the packages that were installed by Installation Manager.

By default, Internet access is required to install updates unless the repository preferences point to a local or network update repository to which the system has access. See the Installation Manager help for more information.

To find and install package updates, take the following steps:
  1. To install updates from a specific repository, for example a repository stored on an HTTP Web server in the intranet, you need to specify the repository location in the Installation Manager preferences before proceeding. To let Installation Manager search the internet for updates, you do not need to do this step.
    Note: If you specify repositories in the Installation Manager preferences, Installation Manager searches the internet for updates in addition to searching the repositories you specify. If you do not want Installation Manager to search for updates, go to File -> Preferences and deselect the Search service repositories during installation and updates checkbox at the bottom of the Repositories panel. This tells Installation Manager to search only the repositories specified in the preferences and not to search the internet.
  2. From the main panel of the Installation Manager, click Update.
  3. On the Update Packages panel, select the package group that contains the packages to modify. If you need help determining what packages are installed, click Cancel, then click File -> View Installed Packages. The page that is displayed shows you the package groups and packages that are installed on the system. To check for updates for all of the installed packages, select the Update All check box. Click Next to continue.
  4. Installation Manager searches for any available updates to the installed packages. The next panel displays a list of available updates that were found.
  5. By default, only the recommended updates are displayed. To see all of the updates for the package, click Show All. The updates are displayed with the required dependencies preselected.
  6. Select the updates to install and click Next.
  7. On the Licenses panel, read the license agreements for the selected updates. There is a license agreement for each update you selected to install. On the left side of the License panel, click each package name to display its license agreement.
    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.
  8. On the Summary panel, review your choices before you begin installing the updates. To change the choices you made on previous panels, click Back and make your changes. When you are satisfied with your installation choices, click Update to install the update. The update installation begins and a progress indicator shows you the percentage of the installation completed.
  9. The Complete page is displayed with results.
  10. Click View Log File link to see the complete installation log.

Uninstalling IBM Rational Developer for z Systems

About this task

The Uninstall option in the Installation Manager can be used to uninstall packages that were previously installed using Installation Manager.

To uninstall the packages, you must log in to the system using the same user account that you used to install the packages.

To begin the uninstallation process, do one of these steps :
  • From the Windows Add or Remove Programs screen, select IBM Rational Developer for z Systems (package group name) and click Remove. The IBM Installation Manager is started.
  • From the Windows Start menu, click Start > All Programs > IBM Installation Manager > IBM Installation Manager.
    Note: If you did a non-administrator installation, click Start > All Programs > My IBM Installation Manager > My IBM Installation Manager.
To begin the uninstallation process, do these steps:
  1. Open a terminal window.
  2. Change to the Installation Manager install directory/eclipse directory. (Example: /opt/IBM/InstallationManager/eclipse)
  3. Run ./IBMIM.

Procedure

  1. Close all of the programs that you installed using Installation Manager.
  2. From the main panel of Installation Manager, click Uninstall.
  3. On the Uninstall Packages panel, select the packages to uninstall. Click Next.
  4. In the Packages page, select the packages to uninstall and click Next.
  5. On the Summary panel, review the packages you selected to uninstall. To make any changes, click Back. To begin the uninstallation process, click Uninstall.
  6. The Complete panel is displayed after the uninstallation finishes and shows the results. Click Done.

Migration

Migrating WebSphere® Developer for zSeries or WebSphere Developer for z Systems workspaces

About this task

IBM Rational Developer for z Systems cannot be upgraded from Version 8.5, 9.0, or 9.1 to Version 9.5.1. Version 9.5.1 can coexist with all of the previous versions of Developer for z Systems in a different installation location.

Developer for z Systems cannot migrate workspaces from one operating system to another. For example, you cannot migrate a Windows-based workspace to into a Linux-based Developer for z Systems workspace.

Installing additional software

Installing the required z Systems components

For instructions on installing the host code, see the installation configuration documentation in the related product directory:
  • RDz951_zOS_SMPE for z/OS systems
  • RDz951_RSE

Installing IBM Data Studio

About this task

IBM Data Studio has its own set of installation documentation, which is available on the IBM Data Studio disc with the product.

Installing the Rational Team Concert Integration for z Systems extension

The Rational Team Concert Integration for z Systems extension can be installed at the same time that you install IBM Rational Developer for z Systems if you do these steps:
  1. Start the installation by choosing either a guided or expert installation from the launchpad, as described in Installing Developer for z Systems by using the launchpad program.
  2. When Installation Manager starts, "Rational Team Concert - Client for Eclipse IDE" and the "Rational Team Concert Integration for z Systems extension" are listed on the Available Packages panel. Select the Rational Team Concert Integration for z Systems extension.
  3. If either Rational Developer for z Systems or Rational Team Concert - Client for Eclipse IDE is not selected, and you do not already have the one that is not selected installed, select that one.
  4. Click Next and follow the panels in the Install Packages wizard to install the extension.

Known problems and limitations

This section covers known problems and limitations with installation and uninstallation.

For information about product problems and limitations, see the rdz951_releasenotes.html file located in the Documents\nl\en\readme directory of the IBM Rational Developer for z Systems Setup disc.

IBM Packaging Utility

You can use the IBM Packaging Utility software to copy packages to a repository that can be placed on a Web server available over HTTP or HTTPS.

The Packaging Utility software is included on the IBM Rational Enterprise Deployment disc. To place a repository containing Rational Developer for z Systems and other packages on a Web server available over HTTP, use the Packaging Utility to copy the packages into the repository.

You can use this utility to do these tasks:
  • Generate a new repository for packages.
  • Copy packages to a new repository. You can copy multiple packages into a single repository, thereby creating a common location in your enterprise from which products can be installed using IBM Installation Manager.
  • Delete packages from a repository.

For detailed instructions on installing and using IBM Packaging Utility, see the Installation Manager product documentation.

For the most current information, see the "Managing packages with Packaging Utility" topic.

Notices

This information was developed for products and services offered in the US. This material might be available from IBM in other languages. However, you may be required to own a copy of the product or product version in that language in order to access it.

IBM may not offer the products, services, or features discussed in this document 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 document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

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

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

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 OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions 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.

Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk.

IBM may use or distribute any of the information you provide in any way it believes appropriate without incurring any obligation to you.

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:

IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

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 document 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.

The performance data and client examples cited are presented for illustrative purposes only. Actual performance results may vary depending on specific configurations and operating conditions.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBMproducts. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

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

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Programming interface information

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Terms and conditions for product documentation

Permissions for the use of these publications are granted subject to the following terms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the IBM website.

Personal use

You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of IBM.

Commercial use

You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM.

Rights

Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein.

IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations.

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

Copyright license

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Trademark acknowledgments

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at www.ibm.com/legal/copytrade.shtml.

Adobe and PostScript are trademarks of Adobe Systems Incorporated.

Cell Broadband Engine - Sony Computer Entertainment Inc.

Rational is a trademark of International Business Machines Corporation and Rational Software Corporation, in the United States, other countries, or both.

Intel, Intel Centrino, Intel SpeedStep, Intel Xeon, Celeron, Itanium, and Pentium are trademarks of Intel Corporation in the United States, or other countries, or both.

IT Infrastructure Library is a trademark of Central Computer and Telecommunications Agency

ITIL is a trademark of The Minister for the Cabinet Office

Linear Tape-Open, LTO, and Ultrium are trademarks of HP, IBM Corp., and Quantum

Linux is a trademark of Linus Torvalds

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

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

UNIX is a registered trademark of The Open Group in the United States and other countries.