Installing ZIETrans

With the information in this chapter you can:

Prerequisites

IBM® Installation Manager Version 1.8.3, or later, is required to install ZIETrans Toolkit.

Note:
For more about IBM Installation Manager, see http://www.ibm.com/support/knowledgecenter/SSDV2W.

When you install ZIETrans V1.0 using the IBM Installation Manager, the installation process checks that prerequisite packages and features are already installed. If not, a message is displayed, and the install does not proceed. The following sections list the prerequisite packages and features that must already be installed.

HCL ZIETrans

For HCL ZIETrans (ZIETrans):

If none of the required Rational SDP packages are installed, ZIETrans will not install. If this occurs, use the Install function of the IBM Installation Manager to install one of the required packages along with the required features. Then start the ZIETrans install again.

If one of the required Rational SDP packages is installed without the required features, ZIETrans will not install. If this occurs, use the Modify function of IBM Installation Manager to add the required features. Then start the ZIETrans install again.

Other prerequisites

There are other hardware and software prerequisites for the system where you install ZIETrans Toolkit, the systems where you deploy ZIETrans applications, WebSphere Application Server, and the browsers with which your users will interact with ZIETrans Web applications. For the current list of supported hardware and software prerequisites, see the information in the HCL Support Site for HCL Z and I Emulator for Transformation at https://www.hcltech.com/software/support.

Installing ZIETrans Toolkit

To install ZIETrans Toolkit:

  1. Verify that your system meets all the prerequisites. For more information see Prerequisites.
  2. ZIETrans is structured as an Eclipse offering that is installed to a Rational SDP system using IBM Installation Manager.
  3. If you are installing from a CD and autorun is enabled, then the launchpad starts automatically when you insert the installation disk into your CD drive. If autorun is not enabled, or if you are installing from an electronic image, run the launchpad.exe program located in the root directory of the CD or located in the root directory of the extracted electronic image of the installation disk.
  4. Select the language for the launchpad. Click OK.
  5. The HCL ZIETrans V1.0 window appears. From this window you can install the product and view release information. Be sure to click Release Notes to review last-minute information.
  6. When you are ready to install ZIETrans Toolkit, click Install HCL ZIETrans V1.0 which launches the IBM Installation Manager.
    Note:
    If IBM Installation Manager is not installed an error message is displayed.
  7. The IBM Installation Manager window appears.
  8. On the Install Packages panel, the box for HCL ZIETrans is selected for you. Click Next.
    Note:
    An error message is displayed if the required level of IBM Installation Manager is not installed.
  9. On the Licenses panel, read and accept the terms in the license agreement, and click Next.
  10. On the Location panel, under Package Group Name, select the package group where you want to install ZIETrans, for example IBM Software Delivery Platform, and click Next.
    Note:
    You must select an existing package group where you have installed the prerequisite software delivery products.
  11. On the Features panel, in addition to ZIETrans, you can select for installation the following ZIETrans features. Click Next.
    Notes:
    1. You can install these features at a later time by using the Modify function of IBM Installation Manager.
    2. For prerequisite information see Prerequisites.
  12. On the Summary panel, click Install.
  13. You will see a progress bar as the installation proceeds and Start menu items are created.
  14. On the Install Packages panel, you are informed if the installation was completed successfully. If necessary, you can click View Log File to view the installation log. Click Finish to close the installation panel.
Notes:
  1. All languages supported by ZIETrans and the ZIETrans features are installed during the installation process.
  2. ZIETrans cannot be installed at the same time you install the prerequisite level of Rational SDP and features. You must complete the installation of the prerequisite level of Rational SDP and features before installing ZIETrans.

Adding the ZIETrans installation repository to IBM Installation Manager

The ZIETrans installation program automatically adds the ZIETrans installation directory as a repository in IBM Installation Manager. If for any reason you need to manually add the ZIETrans installation directory as a repository, follow these steps:

  1. From the IBM Installation Manager menu bar, select File > Preferences.
  2. On the Preferences panel, click the Add Repository button.
  3. On the Add a Repository panel, click the Browse button.
  4. On the Select a Repository panel, browse to the ZIETrans CD or the extracted electronic image of the ZIETrans installation disk, in the root directory select the diskTag.inf file, and click OPEN.
    Note:
    If adding a repository for a local installation of a ZIETrans fix pack, browse to the directory where you extracted the fix pack installation files. Inside the directory you will see a zietrans\updates directory. Change to that directory, select repository.config, and click Open.
  5. On the Add a Repository panel, click OK.
  6. On the Preferences panel, click OK.

Uninstalling ZIETrans Toolkit

When you uninstall the ZIETrans package, the ZIETrans Toolkit and all installed features are uninstalled.

When you uninstall ZIETrans Toolkit, the files for your ZIETrans projects and their resources are not deleted. If you re-install ZIETrans Toolkit you are able to work with projects you have previously created. To delete your ZIETrans project files, delete each project before you uninstall ZIETrans. If you want to delete ZIETrans project files after uninstalling ZIETrans, go to the workspace directory on the file system and delete the ZIETrans project files.

To uninstall ZIETrans Toolkit:

  1. You must be logged on with Administrator privileges.
  2. Close the ZIETrans perspective and exit from Rational SDP.
    Note:
    When you start Rational SDP, it always tries to reopen the last perspective that was open. To avoid error messages, before you uninstall ZIETrans, close the ZIETrans perspectives before you exit Rational SDP. If ZIETrans were the last perspective open when you uninstall ZIETrans, Rational SDP will issue error messages because it cannot find the files necessary to reopen the perspective. If this occurs, change the perspective, the errors do not harm anything.
  3. Start the IBM Installation Manager from the Start menu.
  4. On the IBM Installation Manager panel, click Uninstall.
  5. On the Uninstall Packages panel, select the HCL ZIETrans package and click Next.
  6. On the Summary panel, click Uninstall.
  7. You will see a progress bar as the installation program uninstalls ZIETrans and the Start menu items.
  8. On the Uninstall Packages panel, you are informed if the uninstallation was completed successfully. If necessary, you can click View Log File to view the uninstall log. Click Finish to close the Uninstall Packages panel.

Using silent install and uninstall

You can install or uninstall a product package silently using Installation Manager in silent installation mode. When you run Installation Manager in silent mode, the user interface is not available; instead, a response file inputs the commands that are required to install or uninstall the product package. For more information about how to generate the response files and use them see the section, Installing Silently, on IBM Knowledge Center at http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.3/com.ibm.silentinstall12.doc/topics/c_silent_roadmap.html.

Log files

The install, update, modify, and uninstall processes create log files that you can examine if an error occurs.

By default, the log files are stored in the c:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs\ directory.