Getting started

To install one or more product offerings under IBM Explorer for z/OS Aqua, use the table below to determine which installation options (IBM Installation Manager and/or Eclipse p2) are available for the specific product you're looking for.

Product Name Client (IBM IM) Client (Eclipse p2) Server Trial Documentation
IBM Application Discoveryad
IBM Application Performance Analyzer for z/OS apa adfz
IBM CICS Explorer cicsexplorer
IBM CICS Transaction Gateway tg
IBM CICS Configuration Manager cm
IBM CICS Deployment Assistant da
IBM CICS Interdependency Analyzer ia
IBM CICS Performance Analyzer pa
IBM Data Studio[1] ds
IBM Debug for z Systemsdebugger adfz
IBM Developer for z Systems (IDz)rdz adfz
IBM Fault Analyzer for z/OSfa adfz
IBM File Manager for z/OSfm adfz
IBM IMS Explorer for Development (V3.2/V3.3)
IBM MQ Explorer[1]
IBM Rational Team Concert (RTC)
IBM z/OS Connect EE (V2/V3) enterprise edition zos
IBM Explorer for z/OS zosexplorer explorer aqua
IBM Rational Programming Patterns[2] rpp

  • All products are supported on Eclipse Luna V4.4 and Eclipse Neon V4.6 unless indicated otherwise
  • [1] This product is only supported on Eclipse Luna V4.4
  • [2] This product is only supported on Eclipse Neon V4.6

[1] Recommended for enterprise deployment


IBM Installation Manager (IM)

Install a new Installation Manager for online product installation

Install options Windows (32/64-bit) Linux (32/64-bit) MacOS (64-bit)
IM for z/OS Explorer Aqua V3.0
(Eclipse Luna V4.4)
IM for z/OS Explorer Aqua V3.1
(Eclipse Neon V4.6)

  1. Download one of the installation packages
  2. Unzip and install IBM Installation Manager (IM) using one of the following options.

    Operating System User Install Administrator Install
    Windows imLauncherWindowsUser.bat imLauncherWindows.bat
    Linux imLauncherLinuxUser.sh imLauncherLinux.sh
    OS X InstallerImage_macosx_cocoa_x86_64/Userinst.app InstallerImage_macosx_cocoa_x86_64/Install.app or imLauncherMac.sh
    • User Install uses the home directory of the current user
    • Administrator Install requires administrative privileges and typically uses a common install directory that is accessible to all users
  3. Restart IM after installation
  4. In IM, click Install to view and select product offering(s) for installation

Other installation options including silent and group installation are detailed in IBM Installation Manager documentation under Installing as an administrator, nonadministrator, or group together with a full list of the installation locations for each operating system.

If you are planning deployment to many systems at once consult Using IBM Installation Manager for Enterprise Deployment.


Use an existing Installation Manager for online product installation

  1. Update IBM Installation Manager to version 1.8.5.1 or later - for more information, please refer to this tech note
  2. Launch IBM Installation Manager
  3. Click File → Preferences → Add Repository
  4. Add the applicable repository URL:
    • z/OS Explorer Aqua V3.0 (Eclipse Luna V4.4) http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua/
    • z/OS Explorer Aqua V3.1 (Eclipse Neon V4.6) http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/
    • Your local product repository file path for offline installation, for example C:\my-local-IM-repository\repository.config
  5. Click Install to view and select product offering(s) for installation

For Rational Developer for z Systems (RDz) users, you may directly upgrade RDz V9.5.x to IDz V14 using IM. However, if you are currently using RDz V8.0, 9.0 or 9.1, you must perform a fresh installation of IDz V14 after you have uninstalled RDz. For more information, please refer to the blog “Where oh where has RDz gone?”.

- To install IBM Debug for z Systems, you will need to select the IBM Developer for z Systems offering. More details can be found here: Installing IBM Debug for z Systems.

- If you are using an earlier version of installation manager it is recommended you upgrade to the latest version. More details can be found here: Installing or updating Installation Manager


