Install Eclipse Tools - Mainframe DEV

Step 1: choose your products

Select row	Name	Aqua Version	Installation Methods
Select row	IBM Application Delivery Foundation for z/OS IBM Application Delivery Foundation for z/OS offers a core set of tools for your team to create and maintain applications for z/OS® environments.	3.2, 3.3, 3.4	IM, p2
Select row	IBM Application Discovery ad IBM Application Discovery technology makes it faster and easier for developers to understand and develop applications in a DevOps environment.	3.2, 3.3, 3.4	IM, p2
Select row	IBM Application Performance Analyzer for z/OS apa zos adfz IBM Application Performance Analyzer for z/OS measures and reports how applications use available resources.	3.2, 3.3, 3.4	IM, p2
Select row	IBM CICS Configuration Manager cm IBM CICS Configuration Manager is a tool for administering and maintaining CICS resources.	3.2, 3.3, 3.4	IM, p2
Select row	IBM CICS Deployment Assistant da IBM CICS Deployment Assistant for z/OS provides a centralized, complete model of your CICS infrastructure to improve data discovery	3.2, 3.3	IM, p2
Select row	IBM CICS Explorer cicsexplorer IBM CICS Explorer provides an intuitive way to manage one or more IBM CICS regions. When connected to CICSplex, CICS Explorer can seamlessly manage definitions and resources across your plex as a single point of control.	3.2, 3.3, 3.4	IM, p2
Select row	IBM CICS Interdependency Analyzer ia IBM CICS Interdependency Analyzer is a dynamic discovery tool designed to help system programmers and application developers to better understand the relationships and dependencies of your CICS applications and the environment on which they run	3.2, 3.3, 3.4	IM, p2
Select row	IBM CICS Performance Analyzer pa IBM CICS Performance Analyzer reports on the performance of CICS applications and system, helping to identify and eliminate the causes of online performance issues.	3.2, 3.3	IM, p2
Select row	IBM CICS Transaction Gateway tg IBM CICS Transaction Gateway is a connector for enterprise modernization of CICS assets	3.2, 3.3	IM, p2
Select row	IBM Data Studio ds IBM Data Studio provides an integrated, modular environment to enable database development and administration of IBM Db2 for Linux, UNIX and Windows.	3.2	IM
Select row	IBM Debug for z/OS debugger adfz IBM Debug for z/OS is the stand-alone product that contains IBM z/OS Debugger (previously known as IBM Debug Tool and Integrated Debugger, now consolidated into one unified technology).	3.2 ^[5] , 3.3, 3.4	IM, p2
Select row	IBM Developer for z/OS (IDz or IDz EE) idz rdz adfz IBM Developer for z/OS is a comprehensive integrated development environment for developing and maintaining IBM z/OS applications. It covers both modern and traditional editing and SCM integration in remote and local usage scenarios.	3.2 ^[5] , 3.3, 3.4	IM, p2
Select row	IBM Engineering Workflow Management (Formerly RTC) rtc IBM Engineering Workflow Management manages plans, tasks, project status, as the critical link between required and delivered work.	3.2, 3.3 ^[2] , 3.4	IM, p2
Select row	IBM Explorer for z/OS zosexplorer aqua IBM Explorer for z/OS (z/OS Explorer) is an Eclipse-based integration platform for z/OS users.	3.2, 3.3, 3.4	IM, p2
Select row	IBM Fault Analyzer for z/OS fa adfz IBM Fault Analyzer for z/OS helps developers analyze and fix system and application failures for CICS, WebSphere Application Server for z/OS, WebSphere MQ, IMS™ and DB2 environments.	3.2 ^[5] , 3.3, 3.4	IM, p2
Select row	IBM File Manager for z/OS fm adfz IBM File Manager for z/OS provides flexible, user-friendly tools for enhanced file processing when working with z/OS data sets, Db2, CICS, IMS or WebSphere MQ data generated by the IBM Determination Tools suite.	3.2 ^[5] , 3.3, 3.4	IM, p2
Select row	IBM IMS Configuration Manager cm IBM IMS Configuration Manager for z/OS is a tool to help analyze and compare IMS configurations.	-- ^[6]	--
Select row	IBM IMS Connect Extensions ce IBM IMS Connect Extensions for z/OS Operations Console is a plug-in for z/OS Explorer that provides you with additional capabilities beyond the IBM IMS Connect Extensions for z/OS ISPF-based interface.	3.2, 3.3	IM, p2
Select row	IBM IMS Explorer for Development IBM IMS Explorer for Development is an Eclipse-based graphical tool that can display and edit IMS databases, segments, fields and more.	3.1 ^[1] , 3.2	IM
Select row	IBM Monitoring and Diagnostics Tools - Health Center java IBM Monitoring and Diagnostic Tools - Health Center is a diagnostic tool for monitoring the status of a running Java or Node.js application.	3.2, 3.3, 3.4	IM, p2
Select row	IBM MQ Explorer IBM MQ Explorer is the graphical user interface in which you can administer and monitor IBM MQ objects, whether they are hosted by your local computer or on a remote system.	3.2, 3.3	IM, p2
Select row	IBM Rational Programming Patterns rpp IBM Rational Programming Patterns is a collaborative Integrated Development Environment part of the Jazz™ Collaborative Lifecycle Management solutions.	3.2, 3.3 ^[4]	IM, P2
Select row	IBM Engineering Workflow Management Integration for z/OS rtcz This IBM Developer for z/OS extension provides the capability that allows Engineering Workflow Management to enable Remote project and User Build support for z/OS developers.	3.2, 3.3 ^[3] , 3.4	IM, p2
Select row	IBM z/OS Connect EE zos zosconnect IBM z/OS Connect Enterprise Edition provides a framework that enables z/OS based programs and data to participate fully in the new API economy for mobile and cloud applications.	3.2, 3.3	IM, p2
Select row	IBM Z JCL Expert jclx IBM® Z® JCL Expert is a JCL checker tool. Application programmers know the pressures of building JCL applications with no errors and staying compliant with site standards. This tool provides advanced JCL checking including site standard conformance verification by checking the JCL and utility parameter syntax online. Unlike other offerings, IBM Z JCL Expert performs JCL checking in the development environment already in use.	3.2, 3.3	IM, p2

