Using a Configuration File to Pass ACT Startup Parameters - Aster Client

Teradata Aster® Client Guide

Product
Aster Client
Release Number
7.00
Published
May 2017
Language
English (United States)
Last Update
2018-04-13
dita:mapPath
hki1475000360386.ditamap
dita:ditavalPath
Generic_no_ie_no_tempfilter.ditaval
dita:id
B700-2005
lifecycle
previous
Product Category
Software

Specifying all the necessary startup parameters for ACT on the command line can become cumbersome, especially when using SSL. Because of this, Teradata Aster has provided a way to specify startup parameters in a configuration file, to streamline starting ACT. On Windows and Linux/UNIX-based operating systems, ACT looks for the configuration file in a specific location and loads it automatically. Alternatively, the configuration file may be invoked using the --config-file parameter when launching ACT.

All of the startup parameters in ACT are supported in the config file, except for the following:

--config-file
-V [ --version ]
-? [ --help ]

To use a configuration file, first create a text file of startup parameters. The following rules apply when creating the config file:

  1. Lines starting with a#character are ignored (considered as comments).
  2. Blank lines are ignored (including lines containing just spaces).
  3. Parameters are entered using the format
    flagname: value

    where flagname is same as the name of the command line flag without the preceding hyphens (--) and value is the flag value as it would be provided on the command line. Short notations of flags are not supported. For example:

    host: <ip>

    will work but the following:

    h: <ip>

    will not work.

  4. Flags that do not take any argument on the command line should be given a value of either true or false.
  5. Flag names are case-sensitive.
  6. If the config file includes invalid flag names or repeated entries, ACT will not launch, and an error will display.
  7. If the config file includes the on-error-stop option with the parameters set to enable this option, ACT will stop if an error occurs while running SQL queries. See Setting "on-error-stop" in the ACT config file for information on setting this option.