Uninstalling enterprise application files by dragging them from a monitored directory
After an application file no longer is needed, you can uninstall it by removing its enterprise archive (EAR), web application archive (WAR), Java™ archive (JAR), or Session Initiation Protocol (SIP) archive (SAR) from a monitored directory. An enterprise application file must conform to the Java Platform, Enterprise Edition (Java EE) specification.
Before you begin
- app_server_root/profiles/profile_name/monitoredDeployableApps
- app_server_root/profiles/default/monitoredDeployableApps
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.
- For application servers, the directory path is app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/servers/server_name.
- For managed (federated) nodes, the directory path is app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/nodes/node_name/servers/server_name.
- For clusters, the directory path is app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/clusters/cluster_name.
- For application servers, the directory path is app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers/server_name.
- For managed (federated) nodes, the directory path is app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/node_name/servers/server_name.
- For clusters, the directory path is app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/cluster_name.
About this task
For applications previously installed by adding an EAR, JAR, WAR, or SAR file to a monitored monitoredDeployableApps subdirectory, you 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.
The product scans a monitored directory for new applications no more frequently than every five seconds, by default. The server or cluster must be running for the product to notice changes to files in its monitored directory.
- app_server_root/profiles/profile_name/installedApps/cell_name
- app_server_root/profiles/default/installedApps/cell_name
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 you use a graphical file browser to drag or delete the EAR, JAR, WAR, or SAR file from the directory. Alternatively, you can use operating system commands to delete a file from a monitored directory.
Procedure
Results
The product stops the application or module and uninstalls it from the application server or cluster.
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.
For uninstallations from a federated node of a deployment manager, if a node agent is stopped, the product uninstalls the application or module at the deployment manager level, but does not synchronize the changes with the node. The changes will occur at the node the next time the agent is running and a node synchronization occurs.
What to do next
Examine the server or cluster to verify that 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 administrative console or a wsadmin script to uninstall the application file.