[1] See here for products with extended support for Aqua 3.1.
[2] Check here to download IBM Engineering Workflow Management 7.0.2.
[3] Check here to download IBM Engineering Workflow Management Integration for z/OS 16.0.702.
[4] Note: the current version of IBM Rational Programming Patterns is only compatible with IBM Engineering Workflow Management 7.0.3 or later. Check here to download IBM Rational Programming Patterns 9.7.3 which is compatible with IBM Engineering Workflow Management 7.0.2.
[5] Note: IBM Developer for z/OS V15.0.x, IBM Debug for z/OS V15.0.x, IBM Fault Analyzer for z/OS V14.1.x and IBM File Manager for z/OS V14.1.x have reached the end of service on April 30th 2024.
[6] Note: IBM IMS Configuration Manager for z/OS Eclipse Plugin V2.3.0 has reached the end of service on August 31st 2024. See here for more information.

Step 2: choose an Aqua version

Please select one of the Aqua versions shown below. How do I decide?

Aqua release train version

IBM Explorer for z/OS Aqua (or simply Aqua) is a continuous delivery release train platform that brings together a set of Eclipse-based mainframe development tools and offerings in order to provide z/OS application developers and system programmers an easy way to install, deploy and maintain our IBM Eclipse-based products.

What is the difference between the versions of Aqua?

Each version of Aqua is based on a different version of Eclipse. New features and products will be integrated with newer versions of Aqua while the previous versions will remain in support mode moving forward.

Can I upgrade an Aqua environment directly to another version?

It is not possible to install plug-ins and tools onto an Aqua environment that is from a different Aqua version since each version is based on a specific Eclipse iteration. To move from one Aqua version to another (eg. Aqua 3.3 to Aqua 3.4), you will need a fresh environment and from there you can bring over the workspace data.

Aqua 3.4

(Eclipse V4.31)

This option is unavailable because one or more products that have been selected are not available for this version of Aqua.

A workaround is required to install IBM Z Open Development and IBM Rational Team Concert together. Please see this blog post for more details.

View details

Aqua 3.3

(Eclipse V4.23)

This option is unavailable because one or more products that have been selected are not available for this version of Aqua.

A workaround is required to install IBM Z Open Development and IBM Rational Team Concert together. Please see this blog post for more details.

View details

Aqua 3.2

(Eclipse Photon V4.8)

This option is unavailable because one or more products that have been selected are not available for this version of Aqua.

A workaround is required to install IBM Z Open Development and IBM Rational Team Concert together. Please see this blog post for more details.

