Installing in Silent Mode

Installing Z and I Emulator for Web using silent mode with use of command line Silent argument. For more information refer the below table.
Note:
  1. Z/OS ISPF shell prompt supports only silent installation.
  2. If installer.properties files exists on setup file path, installer automatically takes the input from properties file.

Silent installation the user needs to update the installer.properties files with proper input.

Find the following table for Silent installation, the user needs to update the installer.properties files with proper input.

Table 1. Silent Mode Requirements
OS Type Command More Information
Windows HCL Z and I Emulator for Web ZIEWeb_Windows_x64.exe -i silent -f installer.properties Administrator user Command Prompt
Deployment Wizard ZIEWeb_DW_Windows_x64.exe -i silent -f installer.properties Administrator user Command Prompt
HACL Tool kit ZIEWeb_HACL_Windows_x64.exe -i silent -f installer.properties Administrator user Command Prompt
AIX Z and I Emulator for Web sh ./setup.bin -i silent -f installer.properties Root user Terminal client
Linux Z and I Emulator for Web sh ./setup.bin -i silent -f installer.properties Root user Terminal client
Ubuntu Z and I Emulator for Web sh ./setup.bin -i silent -f installer.properties Root user Terminal client
I5/OS Z and I Emulator for Web Java -jar HCL_ZIEWeb_os400.jar -i silent -f installer.properties Root (qsh) shell Prompt
Z/OS Z and I Emulator for Web Java -jar HCL_ZIEWeb_os400.jar -i silent -f installer.properties Root user account OMVS or ISPF shell prompt
  1. Z and I Emulator for Web Silent installer property ZIEWeb_JRE_HOME is applicable only for I5/OS, Z/OS, and Linux PPC Big Endian operating systems, for other supporting operating system this properties will not consider by installer, JAVA JRE supports form 1.8 and above releases.
  2. Z and I Emulator for Web installation logs are stored in the user’s temporary path (%temp%\HCL_HCL_ZIEWeb\Logs). The Log File format with the product name and time stamp is stored.
  3. GUI input validation are logged in logged file and displays the error messages.
  4. Silent variable inputs are validated, and Errors, Warning and Information logs are logged on log file.
  5. If user provided installation folder which is already exists, it throws an error message: "The installation folder C\program Files\HCL\ZIEForWeb_2.1.0.0 exists and contains files".
  6. Z and I Emulator for Web does not support Repair and Modify installation.
  7. Z and I Emulator for Web Silent installer properties file, if the user specifies IM_UPGRADE_SUPPORT=0, then the HCL Z and I Emulator for Web 2.0 is installed as a New Instance.

    If the user specifies IM_UPGRADE_SUPPORT=1 and IM_PRODUCT_NAME=Z and I Emulator for Web 2.0 (C:\\Program Files\\HCL\\ZIEForWeb). Then, the HCL Z and I Emulator for Web 2.0 performs migrate installation.

Silent Installation Using Command-Line Arguments

Installing Z and I Emulator for Web using silent mode with use of command line Silent argument. For more information refer the below table.

  • To install the HCL Z and I Emulator for Web on Z/OS and I5/OS in Silent mode, use the following command in the terminal.

    Command: java -jar <file name> -i silent -DMI_SUPPORT=0 -DMI_PRODUCT_NAME="HCL Z and I Emulator for Web New Instance" -DIM_UPGRARE_SUPPORT=0 -DUSER_INSTALL_DIR=/opt/HCL/Z and I Emulator for Web_16.0.0.0 -DZIEWEB_JRE_HOME=/usr/lpp/java/J11.0_64 -DPUBLISH_ALIAS_NAME=ZIEWEB -DPUBLISH_DIR=ZIEWEB -DPUBLISH_PORT=8999 -DWS_TYPE=4 -DAPP_SERVER_SELECTED=0

  • To install HCL Z and I Emulator for Web on windows in Silent mode, use the following command in the terminal.

    Command: ZIEWEB_Windows_x64.exe -i silent -DMI_SUPPORT=0 -DMI_PRODUCT_NAME="HCL Z and I Emulator for Web New Instance" -DIM_UPGRADE_SUPPORT=0 -DPUBLISH_ALIAS_NAME=ZIEWEB -DPUBLISH_DIR=ZIEWEB -DPUBLISH_PORT=8999 -DPUBLISH_SECURE_PORT=9001 -DWS_TYPE=4 -DAPP_SERVER_SELECTED=0 -DZIEWEBCLIENT_SUPPORT=0 -DLM_SUPPORT=0

  • To install the HCL Z and I Emulator for Web on AIX, Linux and Ubuntu in Silent mode, use the following command in the terminal.

    Command: sh ./setup.bin -i silent -DMI_SUPPORT=0 -DMI_PRODUCT_NAME="HCL Z and I Emulator for Web New Instance" -DIM_UPGRADE_SUPPORT=0 -DPUBLISH_ALIAS_NAME=ZIEWEB -DPUBLISH_DIR=ZIEWEB -DPUBLISH_PORT=8999 -DPUBLISH_SECURE_PORT=9001 -DWS_TYPE=4 -DAPP_SERVER_SELECTED=0 -DZIEWEBCLIENT_SUPPORT=0 -DLM_SUPPORT=0

