Chapter 17. profile

17.1. profile:change-parents

17.1.1. Description

Replace the profile’s parents with the specified list of parents

17.1.2. Syntax

profile:change-parents [options] profile parents

17.1.3. Arguments

NameDescription

profile

Name of the profile.

parents

The list of new parent profiles.

17.1.4. Options

NameDescription

--help

Display this help message

17.2. profile:copy

17.2.1. Description

Copies the specified source profile

17.2.2. Syntax

profile:copy [options] source profile target profile

17.2.3. Arguments

NameDescription

source profile

Name of the source profile.

target profile

Name of the target profile.

17.2.4. Options

NameDescription

--help

Display this help message

-f, --force

Flag to allow overwriting the target profile (if exists).

17.3. profile:create

17.3.1. Description

Create a new profile with the specified name and parents

17.3.2. Syntax

profile:create [options] [profileId]

17.3.3. Arguments

NameDescription

profileId

 

17.3.4. Options

NameDescription

--help

Display this help message

--parents

Optionally specifies one or multiple parent profiles. To specify multiple parent profiles, specify this flag multiple times on the command line. For example, --parents foo --parents bar.

17.3.5. Details

classpath:profileCreate.txt

17.4. profile:delete

17.4.1. Description

Delete the specified profile

17.4.2. Syntax

profile:delete [options] profile

17.4.3. Arguments

NameDescription

profile

Name of the profile to delete.

17.4.4. Options

NameDescription

--help

Display this help message

17.5. profile:display

17.5.1. Description

Displays information about the specified profile

17.5.2. Syntax

profile:display [options] profile

17.5.3. Arguments

NameDescription

profile

The name of the profile.

17.5.4. Options

NameDescription

--overlay, -o

Shows the overlay profile settings, taking into account the settings inherited from parent profiles.

--help

Display this help message

--effective, -e

Shows the effective profile settings, taking into account properties substitution.

--display-resources, -r

Displays the content of additional profile resources.

17.6. profile:edit

17.6.1. Description

Edits the specified profile

17.6.2. Syntax

profile:edit [options] profile

17.6.3. Arguments

NameDescription

profile

The target profile to edit

17.6.4. Options

NameDescription

--remove

Removes value from a delimited list. It is only usable with the system, config & pid options

--help

Display this help message

--delete

Delete values. This option can be used to delete a feature, a bundle or a pid from the profile.

--append

Append value to a delimited list. It is only usable with the system, config & pid options

-c, --config

Edit the Java system properties that affect the karaf container (analogous to editing etc/config.properties in a root container).

--delimiter

Specifies the delimiter to use for appends and removals.

-x, --extension

Edit extension libraries. To specify multiple libraries, specify this flag multiple times.

-p, --pid

Edit an OSGi configuration property, specified in the format <PID>/<Property>. To specify multiple properties, specify this flag multiple times.

--resource

Selects a resource under the profile to edit. This option should only be used alone.

--set

Set or create values (selected by default).

-i, --import-pid

Imports the pids that are edited, from local OSGi config admin

-f, --features

Edit features. To specify multiple features, specify this flag multiple times. For example, --features foo --features bar.

-r, --repositories

Edit the features repositories. To specify multiple repositories, specify this flag multiple times.

-o, --overrides

Edit overrides. To specify multiple libraries, specify this flag multiple times.

-s, --system

Edit the Java system properties that affect installed bundles (analogous to editing etc/system.properties in a root container).

-b, --bundles

Edit bundles. To specify multiple bundles, specify this flag multiple times.

-n, --endorsed

Edit endorsed libraries. To specify multiple libraries, specify this flag multiple times.

-l, --libs

Edit libraries. To specify multiple libraries, specify this flag multiple times.

17.6.5. Details

classpath:profileEdit.txt

17.7. profile:list

17.7.1. Description

Lists all profiles

17.7.2. Syntax

profile:list [options]

17.7.3. Options

NameDescription

--help

Display this help message

--hidden

Display hidden profiles

17.8. profile:rename

17.8.1. Description

Rename the specified source profile

17.8.2. Syntax

profile:rename [options] profile name new profile name

17.8.3. Arguments

NameDescription

profile name

Name of the profile.

new profile name

New name of the profile.

17.8.4. Options

NameDescription

-f, --force

Flag to allow replacing the target profile (if exists).

--help

Display this help message

--version

The profile version to rename. Defaults to the current default version.