View details

Step 3: choose an installation client

Please select one of the installation methods shown below. How do I decide?

Aqua tools packaging formats

The IBM Aqua products can be installed using two different packaging formats: IBM Installation Manager or Eclipse p2.

IBM Installation Manager (IM)

IBM Installation Manager is IBM’s solution for managing Eclipse-based tools such as Aqua tools. You install a separate utility (IBM Installation Manager) that keeps track of your installed Eclipse-based tools and is able to modify and extend those tools. Some Aqua tools must be installed using IBM Installation Manager — they are not available via Eclipse p2.

Eclipse p2

Eclipse p2 is an installation technology built into Eclipse tools. It can be accessed using the built-in ‘Install New Software’ option. It can often be the quickest way to get going, though not all Aqua tools are available via Eclipse p2.

Making a choice

When choosing the packaging format, ask these questions:

Are all the tools I want to install together supported by this packaging format? Also consider tools you may want to install in the same Eclipse in future. Once you start to create an Eclipse with one of these methods, it’s important to continue to use the same method if you extend it. This avoids the package managers getting confused, resulting in errors. You can see which packaging formats support which tools in the table of all tools.
Do you have an existing enterprise deployment tool that you will use for rollout? Does it already have a way of supporting IBM Installation Manager or Eclipse p2?
Do you just want to try out a tool quickly? Using Eclipse p2 will get you going faster.

IBM Installation Manager

Install with IBM Installation Manager, an application that can access the software repository and guide you through each step of the process.

For IDz 14.1.x using Installation Manager and Aqua 3.1:
- To update - uncheck the Show recommended only option in order to be able to select the latest version of 14.1.x
- To install - check the Show all versions option in order to be able to select the latest version of 14.1.x

Please note IBM Installation Manager V1.9.2.3 or higher is required.

IBM Installation Manager

Installing with IBM Installation Manager is currently not supported by Aqua 3.4 products.

Eclipse p2

Install with the Eclipse p2 provisioning platform, a technology for managing Eclipse- and Equinox-based applications and plug-ins.

Please note the following products and their specific version restriction when installing them with Eclipse p2 for Aqua 3.1:

IBM Developer for z/OS - V14.2.x only
IBM Debug for z/OS - V14.2.x only

Step 4: choose your starting point

Starting from fresh

I do not have IBM Installation Manager installed on my machine.

Extending an existing Installation Manager instance

I have IBM Installation Manager installed on my machine.

Hosting an internal Installation Manager repository

I want to download the entire IBM Installation Manager repository to host internally to my organisation.

This option is unavailable for Aqua 3.0.

Starting from fresh

I do not have Eclipse installed on my machine.

Extending an existing Eclipse instance

I want to extend an existing instance of Eclipse I have installed on my machine.

Hosting an internal repository

I want to download the entire p2 repository to host internally to my organisation.

Download and install

These instructions will show you how to install the selected products, using IBM Installation Manager, from an online IBM repository.

Download and install IBM Installation Manager

If you already have IBM Installation Manager installed, skip this step.

3.0
Aqua 3.0 (Eclipse Luna V4.4)

3.1
Aqua 3.1 (Eclipse Neon V4.6)

3.2
Aqua 3.2 (Eclipse Photon V4.8)

3.3
Aqua 3.3 (Eclipse V4.23)

3.4
Aqua 3.4 (Eclipse V4.31)

LINUX
Linux

WINDOWS
Windows

MAC
MacOS

Choose OS

Download

Download, unzip, and install IBM Installation Manager (IM) using one of the following options:
- Prerequisite: clear the extended attributes of IM zip file:
  xattr -c path_to_IM_zip
- User install: InstallerImage_macosx_cocoa_x86_64/UserInst.app
- Admin install: InstallerImage_macosx_cocoa_x86_64/Install.app or imLauncherMac.sh
- Installation Manager may require root access to install - you can also start the installer by using the sudo command below:
  sudo Downloads/IM_extractdir/Install.app/Contents/MacOS/install
  IM_extractdir is the directory that the package was extracted to
- User install: imLauncherWindowsUser.bat
- Admin install: imLauncherWindows.bat
- User install: imLauncherLinuxUser.sh
- Admin install: imLauncherLinux.sh
Restart IM after the installation has completed.

Install product offerings through IM

In IBM Installation Manager, select 'Install' to view and select product offerings for installation.

