To access this download, you must login.

About this download

Teradata Studio is a client based graphical interface used to perform database administration tasks on Aster and Teradata Databases, as well as moving data to and from Hadoop database systems. It is built on the Eclipse Rich Client Platform (RCP). For more information on Teradata Studio, refer to the article Teradata Studio.

Teradata Studio contains several open-source components. A package containing the source code and licenses for these components is also available for download. This package does not contain proprietary Teradata source code.

Teradata Studio is a fully supported product by Teradata. 

For community support, please visit the Teradata Studio Forum.

► NOTE: This version requires Java Runtime Environment(JRE) 1.7 or 1.8 for Windows and Linux platforms. Mac OSX platforms 10.7 or greater does not provide an Apple JRE. Users must install Oracle's Java Developer Kit (JDK) 1.8 before installing Studio.

README

Teradata Studio 15.12.02 release information.

Supported Platforms:
====================================
     Windows Vista  - Microsoft Windows Vista Enterprise, 32-bit and 64-bit
     Windows Server - Microsoft Windows Server 2003, 32-bit and 64-bit
                    - Microsoft Windows Server 2008, 32-bit and 64-bit
     Windows 2000   - Microsoft Windows 2000, 32-bit
     Windows 7      - Microsoft Windows 7, 32-bit and 64-bit
     Windows 8 and 8.1 - Microsoft Windows 8 and 8.1, 32-bit and 64-bit
     Windows 10     - Microsoft Windows 10, 32-bit and 64-bit
     Ret Hat Server - Red Hat Advanced Server 5.0,6.0, and 7.0 64-bit
     Red Hat Platform - Red Hat Advanced Platform 5.0, 6.0, and 7.0 32-bit and 64-bit
     SUSE Linux Enterprise - SUSE Linux Enterprise 10, 32-bit and 64-bit
            - SUSE Linux Enterprise 11, 32-bit and 64-bit
            - SUSE Linux Enterprise 12, 32-bit and 64-bit
     CentOS 7       - 7, 32-bit and 64-bit
     Apple Mac      - OSX 10.7, 10.8, 10.9, 10.10, and 10.11


Minimum Memory Required:
====================================
     4GB Memory, but 6GB Memory desired


Supported Teradata Databases Versions:
====================================  
     Teradata Database 13.10
     Teradata Database 14.00
     Teradata Database 14.10
     Teradata Database 15.00
     Teradata Database 15.10

Supported Aster Databases Versions:
====================================  
     Aster Database 6.0
     Aster Database 6.10
     Aster Database 6.20

Required Software:
====================================  
     - Java Runtime Environment (JRE) version 1.7 or 1.8
     - Mac OsX 10.7 or greater does not provide the Apple JRE. Users must
     install Oracle's JDK (not JRE) 1.8.

Install Instructions;
====================================
     Download the Teradata Studio zip file from the download site.

  For Windows install:
     1) Unzip the Teradata Studio package to your local file system.
     2) Run the setup.exe to launch the Teradata Studio installation.
     3) Teradata Studio is installed in the Program Files directory.
        For example, C:\Program Files (x86)\Teradata\Client\15.10\Teradata Studio.
    When Teradata Studio is started, a 'workspace' directory is created in your
    home directory (C:\Users\<user>\workspace-studio). This directory contains
    workspace files, including the SQL project folder. The teradata.log file is
    located in the install \configuration directory.


  For Linux install:
    1) Unzip and untar the Teradata Studio package to your local file system.

        gunzip TeradataStudio__linux_x86.15.12.02.00-1.tar.gz
        tar -xvf TeradataStudio__linux_x86.15.12.02.00-1.tar

    2) Change directories (CD) to the TeradataStudio.15.12.02.00 directory

        cd TeradataStudio.15.12.02.00

    3) Switch to Super User or Root and run the Studio install script, passing
       the Studio RPM (Package Management) package:

        su
        ./studioinstall TeradataStudio-15.12.02.00-1.x86.rpm

    4) Provide the path to where you would like to install Teradata Studio.
       The default location is /opt/teradata. When Teradata Studio is started, a workspace
       directory is created in the location where you launched Teradata Studio (TeradataStudio) from,
       called workspace-studio. This directory contains workspace files, including the SQL project folder.
       The teradata.log file is located in the install /configuration directory.

    Note: To check whether Teradata Studio is installed or not, run the following RPM command:

        rpm -qa TeradataStudio
    
    To remove the Teradata Studio product from your Linux system, run the following RPM command:

        rpm -e TeradataStudio

  For Mac OSX Install:
    1) Unzip the Teradata Studio package to your local file system.
    2) Double click on the Teradata Studio.pkg package to invoke the Teradata Studio installer
    3) You can change the install location or use the default install location, which is the
       /Applications/TeradataStudio folder. When Teradata Studio is started, a 'workspace-studio' folder
       is created in the user's Documents folder. This folder contains the workspace files, including the
       SQL project folder. The teradata.log file is located in the install /configuration directory.
    
    To uninstall Studio on the Mac OSX, open a Terminal window and run the Studio uninstall script:

       . ./studio_uninstall.sh
 

