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. |

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.