You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@stratos.apache.org by la...@apache.org on 2013/07/22 11:45:24 UTC

[05/11] Added missing files of cloud controller from cloud controller 1.0.1

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/resources/xslt/datatypes.dtd
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/resources/xslt/datatypes.dtd b/products/cloud_controller/modules/distribution/src/site/xdoc/resources/xslt/datatypes.dtd
new file mode 100644
index 0000000..63794d0
--- /dev/null
+++ b/products/cloud_controller/modules/distribution/src/site/xdoc/resources/xslt/datatypes.dtd
@@ -0,0 +1,200 @@
+<!--
+        DTD for XML Schemas: Part 2: Datatypes
+        $Id: datatypes.dtd,v 1.23 2001/03/16 17:36:30 ht Exp $
+        Note this DTD is NOT normative, or even definitive. - - the
+        prose copy in the datatypes REC is the definitive version
+        (which shouldn't differ from this one except for this comment
+        and entity expansions, but just in case)
+  -->
+<!--
+        This DTD cannot be used on its own, it is intended
+        only for incorporation in XMLSchema.dtd, q.v.
+  -->
+<!-- Define all the element names, with optional prefix -->
+<!ENTITY % simpleType "%p;simpleType">
+<!ENTITY % restriction "%p;restriction">
+<!ENTITY % list "%p;list">
+<!ENTITY % union "%p;union">
+<!ENTITY % maxExclusive "%p;maxExclusive">
+<!ENTITY % minExclusive "%p;minExclusive">
+<!ENTITY % maxInclusive "%p;maxInclusive">
+<!ENTITY % minInclusive "%p;minInclusive">
+<!ENTITY % totalDigits "%p;totalDigits">
+<!ENTITY % fractionDigits "%p;fractionDigits">
+<!ENTITY % length "%p;length">
+<!ENTITY % minLength "%p;minLength">
+<!ENTITY % maxLength "%p;maxLength">
+<!ENTITY % enumeration "%p;enumeration">
+<!ENTITY % whiteSpace "%p;whiteSpace">
+<!ENTITY % pattern "%p;pattern">
+<!--
+        Customisation entities for the ATTLIST of each element
+        type. Define one of these if your schema takes advantage
+        of the anyAttribute='##other' in the schema for schemas
+  -->
+<!ENTITY % simpleTypeAttrs "">
+<!ENTITY % restrictionAttrs "">
+<!ENTITY % listAttrs "">
+<!ENTITY % unionAttrs "">
+<!ENTITY % maxExclusiveAttrs "">
+<!ENTITY % minExclusiveAttrs "">
+<!ENTITY % maxInclusiveAttrs "">
+<!ENTITY % minInclusiveAttrs "">
+<!ENTITY % totalDigitsAttrs "">
+<!ENTITY % fractionDigitsAttrs "">
+<!ENTITY % lengthAttrs "">
+<!ENTITY % minLengthAttrs "">
+<!ENTITY % maxLengthAttrs "">
+<!ENTITY % enumerationAttrs "">
+<!ENTITY % whiteSpaceAttrs "">
+<!ENTITY % patternAttrs "">
+<!-- Define some entities for informative use as attribute
+        types -->
+<!ENTITY % URIref "CDATA">
+<!ENTITY % XPathExpr "CDATA">
+<!ENTITY % QName "NMTOKEN">
+<!ENTITY % QNames "NMTOKENS">
+<!ENTITY % NCName "NMTOKEN">
+<!ENTITY % nonNegativeInteger "NMTOKEN">
+<!ENTITY % boolean "(true|false)">
+<!ENTITY % simpleDerivationSet "CDATA">
+<!--
+        #all or space-separated list drawn from derivationChoice
+  -->
+<!--
+        Note that the use of 'facet' below is less restrictive
+        than is really intended:  There should in fact be no
+        more than one of each of minInclusive, minExclusive,
+        maxInclusive, maxExclusive, totalDigits, fractionDigits,
+        length, maxLength, minLength within datatype,
+        and the min- and max- variants of Inclusive and Exclusive
+        are mutually exclusive. On the other hand,  pattern and
+        enumeration may repeat.
+  -->
+<!ENTITY % minBound "(%minInclusive; | %minExclusive;)">
+<!ENTITY % maxBound "(%maxInclusive; | %maxExclusive;)">
+<!ENTITY % bounds "%minBound; | %maxBound;">
+<!ENTITY % numeric "%totalDigits; | %fractionDigits;">
+<!ENTITY % ordered "%bounds; | %numeric;">
+<!ENTITY % unordered "%pattern; | %enumeration; | %whiteSpace; | %length; |
+   %maxLength; | %minLength;">
+<!ENTITY % facet "%ordered; | %unordered;">
+<!ENTITY % facetAttr "value CDATA #REQUIRED
+        id ID #IMPLIED">
+<!ENTITY % fixedAttr "fixed %boolean; #IMPLIED">
+<!ENTITY % facetModel "(%annotation;)?">
+<!ELEMENT %simpleType; ((%annotation;)?, (%restriction; | %list; | %union;))>
+<!ATTLIST %simpleType;
+	name %NCName; #IMPLIED
+	final %simpleDerivationSet; #IMPLIED
+	id ID #IMPLIED
+	%simpleTypeAttrs; 
+>
+<!-- name is required at top level -->
+<!ELEMENT %restriction; ((%annotation;)?, (%restriction1; | ((%simpleType;)?, (%facet;)*)), (%attrDecls;))>
+<!ATTLIST %restriction;
+	base %QName; #IMPLIED
+	id ID #IMPLIED
+	%restrictionAttrs; 
+>
+<!--
+        base and simpleType child are mutually exclusive,
+        one is required.
+
+        restriction is shared between simpleType and
+        simpleContent and complexContent (in XMLSchema.xsd).
+        restriction1 is for the latter cases, when this
+        is restricting a complex type, as is attrDecls.
+  -->
+<!ELEMENT %list; ((%annotation;)?, (%simpleType;)?)>
+<!ATTLIST %list;
+	itemType %QName; #IMPLIED
+	id ID #IMPLIED
+	%listAttrs; 
+>
+<!--
+        itemType and simpleType child are mutually exclusive,
+        one is required
+  -->
+<!ELEMENT %union; ((%annotation;)?, (%simpleType;)*)>
+<!ATTLIST %union;
+	id ID #IMPLIED
+	memberTypes %QNames; #IMPLIED
+	%unionAttrs; 
+>
+<!--
+        At least one item in memberTypes or one simpleType
+        child is required
+  -->
+<!ELEMENT %maxExclusive; %facetModel;>
+<!ATTLIST %maxExclusive;
+	%facetAttr; 
+	%fixedAttr; 
+	%maxExclusiveAttrs; 
+>
+<!ELEMENT %minExclusive; %facetModel;>
+<!ATTLIST %minExclusive;
+	%facetAttr; 
+	%fixedAttr; 
+	%minExclusiveAttrs; 
+>
+<!ELEMENT %maxInclusive; %facetModel;>
+<!ATTLIST %maxInclusive;
+	%facetAttr; 
+	%fixedAttr; 
+	%maxInclusiveAttrs; 
+>
+<!ELEMENT %minInclusive; %facetModel;>
+<!ATTLIST %minInclusive;
+	%facetAttr; 
+	%fixedAttr; 
+	%minInclusiveAttrs; 
+>
+<!ELEMENT %totalDigits; %facetModel;>
+<!ATTLIST %totalDigits;
+	%facetAttr; 
+	%fixedAttr; 
+	%totalDigitsAttrs; 
+>
+<!ELEMENT %fractionDigits; %facetModel;>
+<!ATTLIST %fractionDigits;
+	%facetAttr; 
+	%fixedAttr; 
+	%fractionDigitsAttrs; 
+>
+<!ELEMENT %length; %facetModel;>
+<!ATTLIST %length;
+	%facetAttr; 
+	%fixedAttr; 
+	%lengthAttrs; 
+>
+<!ELEMENT %minLength; %facetModel;>
+<!ATTLIST %minLength;
+	%facetAttr; 
+	%fixedAttr; 
+	%minLengthAttrs; 
+>
+<!ELEMENT %maxLength; %facetModel;>
+<!ATTLIST %maxLength;
+	%facetAttr; 
+	%fixedAttr; 
+	%maxLengthAttrs; 
+>
+<!-- This one can be repeated -->
+<!ELEMENT %enumeration; %facetModel;>
+<!ATTLIST %enumeration;
+	%facetAttr; 
+	%enumerationAttrs; 
+>
+<!ELEMENT %whiteSpace; %facetModel;>
+<!ATTLIST %whiteSpace;
+	%facetAttr; 
+	%fixedAttr; 
+	%whiteSpaceAttrs; 
+>
+<!-- This one can be repeated -->
+<!ELEMENT %pattern; %facetModel;>
+<!ATTLIST %pattern;
+	%facetAttr; 
+	%patternAttrs; 
+>

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/rm/docs/images/rm.jpg
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/rm/docs/images/rm.jpg b/products/cloud_controller/modules/distribution/src/site/xdoc/rm/docs/images/rm.jpg
new file mode 100644
index 0000000..d0b4a5f
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/rm/docs/images/rm.jpg differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/docs/userguide.xml
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/docs/userguide.xml b/products/cloud_controller/modules/distribution/src/site/xdoc/role/docs/userguide.xml
new file mode 100644
index 0000000..7d05d78
--- /dev/null
+++ b/products/cloud_controller/modules/distribution/src/site/xdoc/role/docs/userguide.xml
@@ -0,0 +1,111 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<!--
+ ~ Copyright (c) 2005-2011, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+ ~
+ ~ WSO2 Inc. licenses this file to you under the Apache License,
+ ~ Version 2.0 (the "License"); you may not use this file except
+ ~ in compliance with the License.
+ ~ You may obtain a copy of the License at
+ ~
+ ~    http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied.  See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<html>
+<head>
+    <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"/>
+  <title>Role Management - User Guide</title>
+  <link href="../../admin/css/documentation.css" rel="stylesheet" type="text/css" media="all" />
+</head>
+
+<body style="font-family: Times New Roman,Times,serif; font-size: 12pt;">
+<h1>User Management</h1>
+
+<p>The User Management component of the WSO2 Carbon facilitates the management
+and control of user accounts and user roles at different levels. The key
+functionalities of this component include:</p>
+<ul>
+  <li>Add, modify or remove user accounts</li>
+  <li>Add, modify or remove user roles</li>
+</ul>
+
+<h2>Managing User Roles</h2>
+
+<p>Use the <em><strong>Roles</strong></em> page to add new user roles, modify
+existing roles, or delete existing roles.</p>
+
+<p><img alt="" src="../images/role-main.png" height="207" width="577"/></p>
+
+<p>Figure 1: Roles Management</p>
+
+
+<ol>
+  <li>In the navigator, under <strong>Configure</strong>, click <strong>Users and Roles
+    </strong>. The <em><strong>User Management</strong></em>
+    page appears.</li>
+  <li>Click on <strong>Roles</strong> in the <strong> System User Store</strong>
+    panel. The <em><strong>Roles</strong></em> page appears.</li>
+</ol>
+<ul>
+  <ul>
+    <li>To add a user role,</li>
+  </ul>
+</ul>
+<ol>
+  <ol>
+    <li>Click <strong>Add New Role</strong> on the
+      <em><strong>Roles</strong></em> page.</li>
+    <li>Enter the role name.</li>
+    <li>Click <strong>Next.</strong></li>
+
+    <p><img alt="" src="../images/add-role1.png" height="200" width="500"/></p>
+
+    <p>Figure 2: Add user role</p>
+    <li>In step 2, select the permissions you want to assign to the role. Please refer to the
+    <a href="rolepermissions.html">Role Permissions</a> guide for details on permissions.</li>
+  </ol>
+</ol>
+
+<p><img alt="" src="../images/add-role2.png" height="418" width="471"/></p>
+
+<p>Figure 3: Add permission to user role</p>
+<ul>
+  <li>You can modify role permissions, and re-assign the users belonging to
+    particular role, by clicking <strong>Edit Permissions</strong>, and
+    <strong>Edit Users</strong> respectively on the
+    <em><strong>Roles</strong></em> page.. 
+    
+  </li>
+    <li>In step 3, optionally, you can select the users who
+      belong to that role. (Some external user stores like LDAP, do not allow to create empty roles. In that case this step is mandatory.)
+    </li>
+    <li>Click <strong>Finish</strong>.
+      The role you created will appear in the <em><strong>Roles</strong></em>
+      panel.
+    </li>
+    <p><img alt="" src="../images/add-role3.png" height="300" width="600"/></p>
+
+    <p>Figure 4: Add users to role</p>
+  <li>To delete a role, click <strong>Delete</strong> on the
+    <em><strong>Roles</strong></em> page. Please note that you cannot delete
+    the admin role from the system.</li>
+</ul>
+
+<p><b>Note:</b></p>
+<ul>
+    <li>If you connect to an external user store (like LDAP) in read only mode, you can read existing roles from it
+    but you can not edit/delete the roles.</li>
+    <li>
+       In this case, you can still create new roles which will be managed internally and which are editable.
+    </li>
+    <li>If you connect to the external user store in read/write mode, you can edit the roles in external user store as well.</li>
+</ul>
+
+<p></p>
+</body>
+</html>

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/Thumbs.db
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/Thumbs.db b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/Thumbs.db
new file mode 100644
index 0000000..4324fd5
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/Thumbs.db differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add-role1.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add-role1.png b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add-role1.png
new file mode 100644
index 0000000..f7e90ff
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add-role1.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add-role3.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add-role3.png b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add-role3.png
new file mode 100644
index 0000000..476502f
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add-role3.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add.gif
new file mode 100644
index 0000000..4bfdd79
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/add.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/contractall.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/contractall.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/contractall.gif
new file mode 100644
index 0000000..b267f7f
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/contractall.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/role-main.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/role-main.png b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/role-main.png
new file mode 100644
index 0000000..1be4bd0
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/role-main.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/user-roles.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/user-roles.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/user-roles.gif
new file mode 100644
index 0000000..8d76864
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/user-roles.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/user-store.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/user-store.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/user-store.gif
new file mode 100644
index 0000000..ccf18a3
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/user-store.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/view.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/view.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/view.gif
new file mode 100644
index 0000000..9a1c6e2
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/role/images/view.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/role/js/treeview.css
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/role/js/treeview.css b/products/cloud_controller/modules/distribution/src/site/xdoc/role/js/treeview.css
new file mode 100644
index 0000000..b0ee63d
--- /dev/null
+++ b/products/cloud_controller/modules/distribution/src/site/xdoc/role/js/treeview.css
@@ -0,0 +1,7 @@
+/*
+Copyright (c) 2009, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 2.7.0
+*/
+.ygtvitem{}.ygtvitem table{margin-bottom:0;border:none;}.ygtvrow td{border:none;padding:0;}.ygtvrow td a{text-decoration:none;}.ygtvtn{width:18px;height:22px;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -5600px no-repeat;}.ygtvtm{width:18px;height:22px;cursor:pointer;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -4000px no-repeat;}.ygtvtmh,.ygtvtmhh{width:18px;height:22px;cursor:pointer;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -4800px no-repeat;}.ygtvtp{width:18px;height:22px;cursor:pointer;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -6400px no-repeat;}.ygtvtph,.ygtvtphh{width:18px;height:22px;cursor:pointer;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -7200px no-repeat;}.ygtvln{width:18px;height:22px;ba
 ckground:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -1600px no-repeat;}.ygtvlm{width:18px;height:22px;cursor:pointer;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 0px no-repeat;}.ygtvlmh,.ygtvlmhh{width:18px;height:22px;cursor:pointer;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -800px no-repeat;}.ygtvlp{width:18px;height:22px;cursor:pointer;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -2400px no-repeat;}.ygtvlph,.ygtvlphh{width:18px;height:22px;cursor:pointer;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -3200px no-repeat;}.ygtvloading{width:18px;height:22px;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-loading.gif) 0 0 no-repeat;}.ygtvdepthcell{width:18px;height:22px;backgroun
 d:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -8000px no-repeat;}.ygtvblankdepthcell{width:18px;height:22px;}.ygtvchildren{}* html .ygtvchildren{height:2%;}.ygtvlabel,.ygtvlabel:link,.ygtvlabel:visited,.ygtvlabel:hover{margin-left:2px;text-decoration:none;background-color:white;cursor:pointer;}.ygtvcontent{cursor:default;}.ygtvspacer{height:22px;width:12px;}.ygtvfocus{background-color:#c0e0e0;border:none;}.ygtvfocus .ygtvlabel,.ygtvfocus .ygtvlabel:link,.ygtvfocus .ygtvlabel:visited,.ygtvfocus .ygtvlabel:hover{background-color:#c0e0e0;}.ygtvfocus a,.ygtvrow td a{outline-style:none;}.ygtvok{width:18px;height:22px;background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -8800px no-repeat;}.ygtvok:hover{background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -8844px no-repeat;}.ygtvcancel{width:18px;height:22px;background:url(http://yui.yahooapis.com/2.
 7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -8822px no-repeat;}.ygtvcancel:hover{background:url(http://yui.yahooapis.com/2.7.0/build/treeview/assets/skins/sam/treeview-sprite.gif) 0 -8866px no-repeat;}.ygtv-label-editor{background-color:#f2f2f2;border:1px solid silver;position:absolute;display:none;overflow:hidden;margin:auto;z-index:9000;}.ygtv-edit-TextNode{width:190px;}.ygtv-edit-TextNode .ygtvcancel,.ygtv-edit-TextNode .ygtvok{border:none;}.ygtv-edit-TextNode .ygtv-button-container{float:right;}.ygtv-edit-TextNode .ygtv-input input{width:140px;}.ygtv-edit-DateNode .ygtvcancel{border:none;}.ygtv-edit-DateNode .ygtvok{display:none;}.ygtv-edit-DateNode .ygtv-button-container{text-align:right;margin:auto;}

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/docs/userguide.xml
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/docs/userguide.xml b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/docs/userguide.xml
new file mode 100644
index 0000000..8f26d9c
--- /dev/null
+++ b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/docs/userguide.xml
@@ -0,0 +1,91 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<!--
+ ~ Copyright (c) 2005-2011, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+ ~
+ ~ WSO2 Inc. licenses this file to you under the Apache License,
+ ~ Version 2.0 (the "License"); you may not use this file except
+ ~ in compliance with the License.
+ ~ You may obtain a copy of the License at
+ ~
+ ~    http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied.  See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<html>
+<head>
+    <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"/>
+  <title>Server Roles Management - User Guide</title>
+  <link href="../../admin/css/documentation.css" rel="stylesheet" type="text/css" media="all" />
+</head>
+
+<body style="font-family: Times New Roman,Times,serif; font-size: 12pt;">
+<h1>Server Roles Manager</h1>
+
+<h2>Introduction</h2>
+
+<p><strong>Server Roles Manager</strong> is a component to manage server roles property for
+   WSO2Carbon based products. Read more about <a href="server-roles.html">
+   <strong>Server Roles</strong></a>.</p>
+
+<p>As carbon supports adding different product features into one product instance original concept
+   of the server role property   being added into carbon.xml is hard to manage as users may have to
+   manually modify the carbon.xml to include the server-roles related to the product feature they
+   have added to a carbon product instance. As WSO2 Stratos and WSO2 Mars are introduced above
+   action is not possible for a tenant since the tenant user is remote to the server instance.</p>
+
+<p>To overcome those issues server role manager is introduced. Server role manager will store the
+   both carbon.xml default product roles and user/tenant specified server roles in Configuration
+   registry. So when a C-App is deploying in carbon the C-App deployer will check for afro-mentioned
+   server roles from the registry instead of carbon.xml.</p>
+
+<h2>How It Works</h2>
+
+<p>You can access the server roles manager UI clicking '<strong>Configure -> Server Roles</strong>'
+   or directly from <strong>https://&lt;host&gt;:&lt;port&gt;/carbon/roles-mgt/server-roles-mgt.jsp
+    </strong>.
+
+Server Roles Manager Displays all the server roles included in the current product instance in the
+landing page.
+
+<p><img alt="" src="../images/landingpage.jpg"/></p>
+<p>Figure 1: Server Roles Manager Landing page.</p>
+
+In server roles manager, server roles properties will be of two types, <strong>Default</strong> and
+<strong>Custom</strong>. Default type will be all the server roles picked from that particular
+product instance's carbon.xml and all other server roles added by the user will have type custom.
+</p>
+
+<h2>Functionality</h2>
+
+<p>Server Roles Manager has two basic functionalities,</p>
+	<ol>
+		<li>Add Server Role</li>
+		<p>You can add any textual name as a server role without special characters except
+           underscore.</p>
+		
+		<p><img alt="" src="../images/add_server_role.jpg"/></p>
+		<p>Figure 2: Add Server Role.</p>
+		
+		<p>Click the link '<strong>Add New Server Role</strong>' and a drop down menu will appear to
+           give the new role name. Just enter the preferred server role name than click
+            <strong>Add</strong>, and it will add the server role name.</p>
+		
+		<li>Remove Server Role</li>
+		<p>Simply click the <strong>garbage/delete icon</strong>
+           (<img alt="" src="../images/delete.gif"/>) at the right side of the any existing server
+           role. It will prompt a <strong>confirmation dialog</strong> and once confirmed it will
+           delete the server role.</p>
+		
+		<p><img alt="" src="../images/delete_server_role.jpg"/></p>
+		<p>Figure 2: Remove Server Role.</p>
+	
+	<p><strong>Note: </strong>Here users can even delete a default server role. Once it is deleted
+        when next time loading server role manager will not pick it up from the carbon.xml.</p>
+	</ol>
+</body>
+</html>

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/add.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/add.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/add.gif
new file mode 100644
index 0000000..4bfdd79
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/add.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/delete_server_role.jpg
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/delete_server_role.jpg b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/delete_server_role.jpg
new file mode 100644
index 0000000..3edceb5
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/delete_server_role.jpg differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/icon-expanded.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/icon-expanded.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/icon-expanded.gif
new file mode 100644
index 0000000..e9b6739
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/icon-expanded.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/server-role.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/server-role.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/server-role.gif
new file mode 100644
index 0000000..019d7b8
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/roles-mgt/images/server-role.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/samples/jms_topic_sample.xml
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/samples/jms_topic_sample.xml b/products/cloud_controller/modules/distribution/src/site/xdoc/samples/jms_topic_sample.xml
new file mode 100644
index 0000000..d58dba4
--- /dev/null
+++ b/products/cloud_controller/modules/distribution/src/site/xdoc/samples/jms_topic_sample.xml
@@ -0,0 +1,252 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+~ Copyright (c) 2009, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+~
+~ WSO2 Inc. licenses this file to you under the Apache License,
+~ Version 2.0 (the "License"); you may not use this file except
+~ in compliance with the License.
+~ You may obtain a copy of the License at
+~
+~ http://www.apache.org/licenses/LICENSE-2.0
+~
+~ Unless required by applicable law or agreed to in writing,
+~ software distributed under the License is distributed on an
+~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~ KIND, either express or implied. See the License for the
+~ specific language governing permissions and limitations
+~ under the License.
+-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+    <head>
+        <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"/>
+        <title>WSO2 MB Samples - JMS Topic Sample</title>
+        <link href="../css/mb-docs.css" rel="stylesheet"/>
+        <link href="../styles/dist-docs.css" rel="stylesheet" type="text/css"
+              media="all"/>
+    </head>
+
+    <body>
+        <p>[<a href="../docs_index.html">Documentation Index</a>]  </p>
+            <h1>WSO2 MB - Samples :JMS Topic Sample</h1>
+
+            <p>This guide demonstrates how topics can be created and used in Message
+                Broker using JMS API.
+            </p>
+
+            <h2>Contents</h2>
+
+            <div class="toc">
+                <ul>
+                    <li>
+                        <a href="#jms_queue_sample">JMS Topic Sample</a>
+                    </li>
+                </ul>
+            </div>
+
+            <h2 id="jms_queue_sample">JMS Topic Sample</h2>
+
+            <p>Following code is used to create a topic, subscribe to it and publish messages. To
+                run this code sample, you need to have dependencies located at
+                $CARBON_HOME/client-lib in class path.
+                To try out following code fragment, Run the Topic Subscriber first and then run
+                Topic Publisher code. You should see, published message in Topic subscriber console.
+
+                You can see created topics in management console as well.
+            </p>
+
+            <p>Topic Publisher: This code is used to publish messages to a given topic.</p>
+
+            <pre xml:space="preserve">
+                package com.org.wso2.mb.jms.sample;
+                /**
+                 * Copyright (c) 2009, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+                 *
+                 * Licensed under the Apache License, Version 2.0 (the "License");
+                 * you may not use this file except in compliance with the License.
+                 * You may obtain a copy of the License at
+                 *
+                 * http://www.apache.org/licenses/LICENSE-2.0
+                 *
+                 * Unless required by applicable law or agreed to in writing, software
+                 * distributed under the License is distributed on an "AS IS" BASIS,
+                 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+                 * See the License for the specific language governing permissions and
+                 * limitations under the License.
+                 */
+
+                import javax.jms.JMSException;
+                import javax.jms.QueueSession;
+                import javax.jms.TextMessage;
+                import javax.jms.Topic;
+                import javax.jms.TopicConnection;
+                import javax.jms.TopicConnectionFactory;
+                import javax.jms.TopicSession;
+                import javax.naming.Context;
+                import javax.naming.InitialContext;
+                import javax.naming.NamingException;
+                import java.util.Properties;
+
+
+                public class TopicPublisher {
+                    public static final String QPID_ICF = "org.wso2.andes.jndi.PropertiesFileInitialContextFactory";
+                    private static final String CF_NAME_PREFIX = "connectionfactory.";
+                    private static final String CF_NAME = "qpidConnectionfactory";
+                    String userName = "admin";
+                    String password = "admin";
+
+                    private static String CARBON_CLIENT_ID = "carbon";
+                    private static String CARBON_VIRTUAL_HOST_NAME = "carbon";
+                    private static String CARBON_DEFAULT_HOSTNAME = "localhost";
+                    private static String CARBON_DEFAULT_PORT = "5672";
+                    String topicName = "MYTopic";
+
+
+                    public static void main(String[] args) throws NamingException, JMSException {
+                        TopicPublisher topicPublisher = new TopicPublisher();
+                        topicPublisher.publishMessage();
+                    }
+
+                    public void publishMessage() throws NamingException, JMSException {
+                        Properties properties = new Properties();
+                        properties.put(Context.INITIAL_CONTEXT_FACTORY, QPID_ICF);
+                        properties.put(CF_NAME_PREFIX + CF_NAME, getTCPConnectionURL(userName, password));
+
+                        System.out.println("getTCPConnectionURL(userName,password) = " + getTCPConnectionURL(userName, password));
+
+                        InitialContext ctx = new InitialContext(properties);
+                        // Lookup connection factory
+                        TopicConnectionFactory connFactory = (TopicConnectionFactory) ctx.lookup(CF_NAME);
+                        TopicConnection topicConnection = connFactory.createTopicConnection();
+                        topicConnection.start();
+                        TopicSession topicSession =
+                                topicConnection.createTopicSession(false, QueueSession.AUTO_ACKNOWLEDGE);
+
+                        // Send message
+                        Topic topic = topicSession.createTopic(topicName);
+
+                        // create the message to send
+                        TextMessage textMessage = topicSession.createTextMessage("Test Message");
+
+                        javax.jms.TopicPublisher topicPublisher = topicSession.createPublisher(topic);
+                        topicPublisher.publish(textMessage);
+
+                        topicSession.close();
+                        topicConnection.close();
+                    }
+
+                    public String getTCPConnectionURL(String username, String password) {
+                        // amqp://{username}:{password}@carbon/carbon?brokerlist='tcp://{hostname}:{port}'
+                        return new StringBuffer()
+                                .append("amqp://").append(username).append(":").append(password)
+                                .append("@").append(CARBON_CLIENT_ID)
+                                .append("/").append(CARBON_VIRTUAL_HOST_NAME)
+                                .append("?brokerlist='tcp://").append(CARBON_DEFAULT_HOSTNAME).append(":").append(CARBON_DEFAULT_PORT).append("'")
+                                .toString();
+                    }
+
+                }
+
+
+            </pre>
+
+            <p>Topic Subscriber: This code is used to Subscribe for topics.
+                topicSubscriber.receive() will wait till a message is received and exit the main
+                thread.
+            </p>
+            <pre xml:space="preserve">
+                package com.org.wso2.mb.jms.sample;
+                /**
+                 * Copyright (c) 2009, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+                 *
+                 * Licensed under the Apache License, Version 2.0 (the "License");
+                 * you may not use this file except in compliance with the License.
+                 * You may obtain a copy of the License at
+                 *
+                 * http://www.apache.org/licenses/LICENSE-2.0
+                 *
+                 * Unless required by applicable law or agreed to in writing, software
+                 * distributed under the License is distributed on an "AS IS" BASIS,
+                 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+                 * See the License for the specific language governing permissions and
+                 * limitations under the License.
+                 */
+
+                import javax.jms.JMSException;
+                import javax.jms.Message;
+                import javax.jms.QueueSession;
+                import javax.jms.TextMessage;
+                import javax.jms.Topic;
+                import javax.jms.TopicConnection;
+                import javax.jms.TopicConnectionFactory;
+                import javax.jms.TopicSession;
+                import javax.naming.Context;
+                import javax.naming.InitialContext;
+                import javax.naming.NamingException;
+                import java.util.Properties;
+
+
+                public class TopicSubscriber {
+                    public static final String QPID_ICF = "org.wso2.andes.jndi.PropertiesFileInitialContextFactory";
+                    private static final String CF_NAME_PREFIX = "connectionfactory.";
+                    private static final String CF_NAME = "qpidConnectionfactory";
+                    String userName = "admin";
+                    String password = "admin";
+
+                    private static String CARBON_CLIENT_ID = "carbon";
+                    private static String CARBON_VIRTUAL_HOST_NAME = "carbon";
+                    private static String CARBON_DEFAULT_HOSTNAME = "localhost";
+                    private static String CARBON_DEFAULT_PORT = "5672";
+                    String topicName = "MYTopic";
+
+
+                    public static void main(String[] args) throws NamingException, JMSException {
+                        TopicSubscriber topicSubscriber = new TopicSubscriber();
+                        topicSubscriber.subscribe();
+                    }
+
+                    public void subscribe() throws NamingException, JMSException {
+                        Properties properties = new Properties();
+                        properties.put(Context.INITIAL_CONTEXT_FACTORY, QPID_ICF);
+                        properties.put(CF_NAME_PREFIX + CF_NAME, getTCPConnectionURL(userName, password));
+
+                        System.out.println("getTCPConnectionURL(userName,password) = " + getTCPConnectionURL(userName, password));
+
+                        InitialContext ctx = new InitialContext(properties);
+                        // Lookup connection factory
+                        TopicConnectionFactory connFactory = (TopicConnectionFactory) ctx.lookup(CF_NAME);
+                        TopicConnection topicConnection = connFactory.createTopicConnection();
+                        topicConnection.start();
+                        TopicSession topicSession =
+                                topicConnection.createTopicSession(false, QueueSession.AUTO_ACKNOWLEDGE);
+
+                        // Send message
+                        Topic topic = topicSession.createTopic(topicName);
+                        javax.jms.TopicSubscriber topicSubscriber = topicSession.createSubscriber(topic);
+                        Message message = topicSubscriber.receive();
+                        if (message instanceof TextMessage) {
+                            TextMessage textMessage = (TextMessage) message;
+                            System.out.println("textMessage.getText() = " + textMessage.getText());
+                        }
+                        topicSession.close();
+                        topicConnection.close();
+                    }
+
+                    public String getTCPConnectionURL(String username, String password) {
+                        // amqp://{username}:{password}@carbon/carbon?brokerlist='tcp://{hostname}:{port}'
+                        return new StringBuffer()
+                                .append("amqp://").append(username).append(":").append(password)
+                                .append("@").append(CARBON_CLIENT_ID)
+                                .append("/").append(CARBON_VIRTUAL_HOST_NAME)
+                                .append("?brokerlist='tcp://").append(CARBON_DEFAULT_HOSTNAME).append(":").append(CARBON_DEFAULT_PORT).append("'")
+                                .toString();
+                    }
+
+                }
+
+
+            </pre>
+        <p>Also note that a MessageListener can be set to topicSubscriber to receive messages asynchronously.</p>
+    </body>
+</html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/samples/jms_transport_sample.xml
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/samples/jms_transport_sample.xml b/products/cloud_controller/modules/distribution/src/site/xdoc/samples/jms_transport_sample.xml
new file mode 100644
index 0000000..c0fab31
--- /dev/null
+++ b/products/cloud_controller/modules/distribution/src/site/xdoc/samples/jms_transport_sample.xml
@@ -0,0 +1,371 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+~ Copyright (c) 2009, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+~
+~ WSO2 Inc. licenses this file to you under the Apache License,
+~ Version 2.0 (the "License"); you may not use this file except
+~ in compliance with the License.
+~ You may obtain a copy of the License at
+~
+~ http://www.apache.org/licenses/LICENSE-2.0
+~
+~ Unless required by applicable law or agreed to in writing,
+~ software distributed under the License is distributed on an
+~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~ KIND, either express or implied. See the License for the
+~ specific language governing permissions and limitations
+~ under the License.
+-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+    <head>
+        <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"/>
+        <title>WSO2 MB Samples - JMS Transport Sample</title>
+        <link href="../css/mb-docs.css" rel="stylesheet"/>
+        <link href="../styles/dist-docs.css" rel="stylesheet" type="text/css"
+              media="all"/>
+    </head>
+
+    <body>
+        <p>[<a href="../docs_index.html">Documentation Index</a>]  </p>
+        <h1>WSO2 MB - Samples :JMS Transport Sample</h1>
+        <p>Apache AXIS2 support a JMS transport layer in addition to the existing HTTP transport. This allows Web
+            service clients and servers to communicate via JMS queues and topics instead of HTTP connections.
+            Both one-way and synchronous two-way requests are supported.</p>
+        <p>The benefits of using JMS as an alternative to HTTP include the following:</p>
+        <ul>
+            <li>
+                Request and response messages are sent by way of reliable messaging.
+            </li>
+            <li>One-way requests allow client and server to be more loosely-coupled (the server does not have to be
+                active when the client sends the one-way request).
+            </li>
+            <li>One-way requests can be sent to multiple servers simultaneously through the use of a topic.
+            </li>
+        </ul>
+        <p>If a web service is to be accessible on the JMS transport, then the corresponding WSDL document should include
+            a JMS binding and a SOAP address which specifies a JMS endpoint URL string. A JMS binding is simply
+            a <b>wsdl:binding </b> element which contains a <b
+            >wsdlsoap:binding</b> element whose transport attribute ends in soap/jms,
+            rather than the normal soap/http value. In addition to the JMS binding, a <b>wsdl:port</b> element which references
+            the JMS binding should be included in the <b>wsdl:service</b> element within the WSDL document. This <b>wsdl:port</b> element
+            should contain a <b>wsdlsoap:address</b> element whose location attribute specifies a JMS endpoint URL string.
+        </p>
+        <p>
+            You also need to decide on the names and types of JMS objects that your application will use. For example,
+            you must decide whether your web service will receive its requests from a queue or a topic. You also must
+            decide whether to use a secure destination (queue or topic). Finally, you will need to decide on the names
+            for your destination, connection factory, and listener port.   The following list provides an example of the
+            names that might be used for the sample MessageReceiveService web service:
+        </p>
+        <table>
+            <tr>
+                <td>Queue</td>  <td>MessageReceiveService, JNDI name: MessageReceiveService</td>
+            </tr>
+            <tr>
+                <td>QueueConnectionFactory</td> <td></td>
+            </tr>
+        </table>
+        <h2>Creating A Simple Service</h2>
+        <p>Following java class with its two operations are hosted in Axis2 server as a web service</p>
+        <pre xml:space="preserve">
+            /*
+            *  Copyright (c) 2005-2010, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+            *
+            *  WSO2 Inc. licenses this file to you under the Apache License,
+            *  Version 2.0 (the "License"); you may not use this file except
+            *  in compliance with the License.
+            *  You may obtain a copy of the License at
+            *
+            *    http://www.apache.org/licenses/LICENSE-2.0
+            *
+            * Unless required by applicable law or agreed to in writing,
+            * software distributed under the License is distributed on an
+            * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+            * KIND, either express or implied.  See the License for the
+            * specific language governing permissions and limitations
+            * under the License.
+            */
+
+            public class MessageReceiveService {
+                public void receive(String message) {
+                    System.out.println("Got the message ==> " + message);
+                }
+                public String echo(String message) {
+                    System.out.println("Got the message ==> " + message);
+                    return message;
+                }
+            }
+        </pre>
+        <p>As WSDL of the service following will be used. Note how JMS bindings are defined. receive operation is an
+            "in only" operation having only input message. But echo is "in-out" operation which is having an output
+            message as well as an input message.
+        </p>
+
+        <pre xml:space="preserve">
+            &lt;wsdl:definitions xmlns:wsdl=&quot;http://schemas.xmlsoap.org/wsdl/&quot; xmlns:ns1=&quot;http://org.apache.axis2/xsd&quot; xmlns:ns=&quot;http://transport.sample.org&quot; xmlns:wsaw=&quot;http://www.w3.org/2006/05/addressing/wsdl&quot; xmlns:http=&quot;http://schemas.xmlsoap.org/wsdl/http/&quot; xmlns:xs=&quot;http://www.w3.org/2001/XMLSchema&quot; xmlns:mime=&quot;http://schemas.xmlsoap.org/wsdl/mime/&quot; xmlns:soap=&quot;http://schemas.xmlsoap.org/wsdl/soap/&quot; xmlns:soap12=&quot;http://schemas.xmlsoap.org/wsdl/soap12/&quot; targetNamespace=&quot;http://transport.sample.org&quot;&gt;
+                &lt;wsdl:types&gt;
+                    &lt;xs:schema attributeFormDefault=&quot;qualified&quot; elementFormDefault=&quot;unqualified&quot; targetNamespace=&quot;http://transport.sample.org&quot;&gt;
+                        &lt;xs:element name=&quot;receive&quot;&gt;
+                            &lt;xs:complexType&gt;
+                                &lt;xs:sequence&gt;
+                                    &lt;xs:element minOccurs=&quot;0&quot; name=&quot;message&quot; nillable=&quot;true&quot; type=&quot;xs:string&quot;/&gt;
+                                &lt;/xs:sequence&gt;
+                            &lt;/xs:complexType&gt;
+                        &lt;/xs:element&gt;
+                        &lt;xs:element name=&quot;echo&quot;&gt;
+                            &lt;xs:complexType&gt;
+                                &lt;xs:sequence&gt;
+                                    &lt;xs:element minOccurs=&quot;0&quot; name=&quot;message&quot; nillable=&quot;true&quot; type=&quot;xs:string&quot;/&gt;
+                                &lt;/xs:sequence&gt;
+                            &lt;/xs:complexType&gt;
+                        &lt;/xs:element&gt;
+                        &lt;xs:element name=&quot;echoResponse&quot;&gt;
+                            &lt;xs:complexType&gt;
+                                &lt;xs:sequence&gt;
+                                    &lt;xs:element minOccurs=&quot;0&quot; name=&quot;return&quot; nillable=&quot;true&quot; type=&quot;xs:string&quot;/&gt;
+                                &lt;/xs:sequence&gt;
+                            &lt;/xs:complexType&gt;
+                        &lt;/xs:element&gt;
+                    &lt;/xs:schema&gt;
+                &lt;/wsdl:types&gt;
+                &lt;wsdl:message name=&quot;echoRequest&quot;&gt;
+                    &lt;wsdl:part name=&quot;parameters&quot; element=&quot;ns:echo&quot;/&gt;
+                &lt;/wsdl:message&gt;
+                &lt;wsdl:message name=&quot;echoResponse&quot;&gt;
+                    &lt;wsdl:part name=&quot;parameters&quot; element=&quot;ns:echoResponse&quot;/&gt;
+                &lt;/wsdl:message&gt;
+                &lt;wsdl:message name=&quot;receiveRequest&quot;&gt;
+                    &lt;wsdl:part name=&quot;parameters&quot; element=&quot;ns:receive&quot;/&gt;
+                &lt;/wsdl:message&gt;
+                &lt;wsdl:portType name=&quot;MessageReceiveServicePortType&quot;&gt;
+                    &lt;wsdl:operation name=&quot;echo&quot;&gt;
+                        &lt;wsdl:input message=&quot;ns:echoRequest&quot; wsaw:Action=&quot;urn:echo&quot;/&gt;
+                        &lt;wsdl:output message=&quot;ns:echoResponse&quot; wsaw:Action=&quot;urn:echoResponse&quot;/&gt;
+                    &lt;/wsdl:operation&gt;
+                    &lt;wsdl:operation name=&quot;receive&quot;&gt;
+                        &lt;wsdl:input message=&quot;ns:receiveRequest&quot; wsaw:Action=&quot;urn:receive&quot;/&gt;
+                    &lt;/wsdl:operation&gt;
+                &lt;/wsdl:portType&gt;
+                &lt;wsdl:binding name=&quot;MessageReceiveServiceSoap11Binding&quot; type=&quot;ns:MessageReceiveServicePortType&quot;&gt;
+                    &lt;soap:binding transport=&quot;http://schemas.xmlsoap.org/soap/http&quot; style=&quot;document&quot;/&gt;
+                    &lt;wsdl:operation name=&quot;echo&quot;&gt;
+                        &lt;soap:operation soapAction=&quot;urn:echo&quot; style=&quot;document&quot;/&gt;
+                        &lt;wsdl:input&gt;
+                            &lt;soap:body use=&quot;literal&quot;/&gt;
+                        &lt;/wsdl:input&gt;
+                        &lt;wsdl:output&gt;
+                            &lt;soap:body use=&quot;literal&quot;/&gt;
+                        &lt;/wsdl:output&gt;
+                    &lt;/wsdl:operation&gt;
+                    &lt;wsdl:operation name=&quot;receive&quot;&gt;
+                        &lt;soap:operation soapAction=&quot;urn:receive&quot; style=&quot;document&quot;/&gt;
+                        &lt;wsdl:input&gt;
+                            &lt;soap:body use=&quot;literal&quot;/&gt;
+                        &lt;/wsdl:input&gt;
+                    &lt;/wsdl:operation&gt;
+                &lt;/wsdl:binding&gt;
+                &lt;wsdl:binding name=&quot;MessageReceiveServiceSoap12Binding&quot; type=&quot;ns:MessageReceiveServicePortType&quot;&gt;
+                    &lt;soap12:binding transport=&quot;http://schemas.xmlsoap.org/soap/http&quot; style=&quot;document&quot;/&gt;
+                    &lt;wsdl:operation name=&quot;echo&quot;&gt;
+                        &lt;soap12:operation soapAction=&quot;urn:echo&quot; style=&quot;document&quot;/&gt;
+                        &lt;wsdl:input&gt;
+                            &lt;soap12:body use=&quot;literal&quot;/&gt;
+                        &lt;/wsdl:input&gt;
+                        &lt;wsdl:output&gt;
+                            &lt;soap12:body use=&quot;literal&quot;/&gt;
+                        &lt;/wsdl:output&gt;
+                    &lt;/wsdl:operation&gt;
+                    &lt;wsdl:operation name=&quot;receive&quot;&gt;
+                        &lt;soap12:operation soapAction=&quot;urn:receive&quot; style=&quot;document&quot;/&gt;
+                        &lt;wsdl:input&gt;
+                            &lt;soap12:body use=&quot;literal&quot;/&gt;
+                        &lt;/wsdl:input&gt;
+                    &lt;/wsdl:operation&gt;
+                &lt;/wsdl:binding&gt;
+                &lt;wsdl:service name=&quot;MessageReceiveService&quot;&gt;
+                    &lt;wsdl:port name=&quot;MessageReceiveServiceJmsSoap11Endpoint&quot; binding=&quot;ns:MessageReceiveServiceSoap11Binding&quot;&gt;
+                        &lt;soap:address location=&quot;jms:/MessageReceiveService?transport.jms.DestinationType=queue&amp;amp;transport.jms.ContentTypeProperty=Content-Type&amp;amp;java.naming.provider.url=conf/jndi.properties&amp;amp;java.naming.factory.initial=org.wso2.andes.jndi.PropertiesFileInitialContextFactory&amp;amp;transport.jms.ConnectionFactoryType=queue&amp;amp;transport.jms.ConnectionFactoryJNDIName=QueueConnectionFactory&quot;/&gt;
+                    &lt;/wsdl:port&gt;
+                    &lt;wsdl:port name=&quot;MessageReceiveServiceJmsSoap12Endpoint&quot; binding=&quot;ns:MessageReceiveServiceSoap12Binding&quot;&gt;
+                        &lt;soap12:address location=&quot;jms:/MessageReceiveService?transport.jms.DestinationType=queue&amp;amp;transport.jms.ContentTypeProperty=Content-Type&amp;amp;java.naming.provider.url=conf/jndi.properties&amp;amp;java.naming.factory.initial=org.wso2.andes.jndi.PropertiesFileInitialContextFactory&amp;amp;transport.jms.ConnectionFactoryType=queue&amp;amp;transport.jms.ConnectionFactoryJNDIName=QueueConnectionFactory&quot;/&gt;
+                    &lt;/wsdl:port&gt;
+                &lt;/wsdl:service&gt;
+            &lt;/wsdl:definitions&gt;
+        </pre>
+
+         <h2>Axi2 Configurations</h2>
+        <p>axi2.xml file, which configures the axis2 server on which above service is hosted, should be enabled with JMS
+            transport.</p>
+        <pre xml:space="preserve">
+            &lt;transportReceiver name=&quot;jms&quot; class=&quot;org.apache.axis2.transport.jms.JMSListener&quot;&gt;
+                &lt;parameter name=&quot;default&quot; locked=&quot;false&quot;&gt;
+                &lt;parameter name=&quot;java.naming.factory.initial&quot; locked=&quot;false&quot;&gt;org.wso2.andes.jndi.PropertiesFileInitialContextFactory&lt;/parameter&gt;
+                &lt;parameter name=&quot;java.naming.provider.url&quot; locked=&quot;false&quot;&gt;conf/jndi.properties&lt;/parameter&gt;
+                &lt;parameter name=&quot;transport.jms.ConnectionFactoryJNDIName&quot; locked=&quot;false&quot;&gt;QueueConnectionFactory&lt;/parameter&gt;
+                &lt;parameter name=&quot;transport.jms.ConnectionFactoryType&quot; locked=&quot;false&quot;&gt;queue&lt;/parameter&gt;
+                &lt;/parameter&gt;
+            &lt;/transportReceiver&gt;
+        </pre>
+        <br></br>
+        <pre xml:space="preserve">
+            <transportSender name="jms" class="org.apache.axis2.transport.jms.JMSSender"/>
+        </pre>
+
+        <h2>Message Broker Bindings</h2>
+        <p>conf/jndi.properties file is having all JMS bindings (Queue/QueueConnectionFactory) mentioned above.</p>
+
+        <pre xml:space="preserve">
+
+            connectionfactory.QueueConnectionFactory=amqp://admin:admin@clientid/carbon?brokerlist='tcp://localhost:5672'
+            queue.MessageReceiveService=MessageReceiveService
+        </pre>
+        <p>Note that WSO2 Message Broker should be running at localhost port 5672 as per this sample.</p>
+        <h2>Start Axis2 Server</h2>
+        <p>Axis2 server is started with above configurations, hosting the above MessageReceiveService service.</p>
+        <pre xml:space="preserve">
+
+            private AxisServer axisServer;
+            public void start(){
+            try {
+                ConfigurationContext configurationContext =
+                ConfigurationContextFactory.createConfigurationContextFromFileSystem(null,"conf/axis2.xml");
+                this.axisServer = new AxisServer();
+                this.axisServer.setConfigurationContext(configurationContext);
+                this.axisServer.deployService(MessageReceiveService.class.getName());
+                try {
+                Thread.sleep(2000);
+                } catch (InterruptedException e) {
+                }
+                } catch (AxisFault axisFault) {
+                axisFault.printStackTrace();
+            } catch (Exception e) {
+                e.printStackTrace();
+            }
+            }
+        </pre>
+
+        <h2>Send A Message To MessageReceiveService Service</h2>
+        <p>Now using axis2_client.xml as the config file a ConfigurationContext can be created and a message can be sent
+            to the service. Note that fist "in-only" message is sent and then "in-out" message is sent. Client stub is
+            generated from the above WSDL using WSDL-To-Java tool (when complied using build.xml at &amp; MB_HOME &amp;
+            /Samples/jmstransport using ant this will be done).
+        </p>
+        <p>Using WSO2 MB management console you can see how  MessageReceiveService queue is created. See Message Broker
+            Queues - User Guide for more information.</p>
+        <pre xml:space="preserve">
+
+            public void sendMessage(){
+            try {
+
+            ConfigurationContext configurationContext =
+            ConfigurationContextFactory.createConfigurationContextFromFileSystem(null, "conf/axis2_client.xml");
+            MessageReceiveServiceStub stub = new MessageReceiveServiceStub(configurationContext,"http://localhost:8080/axis2/services/MessageReceiveService.MessageReceiveServiceHttpSoap11Endpoint/");
+            //first send the in only message
+            stub.receive("Test message to receive ");
+            // inout message
+            String response = stub.echo("Test message to echo");
+            System.out.println("Response ==> " + response);
+
+            try {
+            Thread.sleep(10000);
+            } catch (InterruptedException e) {
+            e.printStackTrace();
+            }
+            } catch (AxisFault axisFault) {
+            axisFault.printStackTrace();
+            } catch (java.rmi.RemoteException e) {
+            e.printStackTrace();
+            }
+            }
+        </pre>
+        <p>
+            The complete sample code demonstrating the scenario will be as follows.
+        </p>
+        <pre xml:space="preserve">
+            /*
+*  Copyright (c) 2005-2010, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+*
+*  WSO2 Inc. licenses this file to you under the Apache License,
+*  Version 2.0 (the "License"); you may not use this file except
+*  in compliance with the License.
+*  You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing,
+* software distributed under the License is distributed on an
+* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+* KIND, either express or implied.  See the License for the
+* specific language governing permissions and limitations
+* under the License.
+*/
+
+import org.apache.axis2.AxisFault;
+import org.apache.axis2.context.ConfigurationContext;
+import org.apache.axis2.context.ConfigurationContextFactory;
+import org.apache.axis2.engine.AxisServer;
+import org.sample.transport.stub.MessageReceiveServiceStub;
+
+public class JMSTransportClient {
+        private AxisServer axisServer;
+        public void start(){
+            try {
+                ConfigurationContext configurationContext =
+                        ConfigurationContextFactory.createConfigurationContextFromFileSystem(null,"conf/axis2.xml");
+                this.axisServer = new AxisServer();
+                this.axisServer.setConfigurationContext(configurationContext);
+                this.axisServer.deployService(MessageReceiveService.class.getName());
+                try {
+                    Thread.sleep(2000);
+                } catch (InterruptedException e) {
+                }
+            } catch (AxisFault axisFault) {
+                axisFault.printStackTrace();
+            } catch (Exception e) {
+                e.printStackTrace();
+            }
+        }
+        public void stop(){
+            try {
+                this.axisServer.stop();
+            } catch (AxisFault axisFault) {
+                axisFault.printStackTrace();
+            }
+        }
+        public void sendMessage(){
+            try {
+
+                ConfigurationContext configurationContext =
+                        ConfigurationContextFactory.createConfigurationContextFromFileSystem(null, "conf/axis2_client.xml");
+                MessageReceiveServiceStub stub = new                    MessageReceiveServiceStub(configurationContext,"http://localhost:8080/axis2/services/MessageReceiveService.MessageReceiveServiceHttpSoap11Endpoint/");
+                //first send the in only message
+                stub.receive("Test message to receive ");
+                // inout message
+                String response = stub.echo("Test message to echo");
+                System.out.println("Response ==> " + response);
+
+                try {
+                    Thread.sleep(10000);
+                } catch (InterruptedException e) {
+                    e.printStackTrace();
+                }
+            } catch (AxisFault axisFault) {
+                axisFault.printStackTrace();
+            } catch (java.rmi.RemoteException e) {
+                e.printStackTrace();
+            }
+        }
+        public static void main(String[] args) {
+
+            JMSTransportClient jmsTransportClient = new JMSTransportClient();
+            jmsTransportClient.start();
+            jmsTransportClient.sendMessage();
+            jmsTransportClient.stop();
+        }
+
+    }
+        </pre>
+    </body>
+</html>

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/samples/web_service_client_sample.xml
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/samples/web_service_client_sample.xml b/products/cloud_controller/modules/distribution/src/site/xdoc/samples/web_service_client_sample.xml
new file mode 100644
index 0000000..33c563e
--- /dev/null
+++ b/products/cloud_controller/modules/distribution/src/site/xdoc/samples/web_service_client_sample.xml
@@ -0,0 +1,232 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+~ Copyright (c) 2009, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+~
+~ WSO2 Inc. licenses this file to you under the Apache License,
+~ Version 2.0 (the "License"); you may not use this file except
+~ in compliance with the License.
+~ You may obtain a copy of the License at
+~
+~ http://www.apache.org/licenses/LICENSE-2.0
+~
+~ Unless required by applicable law or agreed to in writing,
+~ software distributed under the License is distributed on an
+~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~ KIND, either express or implied. See the License for the
+~ specific language governing permissions and limitations
+~ under the License.
+-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+    <head>
+        <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"/>
+        <title>WSO2 MB Samples - Web Service Client Sample</title>
+        <link href="../css/mb-docs.css" rel="stylesheet"/>
+        <link href="../styles/dist-docs.css" rel="stylesheet" type="text/css"
+              media="all"/>
+    </head>
+    <body>
+        <p>[<a href="../docs_index.html">Documentation Index</a>]  </p>
+        <h1>Web Service Client Sample</h1>
+        <p> <a href="http://www.w3.org/Submission/WS-Eventing/">Web Service Eventing Specification </a>  defines how Web
+            Services Eventing supports the simplest levels of Web
+            services interfaces for notification producers and consumers for a distributed event management system. It
+            is a baseline set of operations that allow Web services to provide asynchronous notifications to interested
+            parties. WS-Eventing defines the simplest level of Web services interfaces for notification producers and
+            notification consumers including standard message exchanges to be implemented by service providers that wish
+            to act in these roles, along with operational requirements expected of them. It has a set of functions
+            supporting publish/subscribe required by robust, scalable enterprise applications including message brokering
+            and topic based subscription management.</p>
+        <p>WSO2 MB 2.0.1 supports WS-eventing. This sample shows you how to register a Web Service as an event receiver
+            and subscribe it to the message brokering server, together with how to publish messages to that subscription
+            you have made.</p>
+        <h2>Defining Web Service</h2>
+        <pre xml:space="preserve">
+
+            /*
+            *  Copyright (c) 2005-2010, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+            *
+            *  WSO2 Inc. licenses this file to you under the Apache License,
+            *  Version 2.0 (the "License"); you may not use this file except
+            *  in compliance with the License.
+            *  You may obtain a copy of the License at
+            *
+            *    http://www.apache.org/licenses/LICENSE-2.0
+            *
+            * Unless required by applicable law or agreed to in writing,
+            * software distributed under the License is distributed on an
+            * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+            * KIND, either express or implied.  See the License for the
+            * specific language governing permissions and limitations
+            * under the License.
+            */
+
+
+            public class EventSinkService {
+                public void receive(String message){
+                    System.out.println("Got  the message ==> " + message);
+                }
+            }
+        </pre>
+        <h2>Host The Service And Start A Broker Client With Service URL</h2>
+        <p>Then this service has to be hosted in a server, and a broker client should be defined with that service url.</p>
+        <pre xml:space="preserve">
+
+            private AxisServer axisServer;
+            private BrokerClient brokerClient;
+            public void start() {
+                try {
+                    System.setProperty("javax.net.ssl.trustStore", "../../repository/resources/security/wso2carbon.jks");
+                    System.setProperty("javax.net.ssl.trustStorePassword", "wso2carbon");
+                    this.axisServer = new AxisServer();
+                    this.axisServer.deployService(EventSinkService.class.getName());
+                    this.brokerClient = new BrokerClient("https://localhost:9443/services/EventBrokerService", "admin", "admin");
+                    // give time to start the simple http server
+                    try {
+                    Thread.sleep(2000);
+                    } catch (InterruptedException e) {
+                    }
+                } catch (AxisFault axisFault) {
+                    System.out.println("Can not start the server");
+                } catch (AuthenticationExceptionException e) {
+                    e.printStackTrace();
+                }
+            }
+        </pre>
+        <h2>Subscribe The Service To Receive Events</h2>
+        <p>Now we have to subscribe the above service to the broker to receive events. For that we use a "topic". Broker
+            client implementation allows you to subscribe a service to a topic in Message Broker. Here a topic named
+            "foo/bar" is used.</p>
+        <pre xml:space="preserve">
+
+            public String subscribe() {
+                // set the properties for ssl
+                try {
+                    return this.brokerClient.subscribe("foo/bar" , "http://localhost:6060/axis2/services/EventSinkService/receive");
+                } catch (BrokerClientException e) {
+                    e.printStackTrace();
+                }
+                return null;
+            }
+        </pre>
+        <h2>Publish Messages </h2>
+        <p>When messages or events are published to the topic in message broker, it will be received by the web service.</p>
+        <pre xml:space="preserve">
+
+            public void publish(){
+                try {
+                    this.brokerClient.publish("foo/bar", getOMElementToSend());
+                } catch (AxisFault axisFault) {
+                    axisFault.printStackTrace();
+                }
+            }
+        </pre>
+        <p>As the service only doing flusing the message to the console, you should see the message getting printed in the console.</p>
+        <p>The full sample code will be like following.</p>
+        <pre xml:space="preserve">
+
+/*
+*  Copyright (c) 2005-2010, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+*
+*  WSO2 Inc. licenses this file to you under the Apache License,
+*  Version 2.0 (the "License"); you may not use this file except
+*  in compliance with the License.
+*  You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing,
+* software distributed under the License is distributed on an
+* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+* KIND, either express or implied.  See the License for the
+* specific language governing permissions and limitations
+* under the License.
+*/
+
+import org.apache.axiom.om.OMAbstractFactory;
+import org.apache.axiom.om.OMElement;
+import org.apache.axiom.om.OMFactory;
+import org.apache.axiom.om.OMNamespace;
+import org.apache.axis2.AxisFault;
+import org.apache.axis2.engine.AxisServer;
+import org.wso2.carbon.event.client.broker.BrokerClient;
+import org.wso2.carbon.event.client.broker.BrokerClientException;
+import org.wso2.carbon.event.client.stub.generated.authentication.AuthenticationExceptionException;
+import java.rmi.RemoteException;
+            public class PubSubClient {
+                private AxisServer axisServer;
+                private BrokerClient brokerClient;
+                public void start() {
+                    try {
+                        System.setProperty("javax.net.ssl.trustStore", "../../repository/resources/security/wso2carbon.jks");
+                        System.setProperty("javax.net.ssl.trustStorePassword", "wso2carbon");
+                        this.axisServer = new AxisServer();
+                        this.axisServer.deployService(EventSinkService.class.getName());
+                        this.brokerClient = new BrokerClient("https://localhost:9443/services/EventBrokerService", "admin", "admin");
+                        // give time to start the simple http server
+                        try {
+                            Thread.sleep(2000);
+                        } catch (InterruptedException e) {
+                        }
+                    } catch (AxisFault axisFault) {
+                        System.out.println("Can not start the server");
+                    } catch (AuthenticationExceptionException e) {
+                        e.printStackTrace();
+                    }
+                }
+                public String subscribe() {
+                    // set the properties for ssl
+                    try {
+                        return this.brokerClient.subscribe("foo/bar" , "http://localhost:6060/axis2/services/EventSinkService/receive");
+                    } catch (BrokerClientException e) {
+                        e.printStackTrace();
+                    }
+                    return null;
+                }
+                public void publish(){
+                    try {
+                        this.brokerClient.publish("foo/bar", getOMElementToSend());
+                    } catch (AxisFault axisFault) {
+                        axisFault.printStackTrace();
+                    }
+                }
+                public void unsubscribe(String subscriptionID){
+                    try {
+                        this.brokerClient.unsubscribe(subscriptionID);
+                    } catch (RemoteException e) {
+                        e.printStackTrace();
+                    }
+                }
+                public void stop(){
+                    try {
+                        this.axisServer.stop();
+                    } catch (AxisFault axisFault) {
+                        axisFault.printStackTrace();
+                    }
+                }
+                public static void main(String[] args) {
+                    PubSubClient pubSubClient = new PubSubClient();
+                    pubSubClient.start();
+                    String subscriptionId = pubSubClient.subscribe();
+                    pubSubClient.publish();
+                    try {
+                        Thread.sleep(5000);
+                    } catch (InterruptedException e) {}
+                    pubSubClient.unsubscribe(subscriptionId);
+                    pubSubClient.stop();
+                }
+                private OMElement getOMElementToSend() {
+                    OMFactory omFactory = OMAbstractFactory.getOMFactory();
+                    OMNamespace omNamespace = omFactory.createOMNamespace("http://ws.sample.org", "ns1");
+                    OMElement receiveElement = omFactory.createOMElement("receive", omNamespace);
+                    OMElement messageElement = omFactory.createOMElement("message", omNamespace);
+                    messageElement.setText("Test publish message");
+                    receiveElement.addChild(messageElement);
+                    return receiveElement;
+                }
+}
+        </pre>
+        <p>Note: As you might have already comprehended WSO2 MB should be running when running the sample.</p>
+    </body>
+</html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/docs/images/reporting_crumb.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/docs/images/reporting_crumb.png b/products/cloud_controller/modules/distribution/src/site/xdoc/search/docs/images/reporting_crumb.png
new file mode 100644
index 0000000..a41f431
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/docs/images/reporting_crumb.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/docs/images/save_filter.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/docs/images/save_filter.png b/products/cloud_controller/modules/distribution/src/site/xdoc/search/docs/images/save_filter.png
new file mode 100644
index 0000000..8df8da2
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/docs/images/save_filter.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/icon-expanded.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/icon-expanded.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/icon-expanded.gif
new file mode 100644
index 0000000..e9b6739
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/icon-expanded.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r00.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r00.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r00.gif
new file mode 100644
index 0000000..0723853
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r00.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r01.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r01.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r01.gif
new file mode 100644
index 0000000..9c7b922
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r01.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r04.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r04.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r04.gif
new file mode 100644
index 0000000..02d1276
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r04.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r44.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r44.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r44.gif
new file mode 100644
index 0000000..02d1276
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/r44.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search-content.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search-content.png b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search-content.png
new file mode 100644
index 0000000..ae951e8
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search-content.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search-top.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search-top.png b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search-top.png
new file mode 100644
index 0000000..c288eaf
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search-top.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search.gif
new file mode 100644
index 0000000..86f81ed
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/search/images/search.gif differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/docs/images/activate_security_key_stores.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/docs/images/activate_security_key_stores.png b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/docs/images/activate_security_key_stores.png
new file mode 100644
index 0000000..f85b4b2
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/docs/images/activate_security_key_stores.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/docs/images/activate_security_user_groups.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/docs/images/activate_security_user_groups.png b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/docs/images/activate_security_user_groups.png
new file mode 100644
index 0000000..5148022
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/docs/images/activate_security_user_groups.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario10.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario10.png b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario10.png
new file mode 100644
index 0000000..f5d5327
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario10.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario14.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario14.png b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario14.png
new file mode 100644
index 0000000..3cb7ea6
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario14.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario3.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario3.png b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario3.png
new file mode 100644
index 0000000..2c156a2
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario3.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario6.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario6.png b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario6.png
new file mode 100644
index 0000000..6dc2b62
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario6.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario8.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario8.png b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario8.png
new file mode 100644
index 0000000..e2accbd
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario8.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario9.png
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario9.png b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario9.png
new file mode 100644
index 0000000..c58d683
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/securityconfig/images/scenario9.png differ

http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/6fdeacea/products/cloud_controller/modules/distribution/src/site/xdoc/server-admin/docs/images/server-admin.gif
----------------------------------------------------------------------
diff --git a/products/cloud_controller/modules/distribution/src/site/xdoc/server-admin/docs/images/server-admin.gif b/products/cloud_controller/modules/distribution/src/site/xdoc/server-admin/docs/images/server-admin.gif
new file mode 100644
index 0000000..4dea3d3
Binary files /dev/null and b/products/cloud_controller/modules/distribution/src/site/xdoc/server-admin/docs/images/server-admin.gif differ