(dist)

Install the Pluggable Application Client using the command line

We can install the Pluggable Application Client using the Installation Manager command line.

Important: Before installing the product, you must read the license agreement that we can find with the product files. Signify the acceptance of the license agreement by specifying -acceptLicense in the command.

Install Installation Manager on each of the systems onto which to install the product.

• To use the Installation Manager 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 the 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. images downloadable from the IBM Passport Advantage Online website and other information.

       2. Install Installation Manager on the 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 the 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.PLUGCLIENT.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 that 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.

     • 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 Version 1.6 Information Center or the IBM Installation Manager Version 1.5 Information Center.

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

     Administrative installation:

     installc.exe -acceptLicense -log log_file_path_and_name

     Non-administrative installation:

     userinstc.exe -acceptLicense -log log_file_path_and_name

• If we already have Installation Manager Version 1.5.2 or later installed on the 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. 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.PLUGCLIENT.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 that 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.

  • 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 Version 1.6 Information Center or the IBM Installation Manager Version 1.5 Information Center.

1. Optional: If the repository requires a username and password, create a keyring file to access this repository.

   For more information on creating a keyring file for Installation Manager, read the IBM Installation Manager Version 1.6 Information Center or the IBM Installation Manager Version 1.5 Information Center.

   When creating a keyring file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the URL specified.

   Start in Installation Manager Version 1.6.2, the -keyring and -password options that have been used to access credentials in a keyring file are deprecated. For Installation Manager Version 1.6.2 and later, use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file.

   In Version 1.7, the format of the secure storage file is revised, and is no longer compatible with versions of Installation Manager prior to version 1.7. Update Installation Manager to version 1.7 or higher and then recreate and replace any secure storage files created with earlier versions.

   There is no migration path from keyring files to storage files because of the differences in the file structures. Create a storage file to replace a keyring file. For more information on using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the Installation Manager Version 1.6 Information Center.

2. Log on to the system.

3. Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.

4. Verify that the product repository is available.
   imcl.exe listAvailablePackages -repositories source_repository

   You should see one or more levels of the offering.

5. Use the imcl command to install the product.

   imcl.exe install com.ibm.websphere.PLUGCLIENT.v85_offering_version,optional_feature_ID
     -repositories source_repository    -installationDirectory installation_directory    -sharedResourcesDirectory shared_directory
     -accessRights access_mode
     -preferences preference_key=value
     -properties property_key=value
     -keyring keyring_file -password password   -acceptLicense

   Tips:

   • The relevant terms and conditions, notices, and other information are provided in the license-agreement files in the lafiles or product_name/lafiles subdirectory of the installation image or repository for this product.

   • The offering_version, which optionally can be attached to the offering ID with an underscore, is a specific version of the offering to install (8.5.0.20110503_0200 for example).

     • If offering_version is not specified, the latest version of the offering and all interim fixes for that version are installed.

     • If offering_version is specified, the specified version of the offering and no interim fixes for that version are installed.

     The offering version can be found attached to the end of the offering ID with an underscore when you run the following command against the repository:

     imcl listAvailablePackages -repositories source_repository

   • We can also specify none, recommended or all with the -installFixes argument to indicate which interim fixes we want installed with the offering.

     • If the offering version is not specified, the -installFixes option defaults to all.

     • If the offering version is specified, the -installFixes option defaults to none.

   • The -accessRights parameter is not required if you previously specified the mode in which to install Installation Manager.

   • The program might write important post-installation instructions to standard output.

   For more information on using the imcl command to install the product, see the IBM Installation Manager Version 1.6 Information Center or the IBM Installation Manager Version 1.5 Information Center.

Related tasks

Install and uninstall the Pluggable Application Client for WebSphere Application Server

Install the Pluggable Application Client using the GUI

Install the Pluggable Application Client using response files

Uninstall the Pluggable Application Client using the GUI

Uninstall the Pluggable Application Client using response files

Uninstall the Pluggable Application Client using the command line