Starting A New Application

Creating The Application

When you install Andromeda onto a computer, we say that that computer is now an Andromeda Node. Each Andromeda Node has a special program running on it called the "Node Manager" that is used to build, update, and upgrade the other Andromeda applications running on the node.

To create a new application, launch the node manager. If you have installed with the default instructions, the address will be:

http://localhost/andro_root/andro/index.php

Log in using the node superuser user_id and password that you created during the installation. Then from the menu pick "operations", then "applications", then "New Entry":

Every Andromeda application requires a code. The Andromeda Tutorials are all about a finance application with code "finance", so we will do the same thing in this example. For description we will use "Finance Application" and we will name the spec file 'finance.dd.yaml'. The spec file is named after the application, plus the double extension "dd.yaml" makes it recognizable to syntax coloring editors. Make the Web Path "LOCAL" and the Authoritative Node "LOCAL":

Then hit the [SAVE] button (or type ALT-S). At this point Andromeda now has a record of your application, but it has not done anything with it yet. To get the ball rolling, click on the link at the top right that says "Build this application":

This will popup a window that displays a lot of logging information as the application is built. Once the log is finished you will have a complete skeleton project!

Although there is nothing to see yet, if you want to login, you can use your superuser and log in at:

http://localhost/andro_root/finance

Whenever you have changed the database specification, that is, the finance.dd.yaml file, you can re-run the builder from there. The builder will validate your spec and if it is valid then the builder will apply all of the changes.