IBM Rational Developer for System z

Installation Guide

7.6
GI11-8297-02
Note

Before using this information and the product it supports, be sure to read the general information under Documentation notices for IBM Rational Developer for System z.

(September 2009)

This edition applies to IBM Rational Developer for System z Version 7.6 (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.

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

Copyright International Business Machines Corporation 2000, 2009.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Tables
About this book
Who should read this book
Where to find more information about Developer for System z
Introduction to Developer for System z
Preinstallation tasks
Client installation requirements
Media requirements
Media for additional offerings
Hardware and software requirements
Client prerequisites for Developer for System z
Planning to install
Installation methods
Installing from CD
Using electronic images
Installing from a repository on an HTTP server
Feature installation
Features for Developer for System z
IBM Installation Manager
Installing Installation Manager
Starting Installation Manager
Uninstalling Installation Manager
Using Installation Manager
Installation repositories
Package groups and the shared resource directory
Installing Developer for System z
Installation tasks summary
Overview: Installing Developer for System z from the installation CDs
Overview: Installing Developer for System z from an electronic image on your workstation
Overview: Installing Developer for System z from an electronic image on a shared drive
Overview: Installing Developer for System z from a repository on a HTTP Web server
Overview: Placing Developer for System z on an HTTP Web server
Using the launchpad program
Working with Installation Manager
Silent installation
Copying the installation image to a shared drive or server
Creating a response file
Running Installation Manager in silent installation mode
Response file commands
Reference: Sample response file
Silent install log files
Running Installation Manager in wizard mode
Post-installation tasks
Remote or Web-based helps
Web-based help content
Accessing Web-based help
Downloading help content with the Local Help System Updater site
Updating help content
Installing help content locally using the Local Help Updater and the RDz7.6_updateSite.zip file
Removing help content
Setting up an intranet server for help content
Changing the way that you access help content
Managing licenses
Authorized User License
Floating license
License enablement
Viewing license information for installed packages
Importing a product activation kit
Enabling floating licenses
Purchasing licenses
Starting Developer for System z
Modifying installed packages
Updating installed packages
Uninstalling Developer for System z
Migration
Migrating WebSphere Developer for zSeries or WebSphere Developer for System z workspaces
Appendix A. Installing additional software
Installing required System z components
Installing IBM TxSeries for Multiplatforms
Installing the UML Profiles for COBOL Development extension
Installing RSE Server for Multiplatform
Appendix B. Known problems and limitations
WebSphere Developer for zSeries Version 6.0.1 workspace incompatibility
Appendix C. IBM Packaging Utility
Installing the Packaging Utility
Copying packages to an HTTP server using the Packaging Utility
Documentation notices for IBM Rational Developer for System z
Copyright license
Trademark acknowledgments
Index

Tables

  1. CD name and electronic image references
  2. Developer for System z features
  3. User roles and associated features
  4. Arguments used with the silent installation command
  5. Keys for silent installation preferences
  6. File commands for use during silent installation

About this book

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

This document contains information on the following tasks:

The following names are used in this manual:

Note:
The configuration information found in this document is for IBM Rational Developer for System z Version 7.6.

Who should read this book

This book is intended for programmers installing and configuring Developer for System z 7.6 client on their workstation. To use this book, you need to be familiar with the Microsoft® Windows® operating system.

Where to find more information about Developer for System z

This document does not contain information about using Developer for System z. Refer to the online help for that information.

For information about product problems and limitations, refer to the Readme76.html file located in the Documents\nl\en\readme directory of the CD IBM Rational Developer for System z Installation setup CD.

See the Library page of the Developer for System z Web site: http://www-306.ibm.com/software/awdtools/rdz/library for updated documentation and troubleshooting information.

Introduction to Developer for System z

Developer for System z has a host component and a workstation client component. The host component is typically installed by a site's system programmer and is transparent to the application programmers. For the remainder of this guide, unless the host component is specifically called out, the term Developer for System z will refer to the workstation component of the tool - the graphical user interface powered by the Eclipse platform.

Developer for System z is a set of development tools built on the Eclipse platform (www.eclipse.org). Think of the Eclipse platform as the framework and Developer for System z and other bundled offerings as the tool contributors.

Preinstallation tasks

Before you install the product, complete the steps listed below:

  1. Confirm that your system meets the requirements described in the section Client installation requirements.
  2. Confirm that your user ID meets the required access privileges for installing the product. See User privileges requirements.
  3. Read the section Planning to install.

Client installation requirements

To prepare for installation, you need to confirm the following:

Media requirements

You can match references to CDs with references to electronic image directories as shown in the following table:

Table 1. CD name and electronic image references
CD Name Electronic Image Directory Name
IBM Rational Developer for System z Installation Setup CD RDz76Edition_Setup
Note:
The value forEdition depends on the edition of Developer for System z.
IBM Rational Developer for System z Installation CD 1 RDz76\disk1
IBM Rational Developer for System z Installation CD 2 RDz76\disk2
IBM Rational Developer for System z z/OS SMPE Installation CD RDz76_zOS_SMPE
IBM Rational Developer for System z RSE Server for AIX, Linux, and Linux on System z Installation CD RDz76_RSE
IBM Rational Developer for System z License Activation CD RDz76_License
IBM Rational Developer for System z Documentation CD RDz76_Documentation
UML Profiles for COBOL Development Extension Installation CD RDz76_UMLProfiles\disk1

You must have access to either of the following media to install Developer for System z on the workstation:

Media for additional offerings

In addition to the Developer for System z media, you will have additional installation media for other offerings that are bundled with Developer for System z. This may include IBM® Rational® Business Developer or IBM Rational Application Developer. The bundled software you have will depend on which edition of Developer for System z you purchased. For the remainder of this document, these offerings that are bundled with Developer for System z will be referred to as the bundled offerings.

In order to install required System z components on the System z host, you must have access to either of the following media:

See the IBM Rational Developer for System z Host Planning Guide (GI11-8296), the Program Directory for IBM Rational Developer for System z (GI11-8298), and the IBM Rational Developer for System z Host Configuration Guide (SC31-6930) for details on installing required System z server tools.

In order to convert a trial license to a permanent license, you must have access to the following media:

See Importing a product activation kit for details on converting the license.

In order to install the UML Profiles for COBOL Development Extension, you must have access to either of the following media

See Installing the UML Profiles for COBOL Development extension for details on installing this software.

Hardware and software requirements

The following information on hardware and software requirements for Developer for System z, is also available in Prerequisites for IBM Rational Developer for System z. A copy of this document is available in the Documents directory of IBM Rational Developer for System z Installation Setup CD.

Client prerequisites for Developer for System z

Developer for System z is a licensed program to support users who want to write large-scale business applications.

There are prerequisites and corequisites for using this software.

Hardware requirements

Verify that you meet the minimum hard disk space requirements to install the product. The following table provides an account of space requirements according to each aspect of the installation process:

Hardware Requirements
Processor Intel® Pentium® III 800 MHz or compatible processor

a stronger processor is recommended

Memory 1.5 GB RAM

Recommended minimum: 2 GB RAM

Disk space 1.1 GB of disk space is required to install the IBM Rational Developer for System z traditional developer role.

5 GB of disk space is recommended when installing other bundled software.

  • Disk space requirements can be reduced depending on the features that you install.
  • Additional disk space is required for the resources that you develop.
  • Additional disk space is required if you download the electronic image to install the product.
  • Additional disk space is required if you use FAT32 instead of NTFS.
Display 1024 x 768 resolution using 256 colors

A higher resolution and color palette is recommended.

Other hardware Microsoft mouse or compatible pointing device

Workstation prerequisites

Before you can install the product, verify that your system meets the software requirements.

Operating systems

The following operating systems are supported for this product:

Product Name PTFs or Service Levels Required
Microsoft Windows XP Professional Service Pack 2
Microsoft Windows Server 2003 Enterprise Edition Service Pack 1
Microsoft Windows Server 2003 Standard Edition Service Pack 1
Microsoft Windows Server 2008 Enterprise Edition No Service Level Required
Microsoft Windows Server 2008 Standard Edition No Service Level Required
Microsoft Windows Vista Business No Service Level Required
Microsoft Windows Vista Enterprise No Service Level Required
Microsoft Windows Vista Ultimate No Service Level Required
Notes:
  1. Developer for System z language support is dependent on the above listed operating systems having the base language support.
  2. Developer for System z supports Windows 2003 32 bit mode and Windows 2008 32 bit mode operation.
  3. Developer for System z was developed for use with Eclipse IDE version 3.4.2 that uses at least version 1.6 of the IBM Java™ Development Kit (JDK). You can only extend an existing Eclipse IDE that meets these requirements.
Hosted Development Environments/Virtualization Support
Product Name Version PTFs or Serice Levels required
Windows Terminal Services Windows 2008 and later all available maintenance
Citrix® (32 bit and 64 bit) Presentation Server 4.X all available maintenance
VMware® version 2.0, Workstation all available maintenance
Note:
Developer for System z supports running under the Citrix virtual environment using 64 bit Windows in 32 bit mode compatibility.

For additional information about Software support services for IBM SWG products in a virtualization environment, see Software support for IBM SWG products in a VMware environment and Support Policy for Citrix Metaframe and Rational Team Unifying Platform version 7.0.

Workstation corequisites

Developer for System z requires the software listed in this section to be installed as a prerequisite to installation depending on the Developer for System z functions you select to install.

Note:
For information about supported database servers, Web application servers, and other software products, see the online help.
TXSeries for Multiplatforms

One of the following levels must be installed to support applications with embedded CICS® statements:

Program Number Product Name PTFs or Service Levels Required
5655-M15 TXSeries® for Multiplatforms v 7.1 all available maintenance
5655-M15 TXSeries for Multiplatforms v 6.2 all available maintenance
5655-M15 TXSeries for Multiplatforms v 6.1 IZ00893

The related product Web site is as follows:

http://www.ibm.com/software/htp/cics/txseries/
DB2 for Windows

To support applications with embedded SQL statements, one of the following levels must be installed:

Program Number Product Name PTFs or Service Levels Required
5765-F35 DB2® Workgroup Server Edition v 9.5 Fix pack 3 or higher
5724-B55 DB2 Connect Personal Edition v 9.5 Fix pack 3
5765-F41 DB2 Enterprise Server Edition v 9.1 for Windows Fix pack 3 or higher

The related product Web site is:

http://www.ibm.com/software/data/db2/9/
Note:
DB2 Workgroup Server Edition v9.5 is required for precompilation and DB2® Connect™ Personal Edition v9.5 is required for access to host databases.
Rational Software Architect

To use the COBOL Generation from UML feature, the following application must be installed:

Program Number Product Name PTFs or Service Levels Required
5724-V88 Rational Software Architect v 7.5

The related product Web site is:

http://www-01.ibm.com/software/awdtools/swarchitect/standard/
Rational Team Concert for System z

For Jazz-based source control using Developer for System z remote projects, the following level must be installed:

Program Number Product Name
5724-V82 Rational Team Concert for System z Client v 2.0

The related product Web site is:

http://www-01.ibm.com/software/awdtools/rtcz/
Note:
Rational Team Concert Client v 1.0 or Rational Team Concert for System z Client v 1.0.1 provides selective support for some Developer for System z functions such as local projects. We recommend Rational Team Concert for System z Client v 2.0 for a more integrated and full featured experience.
Web Browser

To view the readme files and the installation guide, one of the following Web browsers must be installed:

Product Name PTFs or Service Levels Required
Microsoft Internet Explorer 6.0 or late all available maintenance
Firefox 1.5.x or later all available maintenance
Adobe Acrobat Reader

The following software must be installed to properly view product documentation PDFs:

Product Name PTFs or Service Levels Required
Adobe® Acrobat Reader Version 7.0 or later all available maintenance

User privileges requirements

You must have a user ID that meets the following requirements before you install IBM Rational Developer for System z.

Planning to install

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

Installation methods

There are a number of methods that you might use when installing Developer for System z.

Some factors that might determine the installation method you use are the following:

The typical installation methods you might use are the following:

Note:
With the latter three methods you could choose to run the Installation Manager program in silent mode to install Developer for System z. For details on running Installation Manager in silent mode, see Silent installation.

Installing from CD

With this method, you have the CD-ROM disks containing the installation files, and typically you are installing Developer for System z on your own workstation. Refer to Overview: Installing Developer for System z from the installation CDs for an overview of the steps.

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 System z and any bundled offerings you wish to install before you can begin the installation. Developer for System z electronic images are packaged as self-extracting executable files. Bundled offerings may be packaged differently, such as in zip files.

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 System z on your own workstation. Refer to Overview: Installing Developer for System z from an electronic image on your workstation for an overview of the steps.

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 System z from a single location. Refer to Overview: Installing Developer for System z from an electronic image on a shared drive for an overview of the steps.

Installing from a repository on an HTTP server

This method provides an alternative way to install across a network. This differs from the previous method because, in order to place installation files for Developer for System z on an HTTP Web server, you must use a utility application - IBM Packaging Utility - which is provided with the Developer for System z installation media. IBM Packaging Utility is used to copy the installation files in a package format that can be used for installing Developer for System z 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, as well as future service updates. Refer to Overview: Installing Developer for System z from a repository on a HTTP Web server and Overview: Placing Developer for System z on an HTTP Web server for an overview of the steps.

Feature installation

You can customize your Developer for System z installation by selecting which features and bundled offerings you want to install. The Developer for System z launchpad provides you with a list of user roles from which you can select the role that most closely describes your developer role within your enterprise. Choosing your user role will launch the installation with a set of Developer for System z features and bundled offerings selected which are recommended for your developer role. The available user roles and bundled offerings will vary depending on the edition of Developer for System z you purchased.

Alternatively, you can launch a custom installation from the launchpad program. This option will launch the installation with all Developer for System z features and bundled offerings selected by default.

Note:
Regardless of whether you choose a user role or select to perform a custom installation, you have the ability to select and deselect additional features before you begin the installation. You are not restricted to the set of features that are selected by default. For more information about user roles and the Developer for System z launchpad program, refer to Using the launchpad program.

Installation Manager automatically enforces any dependencies between features and prevents you from deselecting any features that are required.

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

Features for Developer for System z

The following table shows the features of Developer for System z that you can choose to install, and the user role(s) that include them by default. For information about the available features of other offerings that are bundled with Developer for System z, see the documentation for those offerings.

Note:
The Team and Repository support features (SCLM Developer Toolkit and Rational ClearCase SCM Adapters) and the CARMA feature are not selected by any of the user roles. You may choose one or more of these features based on the software configuration management systems you need to interact with.

Table 2. Developer for System z features
Feature Description User Role(s)
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, as well as workstation-based applications in COBOL, PL/I, and Java. This feature also includes connectivity to other environments, such as AIX and Linux for System z.
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
System z Code Generators Provides design tools and wizards which allow you to rapidly create System z application code skeleton and logic from UML models or user-provided input.
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
SCLM Developer Toolkit Provides tools to access and work with Software Configuration and Library Manager (SCLM) managed source code. Not selected by user roles
Rational ClearCase SCM Adapter Provides the IBM Rational ClearCase SCM and ClearCase MVFS plug-ins, which enable versioning of software artifacts in ClearCase versioned object bases (VOBs) using snapshot views and dynamic views when ClearCase VOB and view servers are also installed. Not selected by user roles
CA Endevor Software Change Manager Provides tools to access and work with CA Endevor Software Change Manager managed source code.
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
Enterprise Service Tools for CICS 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).
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
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.
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
CICS Code Generators Provides design tools and wizards which allow you to rapidly create CICS Transaction Server application code skeleton 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.
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
CICS Service Component Architecture Provides tooling to support Service Component Architecture in CICS, providing added value to traditional CICS systems through integration and deployment of new and existing assets as reusable components and services.
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
Enterprise Service Tools for IMS Enterprise Service Tools for IMS™ provide an integrated set of tools that support modern application architectures and the transformation and reuse of existing IMS application processes. The tools support generation of Web service descriptions and processing artifacts directly to a z/OS system, including the IMS SOAP Gateway and IMS info 2.0 applications. Enterprise Service Tools quickly enable the move towards service-oriented architecture (SOA).
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
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.
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
IMS Code Generators Provides code snippets which allow you to rapidly add common programming objects to IMS application code.
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
Data Tools Provides relational database tools to work with tables, table views, and filters. With these tools, you can create physical database models by means of reverse engineering database tables or 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 Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
System z Stored Procedures Enables you to create, test, and deploy DB2 stored procedures written in COBOL, PL/I, Java, or SQL directly to a z/OS system.
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
File Manager Provides IBM File Manager for z/OS capabilities, including a formatted edit session with multiple views of the data of many dataset types, to Rational Developer for System z.
Note:
This feature requires that you have a license for IBM File Manager for z/OS.
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
Fault Analyzer Enables you to work with fault entries created by IBM Fault Analyzer for z/OS during real-time analysis of abending programs.
Note:
This feature requires that you have a license for IBM Fault Analyzer for z/OS
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer
Common Access Repository Manager (CARMA) Provides a unified interface and set of services for accessing System z-based source control management tools. CARMA also provides a generic graphical user interface (GUI) client that can be used as a framework for accessing and interfacing with custom source control management systems. Not selected by user roles.
Plug-in Development Environment (PDE) Provides tools for creating, developing, testing, debugging, and deploying Eclipse plug-ins, which can be used to extend the Rational Developer for System z Eclipse environment.
  • System z Traditional Developer
  • Service Developer
  • Web Developer
  • J2EE/WAS Developer

