Getting started

Select one of the following methods to install IBM Explorer for z/OS Aqua product offerings.

[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
IBM CICS Explorer

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
IBM CICS Explorer
  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

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. Select and install one or more available installation packages 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 Download
z/OS Explorer Aqua V3.0 update site package
(Eclipse Luna V4.4)
z/OS Explorer Aqua V3.1 update site package
(Eclipse Neon V4.6)

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.