Installing fix packs by using the command line

You can use the IBM® Installation Manager imcl command to update the product offerings with available fix packs. Fix packs contain bundled service to bring the offerings up to a new product level.

1. Log on to your system.

   Make sure that you log on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.

2. Choose whether to install from an online service repository or a local repository that contains the fix pack installation files.

   • Access the online service repository.

     1. Determine the URL for the product.
        You can install from the service repositories by using the same URLs that you used for the initial product installation. These URLs are based on the following pattern, where offering_ID is the offering ID that you can find in WebSphere Application Server product offerings for supported operating systems:

        http://www.ibm.com/software/repositorymanager/offering_ID

        These URLs do not load in a web browser and can be accessed only by Installation Manager.

     2. Optional: Create a master password file to secure your credentials.

        The master password file is a text file that contains a passphrase such as This text is the master password. This file is used to secure your authentication credentials.

        If you create a master password file and use it when you create credentials, you must always specify the master password file.

        Tip: To secure this file, set permissions to restrict access to this file.
     3. Create a credential storage file that contains your IBM software user ID and password by running the imutilsc saveCredential command.
        

        imutilsc.exe saveCredential 
          -secureStorageFile storage_file
          -userName user_ID -userPassword user_password
          -url source_repository 

        

        ./imutilsc saveCredential 
          -secureStorageFile storage_file
          -userName user_ID -userPassword user_password
          -url source_repository 

        Tip: When you create a storage file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the specified URL.

     For more information about storing authentication credentials, see Storing credentials in the IBM Installation Manager documentation.

   • Download files from Fix Central and extract them to create a local repository.

     Each compressed fix-pack file contains an Installation Manager repository for the fix pack and usually has a .zip extension. After you download and extract the fix-pack file, you can use the resulting repository with Installation Manager to update the offering with the fix pack.

     1. Go to Fix Central.
     2. Select WebSphere as the product group.
     3. Select WebSphere Application Server as the product.
     4. Select your installed product version.
     5. Select your operating system as the platform, and click Continue.
     6. Select Browse for fixes, and click Continue.
     7. Under And fix type, select Fix pack.
     8. Click More Information under each fix to view information about the fix.
     9. Select your download options, and click Continue.
     10. Agree to the terms and conditions by clicking I agree.
     11. Click Download now.
     12. Transfer the compressed file in binary format to the system on which it will be installed.
     13. Extract the compressed repository files to a directory on your system.
3. Stop the product installation that you are updating.
4. Start the command line.

   On a CL command line, run the STRQSH command to start the Qshell command shell.

5. Verify that you have the necessary permissions to install the fix pack in your chosen directories.
6. Change to the eclipse/tools directory in the directory where you installed Installation Manager.
7. Verify that the product repository is available.

   The listAvailablePackages command lists one or more levels of the offering.

   

   imcl.exe listAvailablePackages -repositories source_repository

   

   ./imcl listAvailablePackages -repositories source_repository

8. Install the fix pack by running the imcl install command
   

   imcl.exe install offering_ID_offering_version,optional_feature_ID
     -repositories source_repository 
     -installationDirectory product_installation_location
     -secureStorageFile storage_file -masterPasswordFile master_password_file
     -acceptLicense
   

   

   ./imcl install offering_ID_offering_version,optional_feature_ID
     -repositories source_repository 
     -installationDirectory product_installation_location
     -secureStorageFile storage_file -masterPasswordFile master_password_file
     -acceptLicense
   

   Updating offerings with optional features

   When you update a product, you must specify all optional features that were used in the initial product installation. If you do not specify these features, Installation Manager removes them.

   The offering IDs, optional features for each offering, and default features are shown in the following table:

   Table 1. Offering IDs and optional features

   Offering ID	Optional feature ID	Default features
   WebSphere Application Server Network Deployment com.ibm.websphere..v90	core.feature: WebSphere Application Server This feature must be specified to specify the following optional subfeatures: samples: Sample applications thinclient: Standalone thin clients and resource adapters embeddablecontainer: Embeddable EJB container ejbdeploy: EJBDeploy tool for pre-EJB 3.0 modules Note: You cannot use Installation Manager to modify, update, or rollback functions to later add or remove core.feature. Only the subfeatures can be added or removed.	core.feature thinclient embeddablecontainer ejbdeploy
   Application Client for WebSphere Application Server com.ibm.websphere.APPCLIENT.v90	samples: Samples standalonethinclient.resourceadapter.runtime: Standalone Thin Clients Runtime standalonethinclient.resourceadapter.samples: Standalone Thin Clients Samples embeddablecontainer: Embeddable EJB Container	embeddablecontainer
   DMZ Secure Proxy Server for IBM WebSphere Application Server com.ibm.websphere.NDDMZ.v90	core.feature: DMZ Secure Proxy Server for IBM WebSphere Application Server This feature must be specified to specify the following optional subfeature: thinclient: Standalone thin clients and resource adapters	No default features
   Web Server Plug-ins com.ibm.websphere.PLG.v90	No optional features	N/A
   WebSphere Customization Toolbox com.ibm.websphere.WCT.v90	zpmt: Profile Management Tool (z/OS® only) zmmt: z/OS Migration Management Tool pct: Web Server Plug-ins Configuration Tool	All optional features are installed by default

   Offering version information

   The offering_version, which optionally can be attached to the offering ID with an underscore, is a specific version of the offering to install (9.0.0.x_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

9. Optional: List all installed packages to verify the installation:
   

   ./imcl listInstalledPackages -long

   

   imcl.exe listInstalledPackages -long