IBM Installation Manager

The IBM Installation Manager is a program that installs Developer for System z 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 on the IBM Installation Manager, see the Installation Infocenter at:

http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp

Installation Manager is an installation management tool that offers a number of 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 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.

There are six wizards in Installation Manager that make it easy to maintain your package through its lifecycle, as follows:

Installing Installation Manager

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

If you need to install IBM Installation Manager by itself, without installing Developer for System z, the IBM Installation Manager installer is provided as a zip file called im.installer.win32.zip in the IMInstaller directory on the IBM Rational Developer for System z Installation Setup CD if you are using physical installation CDs, or in the RDz76Edition_Setup directory if you downloaded an electronic image. To install IBM Installation Manager take the following steps:

  1. Unzip the im.installer.win32.zip file to a temporary directory on your system to extract the installation files. If you wish to share the IBM Installation Manager installation image with other users in your enterprise, you can also extract the files to a location on a shared drive where other users can access the image.
  2. If you are installing as an Administrator for all users on the system, run the install.exe program, located at the root of the directory in which you extracted the IBM Installation Manager installation image. If you are installing as a non-administrator for the current user only, run the userinst.exe program.
  3. Follow the prompts on the screen to install IBM Installation Manager.

You can also perform a silent installation of the Installation Manager using the following steps:

  1. Unzip the im.installer.win32.zip file to a temporary directory on your system to extract the installation files. If you wish to share the IBM Installation Manager installation image with other users in your enterprise, you can also extract the files to a location on a shared drive where other users can access the image.
  2. Run the following command from the root of the directory where you extracted the installation image to silently install IBM Installation Manager:

