restore_daemon - Teradata Data Mover

Teradata Data Mover User Guide
Product
Teradata Data Mover
Release Number
16.10
Published
June 2017
Language
English (United States)
Last Update
2018-03-29
dita:mapPath
kmo1482331935137.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-4101
lifecycle
previous
Product Category
Analytical Ecosystem

Purpose

The restore_daemon command allows you to restore the previously backed up repository and configuration files of the Data Mover daemon from a directory that you specify. The Data Mover daemon is stopped and then restarted when you run the restore_daemon command. Results of the Teradata ARC script that is used to perform the backup are written to a log file restore_script.output in the backup directory. The restore_daemon command can only be used if restoring a Data Mover repository that has the same hash algorithm as the Data Mover repository that was backed up by the backup_daemon command.

Syntax

http://schemas.teradata.com/unity/DataMover.xsd

Parameters

See Parameter Order.

backup_target_dir
The directory from which Data Mover restores the backup files. The location you specify can be:
  • A path relative to the daemon_backup directory. This is a directory reserved for all backup snapshots.

    If the path is relative, enter the name of the directory that contains the backup files. Never use an initial slash when specifying a relative path.

  • An absolute path. This is any location on the system for which dm_user has write privilege. restore_daemon runs under the dm_user account.

    If the path is absolute, enter the full path to the backup files. Always use an initial slash when specifying an absolute path.

repos_bu_001 is a relative path.
/home/myhome/repos_bu001 is an absolute path.
broker.port
[Optional] You may enter a broker port to overwrite the default value specified in the commandline.properties file in order to connect to a different ActiveMQ server (and therefore a different daemon) at runtime.
61616
broker.url
[Optional] You may enter a broker URL to overwrite the default value specified in the commandline.properties file in order to connect to a different ActiveMQ server (and therefore a different daemon) at runtime.
dm-server1
security_password
[Optional] Password for the super user or authorized Viewpoint user.
53cUr17y
Required if security management is enabled on the Data Mover daemon. Not a valid parameter if -security_password_encrypted is also specified.
security_password_encrypted
[Optional] Encrypted password for the super user.
052c7aabd14c7770141ac3c0137ab98ae0d3f0f7cddf588981206b010c0c1b2f
Required if security management is enabled on the Data Mover daemon. Not a valid parameter if -security_password is also specified.
security_username
[Optional] User ID of the super user or authorized Viewpoint user. The user ID of the super user is dmcl_admin and cannot be changed.
Required if security management is enabled on the Data Mover daemon.

Usage Notes

The following scenarios result in an error:
  • A job is running when you execute the restore_daemon command
  • You do not specify a directory where the backup files are stored
  • You specify an absolute path, but dm_user does not have write privilege for the path
  • You specify a relative or absolute path that does not exist
  • The Data Mover repository being restored does not have the same hash algorithm as the Data Mover repository that was backed up by the backup_daemon command

XML File Example

To use an XML file such as parameters.xml with the restore_daemon command to restore previously backed up repository and configuration files of the Data Mover daemon, type datamove restore_daemon -f parameters.xml.

In the following example, parameters.xml specifies repos_bu_001 as the directory under daemon_backup relative to the install location for the Data Mover daemon on your system where the previous backup was written. 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <dmRestoreDaemon xmlns="http://schemas.teradata.com/dataMover/v2009"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://schemas.teradata.com/unity/datamover.xsd">
   <backup_target_dir>repos_bu_001</backup_target_dir>
 </dmRestoreDaemon>