[AIX Solaris HP-UX Linux Windows][z/OS]

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

This topic assumes that you previously installed an enterprise application or module on a server or cluster by dragging or copying it to a monitored directory and that you want to delete it from the server or cluster. The EAR, JAR, WAR, or SAR file exists in a monitored subdirectory:
  • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/profile_name/monitoredDeployableApps
  • [z/OS]app_server_root/profiles/default/monitoredDeployableApps

[AIX Solaris HP-UX Linux Windows]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.

[AIX Solaris HP-UX Linux Windows]For deployment managers on distributed operating systems, the monitored directory is under the deployment manager profile:
  • 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.
[z/OS]For deployment managers on z/OS® operating systems, the monitored directory path is as follows:
  • 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.
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.

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.

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 or cluster. Also, the product removes application files from the directory for installed applications:
  • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/profile_name/installedApps/cell_name
  • [z/OS]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

  1. Ensure that the application server or cluster from which you want to remove the enterprise application file is running.

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

    [AIX Solaris HP-UX Linux Windows]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:
    startServer server1
    The Server server1 open for e-business message indicates that the server is running.
  2. Open a file browser and locate the monitored directory.

    [AIX Solaris HP-UX Linux Windows]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 that you want to uninstall.

    [AIX Solaris HP-UX Linux Windows]For example, drag or delete the DynaCacheEsi.ear file from the app_server_root/profiles/AppSrv02/monitoredDeployableApps/servers/server1 directory.

Results

The product stops the application or module and uninstalls it from the application server or cluster.

[AIX Solaris HP-UX Linux Windows]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.

Note: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.logSystemErr.log, trace.logactivity.log 檔案。HPEL 與原生 z/OS 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。

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.


指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: July 9, 2016 11:16
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_uninst_dragdrop
檔名:trun_app_uninst_dragdrop.html