This topic applies to WebSphere Application Server Liberty V8.5.5.9 and earlier. For the latest Liberty topics, see the WebSphere Application Server Liberty documentation.

Adding and removing features from Liberty on IBM i operating systems using response files

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

About this task

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

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

[8.5.5.4 or later]To install Version 8.5.5.4 and later of Liberty, you must have IBM Installation Manager Version 1.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 that you can use to run enterprise beans in a standalone Java Platform, Standard Edition (SE) environment. You 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.

Procedure

  1. Optional: If the repository requires a username and password, create a credential-storage file to access this repository.
    Tip: 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 that is specified.
    Note: When you use Installation Manager Version 1.6.2 and later, you should use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential-storage file. In versions of Installation Manager earlier than Version 1.6.2, the -keyring and -password options were used to access credentials in a keyring file. These options were deprecated in Version 1.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 documentation. For more information on using the -keyring and -password options to store credentials in a keyring file, see the Installation Manager Version 1.5 documentation.
  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
    Note: 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 that is 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

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: Tuesday, 12 December 2017
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_ins_modify_is
File name: twlp_ins_modify_is.html