Table 2. Explanation of Parameters
Parameter Description
-i silent Executes the installation in silent mode.
-DMI_SUPPORT=0 Specifies single or multiple instance support: 0 for single instance, 1 for multiple or upgrade instance support.
-DMI_PRODUCT_NAME

Specify Product Name to install as New instance or Upgrade Instance

# For Upgrade instance Product name with Version # MI_PRODUCT_NAME=HCL Z and I Emulator for Web 15.0.2.0

# For Multiple/New Instance support

# MI_PRODUCT_NAME=HCL Z and I Emulator for Web New Instance

-DUSER_INSTALL_DIR Specifies the directory where Z and I Emulator for Web should be installed.
-DZIEWEB_JRE_HOME Path to the Java Runtime Environment (JRE) that Z and I Emulator for Web will use.
-DAPP_SERVER_SELECTED=0 Specifies that no application server is selected.
-DIM_UPGRARE_SUPPORT=0 If the user specifies IM_UPGRADE_SUPPORT=0, then the HCL Z and I Emulator for Web 16.0 is installed as a New Instance.
DIM_PRODUCT_NAME Specifies product name
DCHOSEN_INSTALL_SET=Custom Specifies custom languages installation set.
DCHOSEN_FEATURE_LIST Specifies list of languages.
DPUBLISH_ALIAS_NAME Publish alias Name
DPUBLISH_DIR=ZIEWEB Publish Director name to install publish files
DPUBLISH_PORT=8999 Publish Port
DPUBLISH_SECURE_PORT=9001 Publish secure Port
DWS_TYPE=1 HCL Z and I Emulator for Web Web Server Configuration.

Web Server Type

1 -> Embedded Web server Type

2 -> Detected Web server Type

3 -> Manually select specific Web server Type

4 -> No Web server Type

DWS_PORT=8080 Web Server Port
DWS_SSL_PORT=8443 Web Server SSL Port
DWS_DTD_SERVER_TYPE=IIS Supported Web Server are APACHE or IIS
DWS_DTD_IIS_APPNAME=Default Web Site If IIS Webserver type then specify ISS Website Name
DWEB_SERVER_CONFIG_FILE If Apache is selected for installation need to specify apache installed Config Path.
DWS_MAN_SERVER_TYPE=1

Manual specify web server Type HCL Z and I Emulator for Web Installation

1 -> Apache HTTP Server 2.2 or newer

2 -> HCL HTTP Server 8.5 or newer

DWS_MAN_CONFIG_FILE If Apache or HTTP Server is selected for installation need to specify Server Config Path
DAPP_SERVER_SELECTED=0 HCL WebSphere Application Server Configuration

0 -> without Application Server Configuration

1 -> To Configure WAS Application Server

DAPP_SERVER=HCL WebSphere Application Server V9.0 Application Server Name
DWAS_PROFILE=AppSrv01 Application server Profile Name
DWAS_SERVER=Server1 WAS Server Name
DZIEWEBCLIENT_SUPPORT=0

Z and I Emulator for Web Client Application Server Configuration

0 -> without Z and I Emulator for Web Client Configuration

1 -> To Configure Z and I Emulator for Web Client Configuration

DZIEWEBCLIENT_SERVERTYPE=1

Z and I Emulator for Web Client Application Server Configuration

1 -> Embedded Server

2 -> HCL WebSphere Application Server

3 -> Manually select specific Web Server

DZIEWEBCLIENT_WAS_APPSERVER=HCL WebSphere Application Server V9.0 Application Server Name
DZIEWEBCLIENT_WAS_PROFILE=AppSrv01 Application server Profile Name
DZIEWEBCLIENT_WAS_PROFILE_SERVER=Server1 WAS Server Name
DZIEWEBCLIENT_MAN_SERVERTYPE=1

Z and I Emulator for Web Client Manually select specific Web Server

1 -> Tomcat Apache Server

2 -> HCL Liberty WebSphere Server

