+

Search Tips   |   Advanced Search

Updating enterprise apps with the console


Updating enterprise apps consists of adding a new file or module to an installed Java EE application, or replacing or removing an installed application, file or module.

Before you update the application files on a server, verify the files are assembled in deployable modules.

Next, refer to Ways to update enterprise application files and decide how to update the application files. We can update enterprise apps or modules using the admin console, wsadmin, or Java MBean programming. These ways provide similar updating capabilities.

Further, verify the updated files can be installed to the deployment targets.

This page describes how to update deployed applications or modules using the admin console.

 

  1. Back up the installed application or module.

    1. Go to the Enterprise applications page of the admin console. Click Applications > Application Types > WebSphere enterprise apps
    2. Export the application to an EAR file or export a file in the application. Select the application you want to export and click Export or Export File. Exporting preserves the binding information.

  2. With the application selected on the Enterprise applications page, click Update.

    The Preparing for application update page is displayed.

  3. Under Specify the EAR, WAR, SAR or JAR module to upload and install:

    1. Ensure that Application to be updated refers to the application to be updated.

    2. Under Application update options, select the installed application, module, or file to update.

      The online help Preparing for application update settings provides detailed information on the options.

      Avoid trouble: We cannot add, remove, or modify a Java API for XML-Based Web Services (JAX-WS) annotation using the Replace or add a single file or Replace, add, or delete multiple files update options. These options change a single file or a partial application. If we change a JAX-WS annotation using either of these options, WAS does not return an error. However, we might encounter problems deploying annotated Web services.

  4. If we selected the Replace the entire application or Replace or add a single module option:

    1. Click Next to display a wizard for updating application files.

    2. Complete the steps in the update wizard.

      This update wizard, which is similar to the installation wizard, provides fields for specifying or editing application binding information. Refer to information on installing applications and on the application installation binding settings page for guidance.

      Note that the installation steps have the merged binding information from the new version and the old version. If the new version has bindings for application artifacts such as EJB Java Naming and Directory Interface (JNDI) names, EJB references or resource references, then those bindings will be part of the merged binding information. If new bindings are not present, then bindings are taken from the installed (old) version. If bindings are not present in the old version and if the default binding generation option is enabled, then the default bindings will be part of the merged binding information.

      We can select whether to ignore bindings in the old version or ones in the new version.

  5. Click Finish.

  6. If we did not use the Manage modules page of the update wizard, after updating the application, map the installed application or module to servers or clusters.

    Use the page accessed from the Enterprise Applications page.

    1. Go to the Manage modules page. Click Applications > Application Types > WebSphere enterprise apps > application_name > Manage modules.

    2. Specify the appserver where you want to install modules contained in the application and click OK.

      You can deploy J2EE 1.4 modules to servers on V6 or later nodes. We can deploy Java EE 5 modules to servers on V7.x nodes only.

      On multiple-server products, we can also deploy modules to clusters. To deploy J2EE 1.4 modules, the clusters must contain cluster members on V6 or later nodes. To deploy Java EE 5 modules, the clusters must contain cluster members on V7.x nodes.

 

Results

After replacement of a full application, WAS uninstalls the old application. After replacement of a module, file or partial application, WAS removes the old installed module, file or partial application from the installed application.

 

Next steps

After the application file or module installs successfully, do the following:

  1. If a changed application or module is deployed on a cluster, roll out the changes to all cluster members of the cluster on which the application or module is deployed. Click Rollout Update on the Enterprise applications page to propagate the changed configuration on all cluster members of the cluster on which the application or module is deployed. Rollout Update sequentially updates the configuration on the nodes that contain cluster members.

    Best practice: At the end of the Installing messages displayed by the console during application or module installation, click Manage applications to go to the Enterprise applications page. Do not save changes to the configuration until after you roll out the changes

  2. Save the changes to the configuration.

    On multiple-server products, after you click Save the product deletes the old application files and copies new files when the configuration on the dmgr synchronizes with the configuration on the node where the application is installed.

    If the application is running when you update it, the application stops running before its files are copied to the destination directory of the node and restarts after the copy operation completes. Thus, the application is unavailable on the node during the time the node is synchronizing its configuration with the dmgr.

  3. If needed, restart the application manually so the changes take effect.

    If the application is updated while it is running, WAS automatically stops the application or only its changed components, updates the application logic, and restarts the stopped application or its components.

  4. If the application we are updating is deployed on a server that has its application class loader policy set to Single on the appserver settings page, restart the server.


Ways to update enterprise application files

 

Related tasks


Troubleshooting deployment
Updating enterprise application files
Manage admin console applications using scripting
Updating installed applications with wsadmin
Manage applications through programming

 

Related


Preparing for application update settings
Application server settings

 

Related information


Fine-grained recycle behavior