Validating with the gasadmin tool

The gasadmin tool features options that can prove useful in validating the GAS configuration file and external application configuration files.

configuration-check

gasadmin config --configuration-check

When you run the gasadmin config command with the --configuration-check (-e), it validates the GAS configuration file (as.xcf) and exits. Errors are displayed to the standard output.

configuration-explode

gasadmin config --configuration-explode

When you run the gasadmin config command with the --configuration-explode (-e) option, it explodes the GAS configuration into a hierarchy of configuration elements and outputs them to file in XML format.

One file is created for each application. Each file lists the entire configuration for an application, expanding the inherited components.

<EXECUTION>
  <ENVIRONMENT_VARIABLE Id="FGLDIR">$(res.fgldir)</ENVIRONMENT_VARIABLE>
  <ENVIRONMENT_VARIABLE Id="GREDIR">$(res.gredir)</ENVIRONMENT_VARIABLE>
  <ENVIRONMENT_VARIABLE Id="PATH">$(res.path)</ENVIRONMENT_VARIABLE>
  <ENVIRONMENT_VARIABLE Id="FGLLDPATH">$(res.fglldpath)</ENVIRONMENT_VARIABLE>
  <PATH>$(res.path.fgldir.demo.services)/calculator/server</PATH>
  ...
</EXECUTION>

configuration-expand-resources

gasadmin config -e --configuration-expand-resources

When you use the --configuration-expand-resources (-r) option with the --configuration-explode (-e) it replaces the GAS configuration file's resources and its parent resources with real values, and expand them into XML files.

It can be used in combination with --configuration-explode (-e) or --configuration-explode-external (-t) options.

<EXECUTION>
  <ENVIRONMENT_VARIABLE Id="FGLDIR">C:\4js\fgl</ENVIRONMENT_VARIABLE>
  <ENVIRONMENT_VARIABLE Id="GREDIR">#!GREDIR!#</ENVIRONMENT_VARIABLE>
  <ENVIRONMENT_VARIABLE Id="PATH">C:\Windows;C:\4js\gas\2.50.34\bin;#!GREDIR!#\bin;C:\4js\fgl\bin;C:\4js\fgl\lib</ENVIRONMENT_VARIABLE>
  <ENVIRONMENT_VARIABLE Id="FGLLDPATH">C:\4js\gas\2.50.34\lib;#!GREDIR!#\lib;C:\4js\fgl\lib</ENVIRONMENT_VARIABLE>
  <PATH>C:\4js\fgl/demo/WebServices/calculator/server</PATH>
  ...
</EXECUTION>