Silent installation

You can run a silent installation of IBM® Developer for z/OS® using the Eclipse P2 Director tool, from a command-line interface on Windows or macOS platforms. This method allows you to install the product and optional Aqua tools without any UI interaction.

For information about setting up and running a silent installation by using IBM Installation Manager, refer to Working in silent mode.

For more information about installing software by using the Eclipse P2 director application, see the Eclipse documentation at Eclipse p2 director.

Before you begin

The following are required to run a silent installation:

Download the latest IBM Developer for z/OS P2 ZIP archive (for your operating system platform) from the IBM Mainframe Aqua site.
Choose your update site source:
- Remote (online): Use the Aqua public update site.
- Local (offline or air-gapped): Download the Aqua update-site package ZIP for internal hosting.

Select a launcher path on the basis of your preferred platform:

Platform	Example of launcher location
Windows	`{extraction_directory}\IBM Developer for zOS\developer_for_zosc.exe`
macOS	`/{extraction_directory}/IBM Developer for zOS.app/Contents/MacOS/developer_for_zos`

Procedure

To install the product, use one of the following examples based on your environment: Windows Batch, Windows PowerShell, or macOS shell.

Each example displays how to run a silent installation of IBM Developer for z/OS using the Eclipse P2 director application. These scripts install the main products:

File Manager
Application Performance Analyzer
MQ Explorer
z/OS Connect
IBM Watsonx Code Assistant for Z

Example on Windows batch

@echo off
REM Navigate to where IDz was unzipped
cd "C:\IDz\IBM Developer for zOS\"

REM Use p2 director to install Aqua products on IDz
developer_for_zosc.exe ^
  -application org.eclipse.equinox.p2.director ^
  -consoleLog ^
  -debug ^
  -installIU com.ibm.etools.fm.ui.feature.feature.group,^
com.banknet.apa.pdtools.plugin.feature.feature.group,^
com.ibm.mq.explorer.feature.feature.group,^
com.ibm.mq.explorer.feature.nl1.feature.group,^
com.ibm.systemz.wcaz.main.feature.feature.group,^
com.ibm.systemz.wcaz4e.cshelp.feature.feature.group,^
com.ibm.zosconnect.ui.feature.feature.group ^
  -repository https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.4/ ^
  -noSplash ^
  > output.log
pause

Example on Windows PowerShell


# Define variables
$downloadsDir = "C:\Users\Username\Downloads\"
$p2Dir = "C:\IDz\IBM Developer for zOS\"
$p2UpdateSite = "aqua3.4_all_update_site.zip"

Write-Host "===> Starting the silent install process."

# Navigate to where IDz was unzipped
Set-Location $p2Dir

# Use p2 director to install products
$repoLocation = $downloadsDir + $p2UpdateSite

# File Manager
.\developer_for_zosc.exe -application org.eclipse.equinox.p2.director -repository jar:file:/$repoLocation!/ -installIU com.ibm.etools.fm.ui.feature.feature.group -noSplash

# Application Performance Analyzer
.\developer_for_zosc.exe -application org.eclipse.equinox.p2.director -repository jar:file:/$repoLocation!/ -installIU com.banknet.apa.pdtools.plugin.feature.feature.group -noSplash

# MQ Explorer
.\developer_for_zosc.exe -application org.eclipse.equinox.p2.director -repository jar:file:/$repoLocation!/ -installIU "com.ibm.mq.explorer.feature.feature.group,com.ibm.mq.explorer.feature.nl1.feature.group" -noSplash

# IBM Watsonx Code Assistant for Z
.\developer_for_zosc.exe -application org.eclipse.equinox.p2.director -repository jar:file:/$repoLocation!/ -installIU "com.ibm.systemz.wcaz.main.feature.feature.group,com.ibm.systemz.wcaz4e.cshelp.feature.feature.group" -noSplash

# z/OS Connect
.\developer_for_zosc.exe -application org.eclipse.equinox.p2.director -repository jar:file:/$repoLocation!/ -installIU com.ibm.zosconnect.ui.feature.feature.group -noSplash

# Finish message
Write-Host "===> The silent install process has completed."

Example on macOS shell

#!/bin/bash

"/Applications/IBM Developer for zOS.app/Contents/MacOS/developer_for_zos" \
  -application org.eclipse.equinox.p2.director \
  -installIU \
com.ibm.etools.fm.ui.feature.feature.group,\
com.banknet.apa.pdtools.plugin.feature.feature.group,\
com.ibm.mq.explorer.feature.feature.group,\
com.ibm.mq.explorer.feature.nl1.feature.group,\
com.ibm.systemz.wcaz.main.feature.feature.group,\
com.ibm.systemz.wcaz4e.cshelp.feature.feature.group,\
com.ibm.zosconnect.ui.feature.feature.group \
  -repository 'https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.4/' \
  -noSplash

Remember:

Feature identifiers end with .feature.group, which designates them as an Installable Unit in the Eclipse P2 system. See IBM Aqua 3.4 Products Features for the complete list of available features.
When selecting a product to include in your silent installation script, you can specify individual features. However, to simplify the process and ensure compatibility, it is recommended to include all associated features provided with the product.
Repository format:
- For a remote repository, just use the Aqua update-site URL directly.
- For a local ZIP, use:
```
jar:file:/<path_to_aqua_update_site_zip>!/
```
Launcher:
- On Windows, use developer_for_zosc.exe (the c indicates the console version).
- On macOS, run the executable found inside the app bundle.
Ensure correct line breaks and spacing when writing installation scripts. In Windows batch files, use a caret (^) to continue a command on the next line. In UNIX-based shell scripts, use a backslash (\) for line continuation. Incorrect formatting may result in command execution errors or misinterpretation during installation.

Installing the permanent activation kit

You can install the product activation kit using the same P2 director command structure displayed in previous examples. The process is the same for both Windows and macOS, only the path and executable differ.

Example (Windows)


{extraction_directory}:\IBM Developer for zOS>developer_for_zosc.exe ^ 
-application org.eclipse.equinox.p2.director ^
-repository jar:file:///C:/temp/IDzxxx_P2_PermanentLicense.zip!/ ^
-installIU com.ibm.idz.lum.kit.permanent.feature.feature.group ^
-noSplash

Example (macOS)


"/Applications/IBM Developer for zOS.app/Contents/MacOS/developer_for_zos" \  
-application org.eclipse.equinox.p2.director \
-installIU com.ibm.idz.lum.kit.permanent.feature.feature.group \
-repository "jar:file:///Users/Downloads/IIDzxxx_P2_PermanentLicense.zip!/" \
-noSplash