Teradata Data Mover Installation, Configuration, and Upgrade Guide For Customers
Teradata Data Mover Installation, Configuration, and Upgrade Guide For Customers
Teradata, Aster, BYNET, Claraview, DecisionCast, IntelliBase, IntelliCloud, IntelliFlex, QueryGrid, SQL-MapReduce, Teradata Decision Experts,
"Teradata Labs" logo, Teradata ServiceConnect, and Teradata Source Experts are trademarks or registered trademarks of Teradata Corporation or its
affiliates in the United States and other countries.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
Amazon Web Services, AWS, Amazon Elastic Compute Cloud, Amazon EC2, Amazon Simple Storage Service, Amazon S3, AWS CloudFormation, and
AWS Marketplace are trademarks of Amazon.com, Inc. or its affiliates in the United States and/or other countries.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
Apache, Apache Avro, Apache Hadoop, Apache Hive, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks of the
Apache Software Foundation in the United States and/or other countries.
Apple, Mac, and OS X all are registered trademarks of Apple Inc.
Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda Access,
Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and Maximum Support
are servicemarks of Axeda Corporation.
CENTOS is a trademark of Red Hat, Inc., registered in the U.S. and other countries.
Cloudera and CDH are trademarks or registered trademarks of Cloudera Inc. in the United States, and in jurisdictions throughout the world.
Data Domain, EMC, PowerPath, SRDF, and Symmetrix are either registered trademarks or trademarks of EMC Corporation in the United States and/or
other countries.
GoldenGate is a trademark of Oracle.
Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.
Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other countries.
Intel, Pentium, and XEON are registered trademarks of Intel Corporation.
IBM, CICS, RACF, Tivoli, IBM Spectrum Protect, and z/OS are trademarks or registered trademarks of International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
LSI is a registered trademark of LSI Corporation.
Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and
other countries.
NetVault is a trademark of Quest Software, Inc.
Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.
Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates.
QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation.
Quantum and the Quantum logo are trademarks of Quantum Corporation, registered in the U.S.A. and other countries.
Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license.
SAP is the trademark or registered trademark of SAP AG in Germany and in several other countries.
SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc.
Sentinel® is a registered trademark of SafeNet, Inc.
Simba, the Simba logo, SimbaEngine, SimbaEngine C/S, SimbaExpress and SimbaLib are registered trademarks of Simba Technologies Inc.
SPARC is a registered trademark of SPARC International, Inc.
Unicode is a registered trademark of Unicode, Inc. in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Veritas, the Veritas Logo and NetBackup are trademarks or registered trademarks of Veritas Technologies LLC or its affiliates in the U.S. and other
countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.
The information contained in this document is provided on an "as-is" basis, without warranty of any kind, either express or
implied, including the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. Some
jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. In no event will
Teradata Corporation be liable for any indirect, direct, special, incidental, or consequential damages, including lost profits or
lost savings, even if expressly advised of the possibility of such damages.
The information contained in this document may contain references or cross-references to features, functions, products, or services that are not
announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions,
products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services
available in your country.
Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without
notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without
notice.
To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document.
Please e-mail: [email protected]
Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation
will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative
works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free
to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or
marketing products or services incorporating Feedback.
Copyright © 2015 - 2017 by Teradata. All Rights Reserved.
Table of Contents
Preface...................................................................................................................................................................5
Purpose............................................................................................................................................................................ 5
Audience..........................................................................................................................................................................5
Revision History.............................................................................................................................................................5
Additional Information.................................................................................................................................................5
Teradata Support............................................................................................................................................................6
Product Safety Information.......................................................................................................................................... 6
Chapter 1:
Overview............................................................................................................................................................. 7
Dependencies..................................................................................................................................................................7
Best Practices for Data Mover Networking................................................................................................................ 9
Chapter 2:
Configuring the Environment..............................................................................................13
Configuring the Data Mover Daemon..........................................................................................................13
The daemon.properties File................................................................................................................13
Configuration Properties.................................................................................................................... 15
Configuring the Data Mover Agent.............................................................................................................. 21
Installing and Configuring the Data Mover Agent on a Linux Teradata Server.........................21
The agent.properties File.....................................................................................................................21
Configuring the Data Mover Command-Line Interface............................................................................ 23
Configuring the Data Mover Command-Line Interface on a Linux Teradata Server................23
Installing and Configuring the Data Mover Command-Line Interface on Non-Teradata
Servers....................................................................................................................................................23
The commandline.properties File......................................................................................................25
Configuring the Data Mover REST Service..................................................................................................27
About Configuring High Availability........................................................................................................... 27
Configuring Automatic Failover........................................................................................................27
High Availability Configuration Scenario............................................................................ 28
Verifying Data Mover Package Installation......................................................................... 29
Example: Verifying Data Mover Package Installation........................................................ 30
Setting Up Host Files or DNS.................................................................................................30
Example: Setting Up Host Files or DNS............................................................................... 30
Verifying Required Ports Open..............................................................................................30
Example: Verifying Required Ports are Open......................................................................31
Chapter 3:
Administrative Tasks.......................................................................................................................49
Data Mover Components Script.................................................................................................................... 49
Changing DBC and DATAMOVER Passwords on the Data Mover Server............................................49
Creating a Diagnostic Bundle for Support................................................................................................... 51
Chapter 4:
Upgrading Software..........................................................................................................................57
About Upgrading Data Mover Software.......................................................................................................57
Creating an Incident........................................................................................................................................ 57
Upgrading the Data Mover Command-Line Interface on Non-Teradata Servers................................. 58
Upgrading the Data Mover Agent on a Linux Teradata Server................................................................ 60
Purpose
This guide provides customer information and procedures for installing, configuring, and upgrading
Teradata Data Mover software.
Audience
This guide is intended for use by:
• System administrators
• Database administrators and relational database developers
• Customers
• Teradata Customer Support
Revision History
Date Release Description
June 2017 16.10 Initial release.
Additional Information
Related Links
URL Description
https://access.teradata.com Use Teradata Support to access Orange Books, technical alerts, and
knowledge repositories, view and join forums, and download software
packages.
http://www.teradata.com External site for product, service, resource, support, and other customer
information.
Related Documents
Documents are located at http://www.info.teradata.com.
Title Publication ID
Teradata Data Mover User Guide B035-4101
Describes how to use the Teradata Data Mover portlets and command-line interface.
Teradata Data Mover
Installation, Configuration, and Upgrade Guide for Customers Release 16.10 5
Preface
Teradata Support
Title Publication ID
Parallel Upgrade Tool (PUT) Reference B035-5713
Describes how to install application software using PUT.
Teradata Viewpoint User Guide B035-2206
Describes the Teradata Viewpoint portal, portlets, and system administration features.
Customer Education
Teradata Customer Education delivers training for your global workforce, including scheduled public
courses, customized on-site training, and web-based training. For information about the classes, schedules,
and the Teradata Certification Program, go to www.teradata.com/TEN/.
Customer Support
Customer support is available around-the-clock, seven days a week through the Global Technical Support
Center (GSC). To learn more, go to https://access.teradata.com.
Teradata Support
Teradata customer support is located at https://access.teradata.com.
Example
Notice:
Improper use of the Reconfiguration utility can result in data loss.
Dependencies
Data Mover Server Requirements
Software Level
Operating System SUSE Linux Enterprise Server 11 SP 3
Internal Repository Teradata Database 15.10
Development Tools teradata-jre7-1.7.0_121-tdcl and later
Note:
For non-Teradata servers, you must install or upgrade to JRE 7
before installing or upgrading any components.
Note:
The Data Mover agent must be the exact same version as the Data Mover daemon.
Software Level
Teradata Viewpoint Version 16.00 or 16.10
Cloudera Distribution of Hadoop Version 5.4.x, 5.7, 5.8, and 5.9
for Commodity Hardware
Cloudera Distribution of Hadoop Version 5.4.x, 5.7, 5.8, and 5.9
for Teradata Appliance for
Hadoop
Required Permissions
You must be a root user to install and configure Data Mover components.
• m = message
• n = platform dependent line separator
Dynamic property when layout is PatternLayout.1
Information for creating a layout is at: http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/
PatternLayout.html
log4j.rootLogger=<level The six levels of logging, TRACE | DEBUG | INFO | INFO,logfile
of logging> WARN | ERROR | FATAL. From trace level to
application error. LOG_LEVEL can be updated
dynamically, but not logfile.1
Value is:
LOG_LEVEL, logfile
Note:
Do not remove the term logfile.
If the Viewpoint Authentication server has HTTPS enabled, you can set the following if you want to
authenticate via HTTPS instead: viewpoint.url to https://localhost and viewpoint.port to
443.
1Forproperties that can be set dynamically, the changes take effect one minute after the updated
daemon.properties file is saved. There is no need to restart the daemon service if you are only updating
dynamic properties. For example:
• If you changed the value of log4j.rootLogger from the default of INFO, logfile to DEBUG,
logfile, any debug messages generated would start appearing in the log file one minute after saving the
updated properties file.
• If you changed the value of jobExecutionCoordinator.maxConcurrentJobs from the default
value of 20 to a new value of 25, the new value of 25 would take effect one minute after saving the
updated daemon.properties file.
Configuration Properties
Property Description Default
agentCollector.agentHeartbeat Sets the amount of time in milliseconds to wait for an 600000
WaitMillis agent heartbeat before assuming it has gone out of
service.
blocked.job.maxAllowedLimit The maximum number of jobs that can be marked as 5
BLOCKED and retried. If a job is detected as blocked
Teradata Data Mover
Installation, Configuration, and Upgrade Guide for Customers Release 16.10 15
Chapter 2: Configuring the Environment
Configuring the Data Mover Daemon
Note:
Performance decreases when encryption is
initiated.
Note:
Performance decreases when this setting is used for
object availability.
job.overwriteExistingObjects When set to True, objects that already exist on the False
target database system are overwritten.
job.securityMgmtLevel The level of security management enabled. Valid Job
choices are Daemon and Job.
job.useGroupUserIdPool Defines a set of system names and credentials. When None
creating a job, this group user id pool can be used for
the source or target in place of directly specifying
credentials in the job.
job.useSecurityMgmt When set to True, some Data Mover commands False
require the admin username and password to be
specified when executing the command. For a
complete list of commands affected by this parameter,
see the Teradata Data Mover User Guide.
job.useSyncService Records any changes to the Data Mover repository False
tables (inserts/updates/deletes) in an audit log table.
The value must be set to True to use the Sync service.
job.useUserIdPool Uses a target user from the pool of users. This enables
the running of multiple arc tasks at the same time.
queryGridManagerEncryptedPass Sets the QueryGrid Manager user-encrypted
word password. Cannot be combined with
queryGridManagerPassword.
queryGridManagerPassword Sets the QueryGrid Manager user password. Cannot
be combined with the
queryGridManagerEncryptedPassword.
queryGridManagerUser Sets the QueryGrid Manager user. Support
querygrid.wait.final.status When set to True, the system waits for QueryGrid False
Manager to return the final task status. Setting to
True may impact system performance.
repository.purge.definition.e Enables the automated purging of job definitions. False
nabled
repository.purge.enabled Enables/disables the repository purge feature. The False
default value False means purging is disabled.
repository.purge.history.unit The unit for job history data to be kept in the Days
repository before purging should occur.
The current supported values are Days, Weeks,
Months, and Years.
Note:
Providing a low value can hurt performance.
Teradata recommends using the default value.
Note:
Do not remove the term logfile.
1Forproperties that can be set dynamically, the changes take effect one minute after the updated
daemon.properties file is saved. There is no need to restart the daemon service if you are only updating
dynamic properties. For example:
• If you changed the value of log4j.rootLogger from the default of INFO, logfile to DEBUG,
logfile, any debug messages generated would start appearing in the log file one minute after saving the
updated properties file.
• If you changed the value of agent.maxConcurrentTasks from the default value of 5 to a new value of
6, the new value of 6 would take effect one minute after saving the updated agent.properties file.
Operating Actions
System
Linux (for a. At the command line, type export DM_INTERACTIVE_INSTALL=1 to set the
non- environment variable for interactive install.
Teradata b. At the command line, type the following:
servers)
gunzip DMCmdline__linux_i386.16.10.00.00.tar.gz tar xvf
DMCmdline__linux_i386.16.10.00.00.tar
cd DMCmdline.16.10*
rpm -Uvh DMCmdline__linux_noarch.16.10.00.00-1.rpm
c. Answer the prompts as needed and press Enter to accept the defaults where
appropriate.
d. Type rpm -qa |grep DMCmdline to verify the installation.
Windows a. Copy the Data Mover directory on the media to a folder on the hard drive.
b. Go to DataMover/Windows and unzip tdm-
windows__windows_i386.16.10.00.00.zip.
c. Go to the DISK1 directory and run setup.exe.
d. Answer the prompts as needed and press Next to accept defaults where appropriate.
e. Click Install when finished.
f. Go to Start > Control Panel > Add or Remove Programs to verify installation.
gunzip tdm-aix__aix_power.16.10.00.00.tar.gz
tar xvf tdm-aix__aix_power.16.10.00.00.tar
installp -acF -d ./DMCmdline DMCmdline
b. Answer the prompts as needed and press Enter to accept defaults where appropriate.
c. Type lslpp -l "DM*" to verify the installation.
Note:
In Ubuntu, -i is used for both install and upgrade.
c. Answer the prompts as needed and press Enter to accept the defaults where
appropriate.
d. Type dpkg -l |grep dmcmdline to verify the installation.
6. If the broker URL needs to be changed, edit the commandline.properties file located in the
TDM_install_directory\CommandLine\commandline.properties directory after installation.
7. Specify the broker URL and broker port number for communicating with the JMS bus.
The broker URL value is the machine name or IP address of the machine where ActiveMQ runs. The
broker port value should also be the same as the port number that ActiveMQ uses. The defaults are
broker.url=localhost and broker.port=61616.
log4j.appender.logfile. The number of backup logging files that are created. After 3
maxBackupIndex=<number the maximum number of files has been created, the oldest
of backup files> file is erased.
Example
If Max Backups = 3, three backup logs are created:
• dmCommandLine.log.1
• dmCommandLine.log.2
• dmCommandLine.log.3
If the current dmCommandLine.log size exceeds 10MB, it
rolls to become the new dmCommandLine.log.1 and a new
dmCommandLine.log is created. The previous
dmCommandLine.log.2 becomes the new
dmCommandLine.log.3. The previous
dmCommandLine.log.3 is deleted.
log4j.appender.logfile. The maximum size of the logging file before being rolled 10MB
maxFileSize=<maximum over to backup files.
size of log files>
log4j.appender.logfile. The pattern of the log file layout, where: %d [%t]
layout.ConversionPatter %-5p %c{3}
• d = date
n=<log file pattern - %m%n
layout> • t = thread
• p = log level
• c = class name
• m = message
• n = platform dependent line separator
Information for creating a layout is at: http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/
PatternLayout.html
log4j.rootLogger=<level Six levels of logging, TRACE < DEBUG < INFO < WARN < INFO,logfil
of logging> ERROR < FATAL. From trace level to application error. e
Value is:
<LOG_LEVEL>, logfile
Note:
Do not remove the term logfile.
Note:
When using the synchronization service with failover, use the public IP address of the system, not the
localhost hostname or the 127.0.0.1 IP address.
1. Define an alias for all five servers in the /etc/hosts file on each system (DM1, DM2, DM3, VP1, and
VP2), if not already defined.
For example, the following entries would be added to the host files on DM1:
• ##.##.###.## DM2
• ##.##.###.## DM3
• ##.##.###.## VP1
• ##.##.###.## VP2
2. On DM1 and DM2, add a public IP address to the /etc/hosts file so that the name of the server does
not resolve to the 127.0.0.1 IP address.
An example DM1 entry: ###.##.###.## DM1
Note:
Running the backup command momentarily shuts down the master (DM1) daemon. It is
recommended that you analyze the backup files after the command completes to ensure no errors
occurred.
9. Stop the Data Mover daemon on the master (DM1) server.
10. Copy the backup directory on the master (DM1) server to the slave (DM2) server.
11. Start the Data Mover daemon on the slave (DM2) server to run the restore command.
12. Change the ownership of the backup files on the slave (DM2) server to dmuser.
13. Grant 755 permissions to the backup files on the slave (DM2) server.
14. Run the restore_daemon command to restore the master backup to the slave (DM2) repository.
It is recommended that you analyze the backup files after the command completes to ensure the restore
worked properly.
15. Delete the working files on the Data Mover Sync Service for the master (DM1) and slave (DM2)
servers.
Deleting these working files ensures that the Sync Service does not contain old changes when it is
restarted later in the failover configuration process.
16. Stop the Data Mover daemon on the slave (DM2) server.
Example: Configuring the Dual Active Java Message Service (JMS) Brokers
1. Run ./dmcluster configactivemq-e true -s DM2 - p61616 on the original-master (DM1).
2. Run ./dmclsuter configactivemq -e true -s DM1 -p 61616 on the designated-slave
(DM2).
3. Check TD ActiveMQ logs on DM1 and DM2 to verify the network was enabled:
Teradata Data Mover
Installation, Configuration, and Upgrade Guide for Customers Release 16.10 35
Chapter 2: Configuring the Environment
About Configuring High Availability
Network connection between vm://TeradataActiveMQ#8 and tcp://DM2/
XX.XX.XXX.XX:61616@49353 (TeradataActiveMQ) has been established.
4. Set cluster.enabled=true in daemon.properties, agent.properties,
commandline.properties on DM1 and DM2.
5. Set cluster.enabled=true in agent.properties and commandline.properties on DM3.
6. Set broker.url=DM1, DM2 in daemon.properties and commandline.properties on DM1.
7. Set broker.url=DM2, DM1 in daemon.properties and commandline.properties on DM2.
8. Set broker.url=DM1, DM2 in commandline.properties on DM3.
9. Set broker.url=DM1, DM2 in agent.properties on DM1, DM2, and DM3.
10. [Optional] If you are using the Data Mover portlet, you can configure Dual Active Java Message Service
(JMS) Brokers through Viewpoint.
a) Log in to Viewpoint on VP1.
b) Open the Data Mover Setup portlet.
c) Locate and select the DM1 daemon from the list of daemons.
d) Verify the daemon IP/DNS points to DM1.
e) Select Enabled in portlets to enable clustering.
f) Set the broker URL/port to DM2:61616.
g) Click Apply to finish.
Property Value
master.port 25368
master.host Designated-slave
Property Value
master.port Use same value as the original-master.
master.host Specify as the original-master.
The sync.isMaster property does not need to be modified. The failover process is responsible for
starting the synchronization service as master or slave when a failover occurs.
Property Value
master.port 25368
Teradata Data Mover
36 Installation, Configuration, and Upgrade Guide for Customers Release 16.10
Chapter 2: Configuring the Environment
About Configuring High Availability
Property Value
master.host DM2
Property Value
master.port 25368
master.host DM1
Note:
In a default installation, the master repository host is the same as the master daemon host and the
slave repository host is the same as the slave daemon host.
Failover.properties File
The Data Mover failover.properties file contains the files that control the failover process. When setting up
your failover process, edit these files according to the system you are configuring.
Property Name Description
local.daemon.host Host where the local (master) daemon runs.
remote.daemon.host Host where the remote (slave) daemon runs.
local.monitor.host Host where the monitoring service that monitors the local (master) services
runs.
remote.monitor.host Host where the monitoring service that monitors the remote (slave) services
runs.
local.repository.host Host where the repository used by the local daemon is installed.
If external agents are shared between the master and slave, the shared agent names must be specified for
both local.agents.host and remote.agents.host.
Prompt Action
Please enter the password for Provide the root Linux password for VP1.
root@VP1(MASTER MONITOR):
Please enter the password for Provide the root Linux password for VP1.
root@VP2(SLAVE MONITOR):
Please enter the password for Provide the root Linux password for DM3.
root@DM3(Master Agent(s)):
Where nn.nn in the path refers to the major and minor version numbers of Data Mover.
Note:
Using a low value can hurt performance. The
recommendation is to use the default value.
For more information about Teradata Ecosystem Manager, see the Teradata Ecosystem Manager User
Guide.
Note:
More than two ports on the DM managed server could be available in a customer environment. The
examples in this section use only 2-node source and target systems and two available network ports on
the DM managed server.
1. Add the IP addresses for all source and target COP entries in the /etc/hosts file on the DM managed
server.
2. Define the specific routes for the COP entries in the /etc/sysconfig/network/routes file on the
DM managed server.
3. Restart the network on the DM managed server.
4. Verify the route changes are in place on the DM managed server.
Notice:
Be sure to check that restarting the network will not negatively affect any other users on the server prior
to executing this command.
1. Run the rcnetwork restart command to restart the network on the DM managed server.
# netstat -rn
Teradata Data Mover
Installation, Configuration, and Upgrade Guide for Customers Release 16.10 45
Chapter 2: Configuring the Environment
Data Mover Log Files
Kernel IP routing table
Destination Gateway Genmask Flags MSS Window irtt Iface
153.64.209.92 153.64.107.254 255.255.255.255 UGH 0 0 0 eth4
153.64.106.78 153.64.107.254 255.255.255.255 UGH 0 0 0 eth5
153.64.106.79 153.64.107.254 255.255.255.255 UGH 0 0 0 eth5
153.64.209.91 153.64.107.254 255.255.255.255 UGH 0 0 0 eth4
127.0.0.0 0.0.0.0 255.0.0.0 U 0 0 0 lo
0.0.0.0 153.64.107.254 0.0.0.0 UG 0 0 0 eth2
Note:
If you previously used dm.job.production.password in the daemon.properties file to change
the DATAMOVER password, remove it from daemon.properties before running the
changepassword.sh script.
Note:
We recommend that you run the script before installing or upgrading Data Mover. If you run it after
Data Mover has been installed or upgraded, you must restart the daemon to ensure Data Mover runs
properly.
Non- a. Run the script with the arguments -o, -p, -m, and -d. For example:
Interactive
# changepassword.sh -o old dbc password -p new dbc password -
m old datamover password -d new datamover password, where:
• old dbc password is the existing password for the DBC user
• new dbc password is the new password for the DBC user
• old datamover password is the existing password for the DATAMOVER
user
• new datamover password is the new password for the DATAMOVER user
2. If you ran the changepassword.sh script after Data Mover was installed or upgraded, restart the
daemon as follows:
a. # /etc/init.d/dmdaemon stop
b. # /etc/init.d/dmdaemon start
3. Verify the Data Mover components are ready to use by issuing the following commands:
• datamove list_jobs
• datamove list_agents
Script Example
location:/var/opt/teradata/packages/DataMover160000 # ./changepassword.sh
Do you want to change the DBC password of the Teradata internal repository?
(yes/no/y/n)?
yes
----------------------------------------------------------------
Change DBC Default Password
----------------------------------------------------------------
Old Password:
Retype Old Password:
New Password:
Retype New Password:
Do you want to change the DATAMOVER password of the Teradata internal
Teradata Data Mover
50 Installation, Configuration, and Upgrade Guide for Customers Release 16.10
Chapter 3: Administrative Tasks
Creating a Diagnostic Bundle for Support
repository?(yes/no/y/n)?
y
----------------------------------------------------------------------
Change DATAMOVER Default Password
----------------------------------------------------------------------
Old Password:
Retype Old Password:
New Password:
Retype New Password:
04/19/16 16:01:15 JDBC driver loaded.
Option Setting
Product Area System Management Utilities
Problem Type Teradata Data Mover
2. Record the incident number and leave it open to attach the diagnostic bundle.
Teradata Data Mover
Installation, Configuration, and Upgrade Guide for Customers Release 16.10 51
Chapter 3: Administrative Tasks
Creating a Diagnostic Bundle for Support
Note:
The interactive script prompts you to enter the incident number and other information related to the
issue.
3. As the root user, locate the scripts at /opt/teradata/datamover/support/ for every Data Mover
server in your environment, and do the following:
datamover-server- OS, kernel, CPU, memory, and disk space information, including the
details following:
• jstack and jmap output for tdactivemq, daemon, and agent processes
The dmagentsupport.sh file collects the following information from a server running only the Data
Mover agent:
• Data Mover log files from the agent server
• Recent temp and task directories
The dmagentsupport.sh script creates a data-mover-agent-support output file, which contains
the following information:
• Data Mover agent.properties files
• List of files from the DataMover components installation directory
• OS, kernel, CPU, memory, and disk space information
• Data Mover and TTU packages rpm information
After the script collects the data, a bundle named DataMover-$currentdate-$hostname-1.zip is
created in /var/opt/teradata/datamover/support/incidentnumber.
Note:
All Data Mover upgrades except the DMCmdline package are performed by Teradata Customer Support.
Note:
The DMFailover package from the monitoring servers should be the same version as the Failover package
from the Data Mover managed server.
Creating an Incident
You must obtain an Incident number from the Teradata Support prior to performing any software upgrades.
1. On your Windows PC, open a web browser and go to the Teradata Support at https://access.teradata.com
and log in.
2. Click Create Incident.
3. Make the following selections as appropriate:
Note:
Click the green arrows to move forward or back in the selection screens.
Option Description
Site The site where the activity will be performed.
Priority The Priority of the issue.
Product Area The area of the system where the issue is located or where work will be performed.
Problem Type A list of Problem Types.
Synopsis A short Synopsis of the activity being performed.
Description A short description of the activity being performed.
4. Click Submit.
5. Click OK to confirm the submission of the incident.
Teradata Data Mover
Installation, Configuration, and Upgrade Guide for Customers Release 16.10 57
Chapter 4: Upgrading Software
Upgrading the Data Mover Command-Line Interface on Non-Teradata Servers
The incident is added to the list of Incidents. The Status shows Pending (a blue circle) until Customer
Services accepts the incident, at which time the Status becomes Active (a green circle).
Note:
If there is an existing installation on the system, it must be uninstalled before re-installing. You can have
only one version of the Data Mover Command-Line package on a server.
Steps 1 through 4 do not apply to installation on Windows systems.
Note:
As of Data Mover 16.00, only the major and minor versions of the Data Mover daemon and the Data
Mover command line interface or Data Mover portlet must match.
1. Add the following lines of code to the end of the /etc/profile file to update the JAVA_HOME and
PATH environment variables for all users:
export JAVA_HOME={full path of java installation location}
export PATH=$JAVA_HOME/bin:$PATH
2. Run the command:
source /etc/profile
3. Verify that the output shows JRE.1.7:
java -version
4. Open the .profile file of the root user and verify that the values for the JAVA_HOME and PATH
environment variables are the same as those defined in /etc/profile.
If the values are different, the java -version command will not produce the correct output during
install time, and the installation will fail.
5. Copy the properties file to an outside directory if you want to preserve any customization that you made
to the default values:
TDM_install_directory\CommandLine\commandline.properties
6. Uninstall and upgrade the appropriate software for your system as follows:
Operating Actions
System
Linux (for a. At the command line, type export DM_INTERACTIVE_INSTALL=1 to set the
non- environment variable for interactive install.
Teradata b. At the command line, type the following:
servers)
gunzip DMCmdline__linux_i386.16.10.00.00.tar.gz
tar xvf DMCmdline__linux_i386.16.10.00.00.tar
cd DMCmdline.16.10*
rpm -Uvh DMCmdline__linux_noarch.16.10.00.00-1.rpm
c. Answer the prompts as needed, and press Enter to accept the defaults where
appropriate.
d. Type rpm -qa |grep DMCmdline to verify installation.
Windows a. To uninstall the existing DMCmdline software package, go to Start > Control Panel >
Add or Remove Programs; then, select Teradata Data Mover Command Line Interface
and click Remove.
b. Copy the Data Mover directory on the media to a folder on the hard drive.
c. Go to DataMover/Windows and unzip tdm-
windows__windows_i386.16.10.00.00.zip.
d. Go to the DISK1 directory and run setup.exe.
e. Answer the prompts as needed and press Next to accept defaults where appropriate.
f. Click Install when finished.
g. Go to Start > Control Panel > Add or Remove Programs to verify installation.
• If you do not want to preserve the properties file, you can remove the /opt/
teradata/client/16.10/datamover/commandline folder after uninstall is
completed.
b. At the command line, type the following:
tar xzvf tdm-dm-ubuntu__ubuntu.16.10.00.00.tar.gz
cd DMCmdline.16.10.00.00
dpkg -i DMCmdline__ubuntu_all.16.10.00.00-1.deb
Note:
In Ubuntu, -i is used for both install and upgrade.
c. Type dpkg -l |grep dmcmdline to verify the installation.
7. Restore the values from the properties file you copied to an outside directory if you want to preserve any
customization that you made to the default values and override the values introduced by the patch
TDM_install_directory\CommandLine\commandline.properties
8. Specify the broker URL and broker port number for communicating with the JMS bus.
The broker URL value is the machine name or IP address of the machine where ActiveMQ runs. The
broker port value should also be the same as the port number that ActiveMQ uses. The defaults are
broker.url=localhost and broker.port=61616.
3. Restore the values from the properties file you copied to an outside directory if you want to preserve any
customization that you made to the default values and override the values introduced by the patch:
TDM_install_directory\Agent\agent.properties
4. Specify the broker URL and broker port number for communicating with the JMS bus.