Automatic backups via ISP Client Acceptor (CAD) or via Crontab/Schedule
With an automatic backup there is the possibility to let the ISP server control the automatism(CAD). The second possibility is to control this as a user via crontab (Linux) or a schedule (Windows).
Configuration of the automatic backup (CAD) for Unix and Windows systems
UNIX
The ISP client is configured so that the scheduler process performing the backup is managed with the ISP client acceptor (CAD).
The CAD provides a simple timer that automatically starts and stops the scheduler process as needed.
Therefore, it is no longer necessary to use exclude/include after changes to the "dsm.opt", "dsm.sys " option files and the file referenced by the "inclexcl"option.
with exclude/include statements, there is no need to worry about restarting the ISP scheduler.
If you follow the suggestions of the SCC, you will find the following file after starting the CAD in the directory
/usr/local/tsm/log
you will find the following LOG files:
- dsmerror.log: Error messages of the ISP scheduler
- dsminstr.log: Instrumentation log file
- dsmsched.log: Messages of the ISP Scheduler
- dsmwebcl.log: Messages of the ISP Client Acceptor (CAD).
However, the CAD may only be started after the ISP password has been set.
Setting the ISP password (saving the ISP password in a file in the directory /etc/adsm)
is usually done by starting a backup for the first time.
The start of the TSM client acceptor process is possible in two ways in principle:
init or systemd
Check which startup type is applicable for your computer.
For this you can use the command ps -p 1.
init-Start
For the automatic start of the CAD on your machine save the file dsmcad file into the file
/etc/init.d/dsmcad.
Set the permissions of this file as follows:
chmod 500 /etc/init.d/dsmcad
chown root.root /etc/init.d/dsmcad
Please adjust in this file if necessary the value of the environment variables LANG, LC_CTYPE
and the path for -errorlogname and -instrlogname.
Enable the service for automatic startup at boot time:
/usr/sbin/update-rc.d dsmcad defaults
You can start the CAD manually with the following command:
/etc/init.d/dsmcad start
systemd start
For the automatic start of the CAD on your machine save the file dsmcad.service into the file
/etc/system/system/dsmcad.service.
Please adjust in this file if necessary the value of the environment variables LANG, LC_CTYPE
and the path for -errorlogname and -instrlogname to your circumstances.
Enable the service for automatic startup at boot time:
/usr/bin/systemctl enable dsmcad.service
You can start the CAD manually with the following command:
/usr/bin/systemctl start dsmcad.service
WINDOWS
Installation of the services "ISP Scheduler" and "ISP Client Acceptor
For the automatic backup you have to install two services on your computer:
- ISP Scheduler
- ISP Client Acceptor
The installation of the services may only be performed after the ISP client has been started for the first time with successful entry of the ISP password provided. (see section "Contacting the ISP")
The ISP Scheduler is managed by the ISP Client Acceptor (CAD). The CAD serves as an external timer for the scheduler. When the scheduler is started, it asks the TSM server (is it still called TSM SERVER?!!for the next scheduled event. The event is either executed immediately, or the scheduler is terminated. The CAD will restart the scheduler when the time comes to execute the scheduled event. This reduces the number of background processes on your workstation and avoids memory retention issues that can occur when the scheduler is running without CAD management. The services can be installed as follows:
1. possibility) Execute a batch file
Save the filetsm_services_install on your computer: e.g. in the directory c:\temp\tsm_services_install.bat
Execute this file. Please pay attention to the output messages.
2. Possibility) Entering the necessary commands in a "Command Prompt" window
Open a "Command Prompt Window".
Then change to the directory "c:\Program Files\Tivoli\TSM\baclient", for example:
cd /d %ProgramFiles%\Tivoli\TSM\baclient.
In this directory you will find the dsmcutil utility and the corresponding help file "dsmcutil.chm".
Step 2a) Installation of the ISP Scheduler
dsmcutil install /name:TSM-Backup-Scheduler /node:<tsm-nodename> /autostart:NO /startnow:NO /password:tsm-passwort
Step 2b) Installation of the ISP Client Acceptor (CAD)
dsmcutil install CAD /name:TSM-Client-Acceptor /node:<tsm_nodename> /cadschedname:TSM-Backup-Scheduler /autostart:YES /startnow:YES /password:tsm-passwort
In the directory %ProgramFiles%\Tivoli\TSM\baclient you will find the following important LOG files:
- dsmerror.log: Error messages
- dsminstr.log: Instrumentation log file
- dsmsched.log: Messages of the ISP scheduler
- dsmwebcl.log: Messages of the ISP Client Acceptor (CAD)
Configuration of the automatic backup by schedules for Unix and Windows systems
UNIX - Backup via a Crontab entry
Save the batch file in a suitable directory as shell script (e.g. dsmc_incr).
In the crontab entry you define, you then reference the shell script that was sent along with it.
Example entry:
30 12 * * /<your_path>/dsmc_incr >/dev/null 2>/dev/null
The files generated by the dsmc call
- dsmerror.log: Error messages of the backup
- dsminstr.log: Instrumentation log file
- dsminstr.log.lock
- dsmcincr.log: Log file of the backup
are stored in the directory /var/tmp.
You can change this location to suit your needs at any time in the shell script provided.
The variable pfad_tsm_log_dateien is used for this purpose.
WINDOWS - Backup with a schedule
Save the batch file in a suitable directory as a .bat file (e.g. dsmc_incr.bat).
This batch file is then referenced in the task schedule you define.
The files generated by the dsmc call
- dsmerror.log: Error messages of the backup
- dsminstr.log: Instrumentation log file
- dsminstr.log.lock
- dsmcincr.log: Log file of the backup
are stored in the directory c:\Users\AppData\Local\Temp.
You can adjust this location to your needs at any time in the included script.
The variable path_tsm_log_dateien is used for this purpose.