macOS: Install and configure backup software
Downloading backup software
- Download the latest Storage Protect software from the IBM website. To do this, open both of the following links and select the more recent version:
- Select the latest version of the software and download the file with the extension.dmg. This is usually the largest file in the directory.
- Compare the checksum of the file with the one specified on the manufacturer’s website in the download directory:
shasum -a 256 8.1.*-TIV-TSMBAC-LinuxX86.tar
For older client versions with MD5 hash use md5 instead of shasum -a 256 as command.
Adjust keyboard layout
If you want to run the client via the command line (or via a cron job), you should check whether the keyboard layout you are using is recoginzed.
To do this, start a terminal (as the root user) and type:
sudo dsmc
In case you get the following note when running the client
ANS0102W Unable to open the message repository /Library/Application Support/tivoli/tsm/client/ba/bin/DE_AT/dsmclientV3.cat. The American English repository will be used instead.
create a link to a similar keyboard layout (e.g. DE_DE) in the folder /Library/Application Support/tivoli/tsm/client/ba/bin/ according to the layout mentioned (in this case DE_AT):
cd /Library/Application\ Support/tivoli/tsm/client/ba/bin/
ln -s DE_DE/ DE_AT
Go to the Include/Exclude section in the left column to change your backup rules.
The Include/Exclude rules are read from bottom to top. If you exclude a file or an entire file system from the lower part of the include/exclude list, it will be ignored, even if it is explicitly mentioned above.
For example, the following definition
include /Users/user01/test/test.fileexclude /Users/user01/.../*
would not save the file test.file since the folder has been excluded before.
However, if you write the lines in reverse order, the test.file file is saved as the only object in the directory:
exclude /Users/user01/.../*include /Users/user01/test/test.file
You can find possible Include/Exclude rules on the IBM websites:
To create a new rule, click on Add on the right-hand side and select the desired items from the drop-down menus according to your specifications.
Saving password
To avoid entering a password when starting the backup client, the password can be saved.
- To do this, open the Client settings under the menu item Edit and select the Authorization area on the left.
- Select the item Generate password and press Apply.
This option must be selected if you want to automate the backup.
If you have defined an automatic scheduler task, make sure that when you log in to the backup client again, the password is saved and does not have to be re-entered.