Silent installation

You can run a silent P2 installation of IBM® Developer for z/OS® and its activation kit from a command-line interface on Windows or macOS platforms. This procedure explains how to install Developer for z/OS into z/OS Explorer by using a silent installation process using the Eclipse p2 director application.

Before you begin

To install IBM Developer for z/OS in silent mode from a command line interface, you must know the full path name of the location where the zosexplorerc.exe file (Windows) or the Zosexplorer application (macOS) is installed, for example:

Windows: C:\Program Files\IBM\zOS_Explorer\zosexplorerc.exe

macOS: \Applications\Zosexplorer.app\contents\macOS\zosexplorer

In the sample commands in the following instructions, replace the file path names for the z/OS Explorer command with the path where you installed z/OS Explorer. Replace the repository file names and license file names with the correct file names for the version you are installing.

About this task

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

Installing on Windows

Procedure

  1. To install the product, open a command prompt and run the following command. This sample command is formatted for easier reading. The command does not execute in this format. To execute the command, you must ensure it contains no line feeds and that the -installIU parameter contains no spaces. 
    
c:\zos_Explorer\zosexplorer\zosexplorerc.exe 
  -application org.eclipse.equinox.p2.director 
  -installIU com.ibm.developer.for.zos.product.feature.feature.group,
   com.ibm.idz.categories.cics.tools.feature.feature.group,
   com.ibm.idz.categories.cics.tools.feature.nl0.feature.group,
   com.ibm.idz.categories.code.review.features.feature.group,
   com.ibm.idz.categories.code.review.features.nl0.feature.group,
   com.ibm.idz.categories.core.feature.feature.group,
   com.ibm.idz.categories.core.feature.nl0.feature.group,
   com.ibm.idz.categories.headless.cc.feature.feature.group,
   com.ibm.idz.categories.ims.tools.feature.feature.group,
   com.ibm.idz.categories.ims.tools.feature.nl0.feature.group,
   com.ibm.idz.categories.j2c.feature.feature.group,
   com.ibm.idz.categories.j2c.feature.nl0.feature.group,
   com.ibm.idz.categories.systems.code.gen.feature.feature.group,
   com.ibm.idz.categories.systems.code.gen.feature.nl0.feature.group,
   com.ibm.idz.categories.team.dbb.feature.feature.group,
   com.ibm.idz.categories.team.dbb.feature.nl0.feature.group,
   com.ibm.idz.categories.team.egit.feature.feature.group,
   com.ibm.idz.categories.team.egit.feature.nl0.feature.group,
   com.ibm.idz.categories.team.endevor.feature.feature.group,
   com.ibm.idz.categories.team.endevor.feature.nl0.feature.group,
  -repository https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.4/
  > output.log
    Note: To install from a local zip file of the update site, specify the repository parameter in the following format:
    -repository jar:file:/C:/temp/idz-update-site.zip!/
    This command writes results similar to the following example in the output.log file:
    
Installing com.ibm.developer.for.zos.product.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.cics.tools.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.cics.tools.feature.nl0.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.code.review.features.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.code.review.features.nl0.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.core.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.core.feature.nl0.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.headless.cc.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.ims.tools.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.ims.tools.feature.nl0.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.j2c.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.j2c.feature.nl0.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.systems.code.gen.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.systems.code.gen.feature.nl0.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.team.dbb.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.team.dbb.feature.nl0.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.team.egit.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.team.egit.feature.nl0.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.team.endevor.feature.feature.group 16.0.2.202306121415.
Installing com.ibm.idz.categories.team.endevor.feature.nl0.feature.group 16.0.2.202306121415.
Operation completed in 237804 ms.
  2. To install the product activation kit from a local file, run the following command. This command is formatted for easier reading. The command does not execute in this format. To execute the command, you must ensure it contains no line feeds and that it refers to the correct license file name. 
    
C:\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.perm.lumkit.feature.feature.group -noSplash
    This command results in output similar to the following example:
    
Installing com.ibm.idz.lum.kit.permanent.feature.feature.group v.r.m.date_time_stamp.
Operation completed in 56687 ms.

Installing on macOS

Procedure

  1. To install the product, open a terminal and run the Zosexplorer.app command. This sample command is formatted for easier reading. The command does not execute in this format. To execute the command, you must ensure it contains no line feeds and that the -installIU parameter contains no spaces. 
     /Applications/Zosexplorer.app/Contents/macOS/Zosexplorer 
  -application org.eclipse.equinox.p2.director 
  -installIU com.ibm.developer.for.zos.product.feature.feature.group,
   com.ibm.idz.categories.cics.tools.feature.feature.group,
   com.ibm.idz.categories.cics.tools.feature.nl0.feature.group,
   com.ibm.idz.categories.code.review.features.feature.group,
   com.ibm.idz.categories.code.review.features.nl0.feature.group,
   com.ibm.idz.categories.core.feature.feature.group,
   com.ibm.idz.categories.core.feature.nl0.feature.group,
   com.ibm.idz.categories.headless.cc.feature.feature.group,
   com.ibm.idz.categories.ims.tools.feature.feature.group,
   com.ibm.idz.categories.ims.tools.feature.nl0.feature.group,
   com.ibm.idz.categories.j2c.feature.feature.group,
   com.ibm.idz.categories.j2c.feature.nl0.feature.group,
   com.ibm.idz.categories.systems.code.gen.feature.feature.group,
   com.ibm.idz.categories.systems.code.gen.feature.nl0.feature.group,
   com.ibm.idz.categories.team.dbb.feature.feature.group,
   com.ibm.idz.categories.team.dbb.feature.nl0.feature.group,
   com.ibm.idz.categories.team.egit.feature.feature.group,
   com.ibm.idz.categories.team.egit.feature.nl0.feature.group,
   com.ibm.idz.categories.team.endevor.feature.feature.group,
   com.ibm.idz.categories.team.endevor.feature.nl0.feature.group,
  -repository https://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.4/
  > output.log
    Note: To install from a local zip file of the update site, specify the repository parameter in the following format. Replace <username> with the username on the system where the command is run and the update site file name with the correct file name for the version you are installing.
    -repository 'jar:file:/Users/<username>/Downloads/idz-v.r.m.update.site.zip!/'
  2. To install a permanent license from a local zip file, run the following command. This command is formatted for easier reading. The command does not execute in this format. To execute the command, you must ensure it contains no line feeds and that it contains the correct license file name. 
    
/Applications/Zosexplorer.app/Contents/macOS/Zosexplorer  
-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!/'