Adding and removing features on z/OS
Use IBM® Installation Manager to add and remove features for the WebSphere® Application Server for z/OS® product.
Before you begin
Obtain the product repository for WebSphere Application Server for z/OS Version 9.0. The following instructions assume that the repository is mounted at /usr/lpp/InstallationManagerRepository/HBBO900. The repository can be mounted read-only.
Decide which features you need. Each installed copy of WebSphere Application Server for z/OS can have a different set of installed features.
- WebSphere Application Server traditional
(core.feature)You must install core.feature.
- EJBDeploy tool for pre-EJB 3.0 modules (ejbdeploy)
This optional feature contains the EJBDeploy tool for pre-EJB 3.0 modules.
Before you deploy applications on the server, you must run the EJBDeploy tool on applications that contain EJB modules that are based on specifications before EJB 3.0 that are not in a Java EE 7 application. Running the EJBDeploy tool generates deployment code for enterprise beans in the application. Beginning with the EJB 3.0 specification, the EJBDeploy tool is no longer required because WebSphere Application Server uses a new feature that is called JITDeploy, which automatically generates code when the application starts. EJB modules in a Java EE 7 application uses JITDeploy even if they are based on specifications before EJB 3.0.
- Stand-alone thin clients and resource adapters (thinclient)
This optional feature contains the IBM stand-alone thin clients and resource adapters. IBM thin clients provide a set of clients for various technologies, such as JAX-WS, JAX-RPC, JAX-RS, XML, EJB, JPA, JMS, and more. IBM resource adapters provide the resource adapters for JMS.
- Embeddable EJB container (embeddablecontainer)
The embeddable EJB container is a Java™ Archive (JAR) file that you can use to run enterprise beans in a stand-alone Java Platform, Standard Edition environment. You can run enterprise beans by 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.
- Sample applications (samples)
This optional feature contains the PlantsByWebSphere sample application. The samples feature is recommended for installation in learning and demonstration environments, such as development environments; however, it is not recommended for installation in production application server environments.
- EJBDeploy tool for pre-EJB 3.0 modules (ejbdeploy)
Procedure
- Mount the product file system for the product to which features are being added or
removed.
The file system must be mounted with read and write permissions at the location where it was originally installed with IBM Installation Manager, such as /InstallationManager/products/WebSphere/AppServer/V9R0.
- 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 for z/OS and do not specify the features to be installed, the following features are installed by default:- core.feature
- ejbdeploy
- thinclient
- embeddablecontainer
would install the product with the core.feature, samples, and thinclient features but not the ejbdeploy or embeddablecontainer features.imcl install com.ibm.websphere.zOS.v90,core.feature,samples,thinclient -installationDirectory installation_location -repositories list_of_repository_locations -sharedResourcesDirectory shared_data_location -acceptLicense -secureStorageFile /InstallationManager/im.ssf [-masterPasswordFile /InstallationManager/master.password]
- To add one or more features to an existing product installation,
issue the imcl command and specify the features
to be added. For example:
This will add the embeddablecontainer feature if it is in not already installed.imcl modify com.ibm.websphere.zOS.v90 -addFeatures embeddablecontainer -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.zOS.v90 -installationDirectory installation_location -secureStorageFile /InstallationManager/im.ssf [-masterPasswordFile /InstallationManager/master.password]
- To remove one or more features from an existing product
installation, issue the imcl command and specify
the features to be removed. For example:
This will remove the embeddablecontainer optional feature.imcl modify com.ibm.websphere.zOS.v90 -removeFeatures embeddablecontainer -installationDirectory installation_location
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 WebSphere Application Server nodes and servers.
What to do next
Customize or make use of any new features that you added.


File name: tins_installation_zos_options.html