Undeploy a deployed archive

When you undeploy an archive, the archive is no longer deployed and cannot be reactivated.

An archive can be undeployed. When you undeploy an archive:

All applications and services provided by the archive that are not disabled are disabled at this time.
The MANIFEST file renames to MANIFEST.undeployed. Any archive with the file MANIFEST.undeployed represents an undeployed archive.

When you undeploy an archive, no files are removed. The cleanup of the undeployed archive directory must be explicitly requested.

Enter the gasadmin command with the appropriate arguments.

To undeploy an archive named fuzzy.gar:

gasadmin --undeploy-archive fuzzy.gar

By default, the results are output in text format. When the console output uses the form of an XML document, it can be easier to parse by other applications than textual output. To output in XML, specify the --xml-output option:

gasadmin --undeploy-archive fuzzy.gar --xml-output

The exit status is a 0 (zero) in case of success, 1 in case of error.

XML output examples:

<DEPLOYMENT success=”TRUE”>
  <MESSAGE>Archive <archive-name> successfully undeployed</MESSAGE>
</DEPLOYMENT>

<DEPLOYMENT success=”FALSE”>
  <ERROR>Failed to undeploy <archive-name> archive.</ERROR>
  <ERROR>... and error messages indicating the reasons of the failure...</ERROR>
</DEPLOYMENT>

Text output examples:

Command suceeded.
Genero archive successfully deployed.

Command failed.
ERROR: Failed to undeploy the Genero Archive
ERROR: ... and error messages indicating the reasons of the failure...