apgupd is the mechanism through which client instances communicate with the IFI primary instance and the only method of obtaining new or updated content for the client PostgreSQL database. You will need authentication credentials from IFI CLAIMS in order to communicate with the IFI primary server.
Usage
apgupd [ Options ... ]
apgupd Options
--------------------------------------
--url=URL URL for update methods
default: http://cdws21.ificlaims.com
--user=s User name default: test (will fail)
--password=s Password default: test (will fail)
--noindex Don't queue up indexing
--force Force the update even if it is redundant
--tmp=dir Specify temporary file storage. default=/tmp/
--pgdbname=s Specify configuration database entry
default: alexandria
--facility=s Logging facility (default=apgupd)
--noclean Do not remove temporary processing directory. Default is to clean.
NOTE: this option should only be used to debug errors
--apgupexe=s Specify non-default apgup script (used for debugging)
Default is apgup as found in PATH environment
Process Options
--------------------------------------
--nodaemon Don't put process into background. Default is to daemonize
--interval=i n-seconds between probing for new updates. Default=10
--die-on-error
Exit on error. This will terminate the process in
case of an error at any stage of the update
--help Print this usage and exit
Detailed Description of the Arguments
General Options
| Argument | Description | Default Value |
|---|---|---|
--url | Used for support. The web service url. This argument should only be used when specified by CLAIMS Direct support staff. | http://cdws21.ificlaims.com |
--user | Your CLAIMS Direct user name | test |
--password | Your CLAIMS Direct password | test |
--noindex | When specified, the indexing queue will not be populated. | N/A |
--force | If a load-id has been previously processed, default behavior is to skip it. If specified, the load is processed regardless. | N/A |
--tmp | The temporary processing location. The update packages will be downloaded to this area, unpacked, and loaded. Generally, 10-20GB is sufficient. | /tmp |
--pgdbname | The name of the configuration database entry as specified in /etc/alexandria.xml | alexandria |
--facility | Logging facility. Changing from the default value assumes a logger has been defined in /etc/alexandria-log.conf | apgupd |
--noclean | Used for debugging. When specified, the downloaded package and temporary directory will not be removed after processing. | N/A |
--apgupexe | Used for debugging. When specified, an alternative update process will be called to load and merge the package. | apgup |
Process Options
| Argument | Description | Default Value |
|---|---|---|
--nodaemon | When specified, apgupd will run in the foreground. ctrl+c can be used to cancel it. | N/A |
--interval | The interval (in seconds) between subsequent update checks. | 10 |
--die-on-error | When specified, any error at any stage of the update process will cause apgupd to exit. | N/A |
Daemon Execution
Starting
# all defaults $INSTALL_BASE/bin/apgupd --user=x --password=y # use a specific temporary work area $INSTALL_BASE/bin/apgupd --user=x --password=y --tmp=/some/place/with/fast/disk # do not background process $INSTALL_BASE/bin/apgupd --user=x --password=y --nodaemon
Pausing/Resuming/Stopping
apgupd explicity handles 3 signals: USR1, USR2, INT
# Pause the daemon kill -s USR1 <pid> # Resume processing kill -s USR2 <pid> # Stop daemon completely kill -s INT <pid>