Skip to content
GitHub Mirror of OpenStack Loadbalancing (Atlas)
Java
Pull request Compare This branch is 358 commits ahead, 3244 commits behind rackerlabs:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
bin
core-adapters
core-api
core-common
core-data-model
core-jobs
core-persistence
extensions
server
.gitignore
README.md
git-cheatsheet.txt
pom.xml

README.md

What is Atlas


Atlas is Openstack LoadBalancers API that is actively being developed.

Wiki


http://wiki.openstack.org/Atlas-LB

Requirements


  1. Java >= 1.5

  2. Apache Maven == 2.2.1

  3. Apache ActiveMQ == 5.5.0

    Run ActiveMQ on default port.

    java -jar activemq/bin/run.jar start

  4. MySQL >= 5.x

    Create a MySQL database named 'openstack_atlas'

  5. Glassfish == 3.0.1 (Optional as Atlas comes with an embedded jetty server)

Getting Started for development


  1. Build

    Grab the atlas-lb/core-api/core-public-web/src/deb/contrib/maven/settings.xml and put it inside your ~/.m2 directory:

    cd atlas-lb

    ./bin/build.sh

  2. Configure

    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.

  3. Start atlas:

    ./bin/run.sh

    To run the app into debug mode on port 8080 with embedded jetty:

    ./bin/debug.sh

  4. 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

Something went wrong with that request. Please try again.