Show TOC

Modifying Configuration TemplatesLocate this document in the navigation structure

Use

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

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

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 Start of the navigation path File  Next navigation step  Change System Template End of the navigation path.

  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

        To restore the backup custom data, choose Start of the navigation path File Next navigation step Restore from Backup End of the navigation path.

      • 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

    To modify VM parameters, choose Start of the navigation path View  Next navigation step Expert Mode End of the navigation path.

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

    Example

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

  4. Choose Set Custom Value .

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

  6. To export the modified template, choose Start of the navigation path File  Next navigation step Export Custom Template End of the navigation path.

  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

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

  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.