19.12. Editing a Profile's Configuration Files

Overview

The container's in a fabric can be dynamically updated with new configuration information by altering configuration settings in one or more of the configuration files the container uses. All of the configuration files are monitored by the OSGi Admin Service. When a change is pushed to a container, the OSGi Admin service loads the changes and updates the container and its services with the new information.
Using the Config Files tab you can:
  • view all of the config files in the profile
  • add config files to the profile
  • edit config files in the profile
  • remove config files from the profile

Adding a config file

Warning
Adding a config file to a profile will deploy the configuration change to any container that is currently using the selected profile.
Important
New config files are initially empty and shouldn't have any effect on a running container. The exception to this rule is when the new config file replaces a config file in a parent profile. The new file will occlude any file with same name in the parent profile.
To add a config file:
  1. Select the profile to which you want to add config files.
    The Profiles page for the selected profile opens.
  2. Select the Config Files tab.
    The Config Files tab will be shown on the bottom of the Profiles page.
  3. In the Add new config file field, enter the name of the configuration file to be added to the profile.
  4. Click Add.
    The new config file will appear in the list and be deployed into any containers using the profile.

Editing a config file

Warning
Any changes that you make to a config file update the configuration settings on any container that is currently using the selected profile.
To edit a config file:
  1. Select the profile from which you want to edit config files.
    The Profiles page for the selected profile opens.
  2. Locate the config file to be edited in the list of config files.
  3. Click the config file's name.
    A text editor with the configuration file opens.
  4. Edit the config file to contain the new settings.
  5. Click Save.
    The editor will close and all of the containers using the profile will have their configuration updated with the new settings.

Deleting a config file

Warning
Deleting a config file from a profile will revert the configuration settings to their defaults on any container that is currently using the selected profile.
To delete a config file:
  1. Select the profile from which you want to delete config files.
    The Profiles page for the selected profile opens.
  2. Locate the config file to be deleted in the list of config files.
  3. Click the X to the right of the file.
    A confirmation dialog opens.
  4. Click Yes.
    The config file is removed from the list and the configuration setting in the file are reverted to defaults on all containers using the profile.