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://<host>:<port>/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">
+ <wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http://org.apache.axis2/xsd" xmlns:ns="http://transport.sample.org" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" targetNamespace="http://transport.sample.org">
+ <wsdl:types>
+ <xs:schema attributeFormDefault="qualified" elementFormDefault="unqualified" targetNamespace="http://transport.sample.org">
+ <xs:element name="receive">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element minOccurs="0" name="message" nillable="true" type="xs:string"/>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="echo">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element minOccurs="0" name="message" nillable="true" type="xs:string"/>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="echoResponse">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element minOccurs="0" name="return" nillable="true" type="xs:string"/>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ </xs:schema>
+ </wsdl:types>
+ <wsdl:message name="echoRequest">
+ <wsdl:part name="parameters" element="ns:echo"/>
+ </wsdl:message>
+ <wsdl:message name="echoResponse">
+ <wsdl:part name="parameters" element="ns:echoResponse"/>
+ </wsdl:message>
+ <wsdl:message name="receiveRequest">
+ <wsdl:part name="parameters" element="ns:receive"/>
+ </wsdl:message>
+ <wsdl:portType name="MessageReceiveServicePortType">
+ <wsdl:operation name="echo">
+ <wsdl:input message="ns:echoRequest" wsaw:Action="urn:echo"/>
+ <wsdl:output message="ns:echoResponse" wsaw:Action="urn:echoResponse"/>
+ </wsdl:operation>
+ <wsdl:operation name="receive">
+ <wsdl:input message="ns:receiveRequest" wsaw:Action="urn:receive"/>
+ </wsdl:operation>
+ </wsdl:portType>
+ <wsdl:binding name="MessageReceiveServiceSoap11Binding" type="ns:MessageReceiveServicePortType">
+ <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
+ <wsdl:operation name="echo">
+ <soap:operation soapAction="urn:echo" style="document"/>
+ <wsdl:input>
+ <soap:body use="literal"/>
+ </wsdl:input>
+ <wsdl:output>
+ <soap:body use="literal"/>
+ </wsdl:output>
+ </wsdl:operation>
+ <wsdl:operation name="receive">
+ <soap:operation soapAction="urn:receive" style="document"/>
+ <wsdl:input>
+ <soap:body use="literal"/>
+ </wsdl:input>
+ </wsdl:operation>
+ </wsdl:binding>
+ <wsdl:binding name="MessageReceiveServiceSoap12Binding" type="ns:MessageReceiveServicePortType">
+ <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
+ <wsdl:operation name="echo">
+ <soap12:operation soapAction="urn:echo" style="document"/>
+ <wsdl:input>
+ <soap12:body use="literal"/>
+ </wsdl:input>
+ <wsdl:output>
+ <soap12:body use="literal"/>
+ </wsdl:output>
+ </wsdl:operation>
+ <wsdl:operation name="receive">
+ <soap12:operation soapAction="urn:receive" style="document"/>
+ <wsdl:input>
+ <soap12:body use="literal"/>
+ </wsdl:input>
+ </wsdl:operation>
+ </wsdl:binding>
+ <wsdl:service name="MessageReceiveService">
+ <wsdl:port name="MessageReceiveServiceJmsSoap11Endpoint" binding="ns:MessageReceiveServiceSoap11Binding">
+ <soap:address location="jms:/MessageReceiveService?transport.jms.DestinationType=queue&amp;transport.jms.ContentTypeProperty=Content-Type&amp;java.naming.provider.url=conf/jndi.properties&amp;java.naming.factory.initial=org.wso2.andes.jndi.PropertiesFileInitialContextFactory&amp;transport.jms.ConnectionFactoryType=queue&amp;transport.jms.ConnectionFactoryJNDIName=QueueConnectionFactory"/>
+ </wsdl:port>
+ <wsdl:port name="MessageReceiveServiceJmsSoap12Endpoint" binding="ns:MessageReceiveServiceSoap12Binding">
+ <soap12:address location="jms:/MessageReceiveService?transport.jms.DestinationType=queue&amp;transport.jms.ContentTypeProperty=Content-Type&amp;java.naming.provider.url=conf/jndi.properties&amp;java.naming.factory.initial=org.wso2.andes.jndi.PropertiesFileInitialContextFactory&amp;transport.jms.ConnectionFactoryType=queue&amp;transport.jms.ConnectionFactoryJNDIName=QueueConnectionFactory"/>
+ </wsdl:port>
+ </wsdl:service>
+ </wsdl:definitions>
+ </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">
+ <transportReceiver name="jms" class="org.apache.axis2.transport.jms.JMSListener">
+ <parameter name="default" locked="false">
+ <parameter name="java.naming.factory.initial" locked="false">org.wso2.andes.jndi.PropertiesFileInitialContextFactory</parameter>
+ <parameter name="java.naming.provider.url" locked="false">conf/jndi.properties</parameter>
+ <parameter name="transport.jms.ConnectionFactoryJNDIName" locked="false">QueueConnectionFactory</parameter>
+ <parameter name="transport.jms.ConnectionFactoryType" locked="false">queue</parameter>
+ </parameter>
+ </transportReceiver>
+ </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 & MB_HOME &
+ /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