ART Installation guide

Before you start:

Hardware Requirements

  • Any VMware Server
  • Intel Dual-processor Pentium 4 or better.
  • 1 GB RAM
  • 100 Mbps or faster NIC
  • Free disk space (for a 500-node site): 70 GB (May require 200GB free temporarily during install)
  • A second VM running Microsoft Windows, as an assistant to the ART VM

Software Requirements

  • TSM Server Version 5.4 or higher

Network Requirements

  • Network access to all monitored TSM servers
  • You may need to resolve firewall issues

In Short:

  • Download and unzip the ART virtual appliance from our download page.
  • Import the Appliance. From VMware, use File, Import, and select the downloaded .ova file. Accept the License agreement.
  • Setup Windows Assistant: setup ssh server and dsm.opt files.
  • Setup ART: Browse to the IP address shown under “Getting Started with ART”, on the VMware console.  Request a trial license from if you don’t have one. Set up your TSM servers.
  • Execute: Click the “Start a New Sweep” button on the dashboard. 

In Detail:

Download and start up the  ART virtual appliance.

  1. Download the ART VM, in ova format.
  2. From VMware, use File, Import, and select the downloaded .ova file. Accept the License agreement.

Setup Windows Assistant.

A Windows emulator is built in to ART, but will not physically restore files that were backed up with TSM 7.x clients.  Using the emulator makes it easy to run a quick evaluation.  Setting up Windows Assistant to replace the emulator is optional, but will physically restore those files and is recommended for production use.

  1. Find or create a Windows machine (the “Windows Assistant”) that can be dedicated to ART. Any version of Windows that supports a current version of the TSM client is sufficient.
  2. Install a current TSM client (version 6.4 or later).
  3. Create Windows User named “art”. Make art an administrator, or at least give it backup files and restore-files permission so it can run dsmc.exe.
  4. Run sysdm.cpl, Advanced, Environment Variables; Set system variables
    1. PATH [to include where dsmc lives – suggest it be first in the PATH string)
    2. DSM_DIR
    3. You may have to reboot machine so an ssh session to the Windows Assistant will see those variables.
  5. For each TSM server that ART is configured to test, create a  SERVERNAME.opt file in  “C:\Users\art\dsmoptions (create the dsmoptions dir)., e.g. “TECTSM02.opt”. The SERVERNAME must match that shown in ART’s TSM Servers tab.  Each of these files must have at least:
    1. NODENAME _art_windows
  6. Install sshd
    1. We recommend Bitvise SSHd server; select Personal Edition; restart windows
    2. copy (Cut and paste works well) /home/art/.ssh/ public key over to windows box, into, say, SSHPUBKEY.txt
    3. Run C:\program Files\Bitvise SSH Server\bssctrl.exe (ie, their control panel)
    4. Easy settings, windows user art, import key from SSHPUBKEY.txt file (see above)
    5. Activity Tab, popup notifications, Never (unless you need debugging help)
    6. Adv settings, algorithms, signatures, enable ssh-dss
  7. Test: from ART VM:  ssh art@[ip-of-windows-assistant] dsmc q se should return a few lines.

Setup ART

ART is web-based. Point your browser to the IP address shown on the VMware Console under “Getting Started with ART”.

Click “Login” (upper right), and log in as “art”, password “Tsmworks9!”.

Click the “Preferences” tab.  Choose the emulator, or enter the IP address of the Windows Assistant. Click “Save Basic Settings”.

Click the “TSM Servers” tab.  A window will open asking for your license. Contact for a free trial license.

Copy all four lines (not just the “key=xxx” part) from your the Trial License email,  paste it into ART’s license window, and click Submit.  The license looks like this:

name=My Corp 

Return to the “TSM Servers” tab, then click “Add”.  Enter your TSM server’s contact information.  Repeat for other TSM servers.

Click the “Preferences” tab, and review the Basic Settings. Float your mouse over each field for explanations.


Click the Dashboard tab, then “Start a New Sweep”.

Wait for the first test to physically restore files.  The dashboard refreshes automatically, and Sweep 1 should begin to show progress in 5 minutes or so. Hover the mouse over the pause and stop buttons to the left of the sweep, to see how to control it.  Below is a dashboard that has run 7 sweeps already.


Use the Accounts tab to change the administrator password or add yourself as a new administrator; replace with your email address, and ART will email you a summary report after it completes each sweep.

You can also schedule automatic sweeps using crontab, Autosys or other scheduler.  Just have the scheduler run “/home/art/script/sweeper_daemon”  as user “art”.  See our FAQ for details.