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 2015/12/20 08:56:59 UTC
svn commit: r1720995 [6/6] - in /karaf/site/production/manual/latest-3.0.x:
./ commands/ developers-guide/ users-guide/
Modified: karaf/site/production/manual/latest-3.0.x/users-guide/wrapper.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-3.0.x/users-guide/wrapper.html?rev=1720995&r1=1720994&r2=1720995&view=diff
==============================================================================
--- karaf/site/production/manual/latest-3.0.x/users-guide/wrapper.html (original)
+++ karaf/site/production/manual/latest-3.0.x/users-guide/wrapper.html Sun Dec 20 07:56:55 2015
@@ -8,7 +8,7 @@
<link href="../css/style.css" rel="stylesheet" type="text/css"/>
<link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/>
<title>
- Apache Karaf 3.0.5-SNAPSHOT Guides
+ Apache Karaf 3.0.5 Guides
</title>
</head>
<body>
@@ -156,21 +156,21 @@ OPTIONS
(defaults to )
</pre><p>The <tt>wrapper:install</tt> command detects the running Operating Service and provide the service/daemon ready to be integrated in your system.</p><p>For instance, on a Ubuntu/Debian Linux system:</p><pre>
karaf@root()> wrapper:install
-Creating file: /opt/apache-karaf-3.0.0/bin/karaf-wrapper
-Creating file: /opt/apache-karaf-3.0.0/bin/karaf-service
-Creating file: /opt/apache-karaf-3.0.0/etc/karaf-wrapper.conf
-Creating file: /opt/apache-karaf-3.0.0/lib/libwrapper.so
-Creating file: /opt/apache-karaf-3.0.0/lib/karaf-wrapper.jar
-Creating file: /opt/apache-karaf-3.0.0/lib/karaf-wrapper-main.jar
+Creating file: /opt/apache-karaf-3.0.5/bin/karaf-wrapper
+Creating file: /opt/apache-karaf-3.0.5/bin/karaf-service
+Creating file: /opt/apache-karaf-3.0.5/etc/karaf-wrapper.conf
+Creating file: /opt/apache-karaf-3.0.5/lib/libwrapper.so
+Creating file: /opt/apache-karaf-3.0.5/lib/karaf-wrapper.jar
+Creating file: /opt/apache-karaf-3.0.5/lib/karaf-wrapper-main.jar
Setup complete. You may wish to tweak the JVM properties in the wrapper configuration file:
- /opt/apache-karaf-3.0.0/etc/karaf-wrapper.conf
+ /opt/apache-karaf-3.0.5/etc/karaf-wrapper.conf
before installing and starting the service.
Ubuntu/Debian Linux system detected:
To install the service:
- $ ln -s /opt/apache-karaf-3.0.0/bin/karaf-service /etc/init.d/
+ $ ln -s /opt/apache-karaf-3.0.5/bin/karaf-service /etc/init.d/
To start the service when the machine is rebooted:
$ update-rc.d karaf-service defaults
@@ -187,11 +187,15 @@ Ubuntu/Debian Linux system detected:
To uninstall the service :
$ rm /etc/init.d/karaf-service
-</pre><p>You can note that <tt>wrapper:install</tt> command detected the running operating system ("Ubuntu/Debian Linux system detected").</p><p>You have a complete explanation and list of system commands to perform to integrate Apache Karaf in your system:</p><pre>
-ln -s /opt/apache-karaf-3.0.0/bin/karaf-service /etc/init.d/
+</pre><p>You can note that <tt>wrapper:install</tt> command detected the running operating system ("Ubuntu/Debian Linux system detected").</p><p>You have a complete explanation and list of system commands to perform to integrate Apache Karaf in your systemV:</p><pre>
+ln -s /opt/apache-karaf-3.0.5/bin/karaf-service /etc/init.d/
update-rc.d karaf-service defaults
-</pre><h2 id="Uninstall">Uninstall</h2><p>The <tt>wrapper:install</tt> provides the system commands to perform to uninstall the service/daemon).</p><p>For instance, on Ubuntu/Debian, to uninstall the Apache Karaf service, you have to remove the <tt>karaf-service</tt> script from the runlevel scripts:</p><pre>
+</pre><p>Karaf also supports systemd service, so you can use systemctl instead of SystemV based service:</p><pre>
+systemctl enable /opt/apache-karaf-3.0.5/bin/karaf.service
+</pre><p>This will enable Karaf at system boot.</p><h2 id="Uninstall">Uninstall</h2><p>The <tt>wrapper:install</tt> provides the system commands to perform to uninstall the service/daemon).</p><p>For instance, on Ubuntu/Debian, to uninstall the Apache Karaf service, you have to remove the <tt>karaf-service</tt> script from the runlevel scripts:</p><pre>
rm /etc/init.d/karaf-service
+</pre><p>If you prefered the systemd service instead of systemV:</p><pre>
+systemctl disable karaf
</pre><p>You can remove the "Wrapper Service" installer after that:</p><pre>
karaf@root()> feature:uninstall service-wrapper
</pre><h2 id="NoteforMacOSusers">Note for MacOS users</h2><p>On MacOS you can install the service for an user or for the system.</p><p>If you want to add bin/org.apache.karaf.KARAF as user service move this file into ~/Library/LaunchAgents/:</p><pre>
@@ -229,10 +233,10 @@ launchctl remove org.apache.karaf.KARAF
# Wrapper Properties
#********************************************************************
set.default.JAVA_HOME=/opt/jdk/1.7.0_21
-set.default.KARAF_HOME=/home/jbonofre/workspace/karaf/karaf/assemblies/apache-karaf/target/apache-karaf-3.0.0-SNAPSHOT
-set.default.KARAF_BASE=/home/jbonofre/workspace/karaf/karaf/assemblies/apache-karaf/target/apache-karaf-3.0.0-SNAPSHOT
-set.default.KARAF_DATA=/home/jbonofre/workspace/karaf/karaf/assemblies/apache-karaf/target/apache-karaf-3.0.0-SNAPSHOT/data
-set.default.KARAF_ETC=/home/jbonofre/workspace/karaf/karaf/assemblies/apache-karaf/target/apache-karaf-3.0.0-SNAPSHOT/etc
+set.default.KARAF_HOME=/home/jbonofre/workspace/karaf/karaf/assemblies/apache-karaf/target/apache-karaf-3.0.5-SNAPSHOT
+set.default.KARAF_BASE=/home/jbonofre/workspace/karaf/karaf/assemblies/apache-karaf/target/apache-karaf-3.0.5-SNAPSHOT
+set.default.KARAF_DATA=/home/jbonofre/workspace/karaf/karaf/assemblies/apache-karaf/target/apache-karaf-3.0.5-SNAPSHOT/data
+set.default.KARAF_ETC=/home/jbonofre/workspace/karaf/karaf/assemblies/apache-karaf/target/apache-karaf-3.0.5-SNAPSHOT/etc
# Java Application
wrapper.working.dir=%KARAF_BASE%
@@ -341,7 +345,7 @@ wrapper.ntservice.starttype=AUTO_START
# Allow the service to interact with the desktop.
wrapper.ntservice.interactive=false
-</pre>
+</pre><h3 id="SystemD">SystemD</h3><p>The Karaf service wrapper also support Linux SystemD service.</p>
</div>
</td>
</tr>