Using gtwcontrol to Enable or Disable TLS and to Set the Port - Advanced SQL Engine - Teradata Database

Security Administration

Product
Advanced SQL Engine
Teradata Database
Release Number
17.10
Published
July 2021
Language
English (United States)
Last Update
2022-02-15
dita:mapPath
ppz1593203596223.ditamap
dita:ditavalPath
wrg1590696035526.ditaval
dita:id
B035-1100
lifecycle
previous
Product Category
Teradata Vantageā„¢
TLS can be disabled and later re-enabled by using the gtwcontrol TLS option.
By default TLS is enabled, but Gateway cannot accept TLS connections until the TLS certificates are deployed.

After your system is configured you can use gtwcontrol to change the settings on how you want Gateway to listen on the ports; for example, to listen on both TLS and HTTPS ports or to listen on one port only.

gtwcontrol --TLS [disable|enable|require|nolegacy][,trace=yes|no|all]
  1. To disable TLS:
    gtwcontrol --TLS disable
  2. Restart the database for the change to take effect:
    tpareset -f "Disabling TLS"

Listen on both HTTPS port and Legacy port. Accepts connection on both ports.

# gtwcontrol --TLS enable,trace=no

Listen on both HTTPS port and Legacy port and only accepts connections from HTTPS port

// Listen on both HTTPS port and Legacy port and only accept 
// connections from HTTPS port.
// Return an error for connections from the Legacy port.
# gtwcontrol --TLS require,trace=yes

Listen on Legacy port only

# gtwcontrol --TLS disable,trace=yes

Listen on HTTPS port only

# gtwcontrol --TLS nolegacy,trace=all
The database has to be restarted for the changes to take effect.

For more information, see Teradata Vantageā„¢ - Database Utilities.