Choosing packages to install. The version numbers may differ from what you see.
Select to install the following products:
Review and complete the remaining pages in IBM Installation Manager.

These instructions will show you how to extend an existing Eclipse instance with the selected products, using IBM Installation Manager, from an online IBM repository.

Adding a new online repository to IM

If you do not need to add a new online repository to IBM Installation Manager, skip this step.

Update IBM Installation Manager to version 1.9.1.4 or later.
Update IBM Installation Manager to version 1.9.1.4 or later.
Update IBM Installation Manager to version 1.8.5.1 or later.
Launch IBM Installation Manager.
In the menu bar, select 'File' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
In the menu bar, select 'IBM Installation Manager' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
In the menu bar, select 'File' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
Select the 'Add Repository...' button and paste the following repository URL:
- z/OS Explorer Aqua V3.0 (Eclipse Luna V4.4) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua/
- z/OS Explorer Aqua V3.1 (Eclipse Neon V4.6) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/
- z/OS Explorer Aqua V3.2 (Eclipse Photon V4.8) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.2/
- z/OS Explorer Aqua V3.3 (Eclipse V4.23) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.3/
Select 'OK' to confirm the new repository.

Rational Developer for z Systems (RDz)
Users of RDz V9.1 and below must uninstall RDz and create a fresh installation of IDz in order to upgrade. Users of RDz V9.5.x are unaffected by this limitation. More details

Extending an existing IM installation

In Installation Manager, click Install to view and select product offering(s) for installation.
Select the following products:
Review and accept the licenses.
In the next step, select the "Use the existing package group" radial button.
Continue to follow the instructions to select translations and additional features, then complete the installation.

These instructions will show you how to use a locally hosted repository to install products using IBM Installation Manager.

Download and install IBM Installation Manager

If you already have Installation Manager installed, skip this step.

3.0
Aqua 3.0 (Eclipse Luna V4.4)

3.1
Aqua 3.1 (Eclipse Neon V4.6)

3.2
Aqua 3.2 (Eclipse Photon V4.8)

3.3
Aqua 3.3 (Eclipse V4.23)

3.4
Aqua 3.4 (Eclipse V4.31)

LINUX
Linux

WINDOWS
Windows

MAC
MacOS

Choose OS

Download

Download, unzip, and install IBM Installation Manager (IM) using one of the following options:
- Prerequisite: clear the extended attributes of IM zip file:
  xattr -c path_to_IM_zip
- User install: InstallerImage_macosx_cocoa_x86_64/UserInst.app
- Admin install: InstallerImage_macosx_cocoa_x86_64/Install.app or imLauncherMac.sh
- Installation Manager may require root access to install - you can also start the installer by using the sudo command below:
  sudo Downloads/IM_extractdir/Install.app/Contents/MacOS/install
  IM_extractdir is the directory that the package was extracted to
- User install: imLauncherWindowsUser.bat
- Admin install: imLauncherWindows.bat
- User install: imLauncherLinuxUser.sh
- Admin install: imLauncherLinux.sh
Restart IM after the installation has completed.

Use pre-packaged repository zip files to prepare a local repository

Refer to the table below and download the repository zip files for each of your selected products:

Product Name	Download
IBM Explorer for z/OS (required)	N/A
IBM CICS Explorer (required)	N/A
IBM Application Delivery Foundation for z/OS This package includes the following products: IBM Application Performance Analyzer for z/OS IBM Debug for z/OS IBM Developer for z/OS IBM Fault Analyzer for z/OS IBM File Manager for z/OS	N/A
IBM Application Discovery	N/A
IBM Application Performance Analyzer for z/OS	N/A
IBM CICS Configuration Manager	N/A
IBM CICS Deployment Assistant	N/A
IBM CICS Interdependency Analyzer	N/A
IBM CICS Performance Analyzer	N/A
IBM CICS Transaction Gateway	N/A
IBM Data Studio	N/A	Available soon ^[1]
IBM Debug for z/OS (ADFz package)	N/A
IBM Developer for z/OS 14.1.x	N/A
IBM Developer for z/OS 14.2.x	N/A
IBM Fault Analyzer for z/OS	N/A
IBM File Manager for z/OS	N/A
IBM IMS Configuration Manager	N/A
IBM IMS Connect Extensions	N/A
IBM IMS Explorer for Development	N/A
IBM Monitoring and Diagnostics Tools - Health Center	N/A
IBM MQ Explorer	N/A
IBM Rational Programming Patterns	N/A
IBM Engineering Workflow Management	N/A
IBM Engineering Workflow Management for z/OS V14.1.x	N/A
IBM Engineering Workflow Management for z/OS V14.2.x	N/A
IBM z/OS Connect EE	N/A

