Author: jbonofre
Date: Wed Dec 25 20:23:04 2013
New Revision: 1553413
URL: http://svn.apache.org/r1553413
Log:
[scm-publish] Updating main site with Karaf manual
Modified:
karaf/site/production/manual/latest/update-notes.html
Modified: karaf/site/production/manual/latest/update-notes.html
URL:
http://svn.apache.org/viewvc/karaf/site/production/manual/latest/update-notes.html?rev=1553413&r1=1553412&r2=1553413&view=diff
==============================================================================
--- karaf/site/production/manual/latest/update-notes.html (original)
+++ karaf/site/production/manual/latest/update-notes.html Wed Dec 25 20:23:04
2013
@@ -101,7 +101,7 @@
</td>
<td height="100%" width="100%">
<div class="wiki-content">
-<h1 id="UpdateNotesfrom2.xto3.x">Update Notes (from 2.x to 3.x)</h1><p>This
section is dedicated to users of previous Apache Karaf version.</p><h2
id="Distributions">Distributions</h2><p>The Apache Karaf distributions content
has changed.</p><p>On Apache Karaf 2.x, we provide:</p><ul><li>tar.gz archive
dedicated for Unix platforms</li><li>zip archive dedicated for Windows
platforms</li></ul><p>Now, Apache Karaf 3.x still provide tar.gz and zip
archives, but the content is the same.<br/>Especially, the two archives
contains a <tt>bin</tt> folder with both Unix scripts and Windows bat
scripts.</p><h2 id="Commands">Commands</h2><p>All console commands have been
renamed and dispatched in scopes between Apache Karaf 2.x and Apache Karaf
3.x.</p><p>The purpose is to standardize the naming convention, and use more
"logic" scope (especially for subshell).</p><p>The following table shows the
correspondence between the "old" commands and the "new" ones.</p><div
class="table-wrap"><table class
="confluenceTable"><tr><th class="confluenceTh"> Apache Karaf 2.x
</th><th class="confluenceTh"> Apache Karaf 3.x </th></tr><tr><td
class="confluenceTd"> admin:change-opts </td><td
class="confluenceTd"> instance:opts-change
</td></tr><tr><td class="confluenceTd"> admin:change-rmi-registry-port
</td><td class="confluenceTd"> instance:rmi-registry-port-change
</td></tr><tr><td class="confluenceTd"> admin:change-rmi-server-port
</td><td class="confluenceTd"> instance:rmi-server-port-change
</td></tr><tr><td class="confluenceTd"> admin:change-ssh-port
</td><td class="confluenceTd"> instance:ssh-port-change
</td></tr><tr><td class="confluenceTd"> admin:clone
</td><td class="confluenceTd"> instance:clone
</td></tr><tr><td class="confluenceTd"> admin:connect
</td><td class="confluenceTd"> instance:connect
</td></tr><tr><td class="confluenceTd"> admin:create
</td><td class="confluenceTd"> instance:create
</td></tr><tr><td class="confluenceTd"> admin:destroy
</td><td class="confluenceTd"> instance:destroy
</td></tr><tr><td class="confluenceTd"> admin:list
</td><td class="confluenceTd"> instance:list
</td></tr><tr><td class="confluenceTd"> admin:rename
</td><td class="confluenceTd"> instance:rename
</td></tr><tr><td class="confluenceTd"> admin:start
</td><td class="confluenceTd"> instance:start
</td></tr><tr><td class="confluenceTd"> admin:status
</td><td class="confluenceTd"> instance:status
</td></tr><tr><td class="confluenceTd"> admin:stop
</td><td class="confluence
Td"> instance:stop </td></tr><tr><td
class="confluenceTd"> dev:create-dump </td><td
class="confluenceTd"> dev:dump-create
</td></tr><tr><td class="confluenceTd"> features:add-url
</td><td class="confluenceTd"> feature:repo-add
</td></tr><tr><td class="confluenceTd"> features:chooseurl
</td><td class="confluenceTd"> feature:repo-add
</td></tr><tr><td class="confluenceTd"> features:info
</td><td class="confluenceTd"> feature:info
</td></tr><tr><td class="confluenceTd"> features:install
</td><td class="confluenceTd"> feature:install
</td></tr><tr><td class="confluenceTd"> features:listVersions
</td><td class="confluenceTd"> feature:version-list
</td></tr><tr><td class="confluenceTd"> features:list
</td><td class="confluenceTd"> feature:list
</td></tr><tr><td class="confluenceTd"> features:listRepositories
</td><td class="confluenceTd"> feature:repo-list
</td></tr><tr><td class="confluenceTd"> features:listUrl
</td><td class="confluenceTd"> feature:repo-list
</td></tr><tr><td class="confluenceTd"> features:refreshUrl
</td><td class="confluenceTd"> feature:repo-refresh
</td></tr><tr><td class="confluenceTd"> features:removeRepository
</td><td class="confluenceTd"> feature:repo-remove
</td></tr><tr><td class="confluenceTd"> features:removeUrl
</td><td class="confluenceTd"> feature:repo-remove
</td></tr><tr><td class="confluenceTd"> features:uninstall
</td><td class="confluenceTd"> feature:uninstall
</td></tr><tr><td class="confluenceT
d"> jaas:cancel </td><td class="confluenceTd">
jaas:cancel </td></tr><tr><td
class="confluenceTd"> jaas:pending </td><td
class="confluenceTd"> jaas:pending-list
</td></tr><tr><td class="confluenceTd"> jaas:realms
</td><td class="confluenceTd"> jaas:realm-list
</td></tr><tr><td class="confluenceTd"> jaas:users
</td><td class="confluenceTd"> jaas:user-list
</td></tr><tr><td class="confluenceTd"> jaas:manage
</td><td class="confluenceTd"> jaas:realm-manage
</td></tr><tr><td class="confluenceTd"> jaas:roleadd
</td><td class="confluenceTd"> jaas:role-add
</td></tr><tr><td class="confluenceTd"> jaas:roledel
</td><td class="confluenceTd"> jaas:role-delete </td
></tr><tr><td class="confluenceTd"> jaas:update </td><td
>class="confluenceTd"> jaas:update
></td></tr><tr><td class="confluenceTd"> jaas:useradd
></td><td class="confluenceTd"> jaas:user-add
></td></tr><tr><td class="confluenceTd"> jaas:userdel
></td><td class="confluenceTd"> jaas:user-delete
></td></tr><tr><td class="confluenceTd"> shell:alias
></td><td class="confluenceTd"> shell:alias
></td></tr><tr><td class="confluenceTd"> shell:cat
></td><td class="confluenceTd"> shell:cat
></td></tr><tr><td class="confluenceTd"> shell:clear
></td><td class="confluenceTd"> shell:clear
></td></tr><tr><td class="confluenceTd"> shell:date
></td><td class="confluenceTd"> shell:date
</td></tr><tr><td class="confluenceTd"> shell:each
</td><td class="confluenceTd"> shell:each
</td></tr><tr><td class="confluenceTd"> shell:echo
</td><td class="confluenceTd"> shell:echo
</td></tr><tr><td class="confluenceTd"> shell:exec
</td><td class="confluenceTd"> shell:exec
</td></tr><tr><td class="confluenceTd"> shell:grep
</td><td class="confluenceTd"> shell:grep
</td></tr><tr><td class="confluenceTd"> shell:head
</td><td class="confluenceTd"> shell:head
</td></tr><tr><td class="confluenceTd"> shell:history
</td><td class="confluenceTd"> shell:history
</td></tr><tr><td class="confluenceTd"> shell:if
</td><td clas
s="confluenceTd"> shell:if </td></tr><tr><td
class="confluenceTd"> shell:info </td><td
class="confluenceTd"> shell:info
</td></tr><tr><td class="confluenceTd"> shell:java
</td><td class="confluenceTd"> shell:java
</td></tr><tr><td class="confluenceTd"> shell:logout
</td><td class="confluenceTd"> shell:logout
</td></tr><tr><td class="confluenceTd"> shell:more
</td><td class="confluenceTd"> shell:more
</td></tr><tr><td class="confluenceTd"> shell:new
</td><td class="confluenceTd"> shell:new
</td></tr><tr><td class="confluenceTd"> shell:printf
</td><td class="confluenceTd"> shell:printf
</td></tr><tr><td class="confluenceTd"> shell:sleep
</td><td class="confluenceTd"> shell:sleep
</td></tr><tr><td class="confluenceTd"> shell:sort
</td><td class="confluenceTd"> shell:sort
</td></tr><tr><td class="confluenceTd"> shell:source
</td><td class="confluenceTd"> shell:source
</td></tr><tr><td class="confluenceTd"> shell:tac
</td><td class="confluenceTd"> shell:tac
</td></tr><tr><td class="confluenceTd"> shell:tail
</td><td class="confluenceTd"> shell:tail
</td></tr><tr><td class="confluenceTd"> shell:watch
</td><td class="confluenceTd"> shell:watch
</td></tr><tr><td class="confluenceTd"> shell:wc
</td><td class="confluenceTd"> shell:wc
</td></tr><tr><td class
="confluenceTd"> config:cancel </td><td
class="confluenceTd"> config:cancel
</td></tr><tr><td class="confluenceTd"> config:delete
</td><td class="confluenceTd"> config:delete
</td></tr><tr><td class="confluenceTd"> config:edit
</td><td class="confluenceTd"> config:edit
</td></tr><tr><td class="confluenceTd"> config:list
</td><td class="confluenceTd"> config:list
</td></tr><tr><td class="confluenceTd"> config:propappend
</td><td class="confluenceTd"> config:property-append
</td></tr><tr><td class="confluenceTd"> config:propdel
</td><td class="confluenceTd"> config:property-delete
</td></tr><tr><td class="confluenceTd"> config:proplist
</td><td class="confluenceTd"> config:property-list
</td></tr><tr><td class="confluenceTd"> config:propset
</td><td class="confluenceTd"> config:property-set
</td></tr><tr><td class="confluenceTd"> config:update
</td><td class="confluenceTd"> config:update
</td></tr><tr><td class="confluenceTd"> dev:dynamic-import
</td><td class="confluenceTd"> bundle:dynamic-import
</td></tr><tr><td class="confluenceTd"> dev:framework
</td><td class="confluenceTd"> system:framework
</td></tr><tr><td class="confluenceTd"> dev:print-stack-traces
</td><td class="confluenceTd"> shell:stack-traces-print
</td></tr><tr><td class="confluenceTd"> dev:restart
</td><td class="confluenceTd"> system:shutdown
</td></tr><tr><td class="confluenceTd"> dev:show-tree
</td><td class="confluenceTd"> b
undle:tree-show </td></tr><tr><td
class="confluenceTd"> dev:system-property </td><td
class="confluenceTd"> system:property
</td></tr><tr><td class="confluenceTd"> dev:wait-for-service
</td><td class="confluenceTd"> service:wait
</td></tr><tr><td class="confluenceTd"> dev:watch
</td><td class="confluenceTd"> bundle:watch
</td></tr><tr><td class="confluenceTd"> log:clear
</td><td class="confluenceTd"> log:clear
</td></tr><tr><td class="confluenceTd"> log:display-exception
</td><td class="confluenceTd"> log:exception-display
</td></tr><tr><td class="confluenceTd"> log:display
</td><td class="confluenceTd"> log:display
</td></tr><tr><td class="confluenceTd"> log:get
</td><td class="confluenceTd"> log:get
</td></tr><tr><td class="confluenceTd"> log:tail
</td><td class="confluenceTd"> log:tail
</td></tr><tr><td class="confluenceTd"> log:set
</td><td class="confluenceTd"> log:set
</td></tr><tr><td class="confluenceTd"> obr:addUrl
</td><td class="confluenceTd"> obr:url-add
</td></tr><tr><td class="confluenceTd"> obr:deploy
</td><td class="confluenceTd"> obr:deploy
</td></tr><tr><td class="confluenceTd"> obr:find
</td><td class="confluenceTd"> obr:find
</td></tr><tr><td class="confluenceTd"> obr:info
</td><td class="confluenceTd"> obr:info
</td></tr><tr><td class="confluenceTd"> ob
r:list </td><td class="confluenceTd"> obr:list
</td></tr><tr><td class="confluenceTd"> obr:listUrl
</td><td class="confluenceTd"> obr:url-list
</td></tr><tr><td class="confluenceTd"> obr:refreshUrl
</td><td class="confluenceTd"> obr:url-refresh
</td></tr><tr><td class="confluenceTd"> obr:removeUrl
</td><td class="confluenceTd"> obr:url-remove
</td></tr><tr><td class="confluenceTd"> obr:resolve
</td><td class="confluenceTd"> obr:resolve
</td></tr><tr><td class="confluenceTd"> obr:source
</td><td class="confluenceTd"> obr:source
</td></tr><tr><td class="confluenceTd"> obr:start
</td><td class="confluenceTd"> obr:start
</td></tr>
<tr><td class="confluenceTd"> osgi:bundle-level </td><td
class="confluenceTd"> bundle:start-level
</td></tr><tr><td class="confluenceTd"> osgi:classes
</td><td class="confluenceTd"> bundle:classes
</td></tr><tr><td class="confluenceTd"> osgi:find-class
</td><td class="confluenceTd"> bundle:find-class
</td></tr><tr><td class="confluenceTd"> osgi:headers
</td><td class="confluenceTd"> bundle:headers
</td></tr><tr><td class="confluenceTd"> osgi:info
</td><td class="confluenceTd"> bundle:info
</td></tr><tr><td class="confluenceTd"> osgi:install
</td><td class="confluenceTd"> bundle:install
</td></tr><tr><td class="confluenceTd"> osgi:bundle-services
</td><td class="confluenceTd"> bundle:services
</td></tr><tr><td class="confluenceTd"> osgi:list
</td><td class="confluenceTd"> bundle:list
</td></tr><tr><td class="confluenceTd"> osgi:ls
</td><td class="confluenceTd"> service:list
</td></tr><tr><td class="confluenceTd"> osgi:name
</td><td class="confluenceTd"> system:name
</td></tr><tr><td class="confluenceTd"> osgi:refresh
</td><td class="confluenceTd"> bundle:refresh
</td></tr><tr><td class="confluenceTd"> osgi:resolve
</td><td class="confluenceTd"> bundle:resolve
</td></tr><tr><td class="confluenceTd"> osgi:restart
</td><td class="confluenceTd"> bundle:restart
</td></tr><tr><td class="confluenceTd"> osgi:shutdown
</td><td class="con
fluenceTd"> system:shutdown </td></tr><tr><td
class="confluenceTd"> osgi:start </td><td
class="confluenceTd"> bundle:start
</td></tr><tr><td class="confluenceTd"> osgi:start-level
</td><td class="confluenceTd"> bundle:start-level
</td></tr><tr><td class="confluenceTd"> osgi:stop
</td><td class="confluenceTd"> bundle:stop
</td></tr><tr><td class="confluenceTd"> osgi:uninstall
</td><td class="confluenceTd"> bundle:uninstall
</td></tr><tr><td class="confluenceTd"> osgi:update
</td><td class="confluenceTd"> bundle:update
</td></tr><tr><td class="confluenceTd"> osgi:version
</td><td class="confluenceTd"> system:version
</td></tr><tr><td class="confluenceTd"> packages:exports
</td><td class="confluenceTd"> package:exports
</td></tr><tr><td class="confluenceTd"> packages:imports
</td><td class="confluenceTd"> package:imports
</td></tr><tr><td class="confluenceTd"> ssh:ssh
</td><td class="confluenceTd"> ssh:ssh
</td></tr><tr><td class="confluenceTd"> ssh:sshd
</td><td class="confluenceTd"> ssh:sshd
</td></tr><tr><td class="confluenceTd"> web:list
</td><td class="confluenceTd"> web:list
</td></tr><tr><td class="confluenceTd"> wrapper:install
</td><td class="confluenceTd"> wrapper:install
</td></tr></table></div><p>We encourage the users to use the <tt>--help</tt>
option to check the name and type of arguments and options.</p><h2
id="JMXMBeans">JMX MBeans</h2><p
>Like the console commands, the JMX MBeans object names have been renamed and
>the operations haven been dispatched in<br/>new MBeans.</p><p>The following
>table shows the correspondence between the "old" MBeans object names and the
>"new" ones.</p><div class="table-wrap"><table class="confluenceTable"><tr><th
>class="confluenceTh"> Apache Karaf 2.x </th><th
>class="confluenceTh"> Apache Karaf 3.x
></th></tr><tr><td class="confluenceTd">
><tt>org.apache.karaf:type=bundles,name=*</tt> </td><td
>class="confluenceTd"> <tt>org.apache.karaf:type=bundle,name=*</tt>
></td></tr><tr><td class="confluenceTd">
><tt>org.apache.karaf:type=config,name=*</tt> </td><td
>class="confluenceTd"> <tt>org.apache.karaf:type=config,name=*</tt>
></td></tr><tr><td class="confluenceTd">
><tt>org.apache.karaf:type=dev,name=*</tt> </td><td
>class="confluenceTd"> <tt>org.apache.karaf:type=system,name=*</tt>
></td></tr>
<tr><td class="confluenceTd"> <tt>org;apache.karaf:type=log,name=*</tt>
</td><td class="confluenceTd"> <tt>org.apache.karaf:type=log,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=obr,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=obr,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=packages,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=package,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=services,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=service,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=system,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=system,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=web,name=*</tt> </td><td
class="confluenceTd">
<tt>org.apache.karaf:type=web,name=*</tt>
</td></tr></table></div><h2 id="Features">Features</h2><p>The Apache Karaf
"core" features repository XML URL have changed:</p><div
class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh">
Apache Karaf 2.x
</th><th class="confluenceTh"> Apache Karaf 3.x
</th></tr><tr><td class="confluenceTd">
<tt>mvn:org.apache.karaf.assemblies.features/standard/2.3.x/xml/features</tt>
</td><td class="confluenceTd">
<tt>mvn:org.apache.karaf.features/standard/3.0.x/xml/features</tt>
</td></tr><tr><td class="confluenceTd">
<tt>mvn:org.apache.karaf.assemblies.features/enterprise/2.3.x/xml/features</tt>
</td><td class="confluenceTd">
<tt>mvn:org.apache.karaf.features/enterprise/3.0.x/xml/features</tt>
</td></tr></table></div><p>The Spring features have been isolated in a
dedicated features repository (<tt>m
vn:org.apache.karaf.features/spring/3.0.x/xml/features</tt>).</p><h2
id="Namespaces">Namespaces</h2><p>Apache Karaf 3.x brings updated version of
the namespaces:</p><ul><li>Supported features
namespaces:<ul><li><tt>karaf-features-1.0.0.xsd</tt></li><li><tt>karaf-features-1.1.0.xsd</tt></li><li><tt>karaf-features-1.2.0.xsd</tt></li></ul></li><li>Supported
jaas
namespaces:<ul><li><tt>karaf-jaas-1.0.0.xsd</tt></li><li><tt>karaf-jaas-1.1.0.xsd</tt></li></ul></li><li>Supported
shell
namespaces:<ul><li><tt>karaf-shell-1.0.0.xsd</tt></li><li><tt>karaf-shell-1.1.0.xsd</tt></li></ul></li></ul><h2
id="Mavenplugin">Maven plugin</h2><p>The previous
<tt>features-maven-plugin</tt> and <tt>cmdhelp-maven-plugin</tt> Maven plugins
have been gathered in one main Maven<br/>plugin:
<tt>karaf-maven-plugin</tt>.</p><p>The goals have changed as follow:</p><div
class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh">
Apache Karaf 2.x Maven plugins </th><th class="conflu
enceTh"> Apache Karaf Maven Plugin (3.x) </th></tr><tr><td
class="confluenceTd"> features:add-features-to-repo </td><td
class="confluenceTd"> karaf:features-add-to-repository
</td></tr><tr><td class="confluenceTd"> features:create-kar
</td><td class="confluenceTd"> karaf:features-create-kar
</td></tr><tr><td class="confluenceTd"> features:generate-features-file
</td><td class="confluenceTd"> karaf:features-generate-descriptor
</td></tr><tr><td class="confluenceTd">
features:generate-features-xml </td><td class="confluenceTd">
karaf:features-generate-descriptor </td></tr><tr><td
class="confluenceTd"> features:install-kars </td><td
class="confluenceTd"> karaf:install-kars
</td></tr><tr><td class="confluenceTd"> features:validate-features
</td><td class="co
nfluenceTd"> karaf:features-validate-descriptor
</td></tr><tr><td class="confluenceTd"> cmdhelp:cmdhelp
</td><td class="confluenceTd"> karaf:commands-generate-help
</td></tr></table></div><p>Using the
<tt>features:add-features-to-repo</tt> goal, you have now to explicitily define
the Apache Karaf features URL (previously, the Apache Karaf features were
automatically added).<br/>It means that you have to define:</p><pre>
+<h1 id="UpdateNotesfrom2.xto3.x">Update Notes (from 2.x to 3.x)</h1><p>This
section is dedicated to users of previous Apache Karaf version.</p><h2
id="Distributions">Distributions</h2><p>The Apache Karaf distributions content
has changed.</p><p>On Apache Karaf 2.x, we provide:</p><ul><li>tar.gz archive
dedicated for Unix platforms</li><li>zip archive dedicated for Windows
platforms</li></ul><p>Now, Apache Karaf 3.x still provide tar.gz and zip
archives, but the content is the same.<br/>Especially, the two archives
contains a <tt>bin</tt> folder with both Unix scripts and Windows bat
scripts.</p><h2 id="Commands">Commands</h2><p>All console commands have been
renamed and dispatched in scopes between Apache Karaf 2.x and Apache Karaf
3.x.</p><p>The purpose is to standardize the naming convention, and use more
"logic" scope (especially for subshell).</p><p>The following table shows the
correspondence between the "old" commands and the "new" ones.</p><div
class="table-wrap"><table class
="confluenceTable"><tr><th class="confluenceTh"> Apache Karaf 2.x
</th><th class="confluenceTh"> Apache Karaf 3.x
</th></tr><tr><td class="confluenceTd"> admin:change-opts
</td><td class="confluenceTd"> instance:opts-change
</td></tr><tr><td class="confluenceTd"> admin:change-rmi-registry-port
</td><td class="confluenceTd"> instance:rmi-registry-port-change
</td></tr><tr><td class="confluenceTd"> admin:change-rmi-server-port
</td><td class="confluenceTd"> instance:rmi-server-port-change
</td></tr><tr><td class="confluenceTd"> admin:change-ssh-port
</td><td class="confluenceTd"> instance:ssh-port-change
</td></tr><tr><td class="confluenceTd"> admin:clone
</td><td class="confluenceTd"> instance:clone
</td></tr><tr><td class="confluenceTd"> admin:connect
</td><td class="confluenceTd"> instance:connect
</td></tr><tr><td class="confluenceTd"> admin:create
</td><td class="confluenceTd"> instance:create
</td></tr><tr><td class="confluenceTd"> admin:destroy
</td><td class="confluenceTd"> instance:destroy
</td></tr><tr><td class="confluenceTd"> admin:list
</td><td class="confluenceTd"> instance:list
</td></tr><tr><td class="confluenceTd"> admin:rename
</td><td class="confluenceTd"> instance:rename
</td></tr><tr><td class="confluenceTd"> admin:start
</td><td class="confluenceTd"> instance:start
</td></tr><tr><td class="confluenceTd"> admin:status
</td><td class="confluenceTd"> instance:status
</td></tr><tr><td class="confluenceTd"> admin:stop
</td><td class="conflue
nceTd"> instance:stop </td></tr><tr><td
class="confluenceTd"> dev:create-dump </td><td
class="confluenceTd"> dev:dump-create
</td></tr><tr><td class="confluenceTd"> features:add-url
</td><td class="confluenceTd"> feature:repo-add
</td></tr><tr><td class="confluenceTd"> features:chooseurl
</td><td class="confluenceTd"> feature:repo-add
</td></tr><tr><td class="confluenceTd"> features:info
</td><td class="confluenceTd"> feature:info
</td></tr><tr><td class="confluenceTd"> features:install
</td><td class="confluenceTd"> feature:install
</td></tr><tr><td class="confluenceTd"> features:listVersions
</td><td class="confluenceTd"> feature:version-list
</td></tr><tr><td class="confluenceTd"> features:list
</td><td class="confluenceTd"> feature:list
</td></tr><tr><td class="confluenceTd"> features:listRepositories
</td><td class="confluenceTd"> feature:repo-list
</td></tr><tr><td class="confluenceTd"> features:listUrl
</td><td class="confluenceTd"> feature:repo-list
</td></tr><tr><td class="confluenceTd"> features:refreshUrl
</td><td class="confluenceTd"> feature:repo-refresh
</td></tr><tr><td class="confluenceTd"> features:removeRepository
</td><td class="confluenceTd"> feature:repo-remove
</td></tr><tr><td class="confluenceTd"> features:removeUrl
</td><td class="confluenceTd"> feature:repo-remove
</td></tr><tr><td class="confluenceTd"> features:uninstall
</td><td class="confluenceTd"> feature:uninstall
</td></tr><tr><td class="confluen
ceTd"> jaas:cancel </td><td class="confluenceTd">
jaas:cancel </td></tr><tr><td
class="confluenceTd"> jaas:pending </td><td
class="confluenceTd"> jaas:pending-list
</td></tr><tr><td class="confluenceTd"> jaas:realms
</td><td class="confluenceTd"> jaas:realm-list
</td></tr><tr><td class="confluenceTd"> jaas:users
</td><td class="confluenceTd"> jaas:user-list
</td></tr><tr><td class="confluenceTd"> jaas:manage
</td><td class="confluenceTd"> jaas:realm-manage
</td></tr><tr><td class="confluenceTd"> jaas:roleadd
</td><td class="confluenceTd"> jaas:role-add
</td></tr><tr><td class="confluenceTd"> jaas:roledel
</td><td class="confluenceTd"> jaas:role-delete <
/td></tr><tr><td class="confluenceTd"> jaas:update
</td><td class="confluenceTd"> jaas:update
</td></tr><tr><td class="confluenceTd"> jaas:useradd
</td><td class="confluenceTd"> jaas:user-add
</td></tr><tr><td class="confluenceTd"> jaas:userdel
</td><td class="confluenceTd"> jaas:user-delete
</td></tr><tr><td class="confluenceTd"> shell:alias
</td><td class="confluenceTd"> shell:alias
</td></tr><tr><td class="confluenceTd"> shell:cat
</td><td class="confluenceTd"> shell:cat
</td></tr><tr><td class="confluenceTd"> shell:clear
</td><td class="confluenceTd"> shell:clear
</td></tr><tr><td class="confluenceTd"> shell:date
</td><td class="confluenceTd"> shell:date
</td></tr><tr><td class="confluenceTd">
shell:each </td><td class="confluenceTd"> shell:each
</td></tr><tr><td class="confluenceTd"> shell:echo
</td><td class="confluenceTd"> shell:echo
</td></tr><tr><td class="confluenceTd"> shell:exec
</td><td class="confluenceTd"> shell:exec
</td></tr><tr><td class="confluenceTd"> shell:grep
</td><td class="confluenceTd"> shell:grep
</td></tr><tr><td class="confluenceTd"> shell:head
</td><td class="confluenceTd"> shell:head
</td></tr><tr><td class="confluenceTd"> shell:history
</td><td class="confluenceTd"> shell:history
</td></tr><tr><td class="confluenceTd"> shell:if
</td><td c
lass="confluenceTd"> shell:if
</td></tr><tr><td class="confluenceTd"> shell:info
</td><td class="confluenceTd"> shell:info
</td></tr><tr><td class="confluenceTd"> shell:java
</td><td class="confluenceTd"> shell:java
</td></tr><tr><td class="confluenceTd"> shell:logout
</td><td class="confluenceTd"> shell:logout
</td></tr><tr><td class="confluenceTd"> shell:more
</td><td class="confluenceTd"> shell:more
</td></tr><tr><td class="confluenceTd"> shell:new
</td><td class="confluenceTd"> shell:new
</td></tr><tr><td class="confluenceTd"> shell:printf
</td><td class="confluenceTd"> shell:printf
</td></tr><tr><td class="confluenceTd"> shell:sleep
</td><td class="confluenceTd"> shell:sleep
</td></tr><tr><td class="confluenceTd"> shell:sort
</td><td class="confluenceTd"> shell:sort
</td></tr><tr><td class="confluenceTd"> shell:source
</td><td class="confluenceTd"> shell:source
</td></tr><tr><td class="confluenceTd"> shell:tac
</td><td class="confluenceTd"> shell:tac
</td></tr><tr><td class="confluenceTd"> shell:tail
</td><td class="confluenceTd"> shell:tail
</td></tr><tr><td class="confluenceTd"> shell:watch
</td><td class="confluenceTd"> shell:watch
</td></tr><tr><td class="confluenceTd"> shell:wc
</td><td class="confluenceTd"> shell:wc
</td></tr><tr><td cl
ass="confluenceTd"> config:cancel </td><td
class="confluenceTd"> config:cancel
</td></tr><tr><td class="confluenceTd"> config:delete
</td><td class="confluenceTd"> config:delete
</td></tr><tr><td class="confluenceTd"> config:edit
</td><td class="confluenceTd"> config:edit
</td></tr><tr><td class="confluenceTd"> config:list
</td><td class="confluenceTd"> config:list
</td></tr><tr><td class="confluenceTd"> config:propappend
</td><td class="confluenceTd"> config:property-append
</td></tr><tr><td class="confluenceTd"> config:propdel
</td><td class="confluenceTd"> config:property-delete
</td></tr><tr><td class="confluenceTd"> config:proplist
</td><td class="confluenceTd"> config:property-list
</td></tr><tr><td class="confluenceTd"> config:propset
</td><td class="confluenceTd"> config:property-set
</td></tr><tr><td class="confluenceTd"> config:update
</td><td class="confluenceTd"> config:update
</td></tr><tr><td class="confluenceTd"> dev:dynamic-import
</td><td class="confluenceTd"> bundle:dynamic-import
</td></tr><tr><td class="confluenceTd"> dev:framework
</td><td class="confluenceTd"> system:framework
</td></tr><tr><td class="confluenceTd"> dev:print-stack-traces
</td><td class="confluenceTd"> shell:stack-traces-print
</td></tr><tr><td class="confluenceTd"> dev:restart
</td><td class="confluenceTd"> system:shutdown
</td></tr><tr><td class="confluenceTd"> dev:show-tree
</td><td class="confluenceTd"
> bundle:tree-show </td></tr><tr><td
> class="confluenceTd"> dev:system-property </td><td
> class="confluenceTd"> system:property
> </td></tr><tr><td class="confluenceTd"> dev:wait-for-service
> </td><td class="confluenceTd"> service:wait
> </td></tr><tr><td class="confluenceTd"> dev:watch
> </td><td class="confluenceTd"> bundle:watch
> </td></tr><tr><td class="confluenceTd"> log:clear
> </td><td class="confluenceTd"> log:clear
> </td></tr><tr><td class="confluenceTd"> log:display-exception
> </td><td class="confluenceTd"> log:exception-display
> </td></tr><tr><td class="confluenceTd"> log:display
> </td><td class="confluenceTd"> log:display
> </td></tr><tr><td class="confluenceTd"> log:get
</td><td class="confluenceTd"> log:get
</td></tr><tr><td class="confluenceTd"> log:tail
</td><td class="confluenceTd"> log:tail
</td></tr><tr><td class="confluenceTd"> log:set
</td><td class="confluenceTd"> log:set
</td></tr><tr><td class="confluenceTd"> obr:addUrl
</td><td class="confluenceTd"> obr:url-add
</td></tr><tr><td class="confluenceTd"> obr:deploy
</td><td class="confluenceTd"> obr:deploy
</td></tr><tr><td class="confluenceTd"> obr:find
</td><td class="confluenceTd"> obr:find
</td></tr><tr><td class="confluenceTd"> obr:info
</td><td class="confluenceTd"> obr:info
</td></tr><tr><td class="confluenceTd">
obr:list </td><td class="confluenceTd"> obr:list
</td></tr><tr><td class="confluenceTd">
obr:listUrl </td><td class="confluenceTd"> obr:url-list
</td></tr><tr><td class="confluenceTd">
obr:refreshUrl </td><td class="confluenceTd">
obr:url-refresh </td></tr><tr><td
class="confluenceTd"> obr:removeUrl </td><td
class="confluenceTd"> obr:url-remove
</td></tr><tr><td class="confluenceTd"> obr:resolve
</td><td class="confluenceTd"> obr:resolve
</td></tr><tr><td class="confluenceTd"> obr:source
</td><td class="confluenceTd"> obr:source
</td></tr><tr><td class="confluenceTd"> obr:start
</td><td class="confluenceTd"> obr:start </td></
tr><tr><td class="confluenceTd"> osgi:bundle-level </td><td
class="confluenceTd"> bundle:start-level
</td></tr><tr><td class="confluenceTd"> osgi:classes
</td><td class="confluenceTd"> bundle:classes
</td></tr><tr><td class="confluenceTd"> osgi:find-class
</td><td class="confluenceTd"> bundle:find-class
</td></tr><tr><td class="confluenceTd"> osgi:headers
</td><td class="confluenceTd"> bundle:headers
</td></tr><tr><td class="confluenceTd"> osgi:info
</td><td class="confluenceTd"> bundle:info
</td></tr><tr><td class="confluenceTd"> osgi:install
</td><td class="confluenceTd"> bundle:install
</td></tr><tr><td class="confluenceTd"> osgi:bundle-services
</td><td class="confluenceTd"> bundle:services
</td></tr><tr><td class="confluenceTd"> osgi:list
</td><td class="confluenceTd"> bundle:list
</td></tr><tr><td class="confluenceTd"> osgi:ls
</td><td class="confluenceTd"> service:list
</td></tr><tr><td class="confluenceTd"> osgi:name
</td><td class="confluenceTd"> system:name
</td></tr><tr><td class="confluenceTd"> osgi:refresh
</td><td class="confluenceTd"> bundle:refresh
</td></tr><tr><td class="confluenceTd"> osgi:resolve
</td><td class="confluenceTd"> bundle:resolve
</td></tr><tr><td class="confluenceTd"> osgi:restart
</td><td class="confluenceTd"> bundle:restart
</td></tr><tr><td class="confluenceTd"> osgi:shutdown
</td><td class="
confluenceTd"> system:shutdown </td></tr><tr><td
class="confluenceTd"> osgi:start </td><td
class="confluenceTd"> bundle:start
</td></tr><tr><td class="confluenceTd"> osgi:start-level
</td><td class="confluenceTd"> bundle:start-level
</td></tr><tr><td class="confluenceTd"> osgi:stop
</td><td class="confluenceTd"> bundle:stop
</td></tr><tr><td class="confluenceTd"> osgi:uninstall
</td><td class="confluenceTd"> bundle:uninstall
</td></tr><tr><td class="confluenceTd"> osgi:update
</td><td class="confluenceTd"> bundle:update
</td></tr><tr><td class="confluenceTd"> osgi:version
</td><td class="confluenceTd"> system:version
</td></tr><tr><td class="confluenceTd"> packages:exports
</td><td class="confluenceTd"> package:exports
</td></tr><tr><td class="confluenceTd"> packages:imports
</td><td class="confluenceTd"> package:imports
</td></tr><tr><td class="confluenceTd"> ssh:ssh
</td><td class="confluenceTd"> ssh:ssh
</td></tr><tr><td class="confluenceTd"> ssh:sshd
</td><td class="confluenceTd"> ssh:sshd
</td></tr><tr><td class="confluenceTd"> web:list
</td><td class="confluenceTd"> web:list
</td></tr><tr><td class="confluenceTd"> wrapper:install
</td><td class="confluenceTd"> wrapper:install
</td></tr></table></div><p>We encourage the users to use the <tt>--help</tt>
option to check the name and type of arguments and options.</p><p>In term of
development, the pr
eviously shell anotations provided by the
<tt>org.apache.felix.gogo.commands*</tt> package (<tt>@Command</tt>,
<tt>@Argument</tt>, etc)<br/>are now deprecated. Apache Karaf 3.0.0 still
supports these annotations, but we encourage the users to upgrade to the new
package <tt>org.apache.karaf.shell.commands</tt>.</p><div
class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh">
Shell annotation </th><th class="confluenceTh"> Apache Karaf 2.x
</th><th class="confluenceTh"> Apache Karaf 3.x
</th></tr><tr><td class="confluenceTd">
<tt>@Argument</tt> </td><td class="confluenceTd">
<tt>org.apache.felix.gogo.commands.Argument</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf.shell.commands.Argument</tt>
</td></tr><tr><td class="confluenceTd"> <tt>@Command</tt>
</td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.Command</tt>
</td><td class="confluenceTd">
<tt>org.apache.karaf.shell.commands.Command</tt> </td></tr><tr><td clas
s="confluenceTd"> <tt>@CompleterValues</tt> </td><td class="confluenceTd">
<tt>org.apache.felix.gogo.commands.CompleterValues</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf.shell.commands.CompleterValues</tt>
</td></tr><tr><td class="confluenceTd"> <tt>@Option</tt>
</td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.Option</tt>
</td><td class="confluenceTd"> {{org.apache.karaf.shell.commands.Option
</td></tr><tr><td class="confluenceTd"> <tt>@SubShell</tt>
</td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.SubShell</tt>
</td><td class="confluenceTd">
{{org.apache.karaf.shell.commands.SubShell
</td></tr></table></div><div class="table-wrap"><table
class="confluenceTable"><tr><th class="confluenceTh"> Class name </th><th
class="confluenceTh"> Apache Karaf 2.x
</th><th class="confluenceTh"> Apache Karaf 3.x
</th></tr><tr><td class="confluenceTd"> Action </td><td
class="confluenceTd"> <tt>org.apache.felix.gogo.commands.Acti
on</tt> </td><td class="confluenceTd">
<tt>org.apache.karaf.shell.commands.Action</tt>
</td></tr><tr><td class="confluenceTd"> CommandException </td><td
class="confluenceTd"> <tt>org.apache.felix.gogo.commands.CommandException</tt>
</td><td class="confluenceTd">
<tt>org.apache.karaf.shell.commands.CommandException</tt>
</td></tr><tr><td class="confluenceTd"> AbstractCommand </td><td
class="confluenceTd">
<tt>org.apache.felix.gogo.commands.basic.AbstractCommand</tt> </td><td
class="confluenceTd">
<tt>org.apache.karaf.shell.commands.basic.AbstractCommand</tt>
</td></tr></table></div><h2 id="JMXMBeans">JMX MBeans</h2><p>Like the console
commands, the JMX MBeans object names have been renamed and the operations
haven been dispatched in<br/>new MBeans.</p><p>The following table shows the
correspondence between the "old" MBeans object names and the "new"
ones.</p><div class="table-wrap"><table class="confluenceTable"><tr><th
class="confluenceTh"> Apache Karaf 2.x
</th><th class="confluenceTh"> Apache Karaf 3.x
</th></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=bundles,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=bundle,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=config,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=config,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=dev,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=system,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org;apache.karaf:type=log,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=log,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=obr,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=obr,name=*</tt>
</td></tr><tr><td cl
ass="confluenceTd"> <tt>org.apache.karaf:type=packages,name=*</tt>
</td><td class="confluenceTd"> <tt>org.apache.karaf:type=package,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=services,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=service,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=system,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=system,name=*</tt>
</td></tr><tr><td class="confluenceTd">
<tt>org.apache.karaf:type=web,name=*</tt> </td><td
class="confluenceTd"> <tt>org.apache.karaf:type=web,name=*</tt>
</td></tr></table></div><h2 id="Features">Features</h2><p>The Apache Karaf
"core" features repository XML URL have changed:</p><div
class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh">
Apache Karaf 2.x
</th><th class="confl
uenceTh"> Apache Karaf 3.x
</th></tr><tr><td class="confluenceTd">
<tt>mvn:org.apache.karaf.assemblies.features/standard/2.3.x/xml/features</tt>
</td><td class="confluenceTd">
<tt>mvn:org.apache.karaf.features/standard/3.0.x/xml/features</tt>
</td></tr><tr><td class="confluenceTd">
<tt>mvn:org.apache.karaf.assemblies.features/enterprise/2.3.x/xml/features</tt>
</td><td class="confluenceTd">
<tt>mvn:org.apache.karaf.features/enterprise/3.0.x/xml/features</tt>
</td></tr></table></div><p>The Spring features have been isolated in a
dedicated features repository
(<tt>mvn:org.apache.karaf.features/spring/3.0.x/xml/features</tt>).</p><h2
id="Namespaces">Namespaces</h2><p>Apache Karaf 3.x brings updated version of
the namespaces:</p><ul><li>Supported features
namespaces:<ul><li><tt>karaf-features-1.0.0.xsd</tt></li><li><tt>karaf-features-1.1.0.xsd</tt></li><li><tt>karaf-features-1.2.0.xsd</tt></li></ul></li><li>Supported
jaas na
mespaces:<ul><li><tt>karaf-jaas-1.0.0.xsd</tt></li><li><tt>karaf-jaas-1.1.0.xsd</tt></li></ul></li><li>Supported
shell
namespaces:<ul><li><tt>karaf-shell-1.0.0.xsd</tt></li><li><tt>karaf-shell-1.1.0.xsd</tt></li></ul></li></ul><h2
id="Mavenplugin">Maven plugin</h2><p>The previous
<tt>features-maven-plugin</tt> and <tt>cmdhelp-maven-plugin</tt> Maven plugins
have been gathered in one main Maven<br/>plugin:
<tt>karaf-maven-plugin</tt>.</p><p>The goals have changed as follow:</p><div
class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh">
Apache Karaf 2.x Maven plugins </th><th class="confluenceTh">
Apache Karaf Maven Plugin (3.x) </th></tr><tr><td
class="confluenceTd"> features:add-features-to-repo </td><td
class="confluenceTd"> karaf:features-add-to-repository
</td></tr><tr><td class="confluenceTd"> features:create-kar
</td><td class="confluenceTd"> karaf:features-create-
kar </td></tr><tr><td class="confluenceTd">
features:generate-features-file </td><td class="confluenceTd">
karaf:features-generate-descriptor </td></tr><tr><td
class="confluenceTd"> features:generate-features-xml </td><td
class="confluenceTd"> karaf:features-generate-descriptor
</td></tr><tr><td class="confluenceTd"> features:install-kars
</td><td class="confluenceTd"> karaf:install-kars
</td></tr><tr><td class="confluenceTd"> features:validate-features
</td><td class="confluenceTd"> karaf:features-validate-descriptor
</td></tr><tr><td class="confluenceTd"> cmdhelp:cmdhelp
</td><td class="confluenceTd"> karaf:commands-generate-help
</td></tr></table></div><p>Using the
<tt>features:add-features-to-repo</tt> goal, you have now to explicitily define
the Apache Karaf
features URL (previously, the Apache Karaf features were automatically
added).<br/>It means that you have to define:</p><pre>
<descriptor>mvn:org.apache.karaf.features/standard/3.0.0/xml/features</descriptor>
<descriptor>mvn:org.apache.karaf.features/spring/3.0.0/xml/features</descriptor>
<descriptor>mvn:org.apache.karaf.features/enterprise/3.0.0/xml/features</descriptor>
