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
Name | Description |
---|---|
profile | Name of the profile. |
parents | The list of new parent profiles. |
17.1.4. Options
Name | Description |
---|---|
--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
Name | Description |
---|---|
source profile | Name of the source profile. |
target profile | Name of the target profile. |
17.2.4. Options
Name | Description |
---|---|
--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
Name | Description |
---|---|
profileId |
17.3.4. Options
Name | Description |
---|---|
--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
Name | Description |
---|---|
profile | Name of the profile to delete. |
17.4.4. Options
Name | Description |
---|---|
--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
Name | Description |
---|---|
profile | The name of the profile. |
17.5.4. Options
Name | Description |
---|---|
--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
Name | Description |
---|---|
profile | The target profile to edit |
17.6.4. Options
Name | Description |
---|---|
--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
Name | Description |
---|---|
--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
Name | Description |
---|---|
profile name | Name of the profile. |
new profile name | New name of the profile. |
17.8.4. Options
Name | Description |
---|---|
-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. |