Enterprise Edition Home | Express Edition Home | Previous Page | Next Page   Overview of the ON-Bar Backup and Restore System > Setting ON-Bar Configuration Parameters > Setting ON-Bar Parameters in ONCONFIG >

BAR_BOOT_DIR (XPS)

onconfig.std value
/usr/informix/etc
if value not present
blank
takes effect
When the next onbar-worker process starts

The BAR_BOOT_DIR configuration parameter allows you to change the directory path for the emergency boot files. You must specify it in the global section of the ONCONFIG file.

Accessing the Emergency Boot Files

The onbar_w, onbar_m, and onbar_d utilities must be able to access the directory that you select for the emergency boot files. All coservers must be able to write to the directory for user root. The BAR_BOOT_DIR parameter is designed to be used on a system where the INFORMIXDIR directory is shared but the root user does not have write permissions to the INFORMIXDIR directory. For example, you can set BAR_BOOT_DIR to the /var/informix directory on a multinode system. Because each node has its own /var file system, it prevents read/write permissions problems.

If you change the BAR_BOOT_DIR value while an onbar-worker process is running, it will use the old value. Any new onbar-worker process started after the change will pick up the new value.

Warning:
After you change the BAR_BOOT_DIR value, you must kill all onbar-worker processes on all coservers. When the processes end, either perform a level-0 backup of all storage spaces or move the files from the etc subdirectory to the new location.

Saving the Emergency Boot Files During Reversion

When you revert to an earlier database server version, the reversion script saves the emergency boot files in the directory that the BAR_BOOT_DIR parameter specifies. Otherwise, the reversion script saves the emergency boot files to the $INFORMIXDIR/etc directory if BAR_BOOT_DIR is not set in the ONCONFIG file or is set to an invalid directory.

Enterprise Edition Home | Express Edition Home | [ Top of Page | Previous Page | Next Page | Contents | Index ]