Creating an augment file from a sample data file

Sample templates for data files are in the samples directory: RAFW_HOME/samples.

Procedure

  1. In the RAFW_HOME/samples directory, locate the data file used by the action.

    Location of samples directory

  2. To create the augment file, use the sample data file and do the following:
    • Save the sample data file with the _augment suffix. If the data file is variables.xml, the augment file name is variables_augment.xml.
    • Save the augment file to the augment directory:
      RAFW_HOME\user\environments\ENV01\cells\CELL01\nodes\NODE01\augment\variables_augment.xml
    • Save the augment file to the execution scope in the cell definition.

      For example, to run the action at the node scope, save the augment file to the augment directory at the node scope:

      RAFW_HOME\user\environments\cells\CELL01\nodes\NODE01\augment\variables_augment.xml
  3. Modify the augment file so that it contains only the configuration data that you want to add.

    For example to add a new WebSphere® variable, delete everything in the variables_augment.xml file except for the new <VariableSubstitutionEntry> element node and its parent element node.

    Example:
    <?xml version="1.0" encoding="UTF-8"?>
    <Variables>
    <RAFW_variables>
    <VariableSubstitutionEntry description=
    "Variable created via augment mode in RAFW" symbolicName="AUGMENT_VAR" value="test">
    </VariableSubstitutionEntry>
    </RAFW_variables>
    </Variables>
  4. Save the augment file.
  5. Run the action in augment mode.

Feedback