Installing the WebSphere Customization Toolbox using the command line

You can install the WebSphere Customization Toolbox using the Installation Manager command line.

1. Optional: If the repository requires a username and password, create a keyring file to access this repository.
   Tip: 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 that is specified.

   Supported configurations:

   Starting in Installation Manager Version 1.6.2, the -keyring and -password options that were used to access credentials in a key ring 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 before version 1.7. Update Installation Manager to version 1.7 or higher and then re-create and replace any secure storage files that you created with earlier versions.

   There is no migration path from key ring files to storage files because of the differences in the file structures. You must create a storage file to replace a key ring file. For more information about using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the IBM Installation Manager documentation.

2. Log on to your system.
3. Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.
4. Verify that the product repository is available.
   Windows:

   imcl.exe listAvailablePackages -repositories source_repository

   AIX, HP-UX, Linux, and Solaris:

   ./imcl listAvailablePackages -repositories source_repository

   You should see one or more levels of the offering.
5. Use the imcl command to install the product.
   Windows:

   imcl.exe install com.ibm.websphere.WCT.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
   

   AIX, HP-UX, Linux, and Solaris:

   ./imcl install com.ibm.websphere.WCT.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

   • 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 tools that are separated by commas—the feature ID zpmt indicates the Profile Management Tool (z/OS only), zmmt indicates the z/OS Migration Management Tool, pct indicates the Web Server Plug-ins Configuration Tool, and installtools indicates the Remote Installation Tool for IBM i.

     If a list of features is not specified, the default features are installed.

   • 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 documentation.