blob: 38ddf8ca9d8ac7fe43c77339d322f0841de5edf6 [file] [log] [blame]
h1. Configuration
The files in the {{etc}} directory are used to set the startup configuration.
For dynamic configuration, Karaf provides a suite of command to administer the configuration service grouped under {{config}}. To learn about all currently supported configuration commands type:
|| Command || Description ||
| [{{cancel}}|/commands/config-cancel] | Change the changes to the configuration being edited. |
| [{{edit}}|/commands/config-edit] | Create or edit a configuration. |
| [{{list}}|/commands/config-list] | List existing configurations. |
| [{{propdel}}|/commands/config-propdel] | Delete a property from the edited configuration. |
| [{{proplist}}|/commands/config-proplist] | List properties from the edited configuration. |
| [{{propset}}|/commands/config-propset] | Set a property on the edited configuration. |
| [{{update}}|/commands/config-update] | Save and propagate changes from the configuration being edited. |
h2. Editing
h3. Select Configuration To Edit
For example to edit configuration {{foo.bar}}:
{code}
karaf@root> config:edit foo.bar
{code}
h3. Modify Properties
Use:
* [{{config:proplist}}|/commands/config-proplist] to list existing properties
* [{{config:propdel}}|/commands/config-propdel] to delete existing properties
* [{{config:propset}}|/commands/config-propset] to set a new value for a property
Any number of properties can be modified within a single editing session.
h3. Commit Or Rollback Changes
Use
* [{{config:update}}|/commands/config-update] to commit all changes made in the current session
* [{{config:cancel}}|/commands/config-cancel] to roll back any changes made in the current session