Show TOC

Procedure documentationModifying Configuration Templates Locate this document in the navigation structure

 

During installation, a default configuration, which includes configuration templates, is provided to your system. You can make custom changes within the system configuration templates and also activate new templates using the Config Tool. When you apply the new template, it applies to all Java instances in the relevant cluster.

You can also export the custom template as a child, which derives the configuration of the default (parent) template. Then, you can deploy the child on the same or other systems.

More information: Configuration Templates

Note Note

You can create a child template only if you make custom configurations on template level. Instance changes do not affect the template.

End of the note.

Prerequisites

Before changing the template, make sure AS Java is stopped.

Procedure

Activating a Configuration Template

  1. Start the Config Tool by double-clicking the configtool script file in the <SAP_install_dir>\<system_name>\<instance_name>\j2ee\configtool directory.

  2. Choose   File   Change System Template  .

  3. From the dialog window, choose the relevant new template.

    You have the following options, regarding the custom settings of your templates:

    • Apply existing custom settings of the new template – if the new template you want to apply has been previously customized, this option applies its custom settings. If it has never been used, its default settings are applied.

    • Delete custom settings from the new template

      – if the new template has been previously customized, this option deletes its custom settings. If it has never been used, its default settings are applied.

      • Backup present custom settings of the new template – this option creates a backup of the available custom settings of the new template. This helps you if you want to retrieve these settings in your future configurations.

        Note Note

        To restore the backup custom data, choose   File   Restore from Backup  .

        End of the note.

      • Copy current custom settings to the new template – the settings of the new template are overwritten by the custom settings of the template you have currently used.

  4. Optional: You can enter description of the selected template.

  5. Choose OK.

  6. Start the AS Java.

Result: The new configuration template is activated.

Creating a Child Template

  1. Activate the template you want to use as a basis.

  2. Choose the property you need to change (service or manager property, VM parameter and so on).

    Note Note

    To modify VM parameters, choose   View   Expert Mode  .

    End of the note.

  3. In the Custom Value field, enter the new value as a formula based on the parent value ($parent) .

    Example Example

    If you choose Thread Manager and you need to increase the value of InitialThreadCount by 10, you have to enter $parent+10.

    End of the example.

  4. Choose Set Custom Value.

  5. When you are ready with all property configurations, choose Apply Changes (Apply Changes).

  6. To export the modified template, choose   File   Export Custom Template  .

  7. In the dialog box, enter a name and a vendor. Optionally, you can enter a template description.

    The child is exported as an SDA file in the <SAP_install_dir>\<system_name>\<instance_name>\j2ee\configtool\templates directory.

  8. To use the child template, deploy the SDA file. You can also deploy and use it on other systems.

    More information: Using Shell Scripts to Work with SDAs

    Caution Caution

    You can deploy the child only on systems on which the parent template is available.

    End of the caution.

  9. In the Config Tool, activate the new template.

  10. Start AS Java.

Result: The child template is activated and the changes have taken effect.