[1] Downloading will be available soon, see notes

Products labeled required are necessary for the successful installation of the other products selected.

In the offline environment, extract the archive(s) into a local directory of your choosing.

Use pre-packaged repository zip files to prepare a local repository

Download the following zip file which includes all offerings pre-packaged for use with IBM Installation Manager.

Aqua 3.2 All IM Repo Zip

Alternatively, refer to the table below and download the repository zip files for each of your selected products:

Product Name	Download
IBM Application Delivery Foundation for z/OS This package includes the following products: IBM Application Performance Analyzer for z/OS IBM Debug for z/OS IBM Developer for z/OS IBM Fault Analyzer for z/OS IBM File Manager for z/OS
IBM Explorer for z/OS (required)	N/A
IBM CICS Explorer (required)	N/A
IBM Application Discovery	N/A
IBM Application Performance Analyzer for z/OS	N/A
IBM CICS Configuration Manager	N/A
IBM CICS Deployment Assistant	N/A
IBM CICS Interdependency Analyzer	N/A
IBM Developer for z/OS V15.0.x	N/A
IBM Engineering Workflow Management for z/OS V15.0.x	N/A
IBM CICS Performance Analyzer	N/A
IBM CICS Transaction Gateway	N/A
IBM Data Studio	N/A
IBM Debug for z/OS	N/A	N/A (P2 zip only)
IBM Fault Analyzer for z/OS	N/A
IBM File Manager for z/OS	N/A
IBM IMS Configuration Manager	N/A
IBM IMS Connect Extensions	N/A
IBM IMS Explorer for Development	N/A
IBM Monitoring and Diagnostics Tools - Health Center	N/A
IBM MQ Explorer	N/A
IBM Rational Programming Patterns	N/A
IBM Engineering Workflow Management	N/A
IBM z/OS Connect EE	N/A
IBM Z JCL Expert	N/A

Products labeled required are necessary for the successful installation of the other products selected.

In the offline environment, extract the archive(s) into a local directory of your choosing.

Use pre-packaged repository zip files to prepare a local repository

Download the following zip file which includes all offerings pre-packaged for use with IBM Installation Manager.

Aqua 3.3 All IM Repo Zip

Alternatively, refer to the table below and download the repository zip files for each of your selected products:

Product Name	Download
IBM Application Delivery Foundation for z/OS This package includes the following products: IBM Application Performance Analyzer for z/OS IBM Debug for z/OS IBM Developer for z/OS IBM Fault Analyzer for z/OS IBM File Manager for z/OS
IBM Explorer for z/OS (required)	N/A
IBM CICS Explorer (required)	N/A
IBM Application Discovery	N/A
IBM Application Performance Analyzer for z/OS	N/A
IBM CICS Configuration Manager	N/A
IBM CICS Deployment Assistant	N/A
IBM CICS Interdependency Analyzer	N/A
IBM Developer for z/OS V16.0.x	N/A
IBM Engineering Workflow Management for z/OS V15.0.x	N/A
IBM CICS Performance Analyzer	N/A
IBM CICS Transaction Gateway	N/A
IBM Data Studio	N/A
IBM Debug for z/OS	N/A
IBM Fault Analyzer for z/OS	N/A
IBM File Manager for z/OS	N/A
IBM IMS Configuration Manager	N/A
IBM IMS Connect Extensions	N/A
IBM IMS Explorer for Development	N/A
IBM Monitoring and Diagnostics Tools - Health Center	N/A
IBM MQ Explorer	N/A
IBM Rational Programming Patterns	N/A
IBM Engineering Workflow Management	N/A
IBM z/OS Connect EE	N/A
IBM Z JCL Expert	N/A

Products labeled required are necessary for the successful installation of the other products selected.

In the offline environment, extract the archive(s) into a local directory of your choosing.

Add an offline repository to IM

Launch IBM Installation Manager.
In the menu bar, select 'File' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
In the menu bar, select 'IBM Installation Manager' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
In the menu bar, select 'File' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
Select the 'Add Repository...' button and supply the location of your locally unzipped repository.
Select 'OK' to confirm the new repository.