For more information about installing IBM Installation Manager, refer to the IBM Installation Manager documentation.

Starting Installation Manager

IBM Installation Manager is installed and started automatically when you perform the Developer for System z installation. If you need to start Installation Manager manually to update, modify, roll back, or uninstall packages following the installation, do the following:

  1. Open the Start menu from the Taskbar.

Uninstalling Installation Manager

The IBM Installation Manager must be uninstalled using the Add or Remove Programs panel in Windows.

  1. Open the Start menu from the Taskbar.
  2. Select Control Panel -> Add or Remove Programs -> IBM Installation Manager.
  3. Click the Remove button and follow the instructions provided by the operating system.
Note:
You cannot uninstall IBM Installation Manager until all packages have been uninstalled.

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 CDs, or your local machine. Installation Manager retrieves packages from these repositories to install them on your system.

When you launch the installation of Developer for System z 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 you want to install in the Installation Manager repository preferences so that Installation Manager knows where to look for them. See Setting repository preferences in Installation Manager for more details.

Some organizations may 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 will need to provide you with the correct URL.

By default, IBM Installation Manager uses an embedded URL in each package 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

When you start the installation of Developer for System z from the launchpad program, the necessary repository information is automatically passed to Installation Manager when it starts. 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, then you must add the repository location in the Installation Manager preferences before you can install the package. This 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 may 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 whether or not 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 System z 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 System z and any other bundled offerings you are installing. A package group represents a directory in which packages share resources with other packages in the same group. This is known as shell sharing. When you install Developer for System z and any bundled offerings with Installation Manager, you can choose to 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 will be disabled.)

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

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

Once 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 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 to conserve 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 your largest drive for this. You cannot change the directory location later unless you uninstall all packages.

Extending an existing Eclipse IDE

The Developer for System z package includes a version of the Eclipse integrated development environment (IDE), or workbench, which is installed when you install Developer for System z. However, if you have an existing Eclipse integrated IDE that is already installed on your workstation, you have the option to extend that IDE by adding the Developer for System z functionality to the existing environment.

During the Developer for System z installation, select the Extend an existing Eclipse IDE option on the Location page of the Install Packages wizard to extend an existing Eclipse IDE. You will be asked for the location of your existing Eclipse IDE as well as the Java Virtual Machine (JVM) that you want to use.

You might extend your existing Eclipse IDE, for example, because you want to gain the functionality provided in the Developer for System z package, but you also want to have the preferences and settings in your current IDE when you work with the functionality from Developer for System z. You also might want to work with plug-ins you have already installed to extend the Eclipse IDE.

Your existing Eclipse IDE must be version 3.4 and must use at least version 1.6 of the IBM Java Development Kit (JDK) to be extended. Installation Manager checks that the Eclipse environment you specify meets the requirements for the installation package. If the requirements are not met, you will not be able to extend that Eclipse IDE.

Installing Developer for System z

Installation tasks summary

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

Overview: Installing Developer for System z from the installation CDs

In this installation scenario, you have the CD-ROM disks containing the installation files, and typically you are installing Developer for System z on your own workstation.

The general steps for installing from the installation CDs are the following:

  1. Complete the pre-installation steps listed in Preinstallation tasks.
  2. Insert the IBM Rational Developer for System z Installation Setup CD into your CD-ROM drive.
  3. If autorun is enabled on your system, the Developer for System z launchpad program automatically opens. If autorun is not enabled, start the launchpad program by running launchpad.exe from the root of the CD. Refer to Installing Developer for System z for details.
  4. Choose Install Rational Developer for System z or Upgrade Rational Developer for System z.
  5. This step varies depending on whether you are installing a new release of Developer for System z or updating an existing release of Developer for System z.
  6. Follow the on-screen instructions in the IBM Installation Manager Install Packages wizard or in the Update Packages wizard (depending on your launchpad selection) to install Developer for System z and any bundled offerings. Refer to Working with Installation Manager for details.
  7. Configure your licenses for Developer for System z and any bundled offerings you installed as needed. If you have a trial license and need to configure a term or permanent license, do so now. For example, you may want to configure floating license support. Refer to Managing licenses for details.
  8. Install additional software included with Developer for System z. For more information, see Appendix A. Installing additional software.

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

The general steps for installing from an electronic installation image are the following:

  1. Ensure that your workstation has sufficient space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements.
  2. Download all required parts for Developer for System z and any bundled offerings you wish to install from IBM Passport Advantage to a temporary directory.
  3. Extract the installation image from the compressed files you downloaded and verify the installation image is complete. See Extracting electronic images for details.
  4. Continue with the steps inInstalling from an electronic image, below.

Installing from an electronic image

Take the following steps:

  1. Complete the pre-installation steps listed in Preinstallation tasks.
  2. Start the launchpad program by running launchpad.exe from the root of the RDz76Edition_Setup directory. Refer to Installing Developer for System z for details.
  3. Choose Install Rational Developer for System z or Upgrade Rational Developer for System z.
  4. This step varies depending on whether you are installing a new release of Developer for System z or updating an existing release of Developer for System z.
  5. Follow the on-screen instructions in the IBM Installation Manager Install Packages wizard or in the Update Packages wizard to install Developer for System z and any bundled offerings. Refer to Working with Installation Manager for details.
  6. Configure your licenses for Developer for System z and any bundled offerings you installed as needed. If you have a trial license and need to configure a term or permanent license, do so now. For example, you may want to configure floating license support. Refer to Managing licenses for details.
  7. Install additional software included with Developer for System z. For more information, see Appendix A. Installing additional software.

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

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 System z and any bundled offerings from a single location. This is also useful when you need to perform silent installations on a number of user systems. The following steps are performed by the person placing the installation image on a shared drive:

  1. Ensure that your shared drive has sufficient disk space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements for details.
  2. Download all required parts for Developer for System z 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 into an accessible directory on the shared drive and verify the installation image is complete. See Extracting electronic images for details.

To install Developer for System z interactively from the installation files on the shared drive, take the following steps:

  1. Change to the RDz76Edition_Setup directory on the shared drive containing the installation image.
  2. Follow the steps in Installing from an electronic image to install Developer for System z and any bundled offerings.

For information about performing silent installations using your shared electronic image, refer to Silent installation.

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

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 System z and any bundled offerings has been created on the HTTP Web server. Refer to Overview: Placing Developer for System z on an HTTP Web server for details on copying the installation packages to an HTTP Web server.

To install the Developer for System z 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. Refer to Installing Installation Manager.
  3. Start Installation Manager. Refer to Starting Installation Manager for details.
  4. Add the URL of the repository containing the Developer for System z package to the repository preference in Installation Manager. See Setting repository preferences in Installation Manager.
  5. Click Install or Update to start the Install Packages wizard or the Update Packages wizard in Installation Manager, and follow the on-screen instructions in the Install Packages wizard or Update Packages wizard to complete the installation.
  6. Configure your licenses for Developer for System z and any bundled offerings you installed as needed. If you have a trial license and need to configure a term or permanent license, do so now. For example, you may want to configure floating license support. Refer to Managing licenses for details.
  7. Install additional software included with IBM Rational Developer for System z. For more information, see Appendix A. Installing additional software.

Overview: Placing Developer for System z on an HTTP Web server

You can place the Developer for System z install package, as well other offering packages, on an HTTP Web server by using the IBM Packaging Utility to create an installation repository. You may want to do this if you have a number of different offerings or service updates you want to place in a single repository in addition to the Developer for System z 7.6 offering and its bundled offerings. You can use this repository to perform interactive or silent installations.

Note:
While you can perform silent installations from a repository on an HTTP web server, this step is not required to perform silent installations.

