[Java programming language only]

Installing the product using the command line

Use the Installation Manager from the command line to install WebSphere® eXtreme Scale product offerings.

Before you begin

You must install the necessary product files for the Installation Manager and have access to necessary repositories. For more information, seeIBM Installation Manager and WebSphere eXtreme Scale product offerings.

Procedure

  1. Log on to your system.
  2. Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.
  3. Verify that the product repository is available.
    [Windows]
    imcl.exe listAvailablePackages -repositories source_repository
    [Linux][Unix]
    ./imcl listAvailablePackages -repositories source_repository
    You should see one or more levels of the offering.
  4. Use the imcl command to install the product.
    [Windows]
    imcl install offeringID_version,optionalFeatureID
      -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
    
    For example: imcl install com.ibm.websphere.WXS.v86_8.6.0.20110503_0200,xs.console.feature
    [Linux][Unix]
    ./imcl install offeringID_version,optionalFeatureID
      -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 offeringID is the offering ID that is listed in Offering IDs for WebSphere eXtreme Scale product offerings.
    • The version, which optionally can be attached to the offering ID with an underscore, is a specific version of the offering to install ([Version 8.6 and later]8.6.0.20110503_0200 for example).
      • If version is not specified, the latest version of the offering and all interim fixes for that version are installed.
      • If version is specified, the specified version of the offering and no interim fixes for that version are installed.
      The 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
    • You can also specify none, recommended or all with the -installFixes argument to indicate which interim fixes you 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.
    • You can add a list of features that are separated by commas. An example follows:
      imcl -acceptLicense install com.ibm.websphere.WXS.v85,xs.console.feature,xs.samples.feature 
      imcl -acceptLicense install com.ibm.websphere.WXS.v86,xs.console.feature,xs.samples.feature 
      • xs.client.standalone.feature Available as a required feature if you install WebSphere eXtreme Scale in a stand-alone environment.
      • xs.server.standalone.feature Depending on which product offering you want to install, you can choose to install the server. The server is a selectable feature in the following product offerings:
        • WebSphere eXtreme Scale in a stand-alone environment
      • xs.console.feature Available for all product offerings. You can choose to install the monitoring console. With the web console, you can chart current and historical statistics. This console provides some preconfigured charts for high-level overviews, and has a custom reports page that you can use to build charts from the available statistics. You can use the charting capabilities in the monitoring console of WebSphere eXtreme Scale to view the overall performance of the data grids in your environment
      • xs.samples.feature Available for all product offerings. You can choose to install samples.
      Notes:
    • If you previously specified the mode in which to install Installation Manager, the -accessRights parameter is not required
    • If you experience issues later, Installation Manager can save earlier versions of a package to roll back to. When Installation Manager rolls back a package to a previous version, the current version of the files is uninstalled and the earlier versions are reinstalled. If you choose not to save the files for rollback, you can prevent the files from being saved by specifying a preference:
      -preference com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=False

      For more information about setting your Installation Manager preferences, see the IBM Installation Manager Version 1.5.x Knowledge Center.

      Tip: Even if you choose not to save files for rollback, you can still access product files for rollback from the repository.
    • The program might write important post-installation instructions to standard output.

    For more information about using the imcl command to install the product, see the IBM Installation Manager Version 1.5.x Knowledge Center.