Kbase P118331: How does rfutil archiver setdir work?
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
4/30/2009 |
|
Status: Verified
GOAL:
How does rfutil archiver setdir work?
GOAL:
How does proserve <dbname> -aiarcdir work?
GOAL:
How does aiarchiver work
FACT(s) (Environment):
All Supported Operating Systems
OpenEdge 10.1x
FIX:
The following command syntax will start a database which has been enabled to use the aiarchiver daemon and have the daemon write full AI files to the /tmp/aifiles dir as an example:
proserve <dbname> -aiarcdir /tmp/aifiles
The following command syntax is used to redefine for the AI Archiver tool for which directories to copy FULL After Image Extents:
rfutil <databasename> -C aiarchiver setdir <dirlist>,<dirlist2>
All extents archived by the automated management daemon are "copied" to an output directory specified at database startup time using the ?aiarcdir <dirList> argument or modified by the rfutil aiarchiver setdir command.
These methods (-aiarcdir on database start or rfutil aiarchiver setdir) enable the user to specify up to 10 destination directories to be used for the archived extents.
Specifying multiple output directories allows the archive operation to use another directory as a destination if the primary output destination is filled to capacity, i.e. the disk fills up.
Before extents are archived, the free space in the current archive directory is verified.
If the current directory does not have the enough free space, i.e. the disk device is FULL, the next directory, if any, specified by the ?aiarcdir <dirList> argument is used as the target for the archival.
Each directory in the ?aiarcdir <dirList> list is used until all directories in the list become FULL. If there is no free space in any of the archival directories, a message is logged at regular intervals to the database log indicating that the archival directories are FULL and extent archival is no longer being performed.
The user then has the option of issuing a RFUTIL database ?C aiarchiver setdir dirList command to specify a new set of archival directories. In the event that ALL AI extents become filled and the directory list has been processed and are all FULL, the database will stall, if the -aistall parameter was also specified at database startup time.
The daemon process will attempt to prevent an AI stall by insuring that there are always EMPTY extents. If during normal processing the daemon determines that the number of EMPTY extents is low it will archive and then EMPTY any FULL extents. However, careful AI planning is required when Replication is active and extents remained LOCKED because they are not replicated. LOCKED extents cannot be emptied.