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 distributed operating systems

You can use Installation Manager to install and remove WebSphere® Application Server Liberty Core features.

Before you begin

Ensure that your Installation Manager preferences are pointing to the appropriate web-based or local repositories containing WebSphere Application Server Liberty Core.

About this task

You can use the Installation Manager to install or remove features using one of the following procedures:

  • Using the GUI
  • Using a silent response file

    You can record this response file using the GUI and Installation Manager's record mode, or you can manually create or modify a response file to suit your needs.

  • Using the imcl command-line tool

    Go to the IBM® Installation Manager Information Center for more information.

Procedure

  1. Stop all servers and applications on the WebSphere Application Server Liberty Core installation that is being modified.
  2. Start Installation Manager.
  3. Click Modify.
  4. Select the package group to modify.
  5. Click Next.
    Note: If you are prompted to authenticate, use the IBM ID and password that you registered with on the program website.
  6. Expand IBM WebSphere Application Server LibertyCore.
  7. Select the appropriate checkbox to install a feature, or clear the appropriate checkbox to remove a feature if you already have it installed.
    • Embeddable EJB container and JPA client

      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.

  8. Click Next.
  9. Review the summary information, and click Modify.
    • If the modification is successful, the program displays a message indicating that installation is successful.
    • If the modification is not successful, click View Log File to troubleshoot the problem.
  10. Click Finish.
  11. Click File > Exit to close Installation Manager.

Examples

In the following examples, the optional feature offering names are enclosed in parentheses; for example: Embeddable EJB container and JPA client (embeddablecontainer)
  • For Windows platformsExample of a response file that adds a feature to an installation:
    <?xml version="1.0" encoding="UTF-8"?>
    <agent-input clean='true' temporary='true'>
    <server>
    <repository location='http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85'/>
    </server>
    <install modify='true'>
    <offering id='com.ibm.websphere.liberty.v85' 
      profile='WebSphere Liberty V8.5' 
      features='embeddablecontainer'/>
    </install>
    <profile id='WebSphere Liberty V8.5' 
      installLocation='C:\Program Files\IBM\WebSphere\Liberty'>
    </profile>
    </agent-input>
  • For Windows platformsExample of the imcl command that is modified to add features to an installation:
    imcl.exe modify com.ibm.websphere.liberty.v85
      -addFeatures embeddablecontainer
      -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85
      -installationDirectory C:\Program Files\IBM\WebSphere\Liberty
      -secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt
    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.
  • Example of the imcl command that is modified to remove a feature from an installation:
    imcl.exe modify com.ibm.websphere.liberty.v85
      -removeFeatures embeddablecontainer
      -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85
      -installationDirectory C:\Program Files\IBM\WebSphere\Liberty
      -secureStorageFile C:\credential.store -masterPasswordFile C:\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
File name: twlp_ins_modify.html