Step 1: choose your products

Name Aqua Version Installation Methods
zosexplorer aqua
IBM Explorer for z/OS (z/OS Explorer) is an Eclipse-based integration platform for z/OS users.
3.0, 3.1, 3.2 IM, p2
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.0, 3.1, 3.2 IM, p2
idz rdz adfz
IBM Developer for z Systems 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.0, 3.1 IM
ad
IBM Application Discovery technology makes it faster and easier for developers to understand and develop applications in a DevOps environment.
3.0, 3.1, 3.2 IM, p2
apa zos adfz
IBM Application Performance Analyzer for z/OS measures and reports how applications use available resources.
3.0, 3.1 IM, p2
IBM Application Delivery Foundation for z Systems offers a core set of tools for your team to create and maintain applications for z/OS® environments.
3.1 IM
debugger adfz
IBM Debug for z Systems 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.0, 3.1 IM
cm
IBM CICS Configuration Manager is a tool for administering and maintaining CICS resources.
3.0, 3.1, 3.2 IM, p2
da
IBM CICS Deployment Assistant for z/OS provides a centralized, complete model of your CICS infrastructure to improve data discovery
3.0, 3.1, 3.2 IM, p2
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.0, 3.1, 3.2 IM, p2
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.0, 3.1, 3.2 IM, p2
tg
IBM CICS Transaction Gateway is a connector for enterprise modernization of CICS assets
3.0, 3.1, 3.2 IM, p2
ds
IBM Data Studio provides an integrated, modular environment to enable database development and administration of IBM Db2 for Linux, UNIX and Windows.
3.0, 3.1 IM
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.1 IM, p2
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.0, 3.1, 3.2 IM, p2
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.0, 3.1, 3.2 IM, p2
IBM IMS Explorer for Development is an Eclipse-based graphical tool that can display and edit IMS databases, segments, fields and more.
3.0, 3.1 IM
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.0, 3.1 IM, p2
rtcz
IBM Rational Team Concert Integration for System z provides User Build capability, and local or remote development in a user-specific sandbox environment.
3.1, 3.2 IM, p2
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.0, 3.1, 3.2 IM, p2
rpp
IBM Rational Programming Patterns is a collaborative Integrated Development Environment part of the Jazz™ Collaborative Lifecycle Management solutions.
3.0, 3.1 IM
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.1 IM, p2
cm
IBM IMS Configuration Manager for z/OS is a tool to help analyze and compare IMS configurations.
3.1 IM, p2
rtc
IBM Rational Team Concert manages plans, tasks, project status, as the critical link between required and delivered work.
3.0, 3.1 IM, p2
zod
IBM Z Open Development is an integrated development environment for local development in a user-specific workspace with a modern SCM such has Git. It includes IBM Dependency Based Build (DBB) for build automation capabilities.
3.2 p2
zot zout
IBM Z Open Unit Test is an automated unit testing tool that creates a powerful continuous development, testing, and delivery environment.
3.2 p2

Step 2: choose an Aqua version

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

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.

This version of Aqua is currently not available with IBM Installation Manager and can only be installed through Eclipse p2. For more details, please see this tech note .

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

Aqua 3.1

(Eclipse Neon V4.6)

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

Aqua 3.0

(Eclipse Luna V4.4)

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

Step 3: choose an installation client

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

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.

Eclipse p2

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

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 because one or more products that have been selected are not available for this version of Aqua.

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 Luna V4.6)
3.2
Aqua 3.2 (Eclipse Photon V4.8)
LINUX
Linux
WINDOWS
Windows
MAC
MacOS
Change...
  1. Download, unzip, and install IBM Installation Manager (IM) using one of the following options:
    • User install: InstallerImage_macosx_cocoa_x86_64/UserInst.app
    • Admin install: InstallerImage_macosx_cocoa_x86_64/Install.app or imLauncherMac.sh
    • User install: imLauncherWindowsUser.bat
    • Admin install: imLauncherWindows.bat
    • User install: imLauncherLinuxUser.sh
    • Admin install: imLauncherLinux.sh
  2. Restart IM after the installation has completed.