Install product offerings through IM

In IBM Installation Manager, select 'Install' to view and select product offerings for installation.

Choosing packages to install. The version numbers may differ from what you see.
Select to install the following products:
Review and complete the remaining pages in IBM Installation Manager.

These instructions will show you how to install a new instance of Eclipse with the selected products, using Eclipse p2, from an online IBM repository.

Downloading and extracting the platform executable

3.0
Aqua 3.0 (Eclipse Luna V4.4)

3.1
Aqua 3.1 (Eclipse Neon V4.6)

3.2
Aqua 3.2 (Eclipse Photon V4.8)

3.3
Aqua 3.3 (Eclipse V4.23)

3.4
Aqua 3.4 (Eclipse V4.31)

LINUX
Linux

WINDOWS
Windows

MAC
MacOS

Choose OS

IBM Developer for z/OS (V15.0) 32-bit 64-bit

IBM Developer for z/OS (V15.0) Download 64-bit

IBM Developer for z/OS (V16.0) Download 64-bit

IBM Developer for z/OS (V17.0) Not available

IBM Developer for z/OS (V17.0) Download 64-bit

CICS Explorer 32-bit 64-bit Download 64-bit Not available

CICS Explorer 32-bit 64-bit Download 64-bit Download 64-bit

CICS Explorer Download 64-bit Download 64-bit Download 64-bit

z/OS Explorer 32-bit 64-bit Download 64-bit Not available

z/OS Explorer 32-bit 64-bit Download 64-bit Download 64-bit

z/OS Explorer Download 64-bit Download 64-bit Download 64-bit

Download and extract the package to a location of your choosing.
- MacOS only: prerequisite to upzipping, clear the extended attributes of the zip file:
  xattr -c path_to_zip
- MacOS only: after extracting the client file contents, it is recommended to move the application to the "Applications" folder so that it is possible to update to a new release - updates are not possible when the client files are placed in a different folder.
Launch the platform application by running "zosexplorer". Launch the platform application by running "zosexplorer.exe". Launch the platform application by running "Zosexplorer.app". Why is the executable from z/OS Explorer?
Launch the platform application by running "Z_Open_Development". Launch the platform application by running "Z_Open_Development.exe". Launch the platform application by running "Z_Open_Development.app".
Launch the platform application by running "zosexplorer". Launch the platform application by running "zosexplorer.exe". Launch the platform application by running "Zosexplorer.app". Why is the executable from z/OS Explorer?

Install additional products

Important: IBM Z Open Unit Test is currently only supported on Windows. The following steps are not applicable if the operating system is MacOS or Linux.
Important: a workaround is required to install IBM Z Open Development and IBM Rational Team Concert together. Please see this blog post .
In the menu bar, select 'Help' -> 'Install New Software...'.
Select to work with the "IBM Explorer for z/OS Update Site" and allow the list of available software to load.
Select additional products from the list.
Select the following products from the list:
Review and complete the remaining steps in the install wizard.

These instructions will show you how to extend an existing instance of Eclipse with the selected products, using Eclipse p2, from an online IBM repository.

Adding a new online repository to p2

Launch Eclipse. (Note: IBM Developer for z/OS V16.0.x does not support direct installation on top of an official Eclipse instance.)
In the menu bar, select 'Help' -> 'Install New Software...'.
In the install dialog, select "Add...".
In the "Add Repository" dialog add the repository URL:
- z/OS Explorer Aqua V3.0 (Eclipse Luna V4.4) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua/
- z/OS Explorer Aqua V3.1 (Eclipse Neon V4.6) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/
- z/OS Explorer Aqua V3.2 (Eclipse Photon V4.8) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.2/
- z/OS Explorer Aqua V3.3 (Eclipse V4.23) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.3/
- z/OS Explorer Aqua V3.4 (Eclipse V4.31) https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.4/
At the bottom of the window, enable the checkbox 'Group items by category' to view the list of all individual products.
Important: a workaround is required to install IBM Z Open Development and IBM Rational Team Concert together. Please see this blog post .
Select additional products from the list.
Important: IBM Z Open Unit Test is currently only supported on Windows. The following steps are not applicable if the operating system is MacOS or Linux.
Install the following products:
Review and complete the remaining steps in the install wizard.

If you experience any problem with RSE (Remote System Explorer), please refer to this section:

To resolve the error, check "Show original error and build my own solution" and "Remove items already installed" when the Install Remediation panel is presented
See this page for more in-depth information.

