Add and remove features from Liberty on IBM i operating systems using response files

We can install and remove WebSphere Application Server Liberty Core features using Installation Manager response files.

Perform this procedure to use Installation Manager to install or remove a feature silently using a response file.

Like other Installation Manager operations, we can invoke a modification using the imcl command-line tool. Go to the IBM Installation Manager Information Center for more information.

To install v8.5.5.4 and later of the Liberty profile requires IBM Installation Manager v1.6.2 or later.

Optional features: In the following list of optional features, the names to be used in the response files are enclosed in parentheses:

• Embeddable EJB container and JPA client (embeddablecontainer)

  This option installs the embeddable EJB container and JPA client.

  The embeddable EJB container is a Java Archive (JAR) file for running enterprise beans in a standalone Java Platform, Standard Edition (SE) 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.

  The JPA client can be used with the embeddable EJB container to provide Java Persistence API capability in a Java SE environment.

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

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

   When we use Installation Manager v1.6.2 and later, we should use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential-storage file. In versions of Installation Manager earlier than v1.6.2, the -keyring and -password options were used to access credentials in a keyring file. These options were deprecated in v1.6.2. There is no migration path from keyring files to storage files because of the differences in the file structures. 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. For more information on using the -keyring and -password options to store credentials in a keyring file, see the Installation Manager Version 1.5 Information Center.

2. Sign on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.

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

4. Use a response file to install or remove a feature.

   Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and modify the product. For example:

   ./imcl
     input $HOME/WASFiles/temp/modify_response_file.xml 
     -log $HOME/WASFiles/temp/modify_log.xml 
     -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/master_password_file.txt

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

   For more information on using Installation Manager, read the IBM Installation Manager Information Center.

Example

• Here are examples of response files for modifying the features in an installation:

  • Here is a response file that adds the Embeddable EJB container and JPA client to an existing product installed in the /QIBM/ProdData/WebSphere/AppServer/V85/LibertyCore directory:

    <?xml version="1.0" encoding="UTF-8"?>
    <agent-input>
    <server>
      <repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85'/>
    </server>
    <profile id='WebSphere Liberty V8.5' installLocation='/QIBM/ProdData/WebSphere/AppServer/V85/LibertyCore'>
      <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppServer/V85/LibertyCore'/>
    </profile>
    <install modify='true'>
      <offering profile='WebSphere Liberty V8.5' features='embeddablecontainer' id='com.ibm.websphere.liberty.v85'/>
    </install>
    <preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='/QIBM/UserData/InstallationManager/IMShared'/>
    <preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
    <preference name='com.ibm.cic.common.core.preferences.readTimeout' value='30'/>
    <preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
    <preference name='offering.service.repositories.areUsed' value='true'/>
    <preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
    <preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
    <preference name='http.ntlm.auth.kind' value='NTLM'/>
    <preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
    <preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
    <preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
    <preference name='PassportAdvantageIsEnabled' value='false'/>
    <preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
    </agent-input>

  • To alter this response file to remove a feature, simply change the install tags to uninstall. Here is the same response file modified to remove the Embeddable EJB container and JPA client:

    <?xml version="1.0" encoding="UTF-8"?>
    <agent-input>
    <server>
      <repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85'/>
    </server>
    <profile id='WebSphere Liberty V8.5' installLocation='/QIBM/ProdData/WebSphere/AppServer/V85/LibertyCore'>
      <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppServer/V85/LibertyCore'/>
    </profile>
    <uninstall modify='true'>
      <offering profile='WebSphere Liberty V8.5' features='embeddablecontainer' id='com.ibm.websphere.liberty.v85'/>
    </uninstall>
    <preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='/QIBM/UserData/InstallationManager/IMShared'/>
    <preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
    <preference name='com.ibm.cic.common.core.preferences.readTimeout' value='30'/>
    <preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
    <preference name='offering.service.repositories.areUsed' value='true'/>
    <preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
    <preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
    <preference name='http.ntlm.auth.kind' value='NTLM'/>
    <preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
    <preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
    <preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
    <preference name='PassportAdvantageIsEnabled' value='false'/>
    <preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
    </agent-input>

  • To combine adding and removing features using a single response file, add both an install action and an uninstall action.

• Here is an example of the imcl command for modifying the features in an installation:

  ./imcl modify com.ibm.websphere.liberty.v85
    -addFeatures embeddablecontainer
    -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85
    -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V85/LibertyCore
    -secureStorageFile /var/credential.store -masterPasswordFile /var/master_password_file.txt

Parent topic:

Install Liberty on IBM i operating systems

Tasks:

Install Liberty on IBM i operating systems using the command line

Install Liberty on IBM i operating systems using response files

Install Liberty remotely on IBM i operating systems using the iRemoteInstall command

Verify the installation

Uninstall Liberty from IBM i operating systems using the command line

Uninstall Liberty from IBM i operating systems using response files

Install Liberty interim fixes on IBM i operating systems using the command line

Install Liberty fix packs on IBM i operating systems using the command line

Install Liberty fix packs on IBM i operating systems using response files

Uninstall Liberty interim fixes from IBM i operating systems using the command line

Uninstall Liberty fix packs from IBM i operating systems using the command line

Uninstall Liberty fix packs from IBM i operating systems using response files

---

Terms and conditions for information centers