Adding and removing optional features on z/OS

Use IBM® Installation Manager to add and remove optional 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 8. The following instructions assume that the repository is mounted at /usr/lpp/InstallationManagerRepository/HBBO800. The repository can be mounted read-only.

Decide which optional features you need. Each installed copy of WebSphere Application Server for z/OS can have a different set of installed optional features.

The following optional features are available for the WebSphere Application Server base product. The keyword name for each optional feature is provided in parentheses.
  • EJBDeploy tool for pre-EJB 3.0 modules (ejbdeploy)

    This optional feature contains the EJBDeploy tool for pre-EJB 3.0 modules.

    For transitioning users For transitioning users: The EJBDeploy tool was installed automatically with the product in WebSphere Application Server Version 7 and earlier. It is now an optional feature.trns

    Before you deploy applications on the server, you must run the EJBDeploy tool on applications that contain EJB modules that are based on specifications prior to EJB 3.0. 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 called "JITDeploy", which automatically generates code when the application starts.

  • Standalone thin clients and resource adapters (thinclient)

    This optional feature contains the IBM standalone thin clients and resource adapters. IBM thin clients provide a set of clients for a variety of 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 standalone Java Platform, Standard Edition 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.

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

There are no optional features for DMZ Secure Proxy Server for IBM WebSphere Application Server for z/OS or Web Server Plug-ins for IBM WebSphere Application Server for z/OS.

Procedure

  1. Mount the product file system for the product to which optional 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. 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, the following optional features are installed by default:
    • ejbdeploy
    • thinclient
    • embeddablecontainer
    To install the product with a different assortment of optional 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.zOS.v80,samples,thinclient
      -installationDirectory installation_location
      -repositories repository_location 
      -sharedResourcesDirectory shared_data_location 
      -acceptLicense
    
    would install the product with the samples and thinclient features but not the ejbdeploy or embeddablecontainer features.
  4. To add one or more features to an existing product installation, issue the imcl install command and specify the features to be added, separated by commas, after the offering name.
    For example:
    imcl install com.ibm.websphere.zOS.v80,embeddablecontainer
      -installationDirectory installation_location
      -repositories repository_location 
    
    This will add the embeddablecontainer feature if it is in not already installed.
  5. To remove one or more features from an existing product installation, issue the imcl uninstall command and specify the features to be removed, separated by commas, after the offering name.
    For example:
    imcl uninstall com.ibm.websphere.zOS.v80,samples,thinclient
      -installationDirectory installation_location
    
    This will uninstall the samples and thinclient optional features.
    Note: Before uninstalling optional features, make sure that none of your applications depend on the features being present.
  6. 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 optional features that you added.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 20, 2011 12:20:53 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-zos&topic=tins_installation_zos_options
File name: tins_installation_zos_options.html