This edition applies to IBM® Rational® Developer for System z® Version 8.0.1 (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.
This installation guide provides instructions for installing and uninstalling IBM Rational Developer for System z 8.0.1.
This document contains information on the following tasks:
The information in this document applies to all Rational Developer for System z v8.0.1 packages including IBM Rational Developer for zEnterprise.
This book is intended for programmers installing and configuring Developer for System z 8.0.1 client on their workstation. To use this book, you need to be familiar with the Microsoft® Windows® operating system, the Red Hat Linux® operating system, or the SUSE Linux operating system.
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 rdz80_releasenotes.html file located in the Documents\nl\en\readme directory of the IBM Rational Developer for System z Installation disk or IBM Rational Developer for zEnterprise Installation disk.
See the Library page of the Developer for System z Web site: http://www.ibm.com/software/rational/products/developer/systemz/library/index.html for updated documentation and troubleshooting information.
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.
Disk Name | Electronic Image Directory Name |
---|---|
IBM Rational Developer for System z with EGL Installation disk or IBM Rational Developer for System z with Java Installation disk |
Note: The value for Edition depends
on the edition of Developer
for System z.
|
IBM Rational Developer for zEnterprise Installation disk |
|
IBM Rational Developer for System z z/OS® and Multiplatforms Server Installation disk |
|
IBM Rational Developer for zEnterprise zOS and Multiplatforms Server Installation disk |
|
IBM Rational Developer for System z Quick Start and Documentation disk |
|
IBM Rational Developer for zEnterprise Quick Start and Documentation disk |
|
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.
See Installing the Rational Team Concert Integration extension for details on installing this software.
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. The Prerequisites document contains the most current information about hardware and software requirements. A link to the Prerequisites document can be found on the library page of the Developer for System z Web site:
http://www.ibm.com/software/rational/products/developer/systemz/library/index.html.
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.
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 | 1 GHz or faster 32-bit (x86) or 64-bit (x64)
processor A dual or quad core is recommended. |
Memory | 2 GB RAM minimum Recommended: 3GB RAM or more |
Disk space | 1.1 GB of disk space is required to install the IBM Rational Developer for System z minimum set of features. 1.8 GB of disk space, plus 210 MB of temporary space, is required for a full installation of IBM Rational Developer for System z. This includes Installation Manager and IBM Rational Developer for System z. 5 GB of disk space is recommended when installing other bundled software.
|
Display | 1024 x 768 resolution using 256 colors A higher resolution and color palette is recommended. |
Other hardware | Microsoft mouse or compatible pointing device |
Before you can install the product, verify that your system meets the software requirements.
Product Name | PTFs or Service Levels Required |
---|---|
Microsoft Windows XP Professional | Service Pack 3 or later |
Microsoft Windows Server 2003 Enterprise Edition | Service Pack 1 or later |
Microsoft Windows Server 2003 Standard Edition | Service Pack 1 or later |
Microsoft Windows Server 2008 Enterprise Edition | No Service Level Required |
Microsoft Windows Server 2008 Standard Edition | No Service Level Required |
Microsoft Windows Vista Business | Service Pack 1 |
Microsoft Windows Vista Enterprise | Service Pack 1 |
Microsoft Windows Vista Ultimate | Service Pack 1 |
Microsoft Windows 7 Professional Edition | No service level required |
Microsoft Windows 7 Enterprise Edition | No service level required |
Microsoft Windows 7 Ultimate Edition | No service level required |
Red Hat Linux Desktop v 5.0 32 bit | No service level required |
Red Hat Linux Desktop v 6.0 32 bit | No service level required |
Red Hat Linux Enterprise Server v 5.0 32 bit | No service level required |
Red Hat Linux Enterprise Server v 6.0 32 bit | No service level required |
SUSE Linux Enterprise Server v 10.0 32 bit | No service level required |
SUSE Linux Enterprise Server v 11.0 32 bit | No service level required |
SUSE Linux Enterprise Desktop v 10.0 32 bit | No service level required |
SUSE Linux Enterprise Desktop v 11.0 32 bit | No service level required |
Microsoft Windows 2008 Enterprise Server R2 | No service level required |
Microsoft Windows 2008 Standard Edition R2 | No service level required |
Product Name | Version | PTFs or Service 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® | Server version 2.0, Workstation | all available maintenance |
VMware® | vSphere 4.0 ESXi | all available maintenance |
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.
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.
Program Number | Product Name | PTFs or Service Levels Required |
---|---|---|
5724–B44 | 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 |
Program Number | Product Name | PTFs or Service Levels Required |
---|---|---|
5765-F35 | DB2® Workgroup Server Edition v 9.7 | |
5724-B55 | DB2 Connect Personal Edition v 9.7 | |
5765-F41 | DB2 Enterprise Server Edition v 9.7 for Windows |
Program Number | Product Name | PTFs or Service Levels Required |
---|---|---|
5724-V88 | Rational Software Architect v 8.0.1 |
http://www-01.ibm.com/software/awdtools/swarchitect/standard/
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.
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:
With this method, you have the installation 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 disks for an overview of the steps.
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 zip files.
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.
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.
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.
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 the option of a guided installation or an expert installation.
For more information about 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.
The following table shows the features of Developer for System z that you can choose to install. For information about the available features of other offerings that are bundled with Developer for System z, see the documentation for those offerings.
Feature | Description |
---|---|
System z Integrated Development Environment (required) | Provides an interactive, workstation-based environment where you can connect to a mainframe and develop mainframe-based applications in COBOL, PL/I, Assembler, C/C++, and Java, 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. |
COBOL and PL/I for Windows** ** See explanatory note after this table. |
Enables creation of Windows binaries for COBOL and PL/I programs for use in unit testing applications locally with Windows shell scripts or in the CICS TX Series runtime. This feature is not required for local syntax check; the local syntax check capability is enabled by selection of the System z Integrated Development Environment feature. |
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. |
SCLM Developer Toolkit | Provides tools to access and work with Software Configuration and Library Manager (SCLM) managed source code. |
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. |
CA Endevor Software Change Manager | Provides tools to access and work with CA Endevor Software Change Manager managed source code. |
Enterprise Service Tools for CICS (including Service Component Architecture) | Enterprise Service Tools for CICS provide an integrated set of tools that support modern application architectures and the transformation and reuse of existing CICS application processes. The tools support generation of Web service descriptions and service flow processing artifacts directly to a z/OS system, including CICS TS and the CICS Service Flow Runtime. Enterprise Service Tools quickly enable the move towards service-oriented architecture (SOA). |
BMS Screen Designer | Enables you to visually create and modify Basic Mapping Support (BMS) map sets. It is designed for CICS developers who are familiar with terminal-based tools (for example, SDF II) or GUI-based tools, such as the BMS editor included with VA COBOL. |
CICS Code Generators | Provides design tools and wizards 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. |
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). |
MFS Screen Designer | Enables you to create and modify Message Format Service (MFS) message and format files. Many Information Management System (IMS) programs are based on MFS, which is an IMS Transaction Manager environment facility that formats messages to and from terminal devices. |
IMS Code Generators | Provides code snippets which allow you to rapidly add common programming objects to IMS application code. |
Data Tools | Provides relational database tools to work with tables, table views, and filters. With these tools, you can create physical database models by 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 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. |
File Manager (available only on Windows) | 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.
|
Fault Analyzer (available only on Windows) | 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
|
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. |
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. |
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/v1r4/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.
For the most current information on how to deploy Developer for System z to many users, see the information available in the Installation Manager Infocenter and on the Rational Installation Wiki at:
https://www.ibm.com/developerworks/wikis/display/rationalinstall/Home
IBM Installation Manager is typically installed automatically as part of the Developer for System z installation process.
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.
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.
installc.exe --launcher.ini silent-install.ini
install --launcher.ini silent-install.ini
userinstc.exe --launcher.ini user-silent-install.ini
userinst --launcher.ini user-silent-install.ini
For more information about installing IBM Installation Manager, refer to the IBM Installation Manager documentation.
IBM Installation Manager is installed and started automatically when you perform the Developer for System z installation.
Installable offerings, or packages, are stored in locations called repositories, which can be on an HTTP Web server, shared network drive, physical disks, 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.
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.
The following sections provide an overview of the various installation methods you might use when installing Developer for System z.
In this installation scenario, you have the physical disks containing the installation files, and typically you are installing Developer for System z on your own workstation.
Refer to Installing Developer for System z for details.
Refer to Installing Developer for System z for details.
For information about performing silent installations using your shared electronic image, refer to Silent installation.
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.
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 8.0.1 offering and its bundled offerings. You can use this repository to perform interactive or 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:
The Developer for System z launchpad program provides you with a single location to view release information and begin the installation process.
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.
On the Install Rational Developer for System z panel of the launchpad, you can decide to install for all users (which requires you to have administrator access), or you can just install for the current user. Then you click on one of the provided links to start either a guided installation or an expert installation.
You can select to perform an expert installation rather than selecting a guided installation. Selecting an expert installation will launch the Developer for System z installation with the most common features and bundled offerings selected by default.
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:
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.
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.
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.
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.
IBMIM.exe -record <response file path and name>.xml -log <log file path and name>.xmlFor example,
IBMIM.exe -record C:\my_response_file.xml -log C:\install_log.xml
IBMIM -record <response file path and name>.xml -log <log file path and name>.xmlFor example,
IBMIM -record /root/mylog/my_response_file.xml -log /root/mylog/install_log.xml
You can record a response file without installing or uninstalling a product by adding the optional -skipInstall <agentDataLocation> parameter. Note that <agentDataLocation> must be a writable directory. The argument causes Installation Manager to save the installation data without installing the product. You can use the same <agentDataLocation> in the next recording session to record updates or modifications to the product, or to record license management. Note that the products installed or the preferences, including repository settings, that you may have set on install when not using the -skipInstall argument are not stored. Using -skipInstall will make installation faster because the Installation Manager is not installing the product, it is just recording the installation data.
IBMIM -record <response file and path name> -skipInstall <a writable directory for agent data location>For example (on the Windows platform):
IBMIM -record c:\mylog\responsefile.xml -skipInstall c:\temp\recordData
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 disk in the SilentInstall directory. The sample response file can also be found in the RDz801Edition_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.
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 [arguments]
IBMIM --launcher.ini silent-install.ini [arguments]
The following table describes the 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. |
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>.
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.
<preference> name = "the key of the preference" value = "the value of the preference to be set" </preference>
Use the following table to identify keys and their associated values 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 | 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 | ![]() ![]() 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. |
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 following list contains the currently supported language
codes:
|
Set profile (continued)<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> |
The following properties are used
to configure a z/OS connection
that will be used to automatically retrieve workbench configuration
settings. The connection will be created the first time the workbench
is launched using a new workspace.
|
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. |
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>
You can use silent install log files to examine the results of a silent installation session.
<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.
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.
IBMIM.exe -mode wizard -input <response file>
./IBMIM -mode wizard -input <response file>
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.
If you select this option, then you will be linked to your product information center through an ibm.com®® Web site. You can access the Web-based help for the product only when you are connected to the Internet. When you are disconnected, you will have access to a limited number of help topics that are installed with the product.
After you download the information center content that you need, it will be available when you work while disconnected. You can update the content when changes are available.
If you are an administrator and you want users to access help content from an intranet server, see the installation information for guidance on setting up the intranet server and downloading the help content from the update site.
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.
The 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 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 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 the Installation Manager information center for instructions on how to install the help WAR file on a server. In the Installation Manager information center, select Enterprise installation articles -> Delivering help content from an intranet server.
Help for Developer for System z is available on a product information center on the Internet. You can view this help from within Developer for System z.
During installation, Developer for System z was configured to access the help from the product information center.
The information center for Developer for System z is available from the following Web address:
http://publib.boulder.ibm.com/infocenter/ratdevz/v8r0/index.jsp.
Follow these steps to check your connection to the information center:
This topic explains how to download help content from the Local Help System Updater site.
To install the help content from the RDz8.0_updateSite.zip file found in the install_localhelp directory of the Quick Start Disk, see Installing help content locally using the Local Help Updater and the RDz8.0_updateSite.zip file
To download the help content from the Local Help System Updater site, complete the following steps:
Use the Local Help System updater to ensure that you have the latest help content.
To update the help without restarting the product, complete the following steps:
If you are not going to use remote help to access the help content from the Web and you do not have internet access, you must install the help content locally. This topic explains how to install the help content using the Local Help System Updater and the RDz8.0_updateSite.zip file provided in the install image. The RDz8.0_updateSite.zip file is located on the IBM Rational Developer for System z Quick Start Disk.
To install the help content on the workstation using the Local Help System Updater and the RDz8.0_updateSite.zip file, complete the following steps:
You can use the Local Help System Updater to remove installed help content.
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.
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.
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.
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.
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.
The token-based license model means that you can buy a certain number of token licenses. If you use a Rational tool that checks out a FEATURE that is token-based, the FEATURE line in the license file specifies the number of tokens that are checked out.
Token-based licenses can only be used with floating licenses. They cannot be used for authorized user license.
For more details about token licensing, contact your local IBM marketing representative.
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.
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.
For more information on obtaining activation kits and Floating licenses, see Purchasing licenses.
You can review license information for your installed packages, including license types and expiration dates, from IBM Installation Manager.
The package vendor, current license types, and expiration dates are displayed for each installed package.
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 disk 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.
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.
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.
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.
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.
Optionally, you can also go to Passport Advantage to download the activation kit for your product. After importing the activation kit, you have the option of switching from a floating to a permanent license type if you use your PC offline for long periods.
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.
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.
For best product performance, increase the number of file handles above the default of 1024 handles.
To increase the number of file handles on a Linux computer, complete the following steps:
If you use a Linux operating system, then you must check that your computer meets the requirements listed in this topic.
You might need to set the environment variable MOZILLA_FIVE_HOME to the folder containing you Firefox or Mozilla installation. For example, setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5.
org.eclipse.swt.SWTError: No more handles [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)]
To support the SWT browser widget, your Firefox browser must be dynamically linked, which means it was not downloaded from mozilla.org, but was compiled from source. This is typically the case when Firefox comes as part of the distribution (that is, it is in a place such as /usr/lib/firefox).
One way to ensure that this is true is to see if it is the browser that is pointed at by /etc/gre.conf. The purpose of this gre.conf file is to point at an embeddable browser.
org.eclipse.swt.SWTError: No more handles (java.lang.UnsatisfiedLinkError: /home/n0002466/.eclipse/ibm.software.development.platform_7.0.0 /configuration/org.eclipse.osgi/bundles/267/1/.cp/libswt-mozilla-gtk-3236.so (libxpcom.so: cannot open shared object file: No such file or directory)) SUSE Linux might require a fix for invisible text problem.))
http://support.novell.com/techcenter/psdb/44ab155e3202595389c101e6cf7e20f2.html
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.
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.
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.
See the Developer for System z Host Planning Guide for details on installing required System z components.
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.
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.
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 disk for details on installing the optional RSE Server.
See the IBM Rational Developer for Power Systems Software V8.0 Installation Guide, file AIXp_LinuxpServerInstall.html on the IBM Rational Developer for zEnterprise Server Installation Disk, for details in installing the optional RSE Server on Power/AIX and Power/Linux on IBM Rational Developer for zEnterprise.
This section covers known problems and limitations with installation and uninstallation.
For information about product problems and limitations, refer to the rdz80_releasenotes.html file located in the Documents\nl\en\readme directory of the IBM Rational Developer for System z Installation disk or IBM Rational Developer for zEnterprise Installation disk.
You can use the IBM Packaging Utility software to copy packages to a repository that can be placed on a Web server available over HTTP or HTTPS.
The Packaging Utility software is included on the IBM Rational Enterprise Deployment disk. 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.
Refer to the online help for the Packaging Utility for full instructions on using the tool.
The IBM Packaging Utility must be extracted from a compressed file before it can be used to copy the Developer for System z package.
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.
Alternatively, you can select Passport Advantage... to enter your Passport Advantage ID and password and copy packages from the Passport Advantage.
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.)
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Programming interfaces: Intended programming interfaces allow the customer to write programs to obtain the services of Rational Developer for System z.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
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.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 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.
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 is for planning purposes only. The information herein is subject to change before the products described become available.
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.
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.
See www.ibm.com/legal/copytrade.shtml.
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.
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.
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.