Adding and removing Liberty features on z/OS

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.

1. Mount the product file system for the product to which features are being added or removed.
2. 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

3. 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
   

4. 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.
5. When the appropriate features are added or removed, unmount the product file system and remount it read-only for use by Liberty servers.