Knowledge Base: SETUP : Troubleshooting: DS-Client Workaround for Mac OS X (10.6 Snow Leopard) Auto-Mount Configuration
 
Troubleshooting: DS-Client Workaround for Mac OS X (10.6 Snow Leopard) Auto-Mount Configuration
Creation Date: March 25, 2010
Revision Date: May 12, 2010
Product: DS‑Client (Macintosh)
Summary
This article applies only to DS-Clients running on Mac OS X 10.6 (Snow Leopard).
With the release of Mac OS X 10.6, Apple removed the public API for listing exported volumes. As a result, although the ability to mount volumes and access data remains, the Mac DS-Client is unable to obtain the available volumes for backup. This limitation affects backup set creation, editing backup sets, and restoring data to alternate locations.
This means a default DS-Client installation running on Mac OS X 10.6 cannot use auto-mount backup sets (agentless backup for Mac OS X using Mac-specific API). These are backup sets created by browsing for active Mac volumes on your network (New Backup Set Wizard > Select the computer screen: Local File System\Auto Mount).
The rest of this article deals with a temporary workaround.
Configuring the Mac DS-Client for auto-mount backup
To bypass the limitation caused by removal of the Apple public API from OS X 10.6, the Mac DS-Client can use two configuration files named “mountpoints.cfg” and “mountpoints.permissions”. Both are plain-text files, which for a default installation must be located in /Library/CloudBackup/DS-Client/automount/.
The file mountpoints.cfg contains all the available mount points on the remote machines that will be made available by the DS-Client via the DS-User.
The file “mountpoints.permissions” contains the permission rules which will grant or deny users the right to authenticate (i.e. wrong credentials will fail) with the mount points listed in “mountpoints.cfg”.
IMPORTANT:  The credential files you create must be kept secure, since they contain network credential information in clear text. Do not create these files unless their use conforms to you company’s network / security policies.
File format and example: mountpoints.cfg
The file “mountpoints.cfg” contains computer name / volume name pairs, separated by a colon (:) where computer name may be a local domain name or an Ipv4 address). The ‘#’ character denotes a comment and entries following it will be ignored.
The following is a sample mountpoints.cfg file (/Library/CloudBackup/DS-Client/automount/mountpoints.cfg):
# format = <Machine name or IP>:<shared volume name>
MacMach.local : Dave's Public Folder
MacMach.local : Macintosh HD
AppleMach.local : Mac Hard Disk
# IP works too
192.168.100.101 : Macintosh HD
192.168.100.101 : Mac HD2 #another comment
File format and example: mountpoints.permissions
The file mountpoints.permissions processes each line as one rule. A rule dictates which users are allowed to authenticate with the listed mountpoints. It is formatted as follows:
<mountpoints> % <user permissions>
The mountpoint list is composed of double-quoted items with comma as a separator. Each item must specify the machine name (or IP) followed by a colon (':') and then the exact mountpoint name or wildcard ('*') to denote all mountpoints (e.g. “MacMach.local:Macintosh HD”). You can exclude an item by using the minus (‘-) sign before the machine name or IP address.
The user permissions list is composed of keywords (cAsE-sEnSiTiVe) and usernames with comma and whitespace as separators. Any user names after the keyword “ALLOW” will be allowed to authenticate with the corresponding mountpoint list. For rules that are intended to apply to all users, the keyword “EVERYONE” can be used. To exclude certain users from the permissions list, place the user names after the keyword “EXCEPT” (note: “EXCEPT EVERYONE” will deny all users right to authenticate with the corresponding mountpoint list). These user names must also be defined on each corresponding machine where they attempt to authenticate.
The following is a sample mountpoints.permissions file (/Library/CloudBackup/DS-Client/automount/mountpoints.permissions):
# format = <Mountpoint list> % <Users permissions list>
# allow “dave” to authenticate with “Dave's Public Folder” on
# any machine
“Dave's Public Folder” % ALLOW dave
 
# allow dave and alice to authenticate with “Mac HDD” on
# MacMach.local
“MacMach.local:Mac HDD” % ALLOW dave, alice
 
# allow everyone except dave to authenticate with “Macintosh
# HD” on MacMach.local
“MacMach.local:Macintosh HD” % ALLOW EVERYONE EXCEPT dave
 
# allow alice to authenticate with all mountpoints on
# AppleMach.local except “Mac HDD”
“AppleMach.local:*”, “-AppleMach.local:Mac HDD” % ALLOW alice
 
# IP works too
“192.168.100.101:Mac HD2” % ALLOW EVERYONE #in-line comment
Changes to these configuration files do not require a DS-Client restart. They will take effect upon the next activity.