Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Appendix A. Editing Profiles with the Built-In Text Editor

Abstract

When you have a lot of changes and additions to make to a profile's configuration, it is usually more convenient to do this interactively, using the built-in text editor for profiles. The editor can be accessed by entering the profile-edit command with no arguments except for the profile's name (and optionally, version); or adding the --pid option for editing OSGi PID properties; or adding the --resource option for editing general resources.

A.1. Editing Agent Properties
Copy link

Overview
Copy link

This section explains how to use the built-in text editor to modify a profile's agent properties, which are mainly used to define what bundles and features are deployed by the profile.

Open the agent properties resource
Copy link

To start editing a profile's agent properties using the built-in text editor, enter the following console command: 
JBossFuse:karaf@root> profile-edit Profile [Version]
Copy to Clipboard Toggle word wrap
Where Profile is the name of the profile to edit and you can optionally specify the profile version, Version, as well. The text editor opens in the console window, showing the current profile name and version in the top-left corner of the Window. The bottom row of the editor screen summarizes the available editing commands and you can use the arrow keys to move about the screen.

Specifying feature repository locations
Copy link

To specify the location of a feature repository, add a line in the following format: 
repository.ID=URL
Copy to Clipboard Toggle word wrap
Where ID is an arbitrary unique identifier and URL gives the location of a single feature repository (only one repository URL can be specified on a line).

Specifying deployed features
Copy link

To specify a feature to deploy (which must be available from one of the specified feature repositories), add a line in the following format: 
feature.ID=FeatureName
Copy to Clipboard Toggle word wrap
Where ID is an arbitrary unique identifier and FeatureName is the name of a feature.

Specifying deployed bundles
Copy link

To specify a bundle to deploy, add a line in the following format: 
bundle.ID=URL
Copy to Clipboard Toggle word wrap
Where ID is an arbitrary unique identifier and URL specifies the bundle's location.
Note
A bundle entry can be used in combination with a blueprint: (or spring:) URL handler to deploy a Blueprint XML resource (or a Spring XML resource) as an OSGi bundle.

Specifying bundle overrides
Copy link

To specify a bundle override, add a line in the following format: 
override.ID=URL
Copy to Clipboard Toggle word wrap
Where ID is an arbitrary unique identifier and URL specifies the bundle's location.
Note
A bundle override is used to override a bundle installed by a feature, replacing it with a different version of the bundle. For example, this functionality is used by the patching system to install a patched bundle in a container.

Specifying etc/config.properties properties
Copy link

To specify Java system properties that affect the Apache Karaf container (analogous to editing etc/config.properties in a standalone container), add a line in the following format: 
config.Property=Value
Copy to Clipboard Toggle word wrap

Specifying etc/system.properties properties
Copy link

To specify Java system properties that affect the bundles deployed in the container (analogous to editing etc/system.properties in a standalone container), add a line in the following format: 
system.Property=Value
Copy to Clipboard Toggle word wrap
If the system property, Property, is already set at the JVM level (for example, through the --jvm-opts option to the fabric:container-create command), the preceding fabric:profile-edit command will not override the JVM level setting. To override a JVM level setting, set the system property as follows: 
system.karaf.override.Property=Value
Copy to Clipboard Toggle word wrap

Specifying libraries to add to Java runtime lib/
Copy link

To specify a Java library to deploy (equivalent to adding a library to the lib/ directory of the underlying Java runtime), add a line in the following format: 
lib.ID=URL
Copy to Clipboard Toggle word wrap
Where ID is an arbitrary unique identifier and URL specifies the library's location.
To specify a Java extension library to deploy (equivalent to adding a library to the lib/ext/ directory of the underlying Java runtime), add a line in the following format: 
ext.ID=URL
Copy to Clipboard Toggle word wrap
Where ID is an arbitrary unique identifier and URL specifies the extension library's location.
To specify a Java endorsed library to deploy (equivalent to adding a library to the lib/endorsed/ directory of the underlying Java runtime), add a line in the following format: 
endorsed.ID=URL
Copy to Clipboard Toggle word wrap
Where ID is an arbitrary unique identifier and URL specifies the endorsed library's location.

Example
Copy link

To open the mq-client profile's agent properties for editing, enter the following console command: 
JBossFuse:karaf@root> profile-edit mq-client
Copy to Clipboard Toggle word wrap
The text editor starts up, and you should see the following screen in the console window: 
Profile:mq-client 1.0                                                                 L:1 C:1
#
# Copyright (C) Red Hat, Inc.
# http://redhat.com
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

repository.activemq=mvn:org.apache.activemq/activemq-karaf/${version:activemq}/xml/features
repository.karaf-standard=mvn\:org.apache.karaf.assemblies.features/standard/${version:karaf}/
xml/features

     ^X Quit    ^S Save    ^Z Undo    ^R Redo    ^G Go To    ^F Find    ^N Next    ^P Previous
Copy to Clipboard Toggle word wrap
Type ^X to quit the text editor and get back to the console prompt.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat