What is Atlas
Atlas is Openstack LoadBalancers API that is actively being developed.
Java >= 1.5 (note: Java 1.7 seems to have a compatibility issue with JAXB, so until we fix this, better to be avoided).
Apache Maven == 2.2.1
Apache ActiveMQ == 5.5.0
Run ActiveMQ on default port.
java -jar activemq/bin/run.jar start
MySQL >= 5.x
Create a MySQL database named 'openstack_atlas'
Glassfish == 3.0.1 (Optional as Atlas comes with an embedded jetty server)
Getting Started for development
Grab the atlas-lb/core-api/core-public-web/src/deb/contrib/maven/settings.xml and put it inside your ~/.m2 directory:
Copy all of the configuration files from atlas-lb/core-api/core-public-web/src/deb/contrib/config and put it under your /etc/openstack/atlas directory.
Make sure you update /etc/openstack/atlas/public-api.conf with:
- your database username/password.
- If you are not using null (fake) adapter which is the default one configured, choose another adapter.
To run the app into debug mode on port 8080 with embedded jetty:
If atlas is properly started, it should have created the necessary database tables for you. Seed the 'openstack_atlas' database with some fake data (cluster, hosts, virtual ips, etc.). A sample for testing is here: atlas-lb/core-api/core-public-web/src/deb/contrib/db/ directory
Now you can access the Atlas REST API eg. do a GET on http://localhost:8080/v1.1/1000/loadbalancers where 1000 is a tenant_id. What does it return? May be its time to do a POST. More more operations, http://wiki.openstack.org/Atlas-LB
Deploy under Glassfish Application Server
Alternative to the step 3 above, if you want to use an Application Server like Glassfish instead of the embedded jetty, you could:
/glassfish/glassfish/bin/asadmin start-domain cp atlas-lb/core-api/core-public-web/target/core-public-web-1.1.0-SNAPSHOT.war /glassfish/glassfish/domains/domain1/autodeploy
For more information about Openstack, go to Openstack.org