Running Teradata Studio:
====================================
    Windows:
       Double click the Teradata Studio desktop icon shortcut.

    Linux:
       Update your path variable to include the TeradataStudio directory. Execute TeradataStudio.

    Mac:
       Execute Teradata Studio in the TeradataStudio directory.


Changing the Teradata Studio Workspace and/or Configuration information directories
    - (using Roaming Profiles):
====================================================================================
When Teradata Studio is launched, it creates a workspace directory (called workspace-studio) in your
USER HOME directory. If you want to change the location of your workspace directory, you must pass
the -data option into the TeradataStudio executable. You can do this by changing the Target parameter in the
Windows desktop shortcut or in the command window when launching Teradata Studio. For example:

"C:\Program Files (x86)\Teradata\Client\15.10\Teradata Studio\TeradataStudio.exe" -data "c:\Teradata Studio\My Workspace"

There is another directory (called .eclipse) created in your USER HOME directory that contains configuration
information and jars for launching Teradata Studio. If you want to change the location of your configuration
directory, you must pass the -configuration option into the TeradataStudio executable. You can do this by changing
the Target parameter in the Windows desktop shortcut or in the command window when launching Teradata Studio.
For Example:

"C:\Program Files (x86)\Teradata\Client\15.10\Teradata Studio\TeradataStudio.exe" -configuration "c:\Teradata Studio"

You can combine both the -data and -configuration options on a single command line as well. This is often needed
when using a Roaming Profile that is not always accessible when running applications.


Bug Fixes
====================================
The following bugs were fixed in 15.12.00:

IDE-12242  Running parameterized EXPLAIN with Java 8 results in ArrayIndexOutofBoundsException
IDE-14409  Consistency Required --> ‘SQL Editor’ tab title is displayed with Asterisk symbol sometimes and displayed without it some other times when clicked on ‘SQL Editor’ toolbar button in DSE
IDE-14793  Foreign Servers: DDL generated says remoteserver instead of remotehost
IDE-14804  Create Table form – Unable to create a table with PERIOD(TIME) WITH TIME ZONE and PERIOD(TIMESTAMP) WITH TIME ZONE data types
IDE-14805  Drop Database - 'Drop selected databases' toolbar button should be disabled when nothing is selected in the Object List Viewer after searching for objects
IDE-14814  Duplicate Driver Definitions are being displayed in Preferences Connectivity Driver Definitions window
IDE-14815  ArrayIndexOutOfBounds when reloading the OLV after committing from an Aster Create View while in the Table category
IDE-14824  Move Space: Doesn’t move more than 1 GB even when specified
IDE-14890  Unable to generate DDL for public schema in Aster through TD Studio
IDE-14905  Transfer Progress View – Cancel hangs on a Load/Export job
IDE-14919  Teradata/Aster Smart Load Wizard - ‘Column Type Dialog’ is displayed without title
IDE-14928  Aster Create Database - Reset button should be disabled when form was opened for the first time and also all buttons(Commit, Reset and Cancel) are disappearing after resetting the form
IDE-14931  Aster Create View - Null is displaying in the ‘View Query/SQL’ tab after resetting the form in the Aster Create View form
IDE-14934  Aster Create Role - Databases are shown in random order in Database combo of Create Role form (Databases are shown in Alphabetical Order in Object List Viewer)
IDE-14937  Create Aster Database – Inaccurate error message for exceeding database name length
IDE-15074  Object List Viewer Breadcrumb is incorrect when selecting Show Macro from child database tables in the Navigator
IDE-15179  Teradata SQL Editor - Using Connection Profile dropdown menu to switch to a server that is not connected to results in the program hanging
IDE-15182  SHOW DDL is triggering an extra query (SELECT * )
IDE-15331  Label name is displayed as Database instead of Schemas in the ‘Transfer Hadoop table to Aster table’ wizard
IDE-15355  Data transfer dialog from Hadoop to Aster is closed improperly when only one Aster DB in the combo
IDE-15360  SQL Editor – double clicking on text is causing the cursor to slow down
IDE-15401  Aster Data Editor Timeout: Password dialog does not pop up if says Yes to reconnect
IDE-15426  Aster should only automatically disconnect on a session time out


