Install the IBM Spectrum Protect client: macOS

Storage and backupsStorage and backups

These instructions have been updated for macOS 10.14 and up (Mojave and up).

Part 1: Register your computer for TSM

To register your computer, visit the online administration page. Login with your primary NetLink ID and password.

  1. Click on Create, located under Nodes.

  2. Name your node appropriately by following the instructions on the administration page. Nodes have three components that must combine to make a unique name within TSM:

    • The first component is your department code. Select the appropriate one from the drop-down list (by default, the department you are associated with will appear at the top of the list).
    • The second is a sub-group name within your department. You can enter a pre-existing sub-group or create your own.
    • The third can be anything you wish. You can also create an additional sub-group by separating values with a period.

Be sure to select your operating system from the corresponding drop-down list and click Create. If necessary, you can rename or remove accounts after they have been created.

 

Part 2: Download and install the TSM client

 

For macOS 10.14 and up (Mojave, Catalina, Big Sur and Monterey):
IBM Spectrum Protect 8.1.14.0

Download the dsm.sys and dsm.opt configuration files here: TSM configuration files

 

  1. Download the IBM Spectrum Protect client at the link above as well as the configuration files. 
  2. A window should open. Save the file to your computer.
  3. Find and double click on the file to mount the IBM Spectrum Protect disk image on your desktop.
  4. Double click on the IBM Spectrum Project.pkg package to begin.

    spectrum protect installer
  5. Click Continue on the Introduction page.
  6. Click Continue on the Read Me page.
  7. Click Install.
  8. Enter your computer's Administrator name and password. Once the installation is complete, click Close.
  9. In the Finder, navigate to the IBM_Spectrum_Protect_dsm_files.zip folder downloaded at the beginning of Part 2 above and double-click it to open the folder.       
  10. Drag both dsm.sys and dsm.opt into the Tivoli Storage Manager folder as indicated in the screenshots below. If dragging does not work, save to desktop then move to Tivoli Storage Manager folder located in the Root Library. The folder is located here: Macintosh Hardrive/Library/Preferences/Tivoli Storage Manager or you can follow the steps below:

    screenshot of a macOS finder window showing how to navigate to the mac's root hard drive folder
    Navigate to the root Macintosh Hardrive folder on your mac. 

    screenshot of a finder window with navigation to the Library folder in Macintosh Hardrive
    You should see the Library folder within the Macintosh Hardrive folder.

    screenshot of a finder window in macos showing navigation to application preferences within the library folder in macintosh hardrive
    Inside the Library folder is a Preferences folder.

    screenshot of a macos finder window navigating to the tivoli storage manager folder inside preferences in the library folder of macintosh hardrive
    Navigate to the Tivoli Storage Manager folder within Preferences. This is where the configuration files need to go.

  11. Open the dsm.sys file with the 'TextEdit' application
  12. Find the the 'NODENAME' section in the dsm.sys file (pictured below) and replace the ENTER.NODENAME.HERE text with the node name you created in Part 1 above. image
  13. If you wish to give a non-admin user account the ability to perform backups, add the following line into the dsm.sys file above the NODENAME entry, replacing username with the user account name:
    passworddir "/Users/username/Library/Preferences/Tivoli Storage Manager"
    
    tivolie_dsmsys_step2.png
  14. In the Finder, navigate to the Applications folder and then open the IBM Spectrum Protect folder. Double click on IBM Spectrum Protect Tools for Administrators.

    imageimage
  15. Select IBM Spectrum Protect and click OK. Enter the credentials for an administrator account when prompted.

    spectrum protect menu
  16. If prompted for a TSM Login, click CANCEL.

    node password
  17. On the next screen, click OK.

    tsm operation stopped
  18. When asked if you wish to continue, click Yes.

    local update warning

  19. In the new IBM Spectrum Protect window, click Edit in the top menu and select Client Preferences.

    client prefs menu

  20. Under Common Options, update the Node Name field (ENTER.NODENAME.HERE in this example) with your personal TSM node name.

    preferences enter node

    In the left sidebar, click the Authorization button.

    sidebar click authorization
  21. Under the section "Password access" edit the line under Password Generate:

    Location: /MacintoshHD/Library/Preferences/Tivoli Storage Manager,  or the correct hard drive name if not MacintoshHD


    A screenshot of the password generation window within Tivoli Storage Manager authorisation settings.
     
  22. Click the Apply button. If a warning box appears, click the OK button. Finally, click the OK button in the preference editor window. 

    ***If you are using Apple's Time Machine to back-up your computer, you MUST exclude time machines back-ups from TSM. Click here for step-by-step instructions for excluding Time Machine back-ups from IBM Spectrum Protect back-ups.
      
  23. Quit IBM Spectrum Protect.
  24. In the Finder, navigate to the Application folder and open the IBM Spectrum Protect folder. Double-click on IBM Spectrum Protect for Administrators.
  25. When prompted, enter the password for the TSM node. After you enter the password, press the Login button.

    TSM Mac node password
  26. Configuration is now complete.

See the document TSM initiate overnight backups: Mac OS X for further instructions.