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:
- Lines starting with a#character are ignored (considered as comments).
- Blank lines are ignored (including lines containing just spaces).
- 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.
- Flags that do not take any argument on the command line should be given a value of either true or false.
- Flag names are case-sensitive.
- If the config file includes invalid flag names or repeated entries, ACT will not launch, and an error will display.
- 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.