You can use Installation Manager to add or remove addons and features in an existing
installation. You can change both the optional embeddable EJB container feature and Liberty addons
and features.
Before you begin
Access the product repository for WebSphere®
Application Server Liberty for z/OS®. 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.
When you modify your installation, you can choose to access the IBM WebSphere Liberty Repository
to install addons and features. Access to the IBM WebSphere Liberty Repository requires internet
access. If your system does not have internet access or you want to install customized Liberty
assets, set up an instance of the Liberty Asset Repository Service or a local directory-based
repository, and then add the repository URL, directory path, or archive path in Installation
Manager.
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
- To add one or more features to an existing product installation,
issue the imcl command and specify the features
to be added.
The feature ID of the Embeddable EJB container and JPA client feature is
embeddablecontainer. The optional embeddablecontainer feature is
added by specifying the -addFeatures option and removed by specifying the
-removeFeatures option.
Note: A removal notice was issued for the embeddable EJB container and JPA
client feature as of the 16.0.0.2 fix pack, so the feature is eligible for future removal. For more
information, see Removal notices.
Adding and removing assets when you modify an existing Liberty installation differs from when you
initially install the product. To add Liberty addons or features, specify the symbolic or short
names on the user.addAssets property and specify the
-acceptLicense parameter. To remove addons or features, specify the symbolic or
short names on the user.removeAssets property, separated by double commas.
By default, all of your installed Liberty addons and features remain installed unless you
specifically remove them.
Note: You can install assets from instances of the Liberty Asset
Repository Service or local directory-based repositories with or without internet access. Add the
repository URL, directory path, or archive file path on the -repositories
parameter. These repositories are accessed in the order that they are specified. For more
information about these asset repositories, see Installing assets using Installation Manager. To install assets from the IBM
WebSphere Liberty Repository, you must have access to
the internet. To enable access to the Liberty Repository, on the -properties
parameter, set the user.useLibertyRepository option to true.
The Liberty Repository is the last of the repositories that are accessed during
installation.
Tip: From your Liberty installation, use the installUtility find action
to list the short names of assets that you can install.
The following example command adds the
embeddablecontainer Installation Manager
feature, the
ndMemberBundle Liberty addon, and the
portlet-2.0 and
portletserving-2.0 Liberty features. The
portlet-2.0 feature is
specified using the symbolic name, and
ndMemberBundle and
portletserving-2.0 are specified using the short
names.
./imcl modify com.ibm.websphere.liberty.zOS
-addFeatures embeddablecontainer
-properties user.addAssets=ndMemberBundle,,com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0
-repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.zOS
-installationDirectory /InstallationManager/products/WebSphere/Liberty/16.0.0.2
-secureStorageFile /InstallationManager/im.ssf -masterPasswordFile /InstallationManager/master.password
-acceptLicense
- To remove one or more features from an existing product
installation, issue the imcl command and specify
the features to be removed.
The following example command removes the
embeddablecontainer Installation
Manager feature, the
ndMemberBundle Liberty addon, and the
portlet-2.0 and
portletserving-2.0 Liberty
features.
./imcl modify com.ibm.websphere.liberty.zOS
-removeFeatures embeddablecontainer
-properties user.removeAssets=ndMemberBundle,,com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0
-installationDirectory /InstallationManager/products/WebSphere/Liberty/16.0.0.2
-secureStorageFile /InstallationManager/im.ssf -masterPasswordFile /InstallationManager/master.password
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.