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.
Using Apache ACE
Starting the server
To start using ACE, you must first launch a server. If you're a developer, you can do that inside Eclipse, as explained here. Otherwise, you need to download a distribution of the server, unpack it, and start it up:
- Download a binary distribution of the server from the download page.
- Unpack the archive somewhere on your filesystem.
- Start it by running
run.sh(on Linux and Mac OS X) or
Working with ACE
Apache ACE has both a Web UI and a REST API to interact with it. Both use a similar workflow. You start by checking out a copy of the workspace, then you work on that copy, and finally you commit your changes back to the server.
The following steps can be followed to get started:
- 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.
- 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).
- 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.
- Create a feature by clicking on the 'Add Feature...' button. Features are the first level of logical grouping for artifacts.
- Create a distribution by clicking on the 'Add Distribution...' button. Distributions are another level of logical grouping: you group features into distributions.
- 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.
- Drag a feature onto a distribution and again repeat this process until you've associated all your features with their relevant distributions.
- Now we need a target to actually deploy our artifacts to. To start a target, go to
ace-launcher/targetand start it using
java -jar org.apache.ace.launcher*.jar.
- 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.
- Click on 'Store' to actually store changes on the server, which should trigger the actual deployment of the artifacts to the target.