cfgsamadapter

Name

cfgsamadapter - Configure the end-to-end automation adapter.

Synopsis

cfgsamadapter [-h]

cfgsamadapter [-s]

cfgsamadapter [-s[-g|-gr] [-l location]]

Description

The cfgsamadapter command starts the end-to-end automation adapter configuration dialog, configures the end-to-end automation adapter in silent mode, or generates an input properties file for silent configuration.

Options

<no option>
Starts the configuration dialog as the default action when no option is specified.
-s
  • Starts the configuration utility in silent mode if the -g or -gr option is not specified.
  • Generates an input properties file for silent configuration if the -g or -gr option is specified.
-g
Generates an input properties file for silent configuration if it does not yet exist.
-gr
Generates an input properties file for silent configuration. A file that already exists is replaced.
-l location
In conjunction with options -g and -gr the input properties file for silent configuration is generated in the directory that is specified with location.

To run a silent configuration, the input properties file is retrieved from the directory that is specified with location.

If -l is omitted, the default directory is used, see Examples section.

-h
Writes the command’s usage statement to standard output.

Exit Status

All return codes greater than zero apply if the command is run in silent mode, by using the -s option.
0
The command ran successfully.
1
The command run successfully, but the command output contains warnings.
2
The command failed. Invalid or missing input is detected in the silent input properties file. The command output contains corresponding error messages.
3
The command failed. The attempt to update at least one of the target configuration files failed. The command output lists files and error messages for the unsuccessful update attempts.
9
The command failed due to an unexpected unrecoverable error. The command output contains corresponding error messages.

Security

The command requires either root authority or write access to the directories /etc/opt/IBM/tsamp/sam/cfg and /etc/Tivoli.

Examples

  1. To generate an input properties file for silent configuration, enter: 
    cfgsamadapter -s -g

    Output:

     ----- Generate silent configuration input properties file -----  
Silent configuration input properties file /etc/opt/IBM/tsamp/sam/cfg/silent.samadapter.properties
 has been created.
  2. To generate an input properties file for silent configuration in a location other than the default location, enter: 
    cfgsamadapter -s -g -l /var/config

    Output:

    ----- Generate silent configuration input properties file -----
Silent configuration input properties file /var/config/silent.samadapter.properties has been created.
  3. To configure the end-to-end automation adapter in silent mode, enter: 
    cfgsamadapter -s

    Output:

    Configuration completed successfully. ----- Configuration update status ----- 
Configuration file: /etc/opt/IBM/tsamp/sam/cfg/sam.adapter.properties  Update: OK 
Configuration file: /etc/opt/IBM/tsamp/sam/cfg/sam.adapter.ssl.properties Update: OK 
Configuration file: /etc/opt/IBM/tsamp/sam/cfg/sam.adapter.conf Update: No change 
Configuration file: /etc/opt/IBM/tsamp/sam/cfg/sam.adapter.jaas.properties Update: No change 
Configuration file: /etc/opt/IBM/tsamp/sam/cfg/sam.adapter.jlog.properties Update: No change
Configuration file: /etc/opt/IBM/tsamp/sam/cfg/sam.adapter.plugin.properties Update: No change
Configuration file: /etc/Tivoli/samPublisher.conf  Update: No change 
Configuration file: /etc/opt/IBM/tsamp/sam/cfg/EEZPublisher.conf Update: No change 
Configuration file: /etc/opt/IBM/tsamp/sam/cfg/JDBCPublisher.conf Update: OK 
----- End configuration update status -----

Files

/opt/IBM/tsamp/sam/bin/cfgsamadapter
Location of the cfgsamadapter command.