The following bugs were fixed in 15.12.02:

IDE-16225  Getting NullPointException for Sample Contents on empty table from Hadoop system and Aster 6.0, as well as executing LIMIT on Aster 6.0 in SQL Editor.
IDE-16285  Aster: Loading MR Functions for nc_system in the DSE always returns an empty result set


Improvements
====================================
The following improvements were made in 15.12.00:

IDE-14771  Admin Roles Form - Privileges Held display should include Database name
IDE-15021  Include Space information with Database, User, and Table property forms

CLNTINS-6766 As a User, I want to be able to pass preconfiguration parameters on silent install


The following improvements were made in 15.12.01:

IDE-16155  Need options to disable all copy/export options in Studio & Studio Express


The following improvements were made in 15.12.02:

IDE-16018  Certify CDH 5.8 with Studio


Hadoop Configuration Support:
=============================
Teradata Studio provides an option to transfer data to and from Hadoop systems using its feature called the
Smart Loader for Hadoop. The Smart Loader for Hadoop uses the Teradata Connector for Hadoop (TDCH), which is
installed on the Hadoop node, to provide the data transfer to and from the Hadoop system. Teradata Studio
requires TDCH version 1.4.4. The following are the system requirements of TDCH 1.4.4:

    Supported Teradata Database versions:

        Teradata Database 13.10
        Teradata Database 14.00
        Teradata Database 14.10
        Teradata Database 15.00
        Teradata Database 15.10

    Supported Hortonworks Data Platform (HDP) versions:

        HDP 2.1 (Hadoop 2.4.0, HiveServer2 (HCatalog) 0.13.0)
        HDP 2.1.3 (Hadoop 2.4.0, HiveServer2 (HCatalog) 0.13.1)
        HDP 2.3 (Hadoop 2.7.1, Hive 1.2.1, HBase 1.1.1)
        HDP 2.4 (Hadoop 2.7.1, Hive 1.2.1, HBase 1.1.2)

    Supported Cloudera Hadoop (CDH) versions:
        CDH 5.4, 5.7, 5.8


Teradata Connector for Hadoop Setup:
====================================
The TDCH 1.4.1 must be installed and configured on the Hadoop system. Teradata Plugin for Eclipse's Smart Loader
for Hadoop uses Oozie to submit the data transfer workflow on the Hadoop System. Please follow these instructions
to configure the Hadoop System and create the Oozie workflow files.

1) If the script is not already on your Hadoop system, download and install the TDCH (version 1.4.4) onto your Hadoop system.
2) Navigate to the TDCH scripts folder in the TDCH install directory (default location: /usr/lib/tdch/1.4/scripts)
3) Execute the configureOozie.sh script as root user, providing the locations of your Hadoop services.
    
The usage of the configureOozie.sh script is as follows (this is all a single line):

    Usage: ./configureOozie.sh nn=nameNodeHost [nnHA=fs.default.value] [rm=resourceManagerHost] [oozie=oozieHost] [webhcat=webHCatalogHost] [webhdfs=webHDFSHost]
        [nnPort=nameNodePortNum] [rmPort=resourceManagerPortNum] [ooziePort=ooziePortNum] [webhcatPort=webhcatPortNum] [webhdfsPort=webhdfsPortNum]
        [hiveClientMetastorePort=hiveClientMetastorePortNum] [kerberosRealm=kerberosRealm] [hiveMetaStore=hiveMetaStoreHost]
        [hiveMetaStoreKerberosPrincipal=hiveMetaStoreKerberosPrincipal]

