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.
-DUSER_SHORTCUTS=C\:\\ProgramData\\Microsoft\\Windows\\Start Menu ZIEWEB shortcut will be created based on the path provided by user.
-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