backup_daemon | Commands | Teradata Data Mover - backup_daemon - Teradata Data Mover

Purpose

The backup_daemon command allows you to backup the Data Mover repository. This can be restored using the restore_daemon command.

As of Data Mover 17.05, the backup_daemon command uses the repository_backup.sh scripts located in the /opt/teradata/datamover/daemon/nn.nn directory to back up the daemon configuration from the Data Mover repository. The script uses the PostgresSQL pg_dump command for backup.

Syntax

See Data Mover XML Schemas.

Parameters

See Parameter Order.

backup_target_dir

[Optional] The directory where Data Mover writes 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.

  daemon_backup is a sub-directory of the install location for the Data Mover daemon on your system. By default, the directory is /opt/teradata/datamover/daemon/nn.nn.

• An absolute path. This is any location on the system for which dm_user has write privilege, typically /tmp, /var/opt/teradata/datamover/daemon_backup, and /home. backup_daemon runs under the dm_user account.

dm.rest.endpoint

[Optional] Enter a Data Mover REST server URL to overwrite the default value specified in the commandline.properties file in order to connect to a different REST server (and therefore a different daemon) at runtime.

https://dm-server1:1443/datamover

security_password

[Optional] Password for the super user or authorized Viewpoint user.

Example: 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.

Example: 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

• If you enter repos_bu001 as the relative path, Data Mover writes the backup files to /var/opt/teradata/datamover/daemon_backup/repos_bu001. Never use an initial slash when specifying a relative path.
• If you enter /home/myhome/repos_bu001 as the absolute path and if dm_user has write privilege for this path, Data Mover writes the backup files to /home/myhome/repos_bu001. Always use an initial slash when specifying an absolute path.
• If you do not specify a directory for the backup, Data Mover creates a directory in the format dm_hostname_nn.nn.nn.nn_YYYY-MM-DD_HH.mm.ss under daemon_backup. This format is composed of dm, followed by the hostname of the repository, the Data Mover version, then the date and timestamp of the backup. For example, a backup that occurs at 2am on hostname myhost and Data Mover version 16.20.23.00 on December 3, 2015 is written to the directory dm_myhost_16.20.23.00_2015-12-03_02.00.00.
• The following scenarios result in an error:
  • A job is running when you start the backup_daemon command
  • You specify an absolute path, but dm_user does not have write privilege for the path

XML File Examples

For the backup_daemon command, type datamove backup_daemon -f parameters.xml.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <dmBackupDaemon 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">
 </dmBackupDaemon>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <dmBackupDaemon 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>
 </dmBackupDaemon>