These instructions will show you how to use a locally hosted repository to install products using Eclipse p2.

Downloading and installing Eclipse

If you or your users already have an instance of Eclipse installed, skip this step.

Download an instance of Eclipse from the Aqua repository.

MacOS only: prerequisite to upzipping, clear the extended attributes of the zip file:
xattr -c path_to_zip

3.0
Aqua 3.0 (Eclipse Luna V4.4)

3.1
Aqua 3.1 (Eclipse Neon V4.6)

3.2
Aqua 3.2 (Eclipse Photon V4.8)

3.3
Aqua 3.3 (Eclipse V4.23)

3.4
Aqua 3.4 (Eclipse V4.31)

LINUX
Linux

WINDOWS
Windows

MAC
MacOS
Choose OS

IBM Developer for z/OS (V15.0) 32-bit 64-bit

IBM Developer for z/OS (V15.0) 32-bit 64-bit

IBM Developer for z/OS (V15.0) 64-bit

IBM Developer for z/OS (V16.0) Download 64-bit

IBM Developer for z/OS (V16.0) Download 64-bit

IBM Developer for z/OS (V16.0) Download 64-bit

IBM Developer for z/OS (V17.0) Not available

IBM Developer for z/OS (V17.0) Download 64-bit

IBM Developer for z/OS (V17.0) Download 64-bit

CICS Explorer 32-bit 64-bit Download 64-bit Not available

CICS Explorer 32-bit 64-bit Download 64-bit Download 64-bit

CICS Explorer Download 64-bit Download 64-bit Download 64-bit

z/OS Explorer 32-bit 64-bit Download 64-bit Not available

z/OS Explorer 32-bit 64-bit Download 64-bit Download 64-bit

z/OS Explorer Download 64-bit Download 64-bit Download 64-bit
- Alternatively, download an instance of Eclipse directly from the official site. (Note: IBM Developer for z/OS V16.0.x does not support direct installation on top of an official Eclipse instance.)
  
  Download Eclipse 4.4
  
  Download Eclipse 4.6

Download the entire p2 repository or individual zip files to host internally

Download the necessary files for hosting the p2 repository from one of the options below:

Entire p2 repository

3.2
Aqua update site package

p2
Eclipse Photon V4.8

Download

3.3
Aqua update site package

p2
Eclipse V4.23

Download

3.4
Aqua update site package

p2
Eclipse V4.31

Download

Individual p2 zip files

Product Name	Download
IBM Explorer for z/OS (required)	N/A
IBM CICS Explorer (required)	N/A
IBM Application Discovery	N/A
IBM Application Performance Analyzer for z/OS	N/A
IBM CICS Configuration Manager	N/A
IBM CICS Deployment Assistant	N/A
IBM CICS Interdependency Analyzer	N/A
IBM CICS Performance Analyzer	N/A
IBM CICS Transaction Gateway	N/A
IBM Debug for z/OS	N/A
IBM Developer for z/OS 14.2.x	N/A
IBM Fault Analyzer for z/OS	N/A
IBM File Manager for z/OS	N/A
IBM IMS Configuration Manager	N/A
IBM IMS Connect Extensions	N/A
IBM Monitoring and Diagnostics Tools - Health Center	N/A
IBM MQ Explorer	N/A
IBM Engineering Workflow Management	N/A
IBM Engineering Workflow Management for z/OS V14.2.x	N/A
IBM z/OS Connect EE	N/A

Individual p2 zip files

Product Name	Download
IBM Explorer for z/OS (required)	N/A
IBM CICS Explorer (required)	N/A
IBM Application Discovery	N/A
IBM Application Performance Analyzer for z/OS	N/A
IBM CICS Configuration Manager	N/A
IBM CICS Deployment Assistant	N/A
IBM CICS Interdependency Analyzer	N/A
IBM CICS Performance Analyzer	N/A
IBM CICS Transaction Gateway	N/A
IBM Debug for z/OS	N/A
IBM Developer for z/OS V15.0.x	N/A
IBM Fault Analyzer for z/OS	N/A
IBM File Manager for z/OS	N/A
IBM IMS Configuration Manager	N/A
IBM IMS Connect Extensions	N/A
IBM Monitoring and Diagnostics Tools - Health Center	N/A
IBM MQ Explorer	N/A
IBM Engineering Workflow Management	N/A
IBM Engineering Workflow Management for z/OS V15.0.x	N/A
IBM Z Open Development	N/A
IBM z/OS Connect EE	N/A
IBM Z JCL Expert	N/A
IBM Z Open Unit Test	N/A

