Installation procedure

To install ZIEWeb in the Console Mode, perform the following tasks:
  1. Start IBM Installation Manager in console mode. Open a command prompt with administrator's privileges and change to the tools folder within the IBM Installation Manager Installation directory.
  2. Run the following command in the tools directory
    imcl -c
    On different operating systems, for example:
    • AIX® or Linux:
      /opt/HCL/InstallationManager/eclipse/tools/imcl –c
    • IBM i:
      /QHCL/ProdData/InstallationManager/eclipse/tools/imcl –c
    • Windows:
      \Program Files\HCL\Installation Manager\eclipse\tools\imcl.exe -c
    • z/OS:
      /InstallationManager/bin/eclipse/tools/imcl -c

      For more details on starting Installation Manager in console mode, refer to Starting console mode.

  3. In the console window, specify the HCL Z and I Emulator for Web repository:
    1. Type P, and then press Enter to edit preferences.
    2. Type 1, and then press Enter to specify repositories.
    3. Type D, and then press Enter to add a repository.
    4. Type the repository path for HCL Z and I Emulator for Web 2.0. For example, <path>\ZIEWeb\disk1\diskTag.inf.
    5. Type A, then press Enter to save the repository information.
    6. Type R, and then type press Enter to return to the main menu.
  4. Select 1 to install from the main menu. If you have repositories that require credentials, you are informed to enter your ID and then password. You can also save the credentials when you are asked. See Saving credentials in console mode in the Installation Manager Knowledge Center.
  5. On the panel to select packages to install, type the appropriate number to select the Z and I Emulator for Web 2.0 package.
  6. On the subsequent panel type the appropriate number to choose Version 2.0 for installation and type press Enter.
  7. Enter N to proceed.
  8. Review the license agreement by typing the appropriate number to view license information. To accept the license agreement, type A, and then click Enter. Type N and press Enter to proceed.
  9. Select the Installation Manager Shared Resources Directory. Refer to Overview of package groups and the shared resources directory for further information. To change the directory, enter M, and then Enter. Enter the correct path, then type N to proceed.
  10. The Location panel allows you to specify the location of the HCL Z and I Emulator for Web 2.0 installation directory. Type M to change location of the installation directory. Enter the correct path, and enter N to proceed.
  11. The architecture of the package shows when installing on a 64-bit operating system. For new package groups, you can change the bit mode by entering T: Change to bit-architecture. For example, if the Selected Architecture is displayed as 64-bit and option T is displayed to Change to 32-bit architecture, type T to change to 32-bit architecture.
  12. To accept the default values or to continue after entering a different value, type N to proceed.
  13. On the language panel, enter the number to the left of the language to add or remove the language from the list of languages for installation. You can select only one language at a time or S to select all languages. English is selected by default and it is mandatory. Your language choices apply to all packages installed in the package group. Type N to proceed.
  14. The next panel displays the Configurations menu, for the configuration details required by Z and I Emulator for Web installation:

    Typically, the Z and I Emulator for Web configuration menu has the following entries:

    • Publish Information
    • Web server
    1. Enter the appropriate number to the left of Publish Information entry to review the settings. The Publish Information panel displays the following information:
      • Publish Destination Directory is the location where the Z and I Emulator for Web files that users access from the web are installed. A default value is shown in the panel. Type 1 to change the location if needed.
      • Z and I Emulator for Web Publish Alias is the web-server alias setting for the Z and I Emulator for Web publish directory. Type A to change the location if needed.
      • Service manager port is the port number on which the Z and I Emulator for Web service manager listens. Specify Service Manager port, through which Z and I Emulator for Web clients communicate with the Service Manager. This communication is necessary for the following deployment options:
        • Using the configuration server to maintain session configuration information (as in the configuration server-based and combined deployment models, described in Planning for deployment).

        Port 8999 is the default port for Z and I Emulator for Web. Check with your system administrator to see if this port is occupied. If it is in use, you can change the port during the installation or later. For more information about changing the Service Manager port, see Changing the Service Manager's configuration port in the online help.

        Enter the number associated with any of these options to change the respective settings. Refer to the remaining options on the screen to navigate.

    2. Enter the appropriate number to the left of Web server to review its settings.
      1. The web server panel displays the following options. You need to select the web-server option that is appropriate for your requirement:
        • No Web Server: Select it when you configure the web server manually or when there is no web server. Contact your web server administrator or refer the web-server documentation for details.
          Note: Select No Web Server for z/OS installations because the web server cannot be detected and must be configured manually.
        • Select from list of detected web servers: To select a detected web server, select this option and then select the web server that has been detected.
        • Manually select specific web server: Select this option when an IBM HTTP Server 8.5 or Apache web server 2.2 is installed but not detected. You need to enter the complete path to the httpd.conf file in the web server installation directory.
      2. Enter the number associated with the required option to change the respective settings. Refer to the options on the screen to navigate. Enter N to proceed.
    3. If the installation program detects IBM WebSphere Application Server on your system, the next panel accessed using Application Server tab asks if you want to configure the Z and I Emulator for Web configuration servlet in WebSphere Application Server. If users run Z and I Emulator for Web through a firewall, this eliminates the need to open an extra port for client communications with the Z and I Emulator for Web Service Manager. See Installing the configuration servlet for more information.
      • If you type number or alphabet that appears to the left of the question, IBM Installation Manager displays a list of the versions of the application servers, their profiles and servers detected, prompting users to choose from them. The installation program automatically deploys the configuration servlet on the Web application server you designate, and it configures your clients to access the Service Manager through that servlet.
      • If you proceed without choosing to configure the servlet, the install does not configure the configuration servlet. Clients can access the Service Manager directly on port 8999 (or an alternative port you had specified).
      • The Websphere application server is detected if it has been installed by the same IBM Installation Manager program on the system. The versions that can be detected are Websphere Application Server V8.0 and Websphere Application Server V8.5.
      • A server with administrative security enabled is not supported for servlet configuration during the installation.
  15. The next panel is the summary panel. Review your selections before continuing with the installation.
  16. To generate a response file, enter G: to generate an installation response file.
  17. Enter the name of the response file and use .xml as the file extension. Response files are XML files.
  18. Include a directory location when you enter the response file name to save the file to a different location.
  19. Enter I to start the installation.
  20. When the installation completes, enter F: to finish.
  21. Enter X to exit Installation Manager.