You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2013/12/25 21:23:04 UTC
svn commit: r1553413 - /karaf/site/production/manual/latest/update-notes.html
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>