Add or Remove Mainframe Connectivity | Teradata Vantage on Azure (DIY) - 2.3 - Adding and Removing Mainframe Connectivity - Teradata Vantage on Azure

Teradata Vantage™ on Azure (DIY) Installation and Administration Guide

Teradata Vantage on Azure
Release Number
April 2022
English (United States)
Last Update
  • Before starting, open port 64432 and keep the port open as long as the mainframe is connected.
  • Verify Teradata version using pdepath -i.
  • Verify if dependent packages ( TCHN, luminex, and bti-channel) are installed or not on the Teradata nodes.

    rpm -qa|grep -Ei 'tchn|luminex|bti-channel'.

    If packages are not present, request you to raise a change request with GSO Change control team.
  • Download TCHN and dependent packages from TSD. Download the same version as the TDBMS versions.
  • Azure only - Upgrade tdc-azure-all to 8.5.5 or the latest version.
  • Run the command tdc-feature-init.
  • For HSN update, run the command tdc-hot-standby update/launch.
Adding or removing mainframe connectivity typically takes 3 to 5 minutes, depending on your configuration.
  1. Stop the database.
    # tpareset –x –y stop for mainframe connectivity
  2. Verify the database is in a DOWN/HARDSTOP state.
    # pdestate -a
    Putting the database in this state may take several minutes.
  3. Do one of the following to run the command.
    Option Action
    To add connectivity
    1. Run tdc-mainframe add with arguments.
    • -c followed by the number of PEs to add
    • -y used in conjunction with -c, bypasses user prompt and proceeds running the command automatically
    • -h to display help information
    To remove connectivity
    1. Run tdc-mainframe delete without arguments.

    PEs and nodes are automatically removed when this command is run.

    • Example of adding two mainframe PEs: tdc-mainframe add -c 2
    • Example of adding one mainframe PE: tdc-mainframe add -c 1
    • The database restarts multiple times when tdc-mainframe is running.
  4. At the prompt, check the database status to make sure logons are enabled.
    # pdestate -a
    PDE state is RUN/STARTED.
    DBS state is 4: Logons are enabled - Users are logged on
  5. If you remove mainframe connectivity, close port 64432.