Return-Path: X-Original-To: apmail-karaf-commits-archive@minotaur.apache.org Delivered-To: apmail-karaf-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id DA794F770 for ; Fri, 22 Mar 2013 22:19:29 +0000 (UTC) Received: (qmail 71512 invoked by uid 500); 22 Mar 2013 22:19:29 -0000 Delivered-To: apmail-karaf-commits-archive@karaf.apache.org Received: (qmail 71481 invoked by uid 500); 22 Mar 2013 22:19:29 -0000 Mailing-List: contact commits-help@karaf.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@karaf.apache.org Delivered-To: mailing list commits@karaf.apache.org Received: (qmail 71473 invoked by uid 99); 22 Mar 2013 22:19:29 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 22 Mar 2013 22:19:29 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 22 Mar 2013 22:19:25 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 58EB4238897A; Fri, 22 Mar 2013 22:19:05 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1460031 [2/19] - in /karaf/site/production/manual/latest-2.2.x: ./ commands/ css/ css/scalate/ developers-guide/ images/ users-guide/ Date: Fri, 22 Mar 2013 22:18:57 -0000 To: commits@karaf.apache.org From: jbonofre@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20130322221905.58EB4238897A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Added: karaf/site/production/manual/latest-2.2.x/commands/admin-rename.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/admin-rename.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/admin-rename.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/admin-rename.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

admin:rename

Description

Renames an existing container instance.

Syntax

admin:rename [options] name new-name

Arguments

Name	Description
name	The name of the container instance to rename
new-name	The new name of the container instance

Options

Name	Description
--help	Display this help message

+ +

+ + \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/commands/admin-start.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/admin-start.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/admin-start.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/admin-start.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

admin:start

Description

Starts an existing container instance.

Syntax

admin:start [options] name

Arguments

Name	Description
name	The name of the container instance

Options

Name	Description
--help	Display this help message
-w, --wait	Wait for the instance to be fully started
-o, --java-opts	Java options when launching the instance

+ +

+ + \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/commands/admin-stop.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/admin-stop.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/admin-stop.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/admin-stop.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

admin:stop

Description

Stops an existing container instance.

Syntax

admin:stop [options] name

Arguments

Name	Description
name	The name of the container instance

Options

Name	Description
--help	Display this help message

+ +

+ + \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/commands/commands.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/commands.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/commands.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/commands.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

Commands

admin

config

dev

feature

feature:chooseurl

features

jaas

log

obr

osgi

packages

shell

ssh

web

web:list

wrapper

wrapper:install

+ +

+ + \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/commands/config-cancel.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/config-cancel.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/config-cancel.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/config-cancel.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

config:cancel

Description

Cancels the changes to the configuration being edited.

Syntax

config:cancel [options]

Options

Name	Description
--help	Display this help message

+ +

+ + \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/commands/config-delete.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/config-delete.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/config-delete.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/config-delete.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

config:delete

Description

Delete a configuration.

Syntax

config:delete [options] pid

Arguments

Name	Description
pid	PID of the configuration

Options

Name	Description
-f, --use-file	Configuration lookup using the filename instead of the pid
--no-delete-cfg-file	Do not delete the configuration file from the etc folder
--help	Display this help message
--force	Force the edition of this config, even if another one was under edition

+ +

+ + \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/commands/config-edit.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/config-edit.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/config-edit.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/config-edit.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

config:edit

Description

Creates or edits a configuration.

Syntax

config:edit [options] pid

Arguments

Name	Description
pid	PID of the configuration

Options

Name	Description
-f, --use-file	Configuration lookup using the filename instead of the pid
--help	Display this help message
--force	Force the edition of this config, ev en if another one was under edition

Details

The edit command can be used to create or edit a configuration by passing its pid as argument.
> config:edit org.apache.karaf.sample.pid
The command above will create a file etc/org.apache.karaf.sample.pid which corresponds to a configuration object with pid org.apache.karaf.sample.pid

In case of Managed Service Factories the user can create or edit the configuration of a specific instance of a managed service.
> config:edit org.apache.karaf.sample.service.factory.pid-instanceid
The command above will create a file etc/org.apache.karaf.sample.service.factory.pid-instanceid but in this case the pid is generated, according to the specification.

This makes further editing to the configuration difficult because the generated pid is not known to the user. To make things simple config:edit provides a special flag -f or --use-file which allows editing a config uration using the filename instead of the pid.
So the user can simply edit again the configuration by typing:
> config:edit org.apache.karaf.sample.service.factory.pid-instanceid.

The --factory option can be used to create a new configuration for a given factory pid. The parameter will be used as the factory pid and the configuration pid will be generated. Note that this option

+ +

+ + \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/commands/config-list.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/config-list.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/config-list.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/config-list.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

config:list

Description

Lists existing configurations.

Syntax

config:list [options] [query]

Arguments

Name	Description
query	Query in LDAP syntax. Example: "(service.pid=org.apache.karaf.log)"

Options

Name	Description
--help	Display this help message

+ +

+ + \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/commands/config-propappend.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/commands/config-propappend.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/commands/config-propappend.html (added) +++ karaf/site/production/manual/latest-2.2.x/commands/config-propappend.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,150 @@ + + + + + + + + + + + Apache Karaf 2.2.11-SNAPSHOT Guides + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + +

+ +

+ + + + + +

+ +

config:propappend

Description

Appends the given value to an existing property or creates the property with the specified name and value.

Syntax

config:propappend [options] name value

Arguments

Name	Description
name	The name of the property
value	The value to append to the property

Options

Name	Description
-b, --bypass-storage	Do not store the configuration in a properties file, but fee d it directly to ConfigAdmin
-p, --pid	The configuration pid
--help	Display this help message

+ +

+ + \ No newline at end of file