WAS v8.5 > Develop applications > Develop Client applications > Develop client applications > Install, updating, rolling back, and uninstalling the Application Client for IBM WAS

Install the Application Client using the GUI

We can use the Installation Manager GUI to install the Application Client.


Install Installation Manager:

  1. Perform one of the following procedures:

    • To use the Installation Manager that is included with this product, perform the following actions:

      1. Obtain the necessary files.

        There are three basic options for obtaining and installing Installation Manager and the product.

        • Access the physical media, and use local installation

          We can access the product repositories on the product media.

          1. Install Installation Manager on your system.

            We can install Installation Manager using the product media, using a file obtained from the Passport Advantage site, or using a file containing the most current version of Installation Manager from the IBM Installation Manager download website.

          2. Use Installation Manager to install the product from the product repositories on the media.

        • Download the files from the Passport Advantage site, and use local installation

          Licensed customers with a Passport Advantage ID and password can download the necessary product repositories from the Passport Advantage site.

          1. Download the files from the Passport Advantage site.

            See How to download WAS V8.5 from Passport Advantage Online for a list of the IBM WAS v8.5 installation images downloadable from the IBM Passport Advantage Online website and other information.

          2. Install Installation Manager on your system.

            We can install Installation Manager using the product media, using a file obtained from the Passport Advantage site, or using a file containing the most current version of Installation Manager from the IBM Installation Manager download website.

          3. Use Installation Manager to install the product from the downloaded repositories.

        • Access the live repositories, and use web-based installation

          If we have a Passport Advantage ID and password, we can install the product from the web-based repositories.

          1. Install Installation Manager on your system.

            We can install Installation Manager using the product media, using a file obtained from the Passport Advantage site, or using a file containing the most current version of Installation Manager from the IBM Installation Manager download website.

          2. Use Installation Manager to install the product from the web-based repository located at

              http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85

            This location does not contain a web page that we can access using a web browser. This is a remote web-based repository location that add to your Installation Manager preferences before the Installation Manager GUI can access the files in this repository to install the product.

          Whenever possible, you should use the remote web-based repositories so that you are accessing the most up-to-date installation files.

        Notes:

        • If we do not have a Passport Advantage ID and password, install the product from the product repositories on the media or local repositories.
        • With the Packaging Utility, we can create and manage packages for installation repositories. We can copy multiple packages into one repository or copy multiple disks for one product into a repository. We can copy packages from Passport Advantage or a web-based repository into a local repository for example. For more information on the Packaging Utility, go to the IBM Installation Manager v1.5 Information Center.

      2. Change to the location containing the Installation Manager installation files, and run one of the following commands:

        Administrative installation:

        • install.exe

          ./install

        Non-administrative installation:

        • userinst.exe

          ./userinst

        Group-mode installation:

        ./groupinst


        Notes on group mode:

        • Group mode allows multiple users to use a single instance of IBM Installation Manager to manage software packages.
        • Group mode is not available on Windows operating systems.

        • If we do not install Installation Manager using group mode, you will not be able to use group mode to manage any of the products that you install later using this Installation Manager.
        • Make sure that you change the installation location from the default location in the current user's home directory to a location that is accessible by all users in the group.

        • Set up your groups, permissions, and environment variables as described in the Group mode road maps in the IBM Installation Manager v1.5 Information Center before installing in group mode.

        • For more information on using group mode, read the Group mode road maps in the IBM Installation Manager v1.5 Information Center.

        The installer opens an Install Packages window.

      3. Verify the Installation Manager package is selected, and click Next.
      4. Accept the terms in the license agreements, and click Next.

        The program creates the directory for the installation.

      5. Click Next.
      6. Review the summary information, and click Install.

        • If the installation is successful, the program displays a message indicating that installation is successful.

        • If the installation is not successful, click View Log File to troubleshoot the problem.

    • If we already have Installation Manager v1.5.2 or later installed on your system and to use it to install and maintain the product, obtain the necessary product files.

      There are three basic options for installing the product.

      • Access the physical media, and use local installation

        We can access the product repositories on the product media. Use Installation Manager to install the product from the product repositories on the media.

      • Download the files from the Passport Advantage site, and use local installation

        Licensed customers with a Passport Advantage ID and password can download the necessary product repositories from the Passport Advantage site.

        1. Download the product repositories from the Passport Advantage site.

          See How to download WAS V8.5 from Passport Advantage Online for a list of the IBM WAS v8.5 installation images downloadable from the IBM Passport Advantage Online website and other information.

        2. Use Installation Manager to install the product from the downloaded repositories.

      • Access the live repositories, and use web-based installation

        If we have a Passport Advantage ID and password, we can use Installation Manager to install the product from the web-based repositories. Use Installation Manager to install the product from the web-based repository located at

          http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85

        This location does not contain a web page that we can access using a web browser. This is a remote web-based repository location that specify for the value of the -repositories parameter so the imcl command can access the files in this repository to install the product.

        Whenever possible, you should use the remote web-based repositories so that you are accessing the most up-to-date installation files.

      Notes:

      • If we do not have a Passport Advantage ID and password, install the product from the product repositories on the media or local repositories.
      • With the Packaging Utility, we can create and manage packages for installation repositories. We can copy multiple packages into one repository or copy multiple disks for one product into a repository. We can copy packages from Passport Advantage or a web-based repository into a local repository for example. For more information on the Packaging Utility, go to the IBM Installation Manager v1.5 Information Center.

  2. Add the product repository to your Installation Manager preferences.

    1. Start Installation Manager.
    2. In the top menu, click File > Preferences.

    3. Select Repositories.
    4. Perform the following actions:

      1. Click Add Repository.

      2. Enter the path to the repository.config file in the location containing the repository files.

        For example:

        • C:\repositories\product_name\local-repositories

          /var/repositories/product_name/local-repositories

        or

          http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85

      3. Click OK.

    5. Deselect any locations listed in the Repositories window that you will not be using.

    6. Click Apply.

    7. Click OK.

    8. Click File > Exit to close Installation Manager.

  1. Start Installation Manager.

    Tip: If we installed Installation Manager using group mode, we can start it in group mode with the ./IBMIM command.

    • Group mode allows users to share packages in a common location and manage them with the same instance of Installation Manager.

    • For more information on using group mode, read the Group mode road maps in the IBM Installation Manager v1.5 Information Center.

  2. Click Install.

    If we are prompted to authenticate, use the IBM ID and password that you registered with on the program website.

    Installation Manager searches its defined repositories for available packages.

  3. Perform the following actions.

    1. Select Application Client for IBM WAS and the appropriate version.

      If we are installing the ILAN version WAS v8.5, select Application Client for IBM WAS (ILAN).

      If we already have the Application Client installed on your system, a message displays indicating the Application Client is already installed. For a given Installation Manager, we can install only one Application Client.

      If the Search service repositories during installation and updates option is selected on the Installation Manager Repository preference page and you are connected to the Internet, we can click Check for Other Versions and Extensions to search for updates in the default update repositories for the selected packages. In this case, we do not need to add the specific service-repository URL to the Installation Manager Repository preference page.

    2. Select the fixes to install.

      Any recommended fixes are selected by default.

      If there are recommended fixes, we can select the option to show only recommended fixes and hide non-recommended fixes.

    3. Click Next.

    Installation Manager might prompt you to update to the latest level of Installation Manager when it connects to the repository. Update to the newer version before you continue if you are prompted to do so. Read the IBM Installation Manager v1.5 Information Center for information about automatic updates.

  4. Accept the terms in the license agreements, and click Next.

  5. Specify the installation root directory for the product binaries, which are also referred to as the core product files or system files.

    The panel also displays the shared resources directory and disk-space information.

    Restrictions:

    • Deleting the default target location and leaving an installation-directory field empty prevents you from continuing.
    • Do not use symbolic links as the destination directory.

      Symbolic links are not supported.

    • Do not use a semicolon in the directory name.

      The Application Client cannot install properly if the target directory includes a semicolon.

      A semicolon is the character used to construct the class path on Windows systems.

    • Maximum path length on the Windows Server 2008, Windows Vista, and Windows 7 operating systems is 60 characters.

  6. Click Next.

  7. Select any features to install.

    Choose from the following optional features:

    • IBM Developer Kit, Java 2 Technology Edition

      This option installs the IBM Developer Kit, Java 2 Technology Edition.

      This feature includes a development kit and a runtime-environment package. The runtime-environment package is always installed with the Java EE and Java thin application client feature even if this feature is not installed.

      • Java 2 Runtime Environment

        This option installs the Java 2 runtime environment.

        This feature includes the Java 2 runtime environment of IBM Developer Kit, Java 2 Technology Edition.

      • Developer Kit

        This option installs the developer kit.

        This feature includes the developer kit of IBM Developer Kit, Java 2 Technology Edition.

    • Samples

      This option installs executable and source-code examples of programming in both Java EE and non-Java EE client environments.

    • Standalone Thin Clients, Resource Adapters, and Embeddable Containers

      IBM thin clients and resource adapters provide a set of clients and resource adapters for a variety of technologies, such as JAX-WS, JAX-RPC, JAX-RS, XML, EJB, JPA, JMS, and more. An embeddable container runs in a standalone Java Platform, Standard Edition environment. For example, we can use the embeddable EJB container to run enterprise beans outside the application server.

      • Standalone thin clients and resource adapters

        This option installs the runtime for standalone thin clients.

      • Embeddable EJB container

        This option installs the embeddable EJB container.

        The embeddable EJB container is a JAR file used to run enterprise beans in a standalone Java Platform, Standard Edition environment. We can run enterprise beans using this embeddable container outside the application server. The embeddable EJB container is a part of the EJB 3.1 specification and is primarily used for unit testing enterprise beans business logic.

    We can run the Installation Manager later to modify this installation and add or remove features.

  8. Click Next.

  9. Enter the host name and port number of the Websphere Application Server to which to connect.

  10. Click Next.
  11. Review the summary information, and click Install.

    • If the installation is successful, the program displays a message indicating that installation is successful.

      The program might also display important post-installation instructions as well.

    • If the installation is not successful, click View Log File to troubleshoot the problem.

  12. Click Finish.

  13. Click File > Exit to close Installation Manager.


Related


Install, updating, rolling back, and uninstalling the Application Client for IBM WAS
Install the Application Client using response files
Install the Application Client using the command line
Install and removing features in the Application Client
Install fix packs on the Application Client using the GUI
Uninstall fix packs from the Application Client using the GUI
Uninstall the Application Client using the GUI
Uninstall the Application Client using response files
Uninstall the Application Client using the command line


+

Search Tips   |   Advanced Search