You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by gn...@apache.org on 2011/02/11 11:51:50 UTC
svn commit: r1069742 - in /karaf/sandbox/website/src/main/webapp: ./
index/community/ index/community/news/
index/documentation/karaf-users-guide/4.-understanding-karaf/
index/documentation/karaf-users-guide/6.-advanced-uses/ site/
Author: gnodet
Date: Fri Feb 11 10:51:50 2011
New Revision: 1069742
URL: http://svn.apache.org/viewvc?rev=1069742&view=rev
Log:
Update with latest confluence changes
Added:
karaf/sandbox/website/src/main/webapp/index/community/news/
karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-06-16.page
karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-07-23.page
karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-09-24.page
karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-14.page
karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-25.page
karaf/sandbox/website/src/main/webapp/index/community/news/news-2011-01-11.page
karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.2.-custom-distributions.page
karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.9.-branding-the-console.page
Modified:
karaf/sandbox/website/src/main/webapp/index.page
karaf/sandbox/website/src/main/webapp/index/community/news.page
karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/4.-understanding-karaf/4.6.-provisioning.page
karaf/sandbox/website/src/main/webapp/site/navigation.page
Modified: karaf/sandbox/website/src/main/webapp/index.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index.page?rev=1069742&r1=1069741&r2=1069742&view=diff
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index.page (original)
+++ karaf/sandbox/website/src/main/webapp/index.page Fri Feb 11 10:51:50 2011
@@ -1,9 +1,9 @@
----
-title: Index
-page_version: 13
-page_creator: gnodet
-page_modifier: nanthrax
---- pipeline:conf
+---
+title: Index
+page_version: 15
+page_creator: gnodet
+page_modifier: gnodet
+--- pipeline:conf
{section}
{column}
Apache Karaf is a small OSGi based runtime which provides a lightweight container onto which various components and applications can be deployed.
@@ -60,6 +60,8 @@ new TWTR.Widget({
h2. News
-{blog-posts:5}
+{include:news-2011-01-11}
+{include:news-2010-11-25}
+{include:news-2010-11-14}
----
[More News|News]
\ No newline at end of file
Modified: karaf/sandbox/website/src/main/webapp/index/community/news.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/community/news.page?rev=1069742&r1=1069741&r2=1069742&view=diff
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/community/news.page (original)
+++ karaf/sandbox/website/src/main/webapp/index/community/news.page Fri Feb 11 10:51:50 2011
@@ -1,9 +1,14 @@
---
title: News
-page_version: 1
+page_version: 3
page_creator: gnodet
page_modifier: gnodet
--- pipeline:conf
h2. News
-{blog-posts:20}
+{include:news-2011-01-11}
+{include:news-2010-11-25}
+{include:news-2010-11-14}
+{include:news-2010-09-24}
+{include:news-2010-07-23}
+{include:news-2010-06-16}
Added: karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-06-16.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-06-16.page?rev=1069742&view=auto
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-06-16.page (added)
+++ karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-06-16.page Fri Feb 11 10:51:50 2011
@@ -0,0 +1,12 @@
+---
+title: news-2010-06-16
+page_version: 2
+page_creator: gnodet
+page_modifier: gnodet
+--- pipeline:conf
+h1. Guillaume Nodet posted on Jun 16, 2010\\Karaf is now TLP
+
+
+Today, the [Apache Software Foundation|http://www.apache.org] board has just established Karaf as a new Top Level Project.
+
+The whole community is thrilled and will strive to make the project even better and more successful.
Added: karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-07-23.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-07-23.page?rev=1069742&view=auto
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-07-23.page (added)
+++ karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-07-23.page Fri Feb 11 10:51:50 2011
@@ -0,0 +1,11 @@
+---
+title: news-2010-07-23
+page_version: 2
+page_creator: gnodet
+page_modifier: gnodet
+--- pipeline:conf
+h1. Jamie Goodyear posted on Jul 23, 2010\\Karaf 2.0.0 released
+
+The Karaf team is pleased to announce the availability of [Karaf 2.0.0|http://karaf.apache.org/download.html].
+This release is our first as a top level apache project, and includes a number of new features, improvements and bug fixes.
+For more information, please see the [release notes|http://karaf.apache.org/karaf-200-release.html].
\ No newline at end of file
Added: karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-09-24.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-09-24.page?rev=1069742&view=auto
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-09-24.page (added)
+++ karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-09-24.page Fri Feb 11 10:51:50 2011
@@ -0,0 +1,13 @@
+---
+title: news-2010-09-24
+page_version: 2
+page_creator: gnodet
+page_modifier: gnodet
+--- pipeline:conf
+h1. Jamie Goodyear posted on Sep 24, 2010\\Karaf 2.1.0 released
+
+The Karaf team is pleased to announce the availability of [Karaf 2.1.0|http://karaf.apache.org/download.html] .
+New to this release of Apache Karaf is a JAAS Database Login Module, a way to store passwords in a secured way, a mechanism that allows a karaf application to distinguish between UserPrincipal and RolePrincipal without depending from the Karaf JAAS Module.
+The shell console has been enhanced to be available in a plain non-OSGi environment and smart tab completion has been improved, along with various commands.
+We have also resolved a number of outstanding issues, and improved support on OS X and IBM Java based systems.
+For more information, please see the [release notes|http://karaf.apache.org/karaf-210-release.html] .
\ No newline at end of file
Added: karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-14.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-14.page?rev=1069742&view=auto
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-14.page (added)
+++ karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-14.page Fri Feb 11 10:51:50 2011
@@ -0,0 +1,11 @@
+---
+title: news-2010-11-14
+page_version: 3
+page_creator: gnodet
+page_modifier: gnodet
+--- pipeline:conf
+h1. Jamie Goodyear posted on Nov 14, 2010\\Karaf 2.1.1 released
+
+The Karaf team is pleased to announce the availability of [Karaf 2.1.1|http://karaf.apache.org/download.html].
+This release of Apache Karaf is based off of the 2.1.x series branch, representing an update to Apache Karaf 2.1.0. It contains multiple bug fixes, while introducing a minimal number of changes to dependencies from our last release.
+For more information, please see the [release notes|http://karaf.apache.org/karaf-211-release.html].
\ No newline at end of file
Added: karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-25.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-25.page?rev=1069742&view=auto
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-25.page (added)
+++ karaf/sandbox/website/src/main/webapp/index/community/news/news-2010-11-25.page Fri Feb 11 10:51:50 2011
@@ -0,0 +1,11 @@
+---
+title: news-2010-11-25
+page_version: 2
+page_creator: gnodet
+page_modifier: gnodet
+--- pipeline:conf
+h1. Jamie Goodyear posted on Nov 25, 2010\\Karaf 2.1.2 released
+
+The Karaf team is pleased to announce the availability of [Karaf 2.1.2|http://karaf.apache.org/karaf-212-release.html].
+This release of Apache Karaf is based off of the 2.1.x series branch, representing an update to Apache Karaf 2.1.1. It contains several bug fixes identified in the prior release, and updates the pax-url version.
+For more information, please see the [release notes|http://karaf.apache.org/karaf-212-release.html].
\ No newline at end of file
Added: karaf/sandbox/website/src/main/webapp/index/community/news/news-2011-01-11.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/community/news/news-2011-01-11.page?rev=1069742&view=auto
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/community/news/news-2011-01-11.page (added)
+++ karaf/sandbox/website/src/main/webapp/index/community/news/news-2011-01-11.page Fri Feb 11 10:51:50 2011
@@ -0,0 +1,11 @@
+---
+title: news-2011-01-11
+page_version: 2
+page_creator: gnodet
+page_modifier: gnodet
+--- pipeline:conf
+h1. Jamie Goodyear posted on Jan 11, 2011\\Karaf 2.1.3 released
+
+The Karaf team is pleased to announce the availability of [Karaf 2.1.3|Karaf 2.1.3 Release].
+This release of Apache Karaf is based off of the 2.1.x series branch, representing an update to Apache Karaf 2.1.2. It contains several bug fixes identified in the prior release, and updates the versions of SLF4j, pax-url-mvn, spring, and pax-exam. For more detail please see the change log below.
+For more information, please see the [release notes|Karaf 2.1.3 Release].
\ No newline at end of file
Modified: karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/4.-understanding-karaf/4.6.-provisioning.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/4.-understanding-karaf/4.6.-provisioning.page?rev=1069742&r1=1069741&r2=1069742&view=diff
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/4.-understanding-karaf/4.6.-provisioning.page (original)
+++ karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/4.-understanding-karaf/4.6.-provisioning.page Fri Feb 11 10:51:50 2011
@@ -1,8 +1,8 @@
---
title: 4.6. Provisioning
-page_version: 24
+page_version: 25
page_creator: gnodet
-page_modifier: christian schneider
+page_modifier: nanthrax
--- pipeline:conf
{scrollbar}
{anchor:top}
@@ -81,7 +81,7 @@ This configuration file contains two pro
* {{featuresBoot}}: a comma separated list of features to install at startup
* {{featuresRepositories}}: a comma separated list of feature repositories to load at startup
-This configuration file is of interest if you plan to distribute Apache Karaf distribution which includes pre-installed features. Such a process is detailed in the [6.2. Building custom distributions] section.
+This configuration file is of interest if you plan to distribute Apache Karaf distribution which includes pre-installed features. Such a process is detailed in the [6.2. Custom distributions] section.
h2. Repositories
Added: karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.2.-custom-distributions.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.2.-custom-distributions.page?rev=1069742&view=auto
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.2.-custom-distributions.page (added)
+++ karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.2.-custom-distributions.page Fri Feb 11 10:51:50 2011
@@ -0,0 +1,128 @@
+---
+title: 6.2. Custom distributions
+page_version: 7
+page_creator: gnodet
+page_modifier: nanthrax
+--- pipeline:conf
+{scrollbar}
+{anchor:top}
+
+h1. 6.2. Custom distributions
+
+As Karaf is an OSGi container, it's heavily used as the kernel of applications and middlewares.
+
+You could require to construct your own Karaf distribution matching your requirements.
+This custom distribution could contain:
+- configuration files that you want to change by default (in the etc folder)
+- pre-packaged artifacts in the deploy folder
+- pre-populated system repository (containing your own bundle and features descriptor)
+- renamed or specific scripts in the bin folder
+- branding
+- your documentation files
+
+h2. Maven assembly
+
+Basically a Karaf custom distribution is:
+1. Uncompressing a standard Karaf distribution in a given directory.
+2. Populating the system repo with your features.
+3. Populating the lib directory with your branding or other system bundle jar files.
+4. Overriding the configuration files in the etc folder.
+
+These tasks could be performed using scripting, or more easily and portable, using Apache Maven and a set of Maven plugins.
+
+For instance, the Maven POM could look like:
+
+{code}
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+ <groupId>my.company</groupId>
+ <artifactId>mycustom-karaf</artifactId>
+ <version>1.0</version>
+ <packaging>pom</packaging>
+ <name>My Unix Custom Karaf Distribution</name>
+
+ <properties>
+ <karaf.version>2.1.3</karaf.version>
+ </properties>
+
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.karaf</groupId>
+ <artifactId>apache-karaf</artifactId>
+ <version>${karaf.version}</version>
+ <type>tar.gz</type>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.karaf</groupId>
+ <artifactId>apache-karaf</artifactId>
+ <version>${karaf.version}</version>
+ <type>xml</type>
+ <classifier>features</classifier>
+ </dependency>
+ </dependencies>
+
+ <build>
+ <resources>
+ <resource>
+ <directory>${project.basedir}/src/main/filtered-resources</directory>
+ <filtering>true</filtering>
+ <includes>
+ <include>**/*</include>
+ </includes>
+ </resource>
+ </resources>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-resources-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>filter</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>resources</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.karaf.tooling</groupId>
+ <artifactId>features-maven-plugin</artifactId>
+ <version>${karaf.version}</version>
+ <executions>
+ <execution>
+ <id>add-features-to-repo</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>add-features-to-repo</goal>
+ </goals>
+ <configuration>
+ <descriptors>
+ <descriptor>mvn:org.apache.karaf/apache-karaf/${karaf.version}/xml/features</descriptor>
+ <descriptor>file:${project.basedir}/target/classes/my-features.xml</descriptor>
+ </descriptors>
+ <features>
+ <feature>my-feature</feature>
+ </features>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ <!-- TODO complete with dependency plugin section -->
+ </plugins>
+ </build>
+
+</project>
+{code}
+
+TODO Complete
+
+h2. Custom distribution examples
+
+* [Apache ServiceMix 4|http://svn.apache.org/repos/asf/servicemix/smx4/features/trunk/assembly/]
+* [Apache ServiceMix NMR|http://svn.apache.org/repos/asf/servicemix/smx4/nmr/trunk/assembly/]
+* [BuildProcess BuildEraser|http://buildprocess.svn.sourceforge.net/viewvc/buildprocess/builderaser/trunk/assembly/]
+
+[#top]
+{scrollbar}
Added: karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.9.-branding-the-console.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.9.-branding-the-console.page?rev=1069742&view=auto
==============================================================================
--- karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.9.-branding-the-console.page (added)
+++ karaf/sandbox/website/src/main/webapp/index/documentation/karaf-users-guide/6.-advanced-uses/6.9.-branding-the-console.page Fri Feb 11 10:51:50 2011
@@ -0,0 +1,98 @@
+---
+title: 6.9. Branding the console
+page_version: 3
+page_creator: nanthrax
+page_modifier: nanthrax
+--- pipeline:conf
+{scrollbar}
+{anchor:top}
+
+h1. 6.9. Branding the Console
+
+This chapter will guide you how to brand the Karaf console.
+
+By branding, it means that you can define your own welcome message and console prompt.
+
+h2. Create your branding bundle
+
+At startup, Karaf is looking for a bundle which export {{org.apache.karaf.branding}} package containing a {{branding.properties}}
+file.
+
+So you need to create a very simply bundle just containing a {{org/apache/karaf/branding/branding.properties}} file.
+
+The Maven POM of your branding bundle should looks like:
+
+{code:lang=xml}
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+ <modelVersion>4.0.0</modelVersion>
+
+ <groupId>your.group.id</groupId>
+ <artifactId>your.branding.artifact.id</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <packaging>bundle</packaging>
+ <name>Your Branding Bundle Name</name>
+
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.felix</groupId>
+ <artifactId>maven-bundle-plugin</artifactId>
+ <version>2.2</version>
+ <extensions>true</extensions>
+ <configuration>
+ <instructions>
+ <Bundle-SymbolicName>${project.artifactId}</bundle-SymbolicName>
+ <Import-Package>*</Import-Package>
+ <Private-Package>!*</Private-Package>
+ <Export-Package>
+ org.apache.karaf.branding
+ </Export-Package>
+ <Spring-Context>*;public-context:=false</Spring-Context>
+ </instructions>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+
+</project>
+{code}
+
+Now, add a {{src/main/resources/org/apache/karaf/branding/branding.properties}} looking like:
+
+{{code}}
+welcome = \
+\u001B[36m __ __ ____ \u001B[0m\r\n\
+\u001B[36m / //_/____ __________ _/ __/ \u001B[0m\r\n\
+\u001B[36m / ,< / __ `/ ___/ __ `/ /_ \u001B[0m\r\n\
+\u001B[36m / /| |/ /_/ / / / /_/ / __/ \u001B[0m\r\n\
+\u001B[36m /_/ |_|\\__,_/_/ \\__,_/_/ \u001B[0m\r\n\
+\r\n\
+\u001B[1m Apache Karaf\u001B[0m (${project.version})\r\n\
+\r\n\
+Hit '\u001B[1m<tab>\u001B[0m' for a list of available commands\r\n\
+ and '\u001B[1m[cmd] --help\u001B[0m' for help on a specific command.\r\n\
+Hit '\u001B[1m<ctrl-d>\u001B[0m' or '\u001B[1mosgi:shutdown\u001B[0m' to shutdown Karaf.\r\n
+{{code}}
+
+As you can see, the {{branding.properties}} contains one property:
+* welcome is the welcome message displayed when you start Karaf.
+
+As you can see, welcome string supports ASCII escaped format. For instance \u001B[1m switch the foreground in bold and \u001B[0m
+switch back to normal.
+
+h2. Installing the branding bundle
+
+Build your branding bundle:
+
+{code}
+mvn install
+{code}
+
+and simply drop the generated jar file into the Karaf lib directory.
+
+Start Karaf and you will see your branded Karaf console.
+
+[#top]
+{scrollbar}
\ No newline at end of file
Modified: karaf/sandbox/website/src/main/webapp/site/navigation.page
URL: http://svn.apache.org/viewvc/karaf/sandbox/website/src/main/webapp/site/navigation.page?rev=1069742&r1=1069741&r2=1069742&view=diff
==============================================================================
--- karaf/sandbox/website/src/main/webapp/site/navigation.page (original)
+++ karaf/sandbox/website/src/main/webapp/site/navigation.page Fri Feb 11 10:51:50 2011
@@ -1,19 +1,20 @@
---
title: Navigation
-page_version: 11
+page_version: 14
page_creator: gnodet
page_modifier: gnodet
--- pipeline:conf
h3. [Overview|Karaf Overview]
- [Home|Index]
-- [Getting Started|2. Quick Start]
+- [Getting Started|http://karaf.apache.org/manual/2.1.99-SNAPSHOT/quick-start.html]
- [FAQ]
- [Download]
-h3. [Documentation]
+h3. [Documentation|http://karaf.apache.org/manual/2.1.99-SNAPSHOT]
-- [Users' Guide|Karaf Users' Guide]
+- [Users' Guide|http://karaf.apache.org/manual/2.1.99-SNAPSHOT/users-guide/index.html]
+- [Developer Guide|http://karaf.apache.org/manual/2.1.99-SNAPSHOT/developers-guide/index.html]
h3. Search
@@ -37,16 +38,16 @@ h3. [Community]
- [Mailing Lists]
- [News]
- [Articles]
-- [Site]
- [Team]
h3. [Developers]
-- [Developer Guide|Developers]
- [Roadmap]
- [Source]
- [Building]
- [IRC Room]
+- [Site]
+- [Wiki|https://cwiki.apache.org/confluence/display/KARAF]
h3. [ASF|http://www.apache.org/]