ace-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r804282 - in /websites/staging/ace/trunk/content/user-doc: ./ getting-started.html introduction.html
Date Wed, 08 Feb 2012 22:52:14 GMT
Author: buildbot
Date: Wed Feb  8 22:52:14 2012
New Revision: 804282

Log:
Staging update by buildbot for ace

Added:
    websites/staging/ace/trunk/content/user-doc/
    websites/staging/ace/trunk/content/user-doc/getting-started.html
    websites/staging/ace/trunk/content/user-doc/introduction.html

Added: websites/staging/ace/trunk/content/user-doc/getting-started.html
==============================================================================
--- websites/staging/ace/trunk/content/user-doc/getting-started.html (added)
+++ websites/staging/ace/trunk/content/user-doc/getting-started.html Wed Feb  8 22:52:14 2012
@@ -0,0 +1,181 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+  <head>
+    <title>Getting Started</title>
+
+    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+    <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+    <link rel="stylesheet/less" type="text/css" href="/lib/bootstrap.less">
+    <link href="/css/prettify.css" rel="stylesheet">
+    <script src="/js/less-1.2.1.min.js" type="text/javascript"></script>
+    <script src="http://code.jquery.com/jquery-1.7.min.js"></script>
+    <script src="/js/prettify.js"></script>
+    
+    <script src="/js/bootstrap-alert.js"></script>
+    <script src="/js/bootstrap-dropdown.js"></script>
+    <script src="/js/bootstrap-tooltip.js"></script>
+    <script src="/js/bootstrap-alerts.js"></script>
+    <script src="/js/bootstrap-modal.js"></script>
+    <script src="/js/bootstrap-transition.js"></script>
+    <script src="/js/bootstrap-button.js"></script>
+    <script src="/js/bootstrap-popover.js"></script>
+    <script src="/js/bootstrap-twipsy.js"></script>
+    <script src="/js/bootstrap-buttons.js"></script>
+    <script src="/js/bootstrap-scrollspy.js"></script>
+    <script src="/js/bootstrap-typeahead.js"></script>
+    <script src="/js/bootstrap-carousel.js"></script>
+    <script src="/js/bootstrap-tab.js"></script>
+    <script src="/js/bootstrap-collapse.js"></script>
+    <script src="/js/bootstrap-tabs.js"></script>
+    
+    
+    
+    <script>
+    $(function () { prettyPrint() })
+    $().dropdown()
+    </script>
+  </head>
+
+  <body style="padding-top: 50px;">
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/index.html">Apache ACE</a>
+          <ul class="nav">
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">News <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/news.html">News</a>
+      </li>
+      <li>
+        <a href="/on-the-web.html">On the web</a>
+      </li>
+    </ul>
+  </li>
+  <li>
+    <a href="/downloads.html">Downloads</a>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">User Documentation <b
class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/user-doc/introduction.html">Introduction</a>
+      </li>
+      <li>
+        <a href="/user-doc/getting-started.html">Getting Started</a>
+      </li>
+      <li>
+        <a href="/user-doc/features.html">Features</a>
+      </li>
+      <li>
+        <a href="/user-doc/faq.html">FAQ</a>
+      </li>
+      <li>
+        <a href="/user-doc/support.html">Support</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Developer Documentation
<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/dev-doc/architecture.html">Architecture</a>
+      </li>
+      <li>
+        <a href="/dev-doc/analysis.html">Analysis</a>
+      </li>
+      <li>
+        <a href="/dev-doc/design.html">Design</a>
+      </li>
+      <li>
+        <a href="/dev-doc/coding-standards.html">Coding Standards</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Involved <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/get-involved/mailing-lists.html">Mailing Lists</a>
+      </li>
+      <li>
+        <a href="/get-involved/issue-tracking.html">Issue Tracking</a>
+      </li>
+      <li>
+        <a href="/get-involved/source-code.html">Source Code</a>
+      </li>
+      <li>
+        <a href="/get-involved/project-team.html">Project Team</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Wiki <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/wiki/board-reports.html">Board Reports</a>
+      </li>
+      <li>
+        <a href="/wiki/drafts.html">Drafts</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/apache/about.html">About</a>
+      </li>
+      <li>
+        <a href="/apache/license.html">License</a>
+      </li>
+      <li>
+        <a href="/apache/security.html">Security</a>
+      </li>
+      <li>
+        <a href="/apache/sponsorship.html">Sponsorship</a>
+      </li>
+      <li>
+        <a href="/apache/thanks.html">Thanks</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+
+        </div>
+      </div>
+    </div>
+    <div class="container">
+      <p><a href="/"><i class='icon-home'></i> Home</a>&nbsp;&raquo&nbsp;<a
href="/user-doc/">User-doc</a></p>
+      <h1>Getting Started</h1>
+      <div class="clear"></div>
+      <div id="content"><p>This guide shows the core functionality of ACE, organizing
bundles and other artifacts into logical features and distributions and associating those
with specific targets, all done using a convenient web interface.</p>
+<h2 id="using-apache-ace">Using Apache ACE</h2>
+<p>The following steps can be followed to get started:</p>
+<ol>
+<li>First we need to actually checkout and [build ACE|Maven Build]. Follow the link
to get more information on how to do that.</li>
+<li>Once ACE is built, we can start the server with integrated Web UI. Go to {{ace-target-devserver/target/org.apache.ace.target.devserver-*-distribution/ace-devserver}}.
Start it using the <code>run.sh</code> or <code>run.bat</code> file.</li>
+<li>Now the server is started, let's connect to it. Launch a browser and point it to:
http://localhost:8080/ace/ You should now be greeted with a login prompt. Log in with user
"d" password "f" and you should see a view with 4 empty columns and some buttons at the top
of the screen.</li>
+<li>Click on 'Retrieve' to get the initial version of the repository. It will look
as if nothing's happened, but you have now in fact retrieved the first, empty version of the
repository and can start manipulating it. Once you're happy with it, you can commit it back
(which we'll do a bit later).</li>
+<li>Upload some sample bundles into the artifacts column by first clicking the 'Add
Artifact...' button. In the dialog that appears, you can upload a bundle using the 'Upload'
button in the middle of the window. You can perform this step multiple times if you want to
upload more than one bundle. Finally, hit the 'Add' button to add all uploaded artifacts to
ACE.</li>
+<li>Create a feature by clicking on the 'Add Feature...' button. Features are the first
level of logical grouping for artifacts.</li>
+<li>Create a distribution by clicking on the 'Add Distribution...' button. Distributions
are another level of logical grouping: you group features into distributions.</li>
+<li>Drag an artifact onto a feature to create an association between the two. By repeating
this process you can associate all relevant artifacts to features.</li>
+<li>Drag a feature onto a distribution and again repeat this process until you've associated
all your features with their relevant distributions.</li>
+<li>Now we need a target to actually deploy our artifacts to. To start a target, go
to <code>ace-launcher/target</code> and start it using <code>java -jar org.apache.ace.launcher*.jar</code>.</li>
+<li>After a few seconds, the target should show up in the Web UI. To associate it with
a distribution, drag that distribution onto the target.</li>
+<li>Click on 'Store' to actually store changes on the server, which should trigger
the actual deployment of the artifacts to the target.</li>
+</ol>
+<h2 id="debugging">Debugging</h2>
+<p>You can hook up a standard remote debugger to either target. To do that, edit the
run.sh (or run.bat) script and include the following extra parameter for Pax Runner:</p>
+<p><code>--vmOptions="-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=y"</code></p>
+<p>Now run the target, and start the debugger of your favorite IDE.</p></div>
+      <hr>
+      <footer>
+        <p>Copyright &#169; 2012 The Apache Software Foundation, Licensed under
the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache
and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+      </footer>
+    </div>
+  </body>
+</html>

Added: websites/staging/ace/trunk/content/user-doc/introduction.html
==============================================================================
--- websites/staging/ace/trunk/content/user-doc/introduction.html (added)
+++ websites/staging/ace/trunk/content/user-doc/introduction.html Wed Feb  8 22:52:14 2012
@@ -0,0 +1,178 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+  <head>
+    <title>Introduction</title>
+
+    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+    <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+    <link rel="stylesheet/less" type="text/css" href="/lib/bootstrap.less">
+    <link href="/css/prettify.css" rel="stylesheet">
+    <script src="/js/less-1.2.1.min.js" type="text/javascript"></script>
+    <script src="http://code.jquery.com/jquery-1.7.min.js"></script>
+    <script src="/js/prettify.js"></script>
+    
+    <script src="/js/bootstrap-alert.js"></script>
+    <script src="/js/bootstrap-dropdown.js"></script>
+    <script src="/js/bootstrap-tooltip.js"></script>
+    <script src="/js/bootstrap-alerts.js"></script>
+    <script src="/js/bootstrap-modal.js"></script>
+    <script src="/js/bootstrap-transition.js"></script>
+    <script src="/js/bootstrap-button.js"></script>
+    <script src="/js/bootstrap-popover.js"></script>
+    <script src="/js/bootstrap-twipsy.js"></script>
+    <script src="/js/bootstrap-buttons.js"></script>
+    <script src="/js/bootstrap-scrollspy.js"></script>
+    <script src="/js/bootstrap-typeahead.js"></script>
+    <script src="/js/bootstrap-carousel.js"></script>
+    <script src="/js/bootstrap-tab.js"></script>
+    <script src="/js/bootstrap-collapse.js"></script>
+    <script src="/js/bootstrap-tabs.js"></script>
+    
+    
+    
+    <script>
+    $(function () { prettyPrint() })
+    $().dropdown()
+    </script>
+  </head>
+
+  <body style="padding-top: 50px;">
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/index.html">Apache ACE</a>
+          <ul class="nav">
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">News <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/news.html">News</a>
+      </li>
+      <li>
+        <a href="/on-the-web.html">On the web</a>
+      </li>
+    </ul>
+  </li>
+  <li>
+    <a href="/downloads.html">Downloads</a>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">User Documentation <b
class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/user-doc/introduction.html">Introduction</a>
+      </li>
+      <li>
+        <a href="/user-doc/getting-started.html">Getting Started</a>
+      </li>
+      <li>
+        <a href="/user-doc/features.html">Features</a>
+      </li>
+      <li>
+        <a href="/user-doc/faq.html">FAQ</a>
+      </li>
+      <li>
+        <a href="/user-doc/support.html">Support</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Developer Documentation
<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/dev-doc/architecture.html">Architecture</a>
+      </li>
+      <li>
+        <a href="/dev-doc/analysis.html">Analysis</a>
+      </li>
+      <li>
+        <a href="/dev-doc/design.html">Design</a>
+      </li>
+      <li>
+        <a href="/dev-doc/coding-standards.html">Coding Standards</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Involved <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/get-involved/mailing-lists.html">Mailing Lists</a>
+      </li>
+      <li>
+        <a href="/get-involved/issue-tracking.html">Issue Tracking</a>
+      </li>
+      <li>
+        <a href="/get-involved/source-code.html">Source Code</a>
+      </li>
+      <li>
+        <a href="/get-involved/project-team.html">Project Team</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Wiki <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/wiki/board-reports.html">Board Reports</a>
+      </li>
+      <li>
+        <a href="/wiki/drafts.html">Drafts</a>
+      </li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache <b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li>
+        <a href="/apache/about.html">About</a>
+      </li>
+      <li>
+        <a href="/apache/license.html">License</a>
+      </li>
+      <li>
+        <a href="/apache/security.html">Security</a>
+      </li>
+      <li>
+        <a href="/apache/sponsorship.html">Sponsorship</a>
+      </li>
+      <li>
+        <a href="/apache/thanks.html">Thanks</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+
+        </div>
+      </div>
+    </div>
+    <div class="container">
+      <p><a href="/"><i class='icon-home'></i> Home</a>&nbsp;&raquo&nbsp;<a
href="/user-doc/">User-doc</a></p>
+      <h1>Introduction</h1>
+      <div class="clear"></div>
+      <div id="content"><p>Since its birth in 1999, OSGi has steadily been gaining
popularity as the component model of choice for Java. Originally designed as a framework for
home gateways and other embedded systems, it has since moved on to desktop and enterprise
systems and embraced by major software vendors.</p>
+<p>OSGi allows you to build your systems out of well defined, reusable components,
which brings both exciting new benefits as well as a set of challenges. One of these is the
actual management of components, deployed on different target systems.</p>
+<p>Traditional, monolithic systems usually have fairly straightforward and linear release
schedules. It is quite common for most target systems to have the same version and configuration
of such a system.</p>
+<p>Component based systems can easily be customized on a per target case, meaning there
might be many different configurations out there. When components are developed over time,
they might be released individually and a lot more often than these traditional systems.</p>
+<p>Keeping track of what is installed where becomes quite a challenge if the number
of components and targets grows, and this is where Apache ACE comes in.</p>
+<p>Apache ACE is a software distribution framework. It is written as a set of OSGi
components and consists of three major subsystems:</p>
+<ol>
+<li>dependency management, which handles the complexity of managing the dependencies
between component, aggregating them into groups and licenses and associating those to targets</li>
+<li>deployment management, which ensures that the right components get installed onto
the right targets in a robust and scalable way</li>
+<li>feedback management, which collects life cycle feedback on the target and aggregates
that on a central server</li>
+</ol>
+<p>A typical topology consists of:</p>
+<ul>
+<li>a server, holding the components and their metadata</li>
+<li>multiple target systems, which all connect to the server</li>
+<li>a client, usually a web browser, on which the user interacts with the server</li>
+</ul>
+<p>The Apache ACE software, which consists of a set of OSGi bundles, gets deployed
on a server. A target can be any OSGi framework (Apache Felix, Equinox or Knopflerfish) with
the Apache ACE management agent installed. This agent will connect to the server, identify
itself and poll for updates.</p></div>
+      <hr>
+      <footer>
+        <p>Copyright &#169; 2012 The Apache Software Foundation, Licensed under
the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache
and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+      </footer>
+    </div>
+  </body>
+</html>



Mime
View raw message