Undeploy an archive with gasadmin

When you undeploy an Genero Archive (gar) file, the archive is no longer deployed and cannot be reactivated.

Enter the gasadmin command with the appropriate arguments.

To undeploy a Genero Archive (.gar) file named fuzzy.gar:

gasadmin gar --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 gar --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 succeeded.
Genero archive successfully deployed.

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

What to do next:

If you want to physically remove an undeployed archive, follow the instructions in Clean up undeployed archives.