To place packages on an HTTP Web server you will use the IBM Packaging Utility to create a new installation repository or copy to an existing repository. Refer to Copying packages to an HTTP server using the Packaging Utility for details on using the Packaging Utility to create an installation repository. Once you have created your repository, you can do the following:

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

Using the launchpad program

The Developer for System z 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 System z in the following cases:

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

You can perform a new, full install of Developer for System z version 7.6, or you can upgrade an existing Developer for System z version 7.5 to Developer for System z version 7.6.

If you are performing a new installation of Developer for System z version 7.6, then on the Install Rational Developer for System z panel of the launchpad, you can select from a list of user roles, each describing a developer role you might be performing within your enterprise. Select the role that most closely describes your role as a Developer for System z user to launch the installation with a customized set of features and bundled offerings selected that are recommended for your role. The user roles from which you can select are listed below. Depending on which edition of Developer for System z you purchased, you may not see all of these roles. A description of each role is provided on the launchpad panel.

The following table shows the user roles and corresponding Developer for System z features associated with each role. (See Table 2 for a description of each feature.)

Table 3. User roles and associated features
User role Associated features
System z Traditional Developer
  • System z Integrated Development Environment
  • System z Code Generators
  • BMS Screen Designer
  • MFS Screen Designer
  • Data Tools
  • System z Stored Procedures
  • System z Debugger
  • File Manager
  • Fault Analyzer
  • Plug-in Development Environment (PDE)
Service Developer
  • System z Integrated Development Environment
  • System z Code Generators
  • Enterprise Service Tools for CICS
  • BMS Screen Designer
  • CICS Code Generators
  • CICS Service Component Architecture
  • Enterprise Service Tools for IMS
  • MFS Screen Designer
  • IMS Code Generators
  • Data Tools
  • System z Stored Procedures
  • System z Debugger
  • File Manager
  • Fault Analyzer
  • Plug-in Development Environment (PDE)
Web Developer
  • System z Integrated Development Environment
  • System z Code Generators
  • Enterprise Service Tools for CICS
  • BMS Screen Designer
  • CICS Code Generators
  • CICS Service Component Architecture
  • Enterprise Service Tools for IMS
  • MFS Screen Designer
  • IMS Code Generators
  • Data Tools
  • System z Stored Procedures
  • System z Debugger
  • File Manager
  • Fault Analyzer
  • Plug-in Development Environment (PDE)

This user role also selects the IBM Rational Business Developer and IBM WebSphere Application Server Test Environment offerings.

J2EE / WAS Developer
  • System z Integrated Development Environment
  • System z Code Generators
  • Enterprise Service Tools for CICS
  • BMS Screen Designer
  • CICS Code Generators
  • CICS Service Component Architecture
  • Enterprise Service Tools for IMS
  • MFS Screen Designer
  • IMS Code Generators
  • Data Tools
  • System z Stored Procedures
  • System z Debugger
  • File Manager
  • Fault Analyzer
  • Plug-in Development Environment (PDE)

This user role also selects the IBM Rational Application Developer and IBM WebSphere Application Server Test Environment offerings.

Alternatively, you can select to perform a custom installation rather than selecting a user role. Selecting a custom installation will launch the Developer for System z installation with all 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.

To start the Developer for System z installation from the launchpad program as an administrator, take the following steps:

  1. Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.
  2. If you are installing from the installation CDs, insert the IBM Rational Developer for System z Installation Setup CD into your CD drive. If you are installing from an electronic image, open the RDz76Edition_Setup directory.
  3. If auto-run is enabled on your system, the launchpad program will start automatically. If auto-run is not enabled on your system or you are installing from an electronic image:
  4. Read the Welcome information on the Welcome panel and select the Product documentation tab on the left to see the available documentation. Click the links on the panel to view the product documentation.
  5. If you want to upgrade your existing IBM Rational Developer for System z, click on the Upgrade IBM Rational Developer for System z tab. Then click on Launch IBM Installation Manager to upgrade an existing installation. (This is only valid for upgrading from IBM Rational Developer for System z V7.5.x to V7.6.) After IBM Installation Manager launches, click the Update button and follow the prompts in the Install Packages wizard to complete the installation. For more details, refer to Working with Installation Manager.
  6. If you want to perform a new installation of IBM Rational Developer for System z, click the Install IBM Rational Developer for System z tab on the left. A "Description of roles" tab appears. Click on this tab if you want to read about the roles available for you to choose. Then click back on the Install IBM Rational Developer for System z.
  7. Select your user role from the list of user roles on the panel. This launches the Developer for System z installation with a customized set of features and bundled offerings selected that are recommended for your role. For more information about user roles, refer to Using the launchpad program. Alternatively, you can select to perform a custom installation with all features and bundled offerings selected by default.

    You must also decide whether you are installing as an administrator or a non-administrator. If you are installing as an administrator, be sure the "Install with Administrator access" box is checked. (The box is checked by default.) If you are installing as a non-administrator, you must uncheck the box.

  8. IBM Installation Manager will be launched to perform the installation of Developer for System z and any bundled offerings you choose to install. Follow the prompts in the Install Packages wizard to complete the installation. For more details, refer to Working with Installation Manager.

Working with Installation Manager

When you launch the Developer for System z installation from the launchpad program (see Using the launchpad program), IBM Installation Manager will start and you will be presented with the Install Packages wizard. The following steps will guide you through using the Install Package wizard of Installation Manager to install Developer for System z:

  1. The first panel of the wizard displays a list of the packages that are available for installation. The available packages will include Developer for System z and any bundled offerings that are recommended for the user role you selected on the launchpad. Refer to Using the launchpad program for more details about the launchpad program and user roles. The available bundles offerings will vary depending on the edition of Developer for System z you purchased.

    When you are ready to proceed with the installation, click Next. Installation Manager gathers information about the packages you have selected and proceeds to the Licenses panel.

  2. You might be prompted to update IBM Installation Manager to a newer version if one is available. If prompted, click Yes to install the update, or click No if you want to install the newer version later. If you click Yes, Installation Manager updates itself and informs you that it must restart to complete the update.

    Click OK to restart Installation Manager

    .
  3. On the Licenses panel, read the license agreement for the selected packages. There is a license agreement for each package you select to install. On the left side of the Licenses panel, 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. Click Next to continue.
  4. On the Location panel, Installation Manager will give you the option of either creating a new package group to contain the Developer for System z package, or using an existing package group on your 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.

    To create a new package group for Developer for System z:

    1. Select the radio button labeled Create a new package group.
    2. Enter the installation directory you want to use for the new package group. This directory is where resources will be stored which are specific to the packages installed in the package group. Each package group you create on your 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.
    3. If you do not have any other packages installed on your system, you will also be asked to choose the location to use for the shared resources directory. It is recommended that you select a location on your largest drive for the shared resources directory, as it will be used by every package 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 will display the location of the shared resources directory but you will not be given the option to select or change it.
      Note:
      To change the location of the shared resources directory at a later time you must uninstall all packages and then re-install them, specifying a new shared resources directory.

    To install Developer for System z into an existing package group:

    1. Select the radio button labeled Use an existing package group.
    2. Installation Manager will display a list of the available package groups on your system. Select the package group into which you want to install Developer for System z. Installation Manager will verify that the package group you selected is compatible with Developer for System z. If it is not, Installation Manager will display an error message informing you of the problem and you will not be able to continue with the installation until you select a compatible package group or select to create a new package group.

    When you have finished making your selections, click Next to continue.

  5. On the next Location panel, you can choose to extend an existing Eclipse IDE already installed on your system, adding the functionality in the packages that you are installing. You must have Eclipse Version 3.4 using IBM Java Development Kit (JDK) version 1.6 or higher to select this option. It is recommended that you use the Eclipse IDE and JDK that are packaged with Developer for System z instead of extending an existing one.
  6. On the next Location page, under Languages, select the languages you want to install for this package group. The corresponding national language translations for the user interface and documentation for Developer for System z will be installed.
    Note:
    Your choices apply to all packages installed in this package group.
    Note:
    In this release of Developer for System z, selecting any of the available languages will result in the national language translations for all languages being installed.
  7. On the Features panel, select the features that you want to install for Developer for System z and any bundled offerings you are installing. You can click on the name of any feature to view a description 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 Developer for System z, refer to Feature installation. For information about the available features of the offerings that are bundled with Developer for System z, refer to the documentation for those offerings.

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

  8. On the help system configuration page, select one of the following options and then click Next:
  9. On the Summary panel, review your choices before you begin the installation. If you want to change the choices you made on previous panels, click Back and make your changes. When you are satisfied with your installation choices, click Install to install the packages. The installation begins and a progress indicator shows you the percentage of the installation complete.
  10. 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 to open the installation log in a new window.

  11. If necessary, configure your licensing for Developer for System z and other bundled offerings you installed through the Manage License panel in Installation Manager. This may include configuring floating license support or installing product activation kits to install permanent or term license keys. Refer to Managing licenses for more details.

Silent installation

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

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

There are the following three main tasks for silent installation:

  1. If you are planning to perform silent installations 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.

Copying the installation image to a shared drive or server