Download product repositories for offline installation

    In an online environment, use IBM Packaging Utility to prepare a custom IM repository to be hosted on your local file system for offline product installation by following the steps below:
  1. Download and install IBM Packaging Utility.
    • Optionally, if you do not have an existing IM, proceed to download the IM installation package from here and follow the instructions to install IM.
  2. Launch IBM Packaging Utility and select "Open Packages"
  3. Click on “Open Repository” and add the applicable repository URL into the field:
    • z/OS Explorer Aqua V3.0 (Eclipse Luna V4.4) http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua/
    • z/OS Explorer Aqua V3.1 (Eclipse Neon V4.6) http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/
  4. Select the offerings that you wish to include in your customized repository package
  5. Click “Next” and then specify the directory of your customized repository, click “Copy” to confirm and begin the operation
  6. Once the operation has been completed, compress the directory into a zip file which can then be transferred to the offline environment
    In an offline environment, you may now proceed with the installation:
  1. Extract the zip file into a directory
  2. Proceed with installing products from your local repositories downloaded using IBM Packaging Utility by following the instructions here. Remember to add the file path of your local product repositories to IM

Eclipse (p2)

Download a full version of the explorer platform for online product installation

Download the Eclipse package for IBM Explorer for z/OS Aqua release by selecting one of the following platforms and architectures and perform the following steps to install the product:

Eclipse Luna V4.4

Install Options Windows (32-bit) Windows (64-bit) Linux (32-bit) Linux (64-bit) MacOS (64-bit)
IBM Explorer for z/OS V3.0
IBM CICS Explorer V5.3

Eclipse Neon V4.6

Install Options Windows (32-bit) Windows (64-bit) Linux (32-bit) Linux (64-bit) MacOS (64-bit)
IBM Explorer for z/OS V3.1
IBM CICS Explorer V5.4
  1. Unzip and start using IBM Explorer for z/OS
  2. (Optional) To install one or more features from the Eclipse p2 update site for IBM Explorer for z/OS Aqua release
    • Click Help → Install New Software → Add
    • Select to work with “IBM Explorer for z/OS Update site”
    • Select and install one or more available installation packages or features

Use an existing Eclipse for online product installation

If you have an existing instance of Eclipse (Luna V4.4 or Neon V4.6), perform the following steps to add the Eclipse p2 update site for IBM Explorer for z/OS Aqua release:

  1. Launch Eclipse
  2. Click Help → Install New Software → Add
  3. Add the applicable repository URL:
    • z/OS Explorer Aqua V3.0 (Eclipse Luna V4.4) http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua/
    • z/OS Explorer Aqua V3.1 (Eclipse Neon V4.6) http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/
  4. At the bottom of the window, enable the checkbox for "Group items by category" to view the list of all individual features
  5. Select and install one or more available installation packages or features by following the provided steps

Download product p2 update sites for offline installation

Users who are looking to perform offline installations through Eclipse p2 can do so by downloading the update site package below:


Install options Included offerings Download
z/OS Explorer Aqua V3.0 update site package
(Eclipse Luna V4.4)
  • IBM Application Discovery
  • IBM Application Performance Analyzer for z/OS
  • IBM CICS Configuration Manager
  • IBM CICS Deployment Assistant
  • IBM CICS Explorer
  • IBM CICS Interdependency Analyzer
  • IBM CICS Performance Analyzer
  • IBM CICS Transaction Gateway
  • IBM Explorer for z/OS
  • IBM Fault Analyzer for z/OS
  • IBM File Manager for z/OS
  • IBM MQ Explorer
  • IBM Rational Team Concert
  • IBM z/OS Connect EE (V2)
z/OS Explorer Aqua V3.1 update site package
(Eclipse Neon V4.6)
  • IBM Application Discovery
  • IBM Application Performance Analyzer for z/OS
  • IBM CICS Configuration Manager
  • IBM CICS Deployment Assistant
  • IBM CICS Explorer
  • IBM CICS Interdependency Analyzer
  • IBM CICS Performance Analyzer
  • IBM CICS Transaction Gateway
  • IBM Explorer for z/OS
  • IBM Fault Analyzer for z/OS
  • IBM File Manager for z/OS
  • IBM Rational Team Concert
  • IBM z/OS Connect EE (V3)

For a detailed guide on how proceed with offline installation through Eclipse p2, please see this blog post: Deploying IBM z/OS Explorer Aqua to users without internet access.