ace-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From br...@apache.org
Subject svn commit: r1487784 - /ace/site/trunk/content/user-doc/getting-started.mdtext
Date Thu, 30 May 2013 08:37:51 GMT
Author: bramk
Date: Thu May 30 08:37:51 2013
New Revision: 1487784

URL: http://svn.apache.org/r1487784
Log:
ACE-139 Added ACE 1.0 launcher instructions

Modified:
    ace/site/trunk/content/user-doc/getting-started.mdtext

Modified: ace/site/trunk/content/user-doc/getting-started.mdtext
URL: http://svn.apache.org/viewvc/ace/site/trunk/content/user-doc/getting-started.mdtext?rev=1487784&r1=1487783&r2=1487784&view=diff
==============================================================================
--- ace/site/trunk/content/user-doc/getting-started.mdtext (original)
+++ ace/site/trunk/content/user-doc/getting-started.mdtext Thu May 30 08:37:51 2013
@@ -2,7 +2,7 @@ Title: Getting Started
 
 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.
 
-## Download and startup
+## Download the distribution
 
 To start using ACE, you must first launch a server. If you're a developer, you can do that
inside Eclipse, as explained [here](/dev-doc/getting-started.html). Otherwise, you need to
download a distribution of the server, unpack it, and start it up:
 
@@ -10,15 +10,38 @@ To start using ACE, you must first launc
 
 1. Download a binary distribution of the server from the [download](/downloads.html) page.
 1. Unpack the archive somewhere on your filesystem.
-1. Start it by running `run.sh` (on Linux and Mac OS X) or `run.bat` (on Windows).
 
 ### Version 1.0 (comming soon)
 
 1. Download the binary distribution called `apache-ace-<version>-bin.zip` from the
[download](/downloads.html) page.
 1. Unpack the archive somewhere on your filesystem.
+
+## Start the ACE server
+
+### Version 0.8.1
+
+1. Open a terminal and navigate into the root of the distribution.
+1. Start the server using `run.sh` (on Linux and Mac OS X) or `run.bat` (on Windows).
+
+### Version 1.0
+
+1. Open a terminal and navigate nto the root of the distribution.
 1. Navigate to the sub directory `server-allinone`.
-1. Start it by running `java -jar server-allinone.jar`
+1. Start the server using `java -jar server-allinone.jar`
+
+## Start an ACE target
+
+### Version 0.8.1
 
+1. Open a terminal and navigate into the root of the distribution.
+1. Navigate to the sub directory `ace-launcher/target`.
+1. Start the agent using `java -jar org.apache.ace.launcher*.jar`
+
+### Version 1.0
+
+1. Open a terminal and navigate into the root of the distribution.
+1. Navigate to the sub directory `target`.
+1. Start the target using `java -jar target.jar`
 
 ## Working with ACE
 
@@ -26,13 +49,12 @@ Apache ACE has both a Web UI and a [REST
 
 The following steps can be followed to get started:
 
-1. 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.
-1. 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).
+1. 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.
+1. Click on 'Retrieve' to get the initial version of the repository. The column on the right
will show you have a target running with name `defaultTargetID`. The other columns remain
empty as this is an initial empty version of the repository.
 1. 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.
 1. Create a feature by clicking on the 'Add Feature...' button. Features are the first level
of logical grouping for artifacts.
 1. Create a distribution by clicking on the 'Add Distribution...' button. Distributions are
another level of logical grouping: you group features into distributions.
 1. 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.
 1. Drag a feature onto a distribution and again repeat this process until you've associated
all your features with their relevant distributions.
-1. Now we need a target to actually deploy our artifacts to. To start a target, go to `ace-launcher/target`
and start it using `java -jar org.apache.ace.launcher*.jar`.
-1. 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.
+1. Drag the distribution onto the target to associate it.
 1. Click on 'Store' to actually store changes on the server, which should trigger the actual
deployment of the artifacts to the target.



Mime
View raw message