If you are planning to perform silent installations on multiple systems, you should copy the installation image to a location on a shared drive where other systems in your intranet can access it.

To copy the installation image from physical installation CDs to a shared location, take the following steps:

  1. In the shared location where you want to store the installation image, create a directory named RDz_Setup.
  2. Insert the IBM Rational Developer for System z Installation Setup CD into your CD-ROM drive.
  3. Copy the contents of the IBM Rational Developer for System z Installation Setup CD into the RDz_Setup directory you created in your shared location.
  4. Create another directory in your shared location to contain the product installation files. This folder can have any name you choose, for example RDz.
  5. Create a directory name disk1 inside the directory you created to contain the product installation files, for example RDz\disk1. This directory must be named disk1 in order for the silent installation to work.
  6. Insert IBM Rational Developer for System z Installation CD 1 into your CD-ROM drive.
  7. Copy the contents of IBM Rational Developer for System z Installation CD 1 into the disk1 directory you created.
  8. Repeat steps 5-7 again, this time creating a directory named disk2 and copying the contents of IBM Rational Developer for System z Installation CD 2 into the disk2 directory.
  9. If you want to make other offerings that are bundled with Developer for System z available for silent installation, for example IBM Rational Business Developer and IBM Rational Application Developer, you will need to follow the same process that you followed in steps 4-8 for these offerings.
    1. Create a new directory in your shared location to contain the product installation files for the bundled offering. This directory can have any name you choose.
    2. For each installation CD, create a diskN directory for each installation CD inside the directory you created to contain the product installation files, where N corresponds to the number of the installation CD. Copy the contents of each installation CD into the corresponding diskN directory you created for that CD.
  10. Once you have finished copying the contents of your installation CDs to your shared location, you are ready to create a response file and perform silent installations.

To copy the installation image from an electronic image to a shared location, take the following steps:

  1. Extract each of the compressed files you downloaded for Developer for System z and any bundled offerings you want to make available for silent installations to the shared location where you want to store the image. Alternatively, you could extract the compressed files on your local machine and then copy the uncompressed files and directories to the shared location.
  2. In the shared location, verify that you now have the following:
    1. In the root of the shared directory, you should have the following directories:
      • RDz76Edition_Setup, where Edition will vary depending on the edition of Developer for System z you downloaded.
      • RDz76
      • One directory for each bundled offering you are making available for silent installations, for example IBM Rational Business Developer and IBM Rational Application Developer. The available bundled offerings will vary depending on the edition of Developer for System z you purchased.
    2. In the RDz76 directory, and in the directory for each bundled offering you copied to your shared location, you should have multiple diskN directories, one for each installation disk for the product.
  3. Once you have verified the directory structure of your shared installation image you are ready to create a response file and perform silent installations.

Alternatively, you can copy your installation image to a repository on an HTTP Web server and perform silent installations using the repository. To create a repository you will need to use the IBM Packaging Utility. Refer to Overview: Placing Developer for System z on an HTTP Web server for more details.

Creating a response file

You can create a response file by recording your actions as you install Developer for System z packages using Installation Manager. When you record a response file, all of the selections that you make in the Installation Manager GUI are stored in an XML file. You can then use the same response file to perform silent installations on other systems. When you run Installation Manager in silent mode, Installation Manager uses the XML response file to locate the repository containing the package, select the features to install, and so on.

To record a response file for installation (or uninstallation), take the following steps:

  1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. For example: cd C:\Program Files\IBM\Installation Manager\eclipse.
  2. On a command line, type the following command to start installation manager, substituting your own name and location for the response file and (optionally) the log file:
    IBMIMC.exe -record <response file path and name>.xml -log 
    					<log file path and name>.xml

    For example,

    IBMIMC.exe -record C:\my_response_file.xml -log 
    					C:\install_log.xml
    Note:
    Ensure the directories in which you want the response file and log file to be stored exist. Installation Manager will not create directories for the response file and the log file.
  3. Install Developer for System z and any other bundled offerings you want to install using the Installation Manager GUI. Refer to Working with Installation Manager for more details.
  4. If necessary, configure your licensing for Developer for System z and other bundled offerings you installed. This may include configuring floating license support or installing product activation kits to install permanent license keys. Refer to Managing licenses for more details.
  5. Exit Installation Manager.

After you exit Installation Manager, an XML response file is created and resides in the location specified in the command you use to launch Installation Manager.

A sample response file which can be used to install Developer for System z is provided on the IBM Rational Developer for System z Installation Setup CD in the SilentInstall directory. The sample response file can also be found in the RDz76Edition_Setup directory if you are installing from an electronic image. You can use this file as-is to perform silent installations of Developer for System z, or modify to your own specifications. Refer to Silent installation commands for information on customizing your response file.

Running Installation Manager in silent installation mode

You can run Installation Manager in silent installation mode from a command line.

Refer to the Installation Manager online help for additional documentation on how to run it in silent mode.

You can run Installation Manager in silent mode by running the following command from the directory in which Installation Manager is installed:

IBMIMc.exe --launcher.ini silent-install.ini -silent [arguments]

The following table describes the arguments used with the silent installation command:

Table 4. Arguments used with the silent installation command
Argument Description
-input This argument specifies an XML response file as the input to Installation Manager. A response file contains commands that Installation Manager runs.
-log (Optional) This argument specifies a log file that records the result of the silent installation. The log file is an XML file.

To run Installation Manager in silent installation mode, do the following:

  1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. For example: cd "C:\Program Files\IBM\Installation Manager\eclipse".
  2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file. For example, IBMIMc.exe --launcher.ini silent-install.ini -silent -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml.

Installation Manager runs in silent installation mode. It reads the response file and writes a log file to the directory you specified. You must have a response file when running in silent installation mode, however, log files are optional. A successful install ends in a return code of 0. If the install ends with a non-zero number, the install failed. If you receive a non-zero return code, check the response file and log file for possible causes of the failure. See Silent install log files for more information about log files. If you specified a log file when you entered the silent installation command, any errors will be logged in the log file you specified. A successful installation results in a log file that contains simply the following: <result></result>.

Response file commands

If you want to use the silent installation capabilities of Installation Manager, you need to create a response file that contains all of the commands that Installation Manager must run. The recommended way to do this is to create a response file by recording your actions as you install Developer for System z. However, you can also create or edit a response file manually.

There are the following two categories of commands for the response file:

Silent install preference commands

While you typically specify preferences using the Preferences window, you can also specify preferences (identified as keys) in a response file for use during a silent installation.

Note:
You can specify more than one preference in a response file.

When you define preferences in a response file, your XML code will look similar to the following example:

<preference>
	name = "the key of the preference"
	value = "the value of the preference to be set" 
	</preferences>

Use the following table to identify keys and their associated values for silent installation preferences:

Table 5. Keys for silent installation preferences
Key Value Notes
com.ibm.cic.common.core.preferences.logLocation Specifies the location of Installation Manager log file. Important:This key is optional and is designed for testing and debugging. If you do not specify a location for the log file, both silent installation and the UI version of Installation Manager will use the same location.
com.ibm.cic.license.policy.location Specifies a URL that defines where the remote license policy file resides.
com.ibm.cic.common.core.preferences. http.proxyEnabled True or False is the default value.
com.ibm.cic.common.core.preferences. http.proxyHost Host name or IP address Host name or IP address
com.ibm.cic.common.core.preferences. http.proxyPort Port number
com.ibm.cic.common.core.preferences. http.proxyUseSocks True or False False is the default value.
com.ibm.cic.common.core.preferences. SOCKS.proxyHost Host name or IP address
com.ibm.cic.common.core.preferences. SOCKS.proxyPort Port number
com.ibm.cic.common.core.preferences. ftp.proxyEnabled True or False False is the default value.
com.ibm.cic.common.core.preferences. ftp.proxyHost Host name or IP address
com.ibm.cic.common.core.preferences. ftp.proxyPort Port number
com.ibm.cic.common.core.preferences.eclipseCache c:\IBM\common
Note:
The paths above are default values for this preference; typically, install packages provide their own values for this preference.
You cannot change this location if you have already installed a package.
com.ibm.cic.agent.core.pref.offering.service.repositories.areUsed
True or False
Change this preference to 'False' to disable it. When 'True', all linked repositories are searched when products are installed or updated.
com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts
True or False
Change this preference to 'False' to disable it. When 'True', the files required to roll the package back to a previous version are stored on your system. When 'False', these files are not stored. If you do not store these files, you must connect to your original repository or media to roll back.

Silent installation commands

You can use this reference table to learn more about response file commands for use during a silent installation.

Table 6. File commands for use during silent installation
Response file commands Description
Set profile
<profile id="the profile (package group) id" 
installLocation="the install location of the profile">
<data key="key1" value="value1"/>
<data key="key2" value="value2"/>
</profile>
Use this command to create a package group (or installation location). If the specified package group already exists, the command has no effect. Currently, when creating the profile, the silent installation will also create two installation contexts; one for Eclipse and one for native. A profile is an installation location.

You can use the <data> element for setting profile properties.

