Salesforce

How to manage the aiarchiver daemon online

« Go Back

Information

 
TitleHow to manage the aiarchiver daemon online
URL NameP183482
Article Number000130948
EnvironmentProduct: OpenEdge
Version: 10.1x, 10.2x, 11.x, 12.x
OS: All supported platforms
Other: AIMGT
Question/Problem Description
How to manage the aiarchiver daemon online?
Can the AIMGT daemon be stopped while the database is running?
Can the aiarchiver daemon archive interval be changed from timed to on-demand?
How to change the archiving directory location while the AIMD is running?
How to restart the AI Management deamon online after it has been stopped?
How to restart aiarchiver daemon after it has been stopped, without restarting the database?
Can archiving be disabled online or does the database have to be stopped first?
How to enable the AI Management feature online?
Why can ai files not be emptied with RFUTIL when the database is enabled for AI Management?

 
Steps to Reproduce
Clarifying Information
Error Message
Defect Number
Enhancement Number
Cause
Resolution
The following are some useful Options relating to the AI Archiver database feature that can be changed while the database is online and the AIMGT daemon is active:

Note: The -aistall parameter will be automatically be set to enabled while the ai archiver is enabled, this is a requirement. 
  • Re-set the archiving interval online with an active AIMGT daemon,
$   rfutil dbname -C aiarchiver setinterval <n>

The AIMGT daemon executes in 'timed' mode when "n" is a value between 120 and 86,400,
or when n is set to (zero) 0, the archive interval is set to 'on demand' as opposed to 'timed'. 
 
  • Change the archiving directory location.
$   rfutil dbname -C aiarchiver setdir <new directory location, full paths, comma separated, no spaces, max 512 chars>
  • Stop the daemon running online.
$   rfutil dbname -C aiarchiver end
  • Restart the AI deamon online:
$   proshut dbname -C aimgt -aiarcdir <archive-directory-Path> -aiarcinterval n [-aiarcdircreate]
  • Disable archiving online
$   rfutil dbname -C aiarchiver disable  
  • Enable AI Management online
Since OpenEdge 10.1B, AI Management can be enabled online with PROBKUP:

$   probkup online dbname dbname.bak enableai enableaiarchiver -aiarcdir <dir>,<dir> [ -com -vs 250000  -aistall < $BKFILEVOLS ]
  • Verify the AI Management status
Since OpenEdge 10.1C, the AIMGT feature can be verified with: proutil dbname -C describe.
Since OpenEdge 11.3, the archiving mode is additionally reported under the "Details" column.
For further information refer to Article  How to check if the AI Archiver is running?  

Database Features

ID   Feature                               Active  Details
  ----  ---------------------------------  ------  -------
     8  After Image Management/Archiver    Yes     Timed 120
  • Manually Archive Extents online
$   rfutil dbname -C aiarchive nextextent

OpenEdge 10.1B and later:  AIARCHIVE NEXTEXTENT will force any FULL extents to be archived online whether the AIARCHIVER is running, or has previously been stopped online with RFUTIL -C AIARCHIVER END for example. It cannot be run offline.

$   rfutil dbname -C aiarchive extent <source-ai-extent> target/aifilename

OpenEdge 10.1B and later:  AIARCHIVE EXTENT can be used to manually archive extents when AIMGT is enabled but not running.
AI files can be manually archived and emptied when the AIMGT daemon is inactive online or after the database has shutdown, offline (and the AI Manager deamon is therefore not running). 
AI extents can be archived and marked empty (or Archived in the case they are LOCKED by replication) with RFUTIL AIARCHIVE EXTENT, but not with RFUTIL AIMAGE EMPTY when the AI Archiver feature is enabled.
When used offline, RFUTIL AIARCHIVE EXTENT can be used provided there are sufficient space in the current AI file or enough AI files to switch to in order to record bi recovery Redo and Undo notes. Specify a target directory with sufficient disk space.

For further clarification refer to Article  RFUTIL -C AIARCHIVE NEXTEXTENT vs AIARCHIVE EXTENT   
 
 
Workaround
Notes
Keyword Phrase
Last Modified Date2/16/2022 2:56 PM

Powered by