Use IBM® Installation
Manager to add and remove features for WebSphere® Application Server Liberty for z/OS®.
Before you begin
Obtain the product repository for WebSphere Application Server Liberty for z/OS. The following instructions
assume that the repository is mounted at /usr/lpp/InstallationManagerRepository/HBBO850.
The repository can be mounted read-only.
Decide which features
you need. Each installed copy of WebSphere Application
Server Liberty for z/OS can
have a different set of installed features.
The following optional
features are available for WebSphere Application
Server Liberty for z/OS. The
keyword name for each feature is provided in parentheses.
- Embeddable EJB container and JPA client (embeddablecontainer)
This
option includes 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.
- Extended Programming Models (extprogmodels)
The
Extended Programming Models feature provides a rich set of programming
models such as Web Services, JMS (including Message-Driven Beans),
and Mongo 2.0.
Procedure
- Mount the product file system for the product to which
features are being added or removed.
- Log in to the Unix System Services shell under the Installation
Manager user ID, and change the directory to the eclipse/tools subdirectory
of the Installation Manager binaries location.
For example:
cd /InstallationManager/bin/eclipse/tools
- View a list of the features installed with the product.
You do this by issuing the following Installation Manager
command-line command:
imcl listInstalledPackages -features -long
Tip: When you install a new copy of the WebSphere Application Server Liberty for z/OS and do not specify the features
to be installed, the following features are installed by default:
- embeddablecontainer
- extprogmodels
To install the product with a different assortment of features,
add a complete list of features that you want (separated by commas)
after the package name in the
imcl install command.
For example, the following command:
imcl install com.ibm.websphere.liberty.zOS.v85,embeddablecontainer
-installationDirectory installation_location
-repositories list_of_repository_locations
-sharedResourcesDirectory shared_data_location
-acceptLicense
would install the product with the
embeddablecontainer feature.
- To add one or more features to an existing product installation,
issue the imcl command and specify the features
to be added.
For example:
imcl modify com.ibm.websphere.liberty.zOS.v85
-addFeatures embeddablecontainer
-repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.zOS.v85
-installationDirectory installation_location
This
will add the
embeddablecontainer feature if it is
in not already installed.
- To remove one or more features from an existing product
installation, issue the imcl command and specify
the features to be removed.
For example:
imcl modify com.ibm.websphere.liberty.zOS.v85
-removeFeatures embeddablecontainer
-repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.zOS.v85
-installationDirectory installation_location
This
will remove the
embeddablecontainer optional feature.
Note: Before removing optional features, make sure that none
of your applications depend on the features being present.
- When the appropriate features are added or removed, unmount
the product file system and remount it read-only for use by Liberty
servers.
What to do next
Customize or make use of any new features that you added.