The following list contains the currently supported keys and related values:

  • The eclipseLocation key specifies an existing Eclipse location value, such as c:\myeclipse\eclipse.
  • The cic.selector.nl key specifies the Natural Language (NL) locale selections, such as zh, ja, and en.
    Note:
    Separate multiple NL values with commas.

The following list contains the currently supported language codes:

  • English (en)
  • French (fr)
  • Simplified Chinese (zh)
  • Traditional Chinese (Taiwan) (zh_TW)
  • German (de)
  • Japanese (ja)
  • Spanish (es)
  • Korean (ko)
  • Portuguese (pt_BR)
Set repositories
<server>
<repository location="http:/xxx/repository/">
<repository location="file:/C:/repository/">
<!--add more repositories below>
<...>

</server>
Use this command to specify the repositories used during a silent installation. Each repository location can be a URL or a file path.
Install
<install>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" 
version= "offering version">
</offering>

<!--add more offerings below>
<...>

</install>
Use this command to specify the installation packages that will be installed.

The profile ID must match an existing profile or a profile created by the set profile command.

Feature IDs can be optionally specified by a comma-delimited list, such as "feature1, feature2", and so on. If no feature IDs are specified, all the default features in the specified offering will be installed.

Note:
Required features will be included for installation, even if they are not explicitly specified in the comma-delimited list.
<install modify="true"> or <uninstall modify="true">(optional attribute)
<uninstall modify="true">
<offering 
     profile="profileID"id="Id" 
     version="Version" 
     features="-"/>
</uninstall>
Use the <install modify="true"> attribute on install and uninstall commands to indicate that you want to modify an existing install. If the attribute is not set to true, the value defaults to false. If the intent of the modify operation is only to install additional language packs, then a hyphen "-" should be used in the offering feature id list to indicate no new features are being added.

Important: You must specify "modify=true" and a hyphen "-" feature list as specified in the example; otherwise, the install command will install the offering's default features and the uninstall command will remove all the features.

Uninstall
<uninstall>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" 
version= "offering version">
</offering>

<!--add more offerings below>
<...>

</uninstall>
Use this command to specify the installation packages that will be uninstalled.

The profile ID must match an existing profile or a profile specified in a profile command. Further, if there are no feature IDs specified, all the features in the specified offering will be uninstalled; if there are no offering IDs specified, all the installed offering in the specified profile will be uninstalled.

Rollback
<rollback>
<offering profile= "profile id" 
id= "offering id" 
version= "offering version">
</offering>

<!--add more offerings below>
<...>

</rollback>
Use this command to roll back to the specified offerings from the version currently installed on the specified profile. You cannot specify features in a roll back command.
InstallAll
<installALL/>
Note:
This command is equivalent to using
-silent -installAll 
Use this command to silently search for and install all available installable packages.
UpdateAll
<updateALL/>
Note:
This command is equivalent to using
-silent -updateAll 
Use this command to silently search for and update all available installable packages.

Reference: Sample response file

You can use an XML-based response file to specify predefined information, such as silent installation preferences, repository locations, package groups, and so on. Response files are beneficial for teams and companies that want to install installation packages silently and to standardize the locations and preferences for installation packages.

Sample response file

<agent-input >
<!-- add preferences -->
<preference name="com.ibm.cic.common.core.preferences.http.proxyEnabled" 
  value="c:/temp"/>
<!-- create the profile if it doesn't exist yet -->
<profile id="my_profile" installLocation="c:/temp/my_profile"></profile>
<server>
<repository 
  location= 
    "http://a.site.com/local/products/sample/20060615_1542/repository/">
</repository>/server>

<install>
	<offering profile= "my_profile" features= "core" id= "ies" 
       version= "3.2.0.20060615">	</offering>
</install>

</agent-input>

Silent install log files

You can use silent install log files to examine the results of a silent installation session.

The silent installation functionality creates an XML-based log file that records the result of the silent install execution (as long as a log file path is specified using -log <your log file path>.xml). If your silent installation session is successful, the log file will contain just the root element of <result> </result>. However, if there errors occur during the installation, the silent install log file will contain error elements with messages, such as the following:

<result>
 	<error> Cannot find profile: profile id</error>
 	<error> some other errors</error> 
</result> 

For detail analysis, you can look at the logs generated in the Installation Manager data area. By using a preference command, you can optionally set the data area to your preferred location, as shown in the response file topic.

Running Installation Manager in wizard mode

Wizard mode starts Installation Manager in either the install wizard or the uninstall wizard with your preferences and install or uninstall choices already set based on the specified response file. The response file can only contain preference commands and install or uninstall commands. You cannot mix install and uninstall commands in the same response file when you run Installation Manager in wizard mode.

Enter the following command on the command line to start Installation Manager in wizard mode:

IBMIM.exe -mode wizard -input <response file>

Post-installation tasks

Remote or Web-based helps

With some products, you can access, download, and update help content from the Web. Access to Web-based help content provides you with the latest content that is available for your product.

If your product offers help content on the Web, only a limited number of help topics are installed with the product. By default, your product connects to the Web and accesses help content directly from an information center. If you need to access the help when you are not connected to the Internet, you can download the help and access it locally, or you can connect to an information center on an intranet server if your system administrator has made one available to you.

See the installation guide to find out if your product supports Web-based help content.

The following three options are available during the installation process, but can be changed at any time:

Whether you access Web-based help content, download and use help content locally, or connect to your intranet to get help, click Help > Help content to open help topics and find solutions.

To change the way that your products access help content, see the installation topics for your product for detailed instructions.

Web-based help content

The Rational Developer for System z help system is configured to use remote help so that you can pull in content from the Web dynamically. With remote help, you always have the latest content available from within Rational Developer for System z. Some help systems are not configured to access help content on the Web; in such cases, help content is included with the installation.

You can obtain help three ways. One of these options is best for you, depending on your needs and situation:

You can change your access decision at any time. If you install multiple products together, you can use different locations for the help for each product, depending on installation footprint, frequency of use, and internet policies. If internet speed is an issue, a longer one-time download and local access might be preferable. Later help updates include only differences.

If you are an administrator and you want users to access help content from an intranet server, see Setting up an intranet server for help content for more information..

Accessing Web-based help

Help for Rational Developer for System z is available on a product information center on the Internet. You can view this help from within Rational Developer for System z.

Before you begin

During installation, the option to access help from a remote information center was selected. This option is the default selection.

About this task

The Rational Developer for System z help system can retrieve content installed with the product, as well as content from a remote server running an information center. The information center for Rational Developer for System z has the most current help content and when Rational Developer for System z is configured to retrieve content from a remote information center, the contents of the information center can be accessed by selecting Help -> Help Contents to open your help system.

During installation, Rational Developer for System z was configured to access the help from the product information center.

The information center for Rational Developer for System z is available from the following Web address:

http://publib.boulder.ibm.com/infocenter/ratdevz/v7r6/index.jsp.

Follow these steps to check your connection to the information center:

  1. Open the Preferences dialog
  2. Select Help -> Content
  3. Ensure that Include help content from a remote infocenter is selected.
  4. Ensure that the URL for the Rational Developer for System z information center is in the list of available information centers. If your information center is not listed, complete the following steps:
    1. Click Add
    2. In the Name field, enter a name for the connection.
    3. In the Host field, enter publib.boulder.ibm.com
    4. In the Path field, enter /infocenter/ratdevz/v7r6/
    5. Select Use default port
    6. Click OK
  5. Select the entry for the Rational Developer for System z information center.
  6. Click Test Connection.

Downloading help content with the Local Help System Updater site

This topic explains how to download, remove, and update help content from the Local Help System Updater site. Most help content is not installed when you install Rational Developer for System z with web delivery enabled. To access all help content locally, you need to download it from the IBM Local Help System Updater Web site or from the RDz7.6_updateSite.zip file found in the install_localhelp directory of the documentation CD.

Before you begin

During installation, the help access option, Download help and access the content locally, was selected.

About this task

Before using the help for the product, you have to download the help to your local system.

To install the help content from the RDz7.6_updateSite.zip file found in the install_localhelp directory of the documentation CD, see Installing help content locally using the Local Help Updater and the RDz7.6_updateSite.zip file

To download the help content from the Local Help System Updater site, complete the following steps:

  1. With Rational Developer for System z open, click Help -> Local Help Updater. The Updater site opens.
  2. In the x pane, select the location of the help you want to download. For the IBM Rational Developer for System z beta, you need to add the location.
    1. Select the Internal Sites tab.
    2. Select the + icon to add a location.
    3. Select Remote.
    4. Type a name for the site.
    5. Type http://publib.boulder.ibm.com/infocenter/ratdevz/v7r6/site/site.xml for the URL.
  3. The Available Features list is populated with a list of the help that is available for download. Depending on your network connection speed, this operation might take a few minutes. Select the help content that you need.
  4. Click Install. The help content is downloaded and installed. A progress bar opens and tracks the status of the download.
  5. When the download is completed, open the help in the product by selecting Help -> Help Contents.

Results

