System Administrator Guide : 6. Customizing Vector
 
Share this page                  
Customizing Vector
 
Archiver Exit Script (acpexit)
Archiver Exit Script (acpexit)
The Archiver Process Exit command script (acpexit) is executed by the archiver when it gets an error it cannot process that requires the archiver process to shut down.
This shell script resides in the files directory. You can use the default script behavior, which sends mail to the installation owner account with the reason for the archiver failure, or you can edit the script to customize certain aspects of archiver recovery.
Because the archiver writes sequentially to the end of journal files, a problem occurs when the archiver stops as a result of running out of journal disk space. If left unresolved, running an installation without an archiver (and with journaled databases) eventually causes the log file to fill.
To address this concern, whenever the archiver detects an error condition that forces it to stop (including running out of journal disk space) it first executes the archiver exit script.
Customization of Archiver Exit Script
You can modify the archiver exit script to act appropriately to your installation. For example, one possible course of action is to delete a reserved file on the journal disk to free up space and restart the archiver.
You can customize the archiver exit script in these respects:
The default script sends mail to the installation owner account when archive processing halts and includes the reason for the failure. You can modify this script to notify the system administrator directly of a situation that needs resolving.
You can tailor the script to handle certain resource and environmental problems automatically. For example, if archive processing has stopped because of insufficient disk space, the script can automatically reclaim disk space and resume archive processing.
The default script is executed with one or two arguments, described in Archiver Exit Script Parameters. You can choose whether to incorporate these arguments if you customize the script.
The default script includes examples of processing you can use for your installation. These examples are formatted as comments and can be included in the script by removing the comment prefixes.
Archiver Exit Script Parameters
The archiver exit script parameters are as follows:
Parameter
Description
Status
errornumber
An error number that describes the reason archive processing has stopped. At the end of the default script is a list of all possible error numbers, with an explanation of the error and, in many cases, the recommended actions to correct the error.
Always passed in default script.
database_name
The name of the database that was being processed at the time archiving stopped. The name is provided only if the halt in archive processing was associated with a particular database problem, as opposed to a general system problem.
Sometimes passed in default script.