Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved


Chapter 3 Core Engine Configuration : Validation Tool (asg-validate)

Validation Tool (asg-validate)
The asg-validate tool checks for a complete and correct configuration set using the Config UI before the configuration can be used by the Core Engine at run time.
The asg-validate tool loads the data from all the configuration (cfg) files for a gateway configuration project into the memory and validates it against each other. The asg-validate also loads and compiles all the XSLT files for a gateway configuration project and therefore it checks if the XSLT files are valid.
The asg-validate tool ensures that the data in one configuration file that is dependent on the other configuration file is valid.
For example, you have defined a partner P_1 and assigned it to a partner group PG_1 for a myconfig project configuration. When you run asg-validate for myconfig project, it loads partner P_1 data into memory and finds that this is assigned to PG_1 partner group. Then it checks if the data of partner group PG_1 is also available in the memory of the Core Engine. If it does not find PG_1 partner group data, it throws an error indicating that partner group PG_1 is not defined in Partner Groups.
If all data such as partner, target operations, facade operations, throttles, and so on, is valid and correct for a project configuration, it displays a successful message as: The ASG configuration status is OK . Otherwise, it reports errors on the console.
You can find the output of the asg-validate tool in a log file. See Log File for asg-validate
Running asg-validate Using asg-tools
You can use the asg-tools utility to perform the validation for a gateway project configuration.
Perform the validation for a project configuration as follows:
1.
Navigate to the ASG_HOME/bin directory.
2.
   asg-tools -u asg-validate -a asg_config_name
where asg_config_name is the name of the configuration to be validated.
For example, to validate the BookQueryBE configuration type the following command:
   asg-tools -u asg-validate -a BookQueryBE
Log File for asg-validate
The output of the asg-validate tool is stored in a log file named asg-validate.log. By default, this log file is located in the ASG_CONFIG_HOME/logs directory. You can change the location of the logs directory in the ASG_HOME/bin/asg_validation.cdd file by editing the dir parameter as follows:
   <log-configs>
      <log-config id="logConfig">
   <dir>C:/ProgramData/TIBCO_ASG/tibco/cfgmgmt/logs</dir>
Limitations of asg-validate
The asg-validate mainly validates the integrity of data stored in the configuration files for a configuration set. This tool does not detect certain configuration issues such as invalid URL for a transport, invalid queue, or topic name for JMS services.
The Validate icon on the Config UI uses the asg-validate tool to validate the configuration data entered on the UI. It is recommended to run the validation after you have entered the complete data for a project configuration set. This helps to find the errors at design time so that they can be fixed earlier and prevents errors at runtime for the Core Engine.

Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved