TARASetCfg - Tivoli

Teradata Extension for Tivoli Storage Manager Administrator Guide

Product
Tivoli
Release Number
16.20
16.10
Published
May 2017
Language
English (United States)
Last Update
2019-03-22
dita:mapPath
beb1489436039198.ditamap
dita:ditavalPath
beb1489436039198.ditaval
dita:id
wkq1486409855180
Product Category
Teradata Tools and Utilities

The TARASetCfg utility allows the explicit request that a TARA server reset its configuration parameters by re-reading the defaults configuration file.

Under normal conditions, a TARA server updates its configuration parameters only when it is first brought up, or restarted. However, there are scenarios when you might want to modify the configuration parameters in the TARA server's default configuration file, defaults, while the server is still running. TARASetCfg sends a message to the TARA server instructing it to immediately re-read the defaults configuration file and reset its configuration information. This avoids having to restart the TARA server.

Run the TARASetCfg utility by using the following job specification. The command-line parameter indicators are case-sensitive, therefore use the correct case when specifying the individual parameters. Specify each parameter only once in the command line.

TARASetCfg -u -p [-s -P -v]
	 -u <username to logon to TARA server> - (required)
	 -p <password to logon to TARA server> - (required)

OR

 -e <path to encoded password file> - (required)
      -s <TARA servername>          - [Optional]
      -P <port>                     - [Optional] 
      -v <verbose level:  1|2|3>    - [Optional]

The following table describes TARASetCfg parameters, and indicates if the parameter is required.

Parameters for TARASetCfg 
Parameter Description Required Default
-u <User Name> Specifies the User Name that the utility uses to connect to the TARA Server. Currently the user names allowed are administrator and user. The user has the read-only privilege only.

Example

TARASetCfg -u administrator

Yes Not Applicable
-p <password> Specifies the password for the user name the utility uses to connect to the TARA Server.

Example

TARASetCfg -u adminstrator -p xjmT94Rs

Yes Not Applicable
-e <path to encoded password file> Specifies the path to the file that contains the encoded password to the User Name.

Example

TARASetCfg -u administrator -e C:\Teradata\tara.pwd

The file containing the encoded password is created during the post-install of the TARA Server, and is located in the TARA server bin directory: \Teradata\TARA\server\bin). The name of the file is tara.pwd. If the utility is running on a machine different from the TARA server, tara.pwd can be copied to the machine, and the path to the file containing the encoded password can be specified.

If you need to recreate a file with the encoded password, run the TARALogonGen executable located in the TARA server bin directory: \Teradata\TARA\server\bin. Enter the password and the tool creates a tara.pwd. This file contains the encoded password.

Yes Not Applicable
-s <TARA servername> Specifies the TARA server host whose configuration information you want to reset.

The TARA servername value can be a host name (for example, taraserver1 or localhost) or an IP address of a host (for example, 153.64.14.142).

Example

-s taraserver1

Example

-s localhost

Example

-s 153.64.14.142

No localhost
-P <port> Specifies the port number that the TARA server is running on. The default port is 54323. If the TARA Server port is changed to a different number, this option has to be specified with the correct TARA Server port number.

Example

TaraSetCfg -u administrator -p xflu74Rs -j MyBackupJob -P 55555

No 54323
-v <verbose level: 1|2|3> Specifies the level of debug information to display. There are three valid debug levels: 1, 2, and 3. Higher values provides more extensive debug information. This information is typically only useful for utility developers when gathering information about a reported problem.

Example

-v 3 results in the highest level of debug information

The parameters can be specified in any order.

No If this parameter is not specified, debug information will not appear.