(The parameters are entered on a single line. The parameters surrounded by [ ] are optional. The “[“ and “]” are not part of the command.)
(Note: the Job Tracker in HDP 1.x is now the Resource Manager in HDP 2.x)

    nn - The Name Node host name (required)
    nnHA - If the name node is HA (High Availability), specify the fs.defaultFS value found in core-site.xml
    rm - The Resource Manager host name (uses nn parameter value if omitted)
    oozie - The Oozie host name (uses nn parameter value if omitted)
    webhcat - The WebHCatalog host name (uses nn parameter value if omitted)
    webhdfs - The WebHDFS host name (uses nn parameter value if omitted)
    nnPort - The Name node port number (8020 if omitted)
    rmPort - The Resource Manager port number (8050 if omitted)
    ooziePort - The Oozie port number (11000 if omitted)
    webhcatPort - The WebHCatalog port number (50111 if omitted)
    webhdfsPort - The WebHDFS port number (50070 if omitted)
    hiveClientMetastorePort - The URI port for hive client to connect to metastore server (9083 if omitted)
    kerberosRealm - name of the Kerberos realm
    hiveMetaStore - The Hive Metastore host name (uses nn paarameter value if omitted)
    hiveMetaStoreKerberosPrincipal - The service principal for the metastore thrift server (hive/_HOST if ommitted)

The port numbers are HDP’s defaults. So, if the system being set up has all the services
hosted on a single system on the default ports, only the nn parameter is needed.

The script will exit with an error message if the TDCH is not in its expected location.
Otherwise the script will display a message indicating the parameters values. A sample
message is as follows:

The following is the specification of the Hadoop services used by the Oozie workflows:
{
        "Distribution":"HDP",
        "DistributionVersion":"2.4",
        "TeradataConnectorForHadoopVersion":"1.4.4",
        "WebHCatalog":"hostname",
        "WebHCatalogPort":50111,
        "WebHDFS":"hostname",
        "WebHDFSPort":50070,
        "JobTracker":"hostname",
        "JobTrackerPort":8050,
        "NameNode":"hostname",
        "NameNodePort":8020,
        "NameNodeHA":"fs.defaultFS",
        "NameNodeHAConfigured":true,
        "Oozie":"hostname",
        "OoziePort":11000,
        "HiveClientMetastorePort":9083
        "HiveMetaStoreKerberosPrincipal":"hive/_HOST",
        "KerberosRealm":"",
        "HiveMetaStore":"hostname"
}

** You must also make sure the Teradata IDE/Studio client machine can access the Hadoop system services (hostnames and ports provided to configureOozie script).
Thus, you may need to add the Hadoop services host names and IP addresses to your host file or DNS service.

HORTONWORKS SELF_SIGNED CERTIFICATES:
=====================================

The certificate used by the Knox server needs to be added to the Java runtime's certificate store. You can save the certificate with a web browser.
For example, with Chrome, you can:
•    Enter the Knox server:port in the address bar. It will say that the connection is not private
•    Click Advanced, then click on the Proceed to site link
•    Click on the lock in the address bar and select Details
•    Click View certificate
•    Select the Details tab in the resulting dialog and click the Copy to file... button
•    In the resulting Certificate Export Wizard, save the certificate as Base-64 encoded

(Other browsers have similar methods to get to the Certificate Export Wizard)

Alternatively, on the Knox server, run the command:

     keytool -export -alias gateway-identity -rfc -file knox.crt -keystore <path to gateway.jks keystore (eg. /usr/lib/knox/data/security/keystore/gateway.jks)>

To install the certificate into your Java Runtime certificate store, run the command:
     %JDK_HOME%\bin\keytool.exe -importcert -alias "TDH240 Knox self-signed certificate" -file cert_location/<filename>.txt -keystore %JRE_HOME%\lib\security\cacerts
Where %JDK_HOME% is an environment variable with the location of a JDK and %JRE_HOME% is the location of the JRE used to run Studio.

The keytool.exe will ask for the password to the certificate store. It is “changeit” unless you’ve changed it