The help that you selected is installed on your system. The files are updated automatically when an Internet connection is available.

Updating help content

Use the Local Help System updater to ensure that you have the latest help content.

Before you begin

You have installed help features from the Local Help System Updater Web site.

About this task

Updates are automatically installed each time you start the product, if you have an Internet connection.

To update the help without restarting the product, complete the following steps:

  1. Close the product help system window.
  2. Open the Local Help System Updater by selecting Help -> Local Help Updater. The Updater site opens.
  3. Click the Installed Features tab.
  4. Click Search for Updates. If updates to the content you have installed are available, they are installed to your system. A progress bar indicates the status of the request.
  5. When the update is completed, open the help in the product by selecting Help -> Help Contents.

Installing help content locally using the Local Help Updater and the RDz7.6_updateSite.zip file

If you are not going to use remote help to access the help content from the Web, you must install the help content locally. This topic explains how to install the help content using the Local Help System Updater and the RDz7.6_updateSite.zip file provided in the install image. The RDz7.6_updateSite.zip file is located on the IBM Rational Developer for System z Documentation CD.

Before you begin

During installation, the help access option, Download help and access the content locally, was selected.

About this task

Before using the help for the product, you have to install the help to your local system.

To install the help content on the workstation using the Local Help System Updater, complete the following steps:

  1. Extract the contents of the file RDz7.6_updateSite.zip file found in the install_localhelp directory of the documentation CD to a temporary location on your system. Remember this location.
  2. Using Windows Internet Explorer as your default browser, open Rational Developer for System z, click Help -> Local Help Updater. The Local Help Updater opens.
  3. Specify the location of the extracted RDz7.6_updateSite.zip file.
    1. Select the Internal Sites tab.
    2. Select the + icon to add a location.
    3. Select Local.
    4. Type a name for the site.
    5. Click Browse and browse to the location where you extracted the contents of RDz7.6_updateSite.zip.
    6. Click OK. A progress bar opens and tracks the status as the Local Help Updater searches for the available features included in the RDz7.6_updateSite.zip file.
  4. The Available Features list is populated with a list of the help that is available for download. select IBM Rational Developer for System z Documentation.
  5. Click Install. A progress bar opens and tracks the status of the install.
  6. When the installation is complete, open the help in the product by selecting Help -> Help Contents.

Results

The help that you selected is installed on your system.

Removing help content

You can use the Local Help System Updater to remove installed help content.

Before you begin

You have downloaded help features using the Local Help System Updater.

About this task

To remove installed help content, complete the following steps:

  1. Close the product help system window.
  2. Open the Local Help System Updater by clicking Help -> Local Help Updater. The Updater site opens.
  3. Click the Installed Features tab.
  4. Select the features that you want to remove, then click Remove. The help features you selected are removed from your system. A progress bar indicates the status of the request.
  5. When the removal is completed, open the help in the product by selecting Help -> Help Contents.

Setting up an intranet server for help content

Depending on your security requirements, and organizational needs, you can set up an intranet server behind a firewall to provide help content to users. With this method, users do not have to download and save help content to their computers. This arrangement also frees up disk space on users' computers, because the single copy of the help content is stored on a server and is available to many. You can also make sure that all users have the latest help content from IBM with a single update to the intranet server.

Before you begin

Providing help content on an intranet server requires deploying the enterprise help.war application on the server, and then installing help content into the help.war file . You must have an application server running on Windows Server, that can be accessed by users behind a firewall.

Note:
At this time, the Local Help Updater does not support an application server running in a Linux®, Unix or AIX® environment.
Note:
To download the help content, you must be on the application server.

About this task

These are the general steps for setting up an intranet server for help content:

  1. Set up your application server.
  2. Get the help.war file from http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/war/
  3. Deploy the help.war file com.ibm.rational.rdz.help.war.zip found in the install_localhelp directory of the documentation CD.
  4. Extract the contents of the file RDz7.6_updateSite.zip file found in the install_localhelp directory of the documentation CD to a temporary location on your system. Remember this location.
  5. Start your application server, and browse to the Local Help Updater. The path is http://HOST:PORT/help/updater/updatewar.jsp. For example, the default for a Tomcat application server is http://localhost:9080/help/updater/updatewar.jsp
  6. For the IBM Rational Developer for System z beta, you need to add the location.To install the help content:
    1. Select the Internal Sites tab.
    2. Select the + icon to add a location.
    3. Select Local.
    4. Type a name for the site.
    5. Browse to the location of the site/site.xml file where you extracted the RDz7.6_updateSite.zip file.
    6. Select OK
  7. Click the update site you added in the left pane, and the help features to install are displayed in Available Features.
  8. Select Rational Developer for System z Documentation, and click Install.
  9. After the installation is complete, verify that the help is available by browsing to http://HOST:PORT/help/index.jsp
  10. Now that the help is on the intranet server, users can access it by adding the URL to the intranet server to their Remote Help preferences:
    1. Start the Eclipse-based product, and click Window > Preferences > Help > Content.
    2. Add the location to the intranet server.

.See the Installation Manager information center for an example of setting up an Enterprise solution using Tomcat. In the Installation Manager information center, select Enterprise installation articles -> Delivering help content from an intranet server.

Changing the way that you access help content

You can change the way that you access help content. You can choose from the following methods: access help from the Web; download help and access content locally; or access help from a server on your intranet.

Close the help browser before you change the way that you access help content.

During the installation process, you selected one of the following methods for accessing help content:

To change the way that you access help content, complete the following steps:

  1. Click Windows -> Preferences. The Preferences window opens.
  2. Expand the Help entry, and then click Content. A list displaying the currently configured information center or centers opens. Depending on the access method that was chosen, complete one of the following procedures.

Managing licenses

Licensing for your installed IBM software and customized packages is administered using the Manage Licenses wizard in IBM Installation Manager. The Manage Licenses wizard displays license information and allows you to perform license configuration tasks for each of your installed packages.

Trial licenses that come with some Rational products expire 30 or 60 days after installation. You need to activate your product in order to use it after the expiration date. Using the Manage Licenses wizard, you can upgrade 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.

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 you purchase. For example, if you purchase one floating license for a Rational software product, then any user in your organization may 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 a Rational License Server. The server responds to end-user requests for access to the license keys; it will grant access to the number of concurrent users that matches the number of licenses the organization purchased.

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 have options on how to enable licensing for your product.

Licenses for Rational Software Development Platform offerings are enabled in the following two ways:

Note:
Trial licenses that come with some Rational products expire 30 or 60 days after installation. You need to activate your product in order to use it after the expiration date.

Activation kits

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

Floating license enforcement

Optionally, you can obtain floating license keys, install IBM Rational License Server, and enable Floating license enforcement for your product. Floating license enforcement provides the following benefits:

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

Viewing license information for installed packages

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

To view license information, take the following 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

To install your permanent or term license key, you must 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 CD 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 your product.

To import the activation kit .jar and enable the new license key, take the following 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 CD or download location for the activation kit; then select the appropriate Java archive (.jar) file and click Open.
  6. Click Next. The Summary page displays the target install directory for the activation kit, the product the new license applies to, and version information.
  7. Click Finish.

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

Enabling floating licenses

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

Before enabling Floating license enforcement, you must 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 select the Configure Floating license support button.
  3. Click Next.
  4. Click the Enable Floating license enforcement button.
  5. Configure one or more license server connections, as follows:
    1. Click an empty field in the Servers table or click the Add button.
    2. If your administrator provided you with information for a redundant server environment, click the Redundant Server button. Fields for the primary, secondary, and tertiary server names and ports appear.
    3. Enter the host name of the license server in the Name field.
    4. (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) You can click the Test Connection button to confirm that the connection information is correct and that the server is available.
    7. Click OK.
  6. Click Next.
  7. (Optional) Configure the license usage order for your shell shared or custom packages. The order of licenses in the list determines the order in which your package attempts to obtain access to license keys for a given licensed package.
  8. Click Finish.

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

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

To purchase licenses and enable your product, complete the following 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 do one of the following to enable your product:

When you want to import the activation kit or enable floating license support for your 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 will need to generate a response file to be used by IBM Installation Manager to perform your license configuration tasks. Refer to Silent installation for details on recording a response file and running silent installations. When recording your 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 will be written in the response file.

Starting Developer for System z

You can start Developer for System z from the Windows desktop environment or the command-line interface, as follows:

Modifying installed packages

The IBM Installation Manager Modify Packages allows you to change the content of the installed packages by adding or removing features. This functionality is available only on packages that have been installed using the IBM Installation Manager.

Note:
You may need access to the original installation media and update media to modify your installation. See the Installation Manager help for more information.

Note:
Close all programs that were installed using Installation Manager before modifying.
Note:
You cannot modify the Eclipse location or JVM.