Individual p2 zip files

Product Name	Download
IBM Explorer for z/OS (required)	N/A
IBM CICS Explorer (required)	N/A
IBM Application Discovery	N/A
IBM Application Performance Analyzer for z/OS	N/A
IBM CICS Configuration Manager	N/A
IBM CICS Deployment Assistant	N/A
IBM CICS Interdependency Analyzer	N/A
IBM CICS Performance Analyzer	N/A
IBM CICS Transaction Gateway	N/A
IBM Debug for z/OS	N/A
IBM Developer for z/OS V16.0.x	N/A
IBM Fault Analyzer for z/OS	N/A
IBM File Manager for z/OS	N/A
IBM IMS Configuration Manager	N/A
IBM IMS Connect Extensions	N/A
IBM Monitoring and Diagnostics Tools - Health Center	N/A
IBM MQ Explorer	N/A
IBM Rational Programming Patterns
IBM Engineering Workflow Management	N/A
IBM Engineering Workflow Management for z/OS V15.0.x	N/A
IBM Z Open Development	N/A
IBM z/OS Connect EE	N/A
IBM Z JCL Expert	N/A
IBM Z Open Unit Test	N/A

Individual p2 zip files

Product Name	Download
IBM Application Delivery Foundation for z/OS This package includes the following products: IBM Application Performance Analyzer for z/OS IBM Debug for z/OS IBM Developer for z/OS IBM Fault Analyzer for z/OS IBM File Manager for z/OS
IBM Explorer for z/OS (required)
IBM CICS Explorer (required)
IBM Application Discovery
IBM Application Performance Analyzer for z/OS
IBM CICS Configuration Manager
IBM CICS Deployment Assistant
IBM CICS Interdependency Analyzer
IBM CICS Performance Analyzer
IBM CICS Transaction Gateway
IBM Debug for z/OS
IBM Developer for z/OS V17.0.x
IBM Fault Analyzer for z/OS
IBM File Manager for z/OS
IBM IMS Configuration Manager
IBM IMS Connect Extensions
IBM Monitoring and Diagnostics Tools - Health Center
IBM MQ Explorer
IBM Rational Programming Patterns
IBM Engineering Workflow Management
IBM Engineering Workflow Management for z/OS V17.0.x
IBM z/OS Connect EE
IBM Z JCL Expert

Host the package(s) in a location of your choosing.

Point Eclipse at the locally hosted repository

Important: a workaround is required to install IBM Z Open Development and IBM Rational Team Concert together. Please see this blog post .
Launch Eclipse.
In the menu bar, select 'Help' -> 'Install New Software...'.
In the install dialog, select "Add...".
In the "Add Repository" dialog, select "Archive" and specify the location of your offline installation package.
Select additional products from the list.
Important: IBM Z Open Unit Test is currently only supported on Windows. The following steps are not applicable if the operating system is MacOS or Linux.
Install the following products:

Step 1: choose your products

Step 2: choose an Aqua version

Aqua release train version

What is the difference between the versions of Aqua?

Can I upgrade an Aqua environment directly to another version?

Aqua 3.4

Aqua 3.3

Aqua 3.2

Step 3: choose an installation client

Aqua tools packaging formats

IBM Installation Manager (IM)

Eclipse p2

Making a choice

IBM Installation Manager

IBM Installation Manager

Eclipse p2

Step 4: choose your starting point

Starting from fresh

Extending an existing Installation Manager instance

Hosting an internal Installation Manager repository

Starting from fresh

Extending an existing Eclipse instance

Hosting an internal repository

Download and install

Download and install IBM Installation Manager

Install product offerings through IM

Adding a new online repository to IM

Extending an existing IM installation

Download and install IBM Installation Manager

Use pre-packaged repository zip files to prepare a local repository

Use pre-packaged repository zip files to prepare a local repository

Use pre-packaged repository zip files to prepare a local repository

Add an offline repository to IM

Install product offerings through IM

Downloading and extracting the platform executable

Install additional products

Adding a new online repository to p2

Downloading and installing Eclipse

Download the entire p2 repository or individual zip files to host internally

Point Eclipse at the locally hosted repository

Select Operating System

Windows

MacOS

Linux