DZIEWEBCLIENT_MAN_SERVERPATH=C:\\Program Files\\Tomcat9.0

For Tomcat Apache Server installation path should be define up to Parent folder of WebApps

  • ZIEWEBCLIENT_MAN_SERVERPATH=C:\Program Files\Tomcat9.0

For BM Liberty WebSphere Server installation path should be define up to Parent folder of bin

  • ZIEWEBCLIENT_MAN_SERVERPATH=C:\Program Files\HCL Liberty
DZIEWEBCLIENT_WEBSERVER_PORT=8080 Z and I Emulator for Web Configured WebServer port to communicate with Z and I Emulator for Web Client Application Server
DZIEWEBCLIENT_APPSERVER_PORT=8080 ZIEWEBCLIENT Application Server Port
DODCLIENT_APPSERVER_SECUREPORT=8443 ZIEWEBCLIENT Application Server Secure Port
DZIEWEBCLIENT_MAX_POOL_SIZE=100 ZIEWEBCLIENT Max Pool Size accepts only integer value
DZIEWEBCLIENT_BUFFER_SIZE=4096 ZIEWEBCLIENT Buffer Size accepts only integer value
DZIEWEBCLIENT_CONTEXT_ROOT=zieweb ZIEWEBCLIENT War file will be deployed based on ZIEWEBCLIENT_CONTEXT_ROOT value
DZIEWEBCLIENT_CONFIG_TRACE=false Z and I Emulator for Web Client Config trace accepted values true or false
DZIEWEBCLIENT_SHOW_STATUS=false Z and I Emulator for Web Client Show Status accepted values true or false
DZIEWEBCLIENT_MAP_FILE=false Z and I Emulator for Web Client Map File accepted values true or false
DZIEWEBCLIENT_ZFP_TRACE=false Z and I Emulator for Web Client ZFP trace accepted values true or false
DLM_SUPPORT=0

License Manager Application Server Configuration

0 -> without License Manager Configuration

1 -> To Configure License Manager Configuration

DLM_SERVERTYPE=1

License Manager Application Server Configuration

1 -> Embedded Server

2 -> HCL WebSphere Application Server

3 -> Manually select specific Web Server

DLM_WAS_APPSERVER=HCL WebSphere Application Server V9.0 Application Server Name
DLM_WAS_PROFILE=AppSrv01 Application server Profile Name
DLM_WAS_PROFILE_SERVER=Server1 WAS Server Name
DLM_MAN_SERVERTYPE=1

License Manager Manually select specific Web Server

1 -> Tomcat Apache Server

2 -> HCL Liberty WebSphere Server

DLM_MAN_SERVERPATH=C:\\Program Files\\Tomcat9.0

For Tomcat Apache Server instalaltion path should be define upto Parent folder of WebApps

  • LM_MAN_SERVERPATH=C:\\Program Files\\Tomcat9.0

For BM Liberty WebSphere Server instalaltion path should be define upto Parent folder of bin

  • LM_MAN_SERVERPATH=C:\\Program Files\\HCL Liberty
DLM_APPSERVER_PORT=8080 License Manager Application Server Port
DLM_APPSERVER_SECUREPORT=8443 License Manager Application Server Secure Port
DLM_CONTEXT_ROOT=LicenseManager License Manager War file will be deployed based on LM_CONTEXT_ROOT value
DLM_PCOMM=true License Manager PCOMM Enablement accepted values true or false
DLM_ZIEWEB=true License Manager ZIEWEB Enablement accepted values true or false
DLM_FILEPATH=C:\\Users\\Admin License Manager License file Path
DLM_TRACE_LEVEL=INFO License Manager trace Level accepted values "DEBUG", "INFO", "ALL", "TRACE", "WARN", "ERROR", "FATAL", "OFF"
DLM_DB_SERVER=H2 License Manager Database Server accepted values "H2", "SQLITE", "MYSQL", "DB2"
DLM_DB_DRIVER=org.h2.Driver License Manager Database Driver; Database Driver applicable for "MYSQL", "DB2" Servers
DLM_DB_USER=admin License Manager Database User details; Database User applicable for "H2", "MYSQL", "DB2" Servers
DLM_DB_PASSWORD=admin License Manager Database Password details; Database Password applicable for "H2", "MYSQL", "DB2" Servers
DLM_DB_URL= License Manager Database URL details; Database URL applicable for "MYSQL", "DB2" Servers
DUSER_REQUESTED_RESTART=NO System Level Configuration: Don't change below values until it requires.
RESTART_NEEDED=NO Reboot Parameter on uninstall and install scenarios