modify_admin_password | Commands | Teradata Data Mover - 17.11 - modify_admin_password - Teradata Data Mover

Teradata® Data Mover User Guide

Product
Teradata Data Mover
Release Number
17.11
Release Date
October 2021
Content Type
User Guide
Publication ID
B035-4101-091K
Language
English (United States)

Purpose

The modify_admin_password command allows you to change the password for the super user. By default, the password for the super user is dmcl_admin and cannot be changed.

Parameters

See Parameter Order.

current_password
Current password for the super user. By default, password of the super user is dmcl_admin.
Example: dmcl_admin
Not a valid parameter if -current_password_encrypted is also specified.
current_password_encrypted
Current encrypted password for the super user.
Example: 8fe40e30c56c8f3217b02f978ee347997b5ad82b3f8ac532384484a76cf25be3
Not a valid parameter if -current_password is also specified.
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
new_password
New password for the super user.
Example: 53cUr17y
Not a valid parameter if -new_password_encrypted is also specified.
new_password_encrypted
New encrypted password for the super user.
Example: 052c7aabd14c7770141ac3c0137ab98ae0d3f0f7cddf588981206b010c0c1b2f
Not a valid parameter if -new_password is also specified.
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

You can pass values for the following:
  • A current plaintext password and a new encrypted password in the same command or XML file.
  • A current encrypted password and a new plaintext password in the same command or XML file.
The following scenarios result in an error:
  • You pass values for the current plaintext and current encrypted passwords in the same command or XML file.
  • You pass values for the new plaintext and new encrypted passwords in the same command or XML file.

XML File Example

To use an XML file with the modify_admin_password command to change the password for the super user, type datamove modify_admin_password -f admin_pw_parameters.xml.

In the following example, the current (default) password is updated to 53cUr17y.
<dmModifyAdminPassword 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">
    <current_password>dmcl_admin</current_password>
    <current_password_encrypted></current_password_encrypted>
    <new_password>53cUr17y</new_password>
    <new_password_encrypted></new_password_encrypted>
</dmModifyAdminPassword>
To pass values for encrypted passwords, add them to the XML file for the appropriate element.