To modify an installed package, take the following 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 you want 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 your system. When you are ready, click Modify Packages again, select the package group, and click Next to continue.
  3. On the Languages panel, select or deselect any languages you want to add or remove and click Next.
  4. On the Features panel, the currently installed features are preselected. Select any additional features you wish to install, or deselect any of the installed features to remove them. When you have finished making your selections, click Next to continue.
  5. On the Summary panel, review your choices before you begin modifying your installation. If you want 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 changes you specified. The modification process begins and a progress indicator shows you the percentage of the process completed.
  6. The Complete page is displayed with results.
  7. Click View Log File to see the complete installation log.

Updating installed packages

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

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

Note:
Close all programs that were installed using Installation Manager before updating.

To find and install package updates, take the following steps:

  1. If you want to install updates from a specific repository, for example a repository stored on an HTTP Web server in your intranet, you need to specify the repository location in the Installation Manager preferences before proceeding. If you want to simply let Installation Manager search the internet for updates for you, you do not need to perform this step.
    Note:
    When you specify repositories in the Installation Manager preferences, Installation Manager will still search 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 you want 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 your system. If you want to check for updates for all of your 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. If you want to see all the updates for the package, click Show All. The updates are displayed with the required dependencies preselected.
  6. Select the updates that you want to install and click Next.
  7. On the Licenses panel, read the license agreements for the selected updates. There will be 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. If you want 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 Developer for System z

The Uninstall option in the Installation Manager allows you 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. Do one of the following to begin the uninstall process:

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

Migration

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

If you have a workspace you used in WebSphere Developer for zSeries 6.0.1 or WebSphere Developer for System z 7.0, and you want to migrate the workspace for use with IBM Rational Developer for System z Version 7.6, you must follow these steps:

  1. Install IBM Rational Developer for System z Version 7.6.
  2. Start Rational Developer for System z, specifying the name of the workspace you are migrating. The old workspace is migrated automatically so that all the old artifacts are present and appear in the new workspace.
  3. Rational Developer for System z Version 7.5 workspaces will be migrated to Version 7.6.

Note:
Developer for System z can be upgraded from version 7.5 to version 7.6. Version 7.6 can also coexist with all previous versions of Developer for System z in a different installation location.

Appendix A. Installing additional software

Installing required System z components

See the Developer for System z Host Planning Guide for details on installing required System z components.

Installing IBM TxSeries for Multiplatforms

CICS TxSeries for Multiplatforms provides a local CICS development platform so you can develop CICS programs.

CICS TxSeries has its own set of installation documentation, which is available on the disk with the product.

To install IBM TxSeries for Multiplatforms:

  1. Insert the IBM Rational Developer for System z Installation Setup CD, or open the RDz76Edition_Setup directory of your electronic image.
  2. Run launchpad.exe to start the launchpad program.
  3. Click the Install optional software tab on the left side of the launchpad window.
  4. Click Launch IBM TxSeries for Multiplatforms v7.1 installation to launch the installation.
  5. When prompted, insert the IBM TxSeries for Multiplatforms v7.1 installation CD, or specify the location that contains the electronic installation image.
  6. After the installation starts, follow the prompts on the screen to perform the installation.

Installing the UML Profiles for COBOL Development extension

Note:
This extension requires that you have IBM Rational Software Architect Version 7.5 installed prior to the installation, or that you install it at the same time as the extension. The extension can be installed with or without Developer for System z installed.

To install the UML Profiles for COBOL Development extension:

  1. Insert the IBM Rational Developer for System z Installation Setup CD, or open the RDz76Edition_Setup directory of your electronic image.
  2. Run launchpad.exe to start the launchpad program.
  3. Click the Install optional software tab on the left side of the launchpad window.
  4. Click Launch UML Profiles for COBOL Development installation to launch the installation.
  5. When prompted, insert the UML Profiles for COBOL Development extension installation CD, or specify the location that contains the electronic installation image.
  6. After IBM Installation Manager starts, follow the prompts on the screen to perform the installation.

    If you already have IBM Rational Software Architect installed, choose the package group in which you install it when you are prompted to select the existing package group for installation.

    If you are installing Rational Software Architect at the same time as UML Profiles for COBOL Development, you can either create a new package group or install into an existing one.

Installing RSE Server for Multiplatform

See the Developer for System z RSE Server Installation and Configuration Guide on the IBM Rational Developer for System z RSE Server for AIX, Linux, and Linux on System z Installation CD for details on installing the optional RSE Server.

Appendix B. Known problems and limitations

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

For information about product problems and limitations, refer to the readme.html file located in the Documents\en directory of the CD IBM Rational Developer for System z Installation Setup CD.

WebSphere Developer for zSeries Version 6.0.1 workspace incompatibility

Workspaces used with Rational Developer for System z 7.6 are not compatible with WebSphere Developer for zSeries 6.0.1. If you start Rational Developer for System z 7.6 using a workspace from WebSphere Developer for zSeries 6.0.1, your workspace will be migrated to work with Rational Developer for System z 7.6. If you plan to uninstall the Rational Developer for System z 7.6 and continue to use any WebSphere Developer for zSeries 6.0.1 workspace, you should back up your WebSphere Developer for zSeries 6.0.1 workspace before installing Rational Developer for System z 7.6.

Appendix C. 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 Auxiliary CD. If you want to place a repository containing Developer for System z and other packages on a Web server available over HTTP, then you must use the Packaging Utility to copy the packages into the repository.

You can use this utility to perform the following tasks:

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

Installing the Packaging Utility

The IBM Packaging Utility must be extracted from a compressed file before it can be used to copy the Developer for System z package.

Use the following steps to extract the IBM Packaging Utility software:

  1. Locate the Packaging Utility compressed file on the IBM Rational Auxiliary CD. The compressed file containing the Packaging Utility is located on the IBM Rational Application Developer auxiliary CD, as follows: PackagingUtility\pu.disk_win32.zip.
  2. Extract the files from the compressed file containing the utility into a temporary directory. Be sure to preserve the directory of the compressed files. These are the installation files you will use to install the Packaging Utility.
  3. Change to the directory where you extracted the Packaging Utility installation files and start the installation program.
  4. Run InstallerImage_win32\install.exe.
  5. Installation Manager will start up with the Install Packages wizard configured to install Packaging Utility.
  6. Follow the on-screen instructions in the Install Packages wizard to complete the installation.

Copying packages to an HTTP server using the Packaging Utility

If you want to create a repository on an HTTP server, then you must use the Packaging Utility to copy packages to the repository. The Packaging Utility can be used to combine multiple product packages, as well as service updates, into a single repository location. Refer to the Packaging Utility online help for more information.

To copy packages with the packaging utility, take the following steps:

  1. Start Packaging Utility from the Windows Start menu through Start -> All Programs -> IBM Packaging Utility -> IBM Packaging Utility.
  2. On the main page of the utility, click Copy Packages.
  3. Read the information provided and click Next.
  4. On the Source panel, click Open repository... and enter the location of the package you want to copy. For Developer for System z and its bundled offerings, you would point to the repository.config file located either on the IBM Rational Developer for System z Installation Setup CD or in the RDz76Edition_Setup directory of an electronic image.

    Alternatively, you can select Passport Advantage... to enter your Passport Advantage ID and password and copy packages from the Passport Advantage.

  5. Select the package(s) you want to install from the list of packages that are available in the repository you selected. Click Next.
  6. Read the terms of the license agreements for the selected packages. If you agree to the terms, select I agree with the terms of the license agreements and click Next.
  7. On the Destination panel, select an existing repository or click Browse and select the location where you would like to store your repository. Click OK once you have selected your destination directory.
  8. Click Next to advance to the Summary page. The Summary page displays the selected packages that will be copied into the destination repository. This page also lists the amount of storage space that the copy requires, as well as the amount of available space on the drive.
  9. If you would like to make changes, click Back to return to previous panels and make changes. When you are satisfied with your selections, click Copy to copy the selected packages to the destination repository. A status bar appears at the bottom of the wizard indicating how much time is remaining in the copy process. Once the copy process is finished, a Complete page opens and displays all of the packages that were copied successfully.
  10. Click Done to return to the Packaging Utility main page.
  11. If you would like to copy additional offerings to your repository, repeat steps 2-10, specifying the additional packages you want to copy.

Now that you have used the Packaging Utility to copy the Developer for System z installation files into a repository, you can place the repository on a Web server or other shared driver and make it available over HTTP or HTTPS. (The repository can also be placed on a UNC drive.)

Documentation notices for IBM Rational Developer for System z

© Copyright IBM Corporation - 2009

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

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (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.
3-2-12, Roppongi, Minato-ku, Tokyo 106-8711 Japan

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

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

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

IBM may use or distribute any of the information you supply 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:

Intellectual Property Dept. for Rational Software
IBM Corporation
3039 Cornwallis Road, PO Box 12195
Research Triangle Park, NC 27709
U.S.A.

I

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.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

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-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All 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 the names and addresses used by an actual business enterprise 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.

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.

Rational are trademarks of International Business Machines Corporation and Rational Software Corporation, in the United States, other countries, or both.

Intel and Pentium are trademarks of Intel Corporation in the United States, or other countries, or both.

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.

Index

A B C D E F G H I L M O P R S T U V W
A B C D E F G H I L M O P R S T U V W