svn commit: r1326581 - /openejb/site/trunk/content/provisioning.mdtext

[rm...@apache.org]

Author: rmannibucau
Date: Mon Apr 16 12:59:58 2012
New Revision: 1326581

URL: http://svn.apache.org/viewvc?rev=1326581&view=rev
Log:
adding provisioning page

Added:
    openejb/site/trunk/content/provisioning.mdtext

Added: openejb/site/trunk/content/provisioning.mdtext
URL: http://svn.apache.org/viewvc/openejb/site/trunk/content/provisioning.mdtext?rev=1326581&view=auto
==============================================================================
--- openejb/site/trunk/content/provisioning.mdtext (added)
+++ openejb/site/trunk/content/provisioning.mdtext Mon Apr 16 12:59:58 2012
@@ -0,0 +1,76 @@
+Title: TomEE/OpenEJB provisioning
+
+# Summary
+
+Provioning is about the way to get binaries or information. It is the answer to
+how do i get my application, my webapp, my configuration.
+
+TomEE and OpenEJB brings some help about it allowing you to point out some
+resources instead of providing it directly.
+
+This indirection is clearly very useful to industrialize your software
+or simply to cloudify it.
+
+# A word about this page
+
+This page will not explain you how to deploy an application or
+how to enhance your container. It will simply explain you how which
+kind of urls are supported for such features.
+
+These feature are explained in other places.
+
+# Supported provionings
+## file
+
+This is the default and well know provisioning. Simply give a
+file path the container is able to access through its filesystem.
+
+Example:
+
+    /MIDDLE/foo/bar/my-local-file.jar
+
+## Http/https
+
+Here you give an url to access the desired file. Proxies used are the JVM ones.
+
+Example:
+
+    http://atos.net/foo/bar/my-http-file.jar 
+
+## Maven
+### Usage
+
+Probably the most fun but very useful for cloud deployments: maven.
+Use maven informations to deploy your application.
+
+The location should follow:
+
+    mvn:groupId/artifactId[/[version]/[type]]
+
+or
+
+    mvn:groupId:artifactId[:[version]:[type]]
+
+Note: classifier are supported (through version field)
+
+For instance you can use:
+
+    mvn:net.atos.xa/my-application/1.0.0/war
+
+### Installation
+
+The maven url parsing is not included by default in OpenEJB/TomEE bundle. It needs to be installed.
+
+If you are using an embedded application and maven simply add
+org.apache.openejb:openejb-provisionning:VERSION dependency.
+
+If you are using TomEE you have to extract the org.apache.openejb:openejb-provisionning zip 
+in the same classloader than tomee (webapps/tomee/lib for instance, for other places please have
+a look to other tip pages).
+
+Another way to install it with tomee is to edit or create the file <tomee>/conf/provisioning.properties
+and add the line:
+
+    zip=http://repo1.maven.org/maven2/org/apache/openejb/openejb-provisionning/<version>/openejb-provisionning-<version>.zip
+
+