Install product offerings through IM

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

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

    1. Launch IBM Installation Manager.
    2. In the menu bar, select 'File' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
    3. In the menu bar, select 'IBM Installation Manager' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
    4. In the menu bar, select 'File' -> 'Preferences...', select the 'Repositories' tab, and select 'Add Repository'.
    5. 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/
    6. 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

    1. In Installation Manager, click Install to view and select product offering(s) for installation.
    2. Select the following products:
      • Review and accept the licenses.
      • On the following screen select the "Use the existing package group" radial button.
        Extending an existing IM installation
      • 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 Luna V4.6)
      3.2
      Aqua 3.2 (Eclipse Photon V4.8)
      LINUX
      Linux
      WINDOWS
      Windows
      MAC
      MacOS
      Change...
      1. Download, unzip, and install IBM Installation Manager (IM) using one of the following options:
        • User install: InstallerImage_macosx_cocoa_x86_64/UserInst.app
        • Admin install: InstallerImage_macosx_cocoa_x86_64/Install.app or imLauncherMac.sh
        • User install: imLauncherWindowsUser.bat
        • Admin install: imLauncherWindows.bat
        • User install: imLauncherLinuxUser.sh
        • Admin install: imLauncherLinux.sh
      2. Restart IM after the installation has completed.

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

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

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

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

      Add an offline repository to IM

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

      Install product offerings through IM

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

      2. 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 Luna V4.6)
        3.2
        Aqua 3.2 (Eclipse Photon V4.8)
        LINUX
        Linux
        WINDOWS
        Windows
        MAC
        MacOS
        Change...
        IBM Z Open Development 32-bit 64-bit
        IBM Z Open Development 32-bit 64-bit
        IBM Z Open Development Download 64-bit
        1. Download and extract the package to a location of your choosing.
          • 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.
        2. 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?
        3. 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".
        4. 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

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

          1. Launch Eclipse.
          2. In the menu bar, select 'Help' -> 'Install New Software...'.
          3. In the install dialog, select "Add...".
          4. 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/
          5. At the bottom of the window, enable the checkbox 'Group items by category' to view the list of all individual products.
          6. Important: a workaround is required to install IBM Z Open Development and IBM Rational Team Concert together. Please see this blog post .
          7. Select additional products from the list.
          8. Install the following products:
            • Review and complete the remaining steps in the install wizard.
            If your existing Eclipse was packaged with a version of RSE (Remote System Explorer), you may run into a version conflict during installation.
            • To resolve this 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.

            1. Download an instance of Eclipse from the Aqua release train.
              3.0
              Aqua 3.0 (Eclipse Luna V4.4)
              3.1
              Aqua 3.1 (Eclipse Luna V4.6)
              3.2
              Aqua 3.2 (Eclipse Photon V4.8)
              LINUX
              Linux
              WINDOWS
              Windows
              MAC
              MacOS
              Change...
              IBM Z Open Development 32-bit 64-bit
              IBM Z Open Development 32-bit 64-bit
              IBM Z Open Development Download 64-bit

            Download the entire p2 repository to host internally

            1. Download the following installation package:
              3.0
              Aqua update site package
              p2
              Eclipse Luna V4.4
              3.1
              Aqua update site package
              p2
              Eclipse Neon V4.6
              3.2
              Aqua update site package
              p2
              Eclipse Photon V4.8
            2. Host this package in a location of your choosing.

            Point Eclipse at the locally hosted repository

            1. Important: a workaround is required to install IBM Z Open Development and IBM Rational Team Concert together. Please see this blog post .
            2. Launch Eclipse.
            3. In the menu bar, select 'Help' -> 'Install New Software...'.
            4. In the install dialog, select "Add...".
            5. In the "Add Repository" dialog, select "Archive" and specify the location of your offline installation package.
            6. Select additional products from the list.
            7. Install the following products:

              Select Operating System

              Windows

              MacOS

              Linux