Added: karaf/site/production/manual/latest-2.2.x/users-guide/using-console.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/users-guide/using-console.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/users-guide/using-console.html (added) +++ karaf/site/production/manual/latest-2.2.x/users-guide/using-console.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,224 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd";> +<html lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <meta name="description" content="description goes here"/> + <meta name="keywords" content="keywords,goes,here"/> + <meta name="author" content="The Apache Karaf Team"/> + <link href="../css/style.css" rel="stylesheet" type="text/css"/> + <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/> + <title> + Apache Karaf 2.2.11-SNAPSHOT Guides + </title> + </head> + <body> + <table width="100%" cellpadding="0" cellspacing="0"> + <tr width="100%"> + <td id="cell-0-0" colspan="2"> + + </td> + <td id="cell-0-1"> + + </td> + <td id="cell-0-2" colspan="2"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-1-0"> + + </td> + <td id="cell-1-1"> + + </td> + <td id="cell-1-2"> + <div style="padding: 5px;"> + <div id="banner"> + <table border="0" cellpadding="0" cellspacing="0" width="100%"> + <tr> + <td align="left" class="topbardiv" nowrap=""> +<a href="http://karaf.apache.org/"; title="A server side OSGi distribution"> + <img border="0" src="../images/karaf-logo.png" width="400px"></img> +</a> + </td> + <td align="right" nowrap=""> +<a href="http://www.apache.org/"; title="The Apache Sofware Foundation"> + <img border="0" src="../images/asf-logo.png"> +</a> + </td> + </tr> + </table> + + </div> + <div id="top-menu"> + <table border="0" cellpadding="1" cellspacing="0" width="100%"> + <tr> + <td> + <div align="left"></div> + </td> + <td> + <div align="right"> + <p> +<a href="../index.html" title="Home">Home</a> +| +<a href="index.html" title="Users Guide">Users Guide</a> +| +<a href="../developers-guide/index.html" title="Developers Guide">Developers Guide</a> +</p> + + + </div> + </td> + </tr> + </table> + </div> + </div> + </td> + <td id="cell-1-3"> + + </td> + <td id="cell-1-4"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-2-0" colspan="2"> + + </td> + <td id="cell-2-1"> + <table> + <tr height="100%" valign="top"> + <td height="100%"> + <div id="wrapper-menu-page-right"> + <div id="wrapper-menu-page-top"> + <div id="wrapper-menu-page-bottom"> + <div id="menu-page"> + <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="installation.html">Installing Karaf</a></li><li><a href="directory-structure.html">Directory Structure</a></li><li><a href="start-stop.html">Starting and stopping Karaf</a></li><li><a href="wrapper.html">OS integration</a></li><li><a href="using-console.html">Using the console</a></li><li><a href="remote-console.html">Remote console</a></li><li><a href="web-console.html">Web console</a></li><li><a href="child-instances.html">Child instances</a></li><li><a href="security.html">Security</a></li><li><a href="failover.html">Failover Deployments</a></li><li><a href="logging-system.html">Logging system</a></li><li><a href="deployer.html">Deployer</a ></li><li><a href="provisioning.html">Provisioning</a></li><li><a >href="kar.html">KAR archive</a></li><li><a >href="configuration.html">Configuration</a></li><li><a href="http.html">HTTP >service</a></li><li><a href="web-applications.html">Web >applications</a></li><li><a href="jre-tuning.html">JRE tuning</a></li><li><a >href="jmx.html">JMX for administration and monitoring</a></li></ul><h3 >id="DevelopersGuidedevelopersguideindex"><a >href="../developers-guide/index.html">Developers Guide</a></h3><ul >style="list-style: square"><li><a >href="../developers-guide/archetypes.html">Maven Archetypes</a></li><li><a >href="../developers-guide/branding-console.html">Branding the >Console</a></li><li><a >href="../developers-guide/extending-console.html">Extending the >Console</a></li><li><a >href="../developers-guide/custom-distribution.html">Custom >Distribution</a></li><li><a >href="../developers-guide/security-framework.html">Security >Framework</a></li><li><a href="../developers-guide/features- maven-plugin.html">Using the features-maven-plugin</a></li><li><a href="../developers-guide/debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="../developers-guide/connect-console.html">Programmatically connect to the console</a></li><li><a href="../developers-guide/writing-tests.html">Writing integration tests</a></li><li><a href="../developers-guide/creating-bundles.html">Creating bundles</a></li><li><a href="../developers-guide/shell-syntax.html">Shell syntax</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> + </div> + </div> + </div> + </div> + </td> + <td height="100%" width="100%"> + <div class="wiki-content"> +<h1 id="Usingtheconsole">Using the console</h1><h2 id="Viewingavailablecommands">Viewing available commands</h2><p>To see a list of the available commands in the console press the <tt><tab></tt> key at the prompt.</p><pre> +root@root> Display all 182 possibilities? (y or n) +*:help addurl admin:change-opts +admin:change-rmi-registry-port admin:change-ssh-port admin:connect +admin:create admin:destroy admin:list +admin:rename admin:start admin:stop +bundle-level cancel cat +change-opts change-rmi-registry-port change-ssh-port +clear commandlist config:cancel +config:edit config:list config:propappend +config:propdel config:proplist config:propset +config:update connect create +create-dump destroy dev:create-dump +dev:dynamic-import dev:framework dev:print-stack-traces +dev:restart dev:show-tree dev:watch +display display-exception dynamic-import +each echo edit +exec exports features:addurl +features:info features:install features:list +features:listrepositories features:listurl features:listversions +features:refreshurl features:removerepository features:removeurl +features:uninstall framework get +grep head headers +help history if +imports info install +jaas:cancel jaas:commandlist jaas:list +jaas:manage jaas:roleadd jaas:roledel +jaas:update jaas:useradd jaas:userdel +jaas:userlist java list +listrepositories listurl listversions +log:clear log:display log:display-exception +log:get log:set log:tail +logout ls manage +more new osgi:bundle-level +osgi:headers osgi:info osgi:install +osgi:list osgi:ls osgi:refresh +osgi:resolve osgi:restart osgi:shutdown +osgi:start osgi:start-level osgi:stop +osgi:uninstall osgi:update packages:exports +packages:imports print-stack-traces printf +propappend propdel proplist +propset refresh refreshurl +removerepository removeurl rename +resolve restart roleadd +roledel set shell:cat +shell:clear shell:each shell:echo +shell:exec shell:grep shell:head +shell:history shell:if shell:info +shell:java shell:logout shell:more +shell:new shell:printf shell:sleep +shell:sort shell:tac shell:tail +show-tree shutdown sleep +sort ssh ssh:ssh +ssh:sshd sshd start +start-level stop tac +tail uninstall update +useradd userdel userlist +watch +root@root> +</pre><p>The <tt><tab></tt> key toggles autocompletion anywhere on the line, so if you want to see the commands in the <tt>osgi</tt> group, type the first letters and hit <tt><tab></tt>. Depending on the commands, autocompletion may be available for options and arguments too.</p><h2 id="Gettinghelpforacommand">Getting help for a command</h2><p>To view help on a particular command, type the command followed by <tt>--help</tt> or use the <tt>help</tt> command followed by the name of the command:</p><pre> +karaf@root> features:list --help +DESCRIPTION + features:list + + Lists all existing features available from the defined repositories. + +SYNTAX + features:list [options] + +OPTIONS + --help + Display this help message + -i, --installed + Display a list of all installed features only +</pre><h2 id="More...">More...</h2><p>The list of all available commands and their usage is also available in a <a href="../commands/commands.html">dedicated section</a>.</p><p>You'll find a more in-depth guide to the shell syntax in the <a href="../developers-guide/shell-syntax.html">developers guide</a>.</p><p>The console can also be easily extended by creating new commands as explained in the <a href="../developers-guide/extending-console.html">developers guide</a>.</p> + </div> + </td> + </tr> + </table> + </td> + <td id="cell-2-2" colspan="2"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-3-0"> + + </td> + <td id="cell-3-1"> + + </td> + <td id="cell-3-2"> + <div id="footer"> + <div id="site-footer"> + © 2008-2011 The Apache Software Foundation + <br/> + Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation. + </div> + </div> + </td> + <td id="cell-3-3"> + + </td> + <td id="cell-3-4"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-4-0" colspan="2"> + + </td> + <td id="cell-4-1"> + + </td> + <td id="cell-4-2" colspan="2"> + + </td> + </tr> + </table> + </body> +</html> \ No newline at end of file
Added: karaf/site/production/manual/latest-2.2.x/users-guide/web-applications.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/users-guide/web-applications.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/users-guide/web-applications.html (added) +++ karaf/site/production/manual/latest-2.2.x/users-guide/web-applications.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,213 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd";> +<html lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <meta name="description" content="description goes here"/> + <meta name="keywords" content="keywords,goes,here"/> + <meta name="author" content="The Apache Karaf Team"/> + <link href="../css/style.css" rel="stylesheet" type="text/css"/> + <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/> + <title> + Apache Karaf 2.2.11-SNAPSHOT Guides + </title> + </head> + <body> + <table width="100%" cellpadding="0" cellspacing="0"> + <tr width="100%"> + <td id="cell-0-0" colspan="2"> + + </td> + <td id="cell-0-1"> + + </td> + <td id="cell-0-2" colspan="2"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-1-0"> + + </td> + <td id="cell-1-1"> + + </td> + <td id="cell-1-2"> + <div style="padding: 5px;"> + <div id="banner"> + <table border="0" cellpadding="0" cellspacing="0" width="100%"> + <tr> + <td align="left" class="topbardiv" nowrap=""> +<a href="http://karaf.apache.org/"; title="A server side OSGi distribution"> + <img border="0" src="../images/karaf-logo.png" width="400px"></img> +</a> + </td> + <td align="right" nowrap=""> +<a href="http://www.apache.org/"; title="The Apache Sofware Foundation"> + <img border="0" src="../images/asf-logo.png"> +</a> + </td> + </tr> + </table> + + </div> + <div id="top-menu"> + <table border="0" cellpadding="1" cellspacing="0" width="100%"> + <tr> + <td> + <div align="left"></div> + </td> + <td> + <div align="right"> + <p> +<a href="../index.html" title="Home">Home</a> +| +<a href="index.html" title="Users Guide">Users Guide</a> +| +<a href="../developers-guide/index.html" title="Developers Guide">Developers Guide</a> +</p> + + + </div> + </td> + </tr> + </table> + </div> + </div> + </td> + <td id="cell-1-3"> + + </td> + <td id="cell-1-4"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-2-0" colspan="2"> + + </td> + <td id="cell-2-1"> + <table> + <tr height="100%" valign="top"> + <td height="100%"> + <div id="wrapper-menu-page-right"> + <div id="wrapper-menu-page-top"> + <div id="wrapper-menu-page-bottom"> + <div id="menu-page"> + <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="installation.html">Installing Karaf</a></li><li><a href="directory-structure.html">Directory Structure</a></li><li><a href="start-stop.html">Starting and stopping Karaf</a></li><li><a href="wrapper.html">OS integration</a></li><li><a href="using-console.html">Using the console</a></li><li><a href="remote-console.html">Remote console</a></li><li><a href="web-console.html">Web console</a></li><li><a href="child-instances.html">Child instances</a></li><li><a href="security.html">Security</a></li><li><a href="failover.html">Failover Deployments</a></li><li><a href="logging-system.html">Logging system</a></li><li><a href="deployer.html">Deployer</a ></li><li><a href="provisioning.html">Provisioning</a></li><li><a >href="kar.html">KAR archive</a></li><li><a >href="configuration.html">Configuration</a></li><li><a href="http.html">HTTP >service</a></li><li><a href="web-applications.html">Web >applications</a></li><li><a href="jre-tuning.html">JRE tuning</a></li><li><a >href="jmx.html">JMX for administration and monitoring</a></li></ul><h3 >id="DevelopersGuidedevelopersguideindex"><a >href="../developers-guide/index.html">Developers Guide</a></h3><ul >style="list-style: square"><li><a >href="../developers-guide/archetypes.html">Maven Archetypes</a></li><li><a >href="../developers-guide/branding-console.html">Branding the >Console</a></li><li><a >href="../developers-guide/extending-console.html">Extending the >Console</a></li><li><a >href="../developers-guide/custom-distribution.html">Custom >Distribution</a></li><li><a >href="../developers-guide/security-framework.html">Security >Framework</a></li><li><a href="../developers-guide/features- maven-plugin.html">Using the features-maven-plugin</a></li><li><a href="../developers-guide/debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="../developers-guide/connect-console.html">Programmatically connect to the console</a></li><li><a href="../developers-guide/writing-tests.html">Writing integration tests</a></li><li><a href="../developers-guide/creating-bundles.html">Creating bundles</a></li><li><a href="../developers-guide/shell-syntax.html">Shell syntax</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> + </div> + </div> + </div> + </div> + </td> + <td height="100%" width="100%"> + <div class="wiki-content"> +<h1 id="Webapplications">Web applications</h1><h2 id="Installingwarsupport">Installing war support</h2><p>The following steps will install the "war" feature (support for deploying WAR files with Servlet and JSPs into a Jetty server) into your Karaf instance.</p><ol><li>List the available features -<pre>karaf@root> features:list + State Name +. . . +[uninstalled] [2.2.0] obr karaf-2.2.0 +[uninstalled] [2.2.0] config karaf-2.2.0 +[uninstalled] [2.2.0] http karaf-2.2.0 +[uninstalled] [2.2.0] war karaf-2.2.0 +[uninstalled] [2.2.0] webconsole karaf-2.2.0 +[installed ] [2.2.0] ssh karaf-2.2.0 +. . . +</pre></li><li>Install the war feature (and the sub-features it requires) -<pre>karaf@root> features:install war +</pre><p>Note: you can use the -v or --verbose to see exactly what Karaf does</p><pre>karaf@root> features:install -v war +Installing feature war 2.1.99-SNAPSHOT +Installing feature http 2.1.99-SNAPSHOT +Installing feature jetty 7.1.6.v20100715 +Installing bundle mvn:org.apache.geronimo.specs/geronimo-servlet_2.5_spec/1.1.2 +Found installed bundle: org.apache.servicemix.bundles.asm [10] +Installing bundle mvn:org.eclipse.jetty/jetty-util/7.1.6.v20100715 +Installing bundle mvn:org.eclipse.jetty/jetty-io/7.1.6.v20100715 +Installing bundle mvn:org.eclipse.jetty/jetty-http/7.1.6.v20100715 +Installing bundle mvn:org.eclipse.jetty/jetty-continuation/7.1.6.v20100715 +Installing bundle mvn:org.eclipse.jetty/jetty-server/7.1.6.v20100715 +Installing bundle mvn:org.eclipse.jetty/jetty-security/7.1.6.v20100715 +Installing bundle mvn:org.eclipse.jetty/jetty-servlet/7.1.6.v20100715 +Installing bundle mvn:org.eclipse.jetty/jetty-xml/7.1.6.v20100715 +Checking configuration file mvn:org.apache.karaf/apache-karaf/2.1.99-SNAPSHOT/xml/jettyconfig +Installing bundle mvn:org.ops4j.pax.web/pax-web-api/0.8.2-SNAPSHOT +Installing bundle mvn:org.ops4j.pax.web/pax-web-spi/0.8.2-SNAPSHOT +Installing bundle mvn:org.ops4j.pax.web/pax-web-runtime/0.8.2-SNAPSHOT +Installing bundle mvn:org.ops4j.pax.web/pax-web-jetty/0.8.2-SNAPSHOT +Installing bundle mvn:org.ops4j.pax.web/pax-web-jsp/0.8.2-SNAPSHOT +Installing bundle mvn:org.ops4j.pax.web/pax-web-extender-war/0.8.2-SNAPSHOT +Installing bundle mvn:org.ops4j.pax.web/pax-web-extender-whiteboard/0.8.2-SNAPSHOT +Installing bundle mvn:org.ops4j.pax.web/pax-web-deployer/0.8.2-SNAPSHOT +Installing bundle mvn:org.ops4j.pax.url/pax-url-war/1.2.4 +</pre></li><li>Verify the features were installed<pre>servicemix> features/list + State Name +. . . +[installed ] [2.2.0] http karaf-2.2.0 +[installed ] [2.2.0] war karaf-2.2.0 +. . . +</pre></li><li>Verify the installed bundles were started<pre>karaf@root> osgi:list +START LEVEL 100 + ID State Level Name +. . . +[ 32] [Active ] [ ] [ 60] geronimo-servlet_2.5_spec (1.1.2) +[ 33] [Active ] [ ] [ 60] Apache ServiceMix :: Bundles :: jetty (6.1.22.2) +[ 34] [Active ] [ ] [ 60] OPS4J Pax Web - API (1.0.0) +[ 35] [Active ] [ ] [ 60] OPS4J Pax Web - Service SPI (1.0.0) +[ 36] [Active ] [ ] [ 60] OPS4J Pax Web - Runtime (1.0.0) +[ 37] [Active ] [ ] [ 60] OPS4J Pax Web - Jetty (1.0.0) +[ 38] [Active ] [ ] [ 60] OPS4J Pax Web - Jsp Support (1.0.0) +[ 39] [Active ] [ ] [ 60] OPS4J Pax Web - Extender - WAR (1.0.0) +[ 40] [Active ] [ ] [ 60] OPS4J Pax Web - Extender - Whiteboard (1.0.0) +[ 42] [Active ] [ ] [ 60] OPS4J Pax Web - FileInstall Deployer (1.0.0) +[ 41] [Active ] [ ] [ 60] OPS4J Pax Url - war:, war-i: (1.2.4) +. . . +</pre></li><li>The Jetty server should now be listening on http://localhost:8181/, but with no published applications available.<pre>HTTP ERROR: 404 +NOT_FOUND +RequestURI=/ +Powered by jetty:// +</pre></li></ol><h2 id="DeployingaWARtotheinstalledwebfeature">Deploying a WAR to the installed web feature</h2><p>The following steps will describe how to install a simple WAR file (with JSPs or Servlets) to the just installed web feature.</p><ol><li>To deploy a WAR (JSP or Servlet) to Jetty, update its MANIFEST.MF to include the required OSGi headers as described here - <br/><p><a href="http://team.ops4j.org/wiki/display/ops4j/Pax+Web+Extender+-+War+-+OSGi-fy";>http://team.ops4j.org/wiki/display/ops4j/Pax+Web+Extender+-+War+-+OSGi-fy</a></p></li><li>Copy the updated WAR (archive or extracted files) to the <em>deploy</em> directory.</li></ol><p>If you want to deploy a sample web application into Karaf, you could use the following command:</p><pre> +karaf@root> osgi:install -s webbundle:http://tomcat.apache.org/tomcat-5.5-doc/appdev/sample/sample.war?Bundle-SymbolicName=tomcat-sample&Webapp-Context=/sample +</pre><p>Then open your web browser and point to <tt>http://localhost:8181/sample/index.html</tt>.</p> + </div> + </td> + </tr> + </table> + </td> + <td id="cell-2-2" colspan="2"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-3-0"> + + </td> + <td id="cell-3-1"> + + </td> + <td id="cell-3-2"> + <div id="footer"> + <div id="site-footer"> + © 2008-2011 The Apache Software Foundation + <br/> + Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation. + </div> + </div> + </td> + <td id="cell-3-3"> + + </td> + <td id="cell-3-4"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-4-0" colspan="2"> + + </td> + <td id="cell-4-1"> + + </td> + <td id="cell-4-2" colspan="2"> + + </td> + </tr> + </table> + </body> +</html> \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/users-guide/web-console.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/users-guide/web-console.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/users-guide/web-console.html (added) +++ karaf/site/production/manual/latest-2.2.x/users-guide/web-console.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,156 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd";> +<html lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <meta name="description" content="description goes here"/> + <meta name="keywords" content="keywords,goes,here"/> + <meta name="author" content="The Apache Karaf Team"/> + <link href="../css/style.css" rel="stylesheet" type="text/css"/> + <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/> + <title> + Apache Karaf 2.2.11-SNAPSHOT Guides + </title> + </head> + <body> + <table width="100%" cellpadding="0" cellspacing="0"> + <tr width="100%"> + <td id="cell-0-0" colspan="2"> + + </td> + <td id="cell-0-1"> + + </td> + <td id="cell-0-2" colspan="2"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-1-0"> + + </td> + <td id="cell-1-1"> + + </td> + <td id="cell-1-2"> + <div style="padding: 5px;"> + <div id="banner"> + <table border="0" cellpadding="0" cellspacing="0" width="100%"> + <tr> + <td align="left" class="topbardiv" nowrap=""> +<a href="http://karaf.apache.org/"; title="A server side OSGi distribution"> + <img border="0" src="../images/karaf-logo.png" width="400px"></img> +</a> + </td> + <td align="right" nowrap=""> +<a href="http://www.apache.org/"; title="The Apache Sofware Foundation"> + <img border="0" src="../images/asf-logo.png"> +</a> + </td> + </tr> + </table> + + </div> + <div id="top-menu"> + <table border="0" cellpadding="1" cellspacing="0" width="100%"> + <tr> + <td> + <div align="left"></div> + </td> + <td> + <div align="right"> + <p> +<a href="../index.html" title="Home">Home</a> +| +<a href="index.html" title="Users Guide">Users Guide</a> +| +<a href="../developers-guide/index.html" title="Developers Guide">Developers Guide</a> +</p> + + + </div> + </td> + </tr> + </table> + </div> + </div> + </td> + <td id="cell-1-3"> + + </td> + <td id="cell-1-4"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-2-0" colspan="2"> + + </td> + <td id="cell-2-1"> + <table> + <tr height="100%" valign="top"> + <td height="100%"> + <div id="wrapper-menu-page-right"> + <div id="wrapper-menu-page-top"> + <div id="wrapper-menu-page-bottom"> + <div id="menu-page"> + <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="installation.html">Installing Karaf</a></li><li><a href="directory-structure.html">Directory Structure</a></li><li><a href="start-stop.html">Starting and stopping Karaf</a></li><li><a href="wrapper.html">OS integration</a></li><li><a href="using-console.html">Using the console</a></li><li><a href="remote-console.html">Remote console</a></li><li><a href="web-console.html">Web console</a></li><li><a href="child-instances.html">Child instances</a></li><li><a href="security.html">Security</a></li><li><a href="failover.html">Failover Deployments</a></li><li><a href="logging-system.html">Logging system</a></li><li><a href="deployer.html">Deployer</a ></li><li><a href="provisioning.html">Provisioning</a></li><li><a >href="kar.html">KAR archive</a></li><li><a >href="configuration.html">Configuration</a></li><li><a href="http.html">HTTP >service</a></li><li><a href="web-applications.html">Web >applications</a></li><li><a href="jre-tuning.html">JRE tuning</a></li><li><a >href="jmx.html">JMX for administration and monitoring</a></li></ul><h3 >id="DevelopersGuidedevelopersguideindex"><a >href="../developers-guide/index.html">Developers Guide</a></h3><ul >style="list-style: square"><li><a >href="../developers-guide/archetypes.html">Maven Archetypes</a></li><li><a >href="../developers-guide/branding-console.html">Branding the >Console</a></li><li><a >href="../developers-guide/extending-console.html">Extending the >Console</a></li><li><a >href="../developers-guide/custom-distribution.html">Custom >Distribution</a></li><li><a >href="../developers-guide/security-framework.html">Security >Framework</a></li><li><a href="../developers-guide/features- maven-plugin.html">Using the features-maven-plugin</a></li><li><a href="../developers-guide/debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="../developers-guide/connect-console.html">Programmatically connect to the console</a></li><li><a href="../developers-guide/writing-tests.html">Writing integration tests</a></li><li><a href="../developers-guide/creating-bundles.html">Creating bundles</a></li><li><a href="../developers-guide/shell-syntax.html">Shell syntax</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> + </div> + </div> + </div> + </div> + </td> + <td height="100%" width="100%"> + <div class="wiki-content"> +<h1 id="Webconsole">Web console</h1><p>The Karaf web console provides a graphical overview of the runtime.<br/>You can use it to:</p><ul><li>install and uninstall features</li><li>start, stop, install bundles</li><li>create child instances</li><li>configure Karaf</li><li>view logging informations</li></ul><h2 id="Installingthewebconsole">Installing the web console</h2><p>The web console is not installed by default. To install it, run the following command from the Karaf prompt:</p><pre> +root@karaf> features:install webconsole +</pre><h2 id="Accessingthewebconsole">Accessing the web console</h2><p>To access the console for an instance of Karaf running locally, enter the following address in your web browser:</p><pre> +http://localhost:8181/system/console +</pre><p>Log in with the username <tt>karaf</tt> and the password <tt>karaf</tt>. If you have changed the default user or password, use the one you have configured.</p><h2 id="Changingthewebconsoleportnumber">Changing the web console port number</h2><p>By default, the console runs on port 8181. You can change the port number by creating the properties file, <tt>etc/org.ops4j.pax.web.cfg</tt>, and adding the following property setting (changing the port number to whatever value desired):</p><pre> +org.osgi.service.http.port=8181 +</pre> + </div> + </td> + </tr> + </table> + </td> + <td id="cell-2-2" colspan="2"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-3-0"> + + </td> + <td id="cell-3-1"> + + </td> + <td id="cell-3-2"> + <div id="footer"> + <div id="site-footer"> + © 2008-2011 The Apache Software Foundation + <br/> + Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation. + </div> + </div> + </td> + <td id="cell-3-3"> + + </td> + <td id="cell-3-4"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-4-0" colspan="2"> + + </td> + <td id="cell-4-1"> + + </td> + <td id="cell-4-2" colspan="2"> + + </td> + </tr> + </table> + </body> +</html> \ No newline at end of file Added: karaf/site/production/manual/latest-2.2.x/users-guide/wrapper.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.2.x/users-guide/wrapper.html?rev=1460031&view=auto ============================================================================== --- karaf/site/production/manual/latest-2.2.x/users-guide/wrapper.html (added) +++ karaf/site/production/manual/latest-2.2.x/users-guide/wrapper.html Fri Mar 22 22:18:53 2013 @@ -0,0 +1,233 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd";> +<html lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <meta name="description" content="description goes here"/> + <meta name="keywords" content="keywords,goes,here"/> + <meta name="author" content="The Apache Karaf Team"/> + <link href="../css/style.css" rel="stylesheet" type="text/css"/> + <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/> + <title> + Apache Karaf 2.2.11-SNAPSHOT Guides + </title> + </head> + <body> + <table width="100%" cellpadding="0" cellspacing="0"> + <tr width="100%"> + <td id="cell-0-0" colspan="2"> + + </td> + <td id="cell-0-1"> + + </td> + <td id="cell-0-2" colspan="2"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-1-0"> + + </td> + <td id="cell-1-1"> + + </td> + <td id="cell-1-2"> + <div style="padding: 5px;"> + <div id="banner"> + <table border="0" cellpadding="0" cellspacing="0" width="100%"> + <tr> + <td align="left" class="topbardiv" nowrap=""> +<a href="http://karaf.apache.org/"; title="A server side OSGi distribution"> + <img border="0" src="../images/karaf-logo.png" width="400px"></img> +</a> + </td> + <td align="right" nowrap=""> +<a href="http://www.apache.org/"; title="The Apache Sofware Foundation"> + <img border="0" src="../images/asf-logo.png"> +</a> + </td> + </tr> + </table> + + </div> + <div id="top-menu"> + <table border="0" cellpadding="1" cellspacing="0" width="100%"> + <tr> + <td> + <div align="left"></div> + </td> + <td> + <div align="right"> + <p> +<a href="../index.html" title="Home">Home</a> +| +<a href="index.html" title="Users Guide">Users Guide</a> +| +<a href="../developers-guide/index.html" title="Developers Guide">Developers Guide</a> +</p> + + + </div> + </td> + </tr> + </table> + </div> + </div> + </td> + <td id="cell-1-3"> + + </td> + <td id="cell-1-4"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-2-0" colspan="2"> + + </td> + <td id="cell-2-1"> + <table> + <tr height="100%" valign="top"> + <td height="100%"> + <div id="wrapper-menu-page-right"> + <div id="wrapper-menu-page-top"> + <div id="wrapper-menu-page-bottom"> + <div id="menu-page"> + <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="installation.html">Installing Karaf</a></li><li><a href="directory-structure.html">Directory Structure</a></li><li><a href="start-stop.html">Starting and stopping Karaf</a></li><li><a href="wrapper.html">OS integration</a></li><li><a href="using-console.html">Using the console</a></li><li><a href="remote-console.html">Remote console</a></li><li><a href="web-console.html">Web console</a></li><li><a href="child-instances.html">Child instances</a></li><li><a href="security.html">Security</a></li><li><a href="failover.html">Failover Deployments</a></li><li><a href="logging-system.html">Logging system</a></li><li><a href="deployer.html">Deployer</a ></li><li><a href="provisioning.html">Provisioning</a></li><li><a >href="kar.html">KAR archive</a></li><li><a >href="configuration.html">Configuration</a></li><li><a href="http.html">HTTP >service</a></li><li><a href="web-applications.html">Web >applications</a></li><li><a href="jre-tuning.html">JRE tuning</a></li><li><a >href="jmx.html">JMX for administration and monitoring</a></li></ul><h3 >id="DevelopersGuidedevelopersguideindex"><a >href="../developers-guide/index.html">Developers Guide</a></h3><ul >style="list-style: square"><li><a >href="../developers-guide/archetypes.html">Maven Archetypes</a></li><li><a >href="../developers-guide/branding-console.html">Branding the >Console</a></li><li><a >href="../developers-guide/extending-console.html">Extending the >Console</a></li><li><a >href="../developers-guide/custom-distribution.html">Custom >Distribution</a></li><li><a >href="../developers-guide/security-framework.html">Security >Framework</a></li><li><a href="../developers-guide/features- maven-plugin.html">Using the features-maven-plugin</a></li><li><a href="../developers-guide/debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="../developers-guide/connect-console.html">Programmatically connect to the console</a></li><li><a href="../developers-guide/writing-tests.html">Writing integration tests</a></li><li><a href="../developers-guide/creating-bundles.html">Creating bundles</a></li><li><a href="../developers-guide/shell-syntax.html">Shell syntax</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> + </div> + </div> + </div> + </div> + </td> + <td height="100%" width="100%"> + <div class="wiki-content"> +<h1 id="ServiceWrapper">Service Wrapper</h1><h2 id="Introduction">Introduction</h2><p>The Karaf Wrapper (for service wrapper) makes it possible to install Karaf as a Windows Service. Likewise, the scripts shipped with Karaf also make it very easy to install Karaf as a daemon process on Unix systems.</p><p>The Wrapper correctly handles "user's log outs" under Windows, service dependencies, and the ability to run services which interact with the desktop.</p><h2 id="Supportedplatforms">Supported platforms</h2><p>The following platforms are supported by the Karaf Wrapper:</p><ul><li>AIX</li><li>FreeBSD</li><li>HP-UX, 32-bit and 64-bit versions</li><li>SGI Irix</li><li>Linux kernels 2.2.x, 2.4.x, 2.6.x. Known to work with Debian, Ubuntu, and Red Hat, but should work with any distribution. Currently supported on both 32-bit and 64-bit x86, Itanium, and PPC systems.</li><li>Macintosh OS X</li><li>Sun OS, Solaris 9 and 10. Currently supported on both 32-bit and 64-bit sparc, and x86 systems.</li><li>Windows - Windows 2000, XP, 2003, Vista, 2008 and Windows 7. Currently supported on both 32-bit and 64-bit x86 and Itanium systems. Also known to run on Windows 98 and ME, however due the lack of support for services in the OS, the Wrapper can be run only in console mode.</li></ul><h2 id="Installation">Installation</h2><p>Karaf Wrapper is an optional feature. To install it, simply type:</p><pre> +karaf@root> features:install wrapper +</pre><p>Once installed, wrapper feature will provide <tt>wrapper:install</tt> new command in the Karaf shell:</p><pre> +karaf@root> wrapper:install --help +DESCRIPTION + wrapper:install + + Install the container as a system service in the OS. + +SYNTAX + wrapper:install [options] + +OPTIONS + -s, --start-type + Mode in which the service is installed. AUTO_START or DEMAND_START (Default: AUTO_START) + (defaults to AUTO_START) + --help + Display this help message + -n, --name + The service name that will be used when installing the service. (Default: karaf) + (defaults to karaf) + -d, --display + The display name of the service. + -D, --description + The description of the service. + (defaults to ) +</pre><p>Using <tt>wrapper:install</tt>, you can install Karaf as a service.</p><p>For instance, to register Karaf as a service (depending of the running OS), in automatic start mode, simply type:</p><pre> +karaf@root> wrapper:install -s AUTO_START -n KARAF -d Karaf -D "Karaf Service" +</pre><p>For instance, on Linux, <tt>wrapper:install</tt> command will do:</p><pre> +karaf@root> wrapper:install -s AUTO_START -n KARAF -d Karaf -D "Karaf Service" +Creating file: /home/onofreje/apache-karaf-2.1.3/bin/KARAF-wrapper +Creating file: /home/onofreje/apache-karaf-2.1.3/bin/KARAF-service +Creating file: /home/onofreje/apache-karaf-2.1.3/etc/KARAF-wrapper.conf +Creating file: /home/onofreje/apache-karaf-2.1.3/lib/libwrapper.so +Creating file: /home/onofreje/apache-karaf-2.1.3/lib/karaf-wrapper.jar +Creating file: /home/onofreje/apache-karaf-2.1.3/lib/karaf-wrapper-main.jar + +Setup complete. You may wish to tweak the JVM properties in the wrapper configuration file: + /home/onofreje/apache-karaf-2.1.3/etc/KARAF-wrapper.conf +before installing and starting the service. + +The way the service is installed depends upon your flavor of Linux. + +On Redhat/Fedora/CentOS Systems: + To install the service: + $ ln -s /home/onofreje/apache-karaf-2.1.3/bin/KARAF-service /etc/init.d/ + $ chkconfig KARAF-service --add + + To start the service when the machine is rebooted: + $ chkconfig KARAF-service on + + To disable starting the service when the machine is rebooted: + $ chkconfig KARAF-service off + + To start the service: + $ service KARAF-service start + + To stop the service: + $ service KARAF-service stop + + To uninstall the service : + $ chkconfig KARAF-service --del + $ rm /etc/init.d/KARAF-service + +On Ubuntu/Debian Systems: + To install the service: + $ ln -s /home/onofreje/apache-karaf-2.1.3/bin/KARAF-service /etc/init.d/ + + To start the service when the machine is rebooted: + $ update-rc.d KARAF-service defaults + + To disable starting the service when the machine is rebooted: + $ update-rc.d -f KARAF-service remove + + To start the service: + $ /etc/init.d/KARAF-service start + + To stop the service: + $ /etc/init.d/KARAF-service stop + + To uninstall the service : + $ rm /etc/init.d/KARAF-service + +</pre> + </div> + </td> + </tr> + </table> + </td> + <td id="cell-2-2" colspan="2"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-3-0"> + + </td> + <td id="cell-3-1"> + + </td> + <td id="cell-3-2"> + <div id="footer"> + <div id="site-footer"> + © 2008-2011 The Apache Software Foundation + <br/> + Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation. + </div> + </div> + </td> + <td id="cell-3-3"> + + </td> + <td id="cell-3-4"> + + </td> + </tr> + <tr width="100%"> + <td id="cell-4-0" colspan="2"> + + </td> + <td id="cell-4-1"> + + </td> + <td id="cell-4-2" colspan="2"> + + </td> + </tr> + </table> + </body> +</html> \ No newline at end of file
