wiki:Backups

Backing Up Address Book Server

Automated Option

Install the client component on your server and configure the license key and host address via System Preferences. In the DMG download navigate to the Schedule / Server Backup folder and execute the Install Auto Backup on Leopard.command script. This will open up Terminal and install the daily backup schedule. Verify that a backup has been created via the web interface. Going forward every 24 hours a new backup file will be created.

Manual Option

The backup is triggered either via System Preferences or using the command line tool

/Library/Application Support/AddressBookClient/BackupTool

from any of the configured clients. This will create a new backup file of the database on the server in the following folder :

/usr/share/addressBookServerEnterpriseEdition/AddressBookServer[Timestamp].zip

To automate the backup you can either use cron or launchd. You might want to consider installing the client on the server as well to run the backup locally. After installing and configuring the host address and license on the client you can disable the client, unless you want to sync the servers Address Book as well.

Using Cron

From one of the user accounts configured to access the server open up Terminal and enter the following command:

crontab -e

This will start you favourite editor (VI). To enable daily automated backups at midnight add the following entry to the file

0 0 * * *       /Library/Application\ Support/AddressBookClient/BackupTool

More information about cron can be found in 'man -s 5 crontab'

Using launchd

The following configuration file will backup the server daily. Copy this file to the ~/Libarary/LaunchAgent? folder and then run the load command to initiate the first backup cycle.

launchctl load -S Background ~/Library/LaunchAgents/com.addressbookserver.backup.tool.plist

On Tiger (10.4) use the following command:

launchctl load ~/Library/LaunchAgents/com.addressbookserver.backup.tool.plist

Configuration file (attached)

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>Label</key>
	<string>com.addressbookserver.backup.tool</string>
	<key>LimitLoadToSessionType</key>
	<array>
		<string>Background</string>
	</array>
	<key>Program</key>
	<string>/Library/Application Support/AddressBookClient/BackupTool</string>
	<key>StartInterval</key>
	<integer>86400</integer>
</dict>
</plist>

Restore Address Book Server Backup

PostgreSQL users

Details on backing up Postgresql are available on the Postgresql configuration page