Upgrade Command-Line on Non-Teradata Servers | Teradata Data Mover - 17.05 - Upgrading the Data Mover Command-Line Interface on Non-Teradata Servers - Teradata Data Mover

Teradata® Data Mover Installation, Configuration, and Upgrade Guide for Customers

prodname
Teradata Data Mover
vrm_release
17.05
created_date
October 2020
category
Administration
Configuration
Installation
featnum
B035-4102-090K
The Data Mover Command-Line Interface must be installed for Solaris Sparc, IBM AIX, Ubuntu, Windows systems, and Linux on non-Teradata servers using the following procedures. You cannot use PUT to install the Command-Line Interface on those systems.
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.

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.8:
    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 System Actions
    Linux (for non-Teradata servers)
    1. At the command line, type export DM_INTERACTIVE_INSTALL=1 to set the environment variable for interactive install.
    2. At the command line, type the following:

      gunzip DMCmdline__linux_i386.17.05.xx.xx.tar.gz

      tar xvf DMCmdline__linux_i386.17.05.xx.xx.tar

      cd DMCmdline.17.05*

      rpm -Uvh DMCmdline__linux_noarch.17.05.xx.xx-1.rpm

    3. Answer the prompts as needed, and press Enter to accept the defaults where appropriate.
    4. Type rpm -qa |grep DMCmdline to verify installation.
    Solaris Sparc
    1. At the command line, type pkgrm DMCmdline to uninstall.
    2. At the command line, type the following to upgrade:

      gunzip tdm-solaris__solaris_sparc.17.05.xx.xx.tar.gz

      tar xvf tdm-solaris__solaris_sparc.17.05.xx.xx.tar

      pkgadd -d 'pwd' DMCmdline

    3. Answer the prompts as needed and press Enter to accept defaults where appropriate.
    4. Type pkginfo -l DMCmdline to verify installation.
    IBM AIX
    1. At the command line, type installp -u DMCmdline to uninstall.
    2. At the command line, type the following to upgrade:

      gunzip tdm-aix__aix_power.17.05.xx.xx.tar.gz

      tar xvf tdm-aix__aix_power.17.05.xx.xx.tar

      installp -acF -d ./DMCmdline DMCmdline

    3. Answer the prompts as needed and press Enter to accept defaults where appropriate.
    4. Type lslpp -l "DM*" to verify installation.
    Windows
    1. 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 select Remove.
    2. Copy the Data Mover directory on the media to a folder on the hard drive.
    3. Go to DataMover/Windows and unzip tdm-windows__windows_i386.17.05.xx.xx.zip.
    4. Go to the DISK1 directory and run setup.exe.
    5. Answer the prompts as needed and press Next to accept defaults where appropriate.
    6. Select Install when finished.
    7. Go to Start > Control Panel > Add or Remove Programs to verify installation.
    Ubuntu
    1. At the command line, type dpkg -P dmcmdline to uninstall.
      • The commandline.properties file is preserved as commandline.properties.dpkgsave in the /opt/teradata/client/17.05/datamover/commandline directory, and you can ignore the following warning:
        Warning: while removing dmcmdline, directory /opt/teradata/client/17.05/datamover/commandline is not empty so not removed
      • If you do not want to preserve the properties file, you can remove the /opt/teradata/client/17.05/datamover/commandline folder after uninstall is completed.
    2. At the command line, type the following:

      tar xzvf tdm-dm-ubuntu__ubuntu.17.05.xx.xx.tar.gz

      cd DMCmdline.17.05.xx.xx

      dpkg -i DMCmdline__ubuntu_all.17.05.xx.xx-1.deb
      In Ubuntu, -i is used for both install and upgrade.
    3. 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 Data Mover REST server URL for communicating with the daemon as in the following example:
    dm.rest.endpoint=https://dm_host:1443/datamover

    Make sure the host:port value used for dm.rest.endpoint is on the accept.host.list in tdmrest.properties.

  9. Log out of the current session and log back in to view the updated environment.