Install Teradata Studio | Using the Wizard on Windows | Teradata Studio - Installing Teradata Studio Using the Wizard - Teradata Studio

Teradata® Studio™ and Studio™ Express Installation Guide
Product
Teradata Studio
Release Number
17.00
Published
January 2021
Language
English (United States)
Last Update
2021-01-11
dita:mapPath
njz1576517377361.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-2037
lifecycle
previous
Product Category
Teradata Tools and Utilities
  1. Navigate to the directory where you downloaded the Teradata Studio package.
  2. Unzip the Teradata Studio package to your local file system.
  3. [Optional] Pre-configure connection profiles to be assigned at installation:
    1. In the unzipped Teradata Studio package, navigate to the Config directory.
    2. Edit the TeradataStudioDataSources_template.config file to define the connection profiles.
    3. Save the file as TeradataStudioDataSources.config in the Config directory or any other directory that is accessible by the installation process.
  4. [Optional] Pre-configure preferences to be set at installation:
    If you edited and saved the TeradataStudioDataSources.config file to an alternate directory location in the previous step, then save the TeradataStudioPreferences.config file to this same location.
    1. In the unzipped Teradata Studio package, navigate to the Config directory.
    2. Edit the TeradataStudioPreferences_template.config file to define the preferences.
    3. Save the file as TeradataStudioPreferences.config in the Config directory or any other directory that is accessible by the installation process.
  5. [Optional] If you intend to connect to systems using Kerberos Authentication, create a krb5.ini file. This task is outside the scope of Teradata Studio.
  6. Double-click setup.exe to start the Teradata Studio installer, accept the license, and select the Java Runtime Environment.
    If Oracle JRE 8, 10, or 11 is installed, the Installer dialog specifies the JRE path. If JRE from another vendor is installed, such as Zulu, click Browse to select a compatible version.

    If the selected Java Runtime Environment is different than system default JRE (JRE configured in the PATH environment variable), the selected JRE location will be added in the TeradataStudio.ini file.

    If the JRE is removed or upgraded after installing Teradata Studio, run the UpdateJRE.vbs as administrator to update JRE path in the TeradataStudio.ini file. For example:

    cscript UpdateJRE.vbs "C:\Program Files\Java\jre1.8.0_151\"

    This script is in the same directory as TeradataStudio.exe.

  7. In the Workspace Location step, keep the default or Browse to a different location.
    The workspace directory contains workspace files, including the SQL project folder and log file.
  8. [Optional] If you edited the TeradataStudioDataSources.config or TeradataStudioPreferences.config file, do the following in the install wizard:
    1. On the Pre-Configure Database Connection Profile page of the Install Wizard, select Set up Studio with pre-configured TeradataStudioDataSources.config and/or TeradataStudioPreferences.config files.
    2. Browse for the location of the files.
  9. [Optional] If you intend to connect to systems using Kerberos Authentication, do the following in the install wizard:
    1. On the Pre-Configure Database Connection Profile page of the Install Wizard, select Setup for Kerberos environment. As noted, this will modify the registry so be sure you have registry edit permission. The TeradataStudio.ini file will also be modified.
    2. Browse to the location of your krb5.ini file and click OK and then Next.
  10. Designate the Destination Folder options you want and click Next.
  11. Click Install.
  12. If you intend to connect to systems using Kerberos Authentication, you must run kinit to initialize your Kerberos credential before launching Teradata Studio.