Installing and removing features on distributed operating systems

You can use Installation Manager to install and remove a product feature.

Before you begin

Make sure that your Installation Manager preferences are pointing to the appropriate web-based or local repositories containing the product.

About this task

Perform this procedure to use the Installation Manager GUI to install or remove a feature.

Note: Like other Installation Manager operations, you can also invoke a modification using one of the following procedures:

Procedure

  1. Stop all servers and applications on the WebSphere Application Server installation that is being modified.
  2. Start Installation Manager.
  3. Click Modify.
  4. Select the package group to modify.
  5. Click Next.
    Note: If you are prompted to authenticate, use the IBM ID and password that you registered with on the program website.
  6. Expand IBM WebSphere Application Server Network Deployment.
  7. Check the appropriate checkbox to install a feature, or clear the appropriate checkbox to remove a feature if you already have it installed.
    • EJBDeploy tool for pre-EJB 3.0 modules

      This option installs 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.

      Tip: Unexpected errors might occur if applications that are provided with IBM WebSphere Application Server, such as the samples, require the optional EJBDeploy tool for pre-EJB 3.0 modules but the feature is not installed. If you deploy and use applications that might require pre-EJB 3.0 modules, include the optional EJBDeploy feature in all WebSphere Application Server installations that will be used by servers running the pre-EJB 3.0 applications.
    • Standalone thin clients, resource adapters, and embeddable containers

      IBM thin clients and resource adapters provide a set of clients and resource adapters for a variety of technologies, such as JAX-WS, JAX-RPC, JAX-RS, XML, EJB, JPA, JMS, and more. An embeddable container runs in a standalone Java Platform, Standard Edition environment. For example, you can use the embeddable EJB container to run enterprise beans outside the application server.

      • Standalone thin clients and resource adapters

        This option installs 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

        This option installs the embeddable EJB container.

        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

      This option installs the sample applications for learning and demonstration environments.

      The samples include both source code files and integrated enterprise applications that demonstrate some of the latest Java (TM) Platform, Enterprise Edition (Java EE) and WebSphere technologies. The samples are recommended for installation to learning and demonstration environments, such as development environments. However, they are not recommended for installation to production application server environments.

  8. Click Next.
  9. Review the summary information, and click Modify.
    • If the modification is successful, the program displays a message indicating that installation is successful.
    • If the modification is not successful, click View Log File to troubleshoot the problem.
  10. Click Finish.
  11. Click File > Exit to close Installation Manager.

Example

Modifying features:
In the following list, the optional feature offering names are enclosed in parentheses:
  • EJBDeploy tool for pre-EJB 3.0 modules (ejbdeploy)
  • Standalone thin clients, resource adapters, and embeddable containers
    • Standalone thin clients and resource adapters (thinclient)
    • Embeddable EJB container (embeddablecontainer)
  • Sample applications (samples)
Here is an example of a response file for modifying the features in an installation:
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<server>
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v80" />
</server>
<install modify='true'>
<offering id='com.ibm.websphere.ND.v80' 
  profile='IBM WebSphere Application Server Network Deployment V8.0' 
  features='samples'/>
</install>
<uninstall modify='true'>
<offering id='com.ibm.websphere.ND.v80' 
  profile='IBM WebSphere Application Server Network Deployment V8.0' 
  features='thinclient,ejbdeploy,embeddablecontainer'/>
</uninstall>
<profile id='IBM WebSphere Application Server Network Deployment V8.0' 
  installLocation='C:\Program Files\IBM\WebSphere\AppServer'>
<data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\AppServer'/>
<data key='user.import.profile' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>
Tip: See Sample response file: Modifying IBM WebSphere Application Server Network Deployment for an annotated sample of a response file for performing this procedure.
Here is an example of using the imcl command to modify the features in an installation:
imcl.exe modify com.ibm.websphere.ND.v80
  -addFeatures samples
  -removeFeatures thinclient,ejbdeploy,embeddablecontainer
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v80
  -installationDirectory C:\Program Files\IBM\WebSphere\AppServer
  -keyring C:\keyring_file.keyring -password password
Note: [Updated in April 2013] Starting in Installation Manager Version 1.6.2, the -keyring and -password options that have been used to access credentials in a keyring file are deprecated. When you use Installation Manager Version 1.6.2 and later, use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file. There is no migration path from keyring files to storage files because of the differences in the file structures. You must create a storage file to replace a keyring file. For more information on using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the Installation Manager Version 1.6 Information Center.

[Updated in April 2013]

apr2013
Restriction: The imcl command-line tool in Installation Manager Version 1.4.x and earlier cannot update the product and remove features at the same time You should update the package that has the same features using the imcl command, and then remove unwanted features using the imcl command.
Modifying languages:

To change the installed languages, use the -properties argument with the cic.selector.nl property in the imcl command to specify the languages that you want in your installation.

For example:
imcl.exe modify com.ibm.websphere.ND.v80_8.0.0.20110503_0200
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v80
  -installationDirectory C:\Program Files\IBM\WebSphere\AppServer
  -properties cic.selector.nl=en,hu,ko,pl,es 
  -keyring C:\keyring_file.keyring -password password

English, Hungarian, Korean, Polish and Spanish would be installed after using this example. If you started with an installation with English only, this would add the other languages. If you started with an installation with more languages, the other languages would be removed.

To find out which languages are installed, use listInstallationDirectories with the imcl command and specify either -long, or -verbose.
For example:
imcl.exe listInstallationDirectories -long



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 and conditions for information centers | Feedback

Last updatedLast updated: Feb 6, 2014 11:19:27 PM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-dist&topic=tins_modify
File name: tins_modify.html