Getting Started with the Grails-based Power TAC simulation server

Prerequisites

• Required Software
  • JDK
  • Grails 1.3.7
  • Git
  • Integrated Development Environment. We recommend IntelliJ IDEA v10, NetBeans, or SpringSource ToolSuite (a customized eclipse version with default support for Groovy and Grails)

Reading Material

In order to get familiar with the grails framework we're using and to fully understand the development/deployment process, we recommend you get familiar with:

• Grails
  • Grails reference documentation
  • Getting started with Grails, Second Edition
• Git
  • Git
  • Github usage

If you're contributing, please read and follow our Development Policies completely.

Downloading and running the Power TAC Server

1. cd /your/target/checkout/directory
2. git clone https://github.com/powertac/powertac-server.git
3. Repeat Step 2 for
   1. git clone https://github.com/powertac-plugins/powertac-common.git
   2. git clone https://github.com/powertac-plugins/powertac-server-interface.git
   3. git clone https://github.com/powertac-plugins/powertac-web-app.git
   4. git clone https://github.com/powertac-plugins/powertac-style.git
   5. git clone https://github.com/powertac-plugins/powertac-random.git
   6. git clone https://github.com/powertac-plugins/powertac-genco.git
   7. git clone https://github.com/powertac-plugins/powertac-auctioneer-pda.git
   8. git clone https://github.com/powertac-plugins/powertac-accounting-service.git
   9. git clone https://github.com/powertac-plugins/powertac-household-customer.git
   10. git clone https://github.com/powertac-plugins/powertac-physical-environment.git
   11. git clone https://github.com/powertac-plugins/powertac-distribution-utility.git
   12. git clone https://github.com/powertac-plugins/powertac-default-broker.git
   13. git clone https://github.com/powertac-plugins/powertac-visualizer.git
   14. git clone https://github.com/powertac-plugins/powertac-db-stuff.git
4. cd powertac-server
5. grails run-app
6. Should the process fail because a Spring Security or some other dependency is missing, re-run grails run-app and it should download the necessary dependencies.

After downloading additional dependencies and plugins the server will initialize itself, start locally on your computer, and indicate its ready state:

Server running. Browse to http://localhost:8080/powertac-server

Browse to http://localhost:8080/powertac-server to check that your server is up and running correctly. Here you can set up local competitions in order to test your own Power TAC client.

Downloading and running the Power TAC Grails Demo Agent

1. cd /your/target/checkout/directory
2. git clone https://github.com/powertac/powertac-demo-agent-grails.git
3. cd powertac-demo-agent-grails
4. grails run-app or, if you are running the server and client on the same machine: grails -Dserver.port=9090 run-app

Browse to http://localhost:9090/powertac-demo-agent-grails to check that the demo agent is running correctly.

1. You will have to enter a valid web-app destination if you're running a tournament configuration. Since you are most likely to run a research configuration, enter the URL of your local Power TAC server http://localhost:8080/powertac-server if necessary.
2. In the default "research" mode, there is no need to create an account for your Broker. It should be able to log in without a password.

Developing Custom Power TAC Plugins (Customer, Auctioneer, Weather, etc.)

Please refer to the plugin development getting started guide.