WAS v8.5 > Administer applications and their environment > Deploy enterprise applications

Uninstall enterprise application files by dragging them from a monitored directory

After an application file no longer is needed, we can uninstall it by removing its EAR, web application archive (WAR), JAR, or SIP archive (SAR) from a monitored directory. An enterprise application file must conform to the Java EE specification.

This topic assumes that you previously installed an enterprise application or module on a server by dragging or copying it to a monitored directory and to delete it from the server. The EAR, JAR, WAR, or SAR file exists in a monitored subdirectory:

For base (stand-alone) application servers on distributed operating systems, the monitored directory is under the application server profile. The directory path is app_server_root/profiles/application_server_profile_name/monitoredDeployableApps/servers/server_name.

Restriction: Installing an EAR, JAR, WAR, or SAR file by adding it to a monitored directory is available only on distributed and z/OS operating systems. It is not supported on IBM i operating systems. For applications previously installed by adding an EAR, JAR, WAR, or SAR file to a monitored monitoredDeployableApps subdirectory, we can uninstall the application or module from the application server by dragging or deleting the EAR, JAR, WAR, or SAR file from the monitoredDeployableApps subdirectory.

WAS v8.5 scans a monitored directory for new applications no more frequently than every five seconds, by default. The server must be running for the product to notice changes to files in its monitored directory.

After not finding the EAR, JAR, WAR, or SAR file in the monitored directory, the product stops the application or module and uninstalls the file from the application server. Also, the product removes application files from the directory for installed applications:

Uninstalling an application file deletes it from the product configuration repository and deletes the application module binaries from the file system of the node where the application modules are installed.

This topic assumes that we use a graphical file browser to drag or delete the EAR, JAR, WAR, or SAR file from the directory. Alternatively, we can use operating system commands to delete a file from a monitored directory.

  1. Ensure the application server from which to remove the enterprise application file is running.

    To see which servers are running, we can use the serverStatus -all command. To start a server, we can use the startServer server_name command.

    For example, for a stand-alone application server node with a profile name of AppSrv02, run the serverStatus command from a command prompt at the app_server_root/profiles/AppSrv02/bin directory:

      serverStatus -all

    If the server is not running, start the server. For example, to start an application server named server1 on AppSrv02, run the startServer command from a command prompt at the app_server_root/profiles/AppSrv02/bin directory:

    The Server server1 open for e-business message indicates the server is running.
  2. Open a file browser and locate the monitored directory.

    For example, for server1 in the AppSrv02 profile, locate the app_server_root/profiles/AppSrv02/monitoredDeployableApps/servers/server1 directory.

  3. Remove the EAR, JAR, WAR, or SAR file to uninstall.

    For example, drag or delete the DynaCacheEsi.ear file from the app_server_root/profiles/AppSrv02/monitoredDeployableApps/servers/server1 directory.


Results

WAS v8.5 stops the application or module and uninstalls it from the application server.

For the AppSrv02 example, the product writes messages about the uninstallation to the SystemOut.log file in the app_server_root/logs/server_name directory. The messages start with the CWLDD message key.

IBM recommends using the HPEL log and trace infrastructure. With HPEL, one views logs using the LogViewer command-line tool in PROFILE/bin.

Examine the server to verify the application or module is no longer installed.

If the uninstallation is not successful, read messages in the SystemOut.log and fix the error condition. Add the EAR, JAR, WAR, or SAR file back into the monitored monitoredDeployableApps subdirectory, wait for the product to detect the file, and then remove it from the directory again. If the uninstallation still is not successful, use the dmgr console or a wsadmin script to uninstall the application file.


Related


Install enterprise application files by adding them to a monitored directory
Uninstall enterprise applications using the console
Uninstall enterprise applications using wsadmin.sh
Deploy enterprise applications
Troubleshoot applications with HPEL


Reference:

Directory conventions


+

Search Tips   |   Advanced Search