- A bash script named
customize.sh
in the root of the ZIP archive. This file must satisfy the requirements listed below. - Support files needed by the script. Common support files include
.crt
and.key
files for certificates, but you can include any file types you want. Support files can be organized into subfolders within the ZIP archive if desired.
Customization package installation folder
When a customization package is uploaded to a target DNS server, its contents are extracted to the following directory:
/home/bluecat/preserved_scripts/customizations/
Commands and actions in the script must assume that it can be run from that folder.
customize.sh
script needs to copy or store data
files as part of a backup or restore operation, you can store them within this
folder.Customization package calls and return values
BSUS will call customize.ph
before and after the upgrade, with the
following parameters.
Parameter | Description |
---|---|
-b |
Called by BSUS just before an
update is applied, if preliminary checks passed
( Expected actions: When the If backup actions need to create additional backup data files,
they can be safely stored in the Return value: If successful, the script should return 0. If the backup operation was unsuccessful, the script should return a non-zero value. If the an unsuccessful (non-zero) result is returned for any server in a Server Batch, BSUS will abort the update operation for that Batch and report the returned value in its event log. Tip: If no backup actions are needed, you can simply
have the script return 0 when
-b is
used. |
-r |
Called by BSUS just after an
update is applied, if the update was successful
( Expected actions: When the Return value: If successful, the script should return 0. If the restore operation was unsuccessful, the script should return a non-zero value; BSUS will report the returned value in its event log. |