Yote
Author: Eric Wolf, coyocanid@gmail.com

# Installing Yote

You can install Yote using either CPAN or Github. This will install the libraries and the yote_server program and create a base directory in the first of the following places that is writeable to the account doing the installation :

- /opt/yote
- /var/yote
- /usr/local/yote
- ~/yote

CPAN
  `$ sudo CPAN Yote`
Github
  Get Yote on github : https://github.com/ewolf/Yote
  `$ perl Build.PL
  $ ./Build installdeps
  $ ./Build test
  $ sudo ./Build install
  `

# Running Yote

Yote can be run on any available port using the `yote_server` command. As of this writing, `yote_server` is not yet daemonized. The first time `yote_server` is run, it will prompt for some configuration information.

> `

>     $ yote_server --port=80

> `

# Configuring Yote

When Yote is run for the first time, it asks what port the server should be run on and what sort of datastore engine should be set up. Yote can always use a Sqlite database as a store.

The available engines are :

- mongoDB ( preferred )
- Sqlite
- MySQL

### Accounts

Once started, the first user login account created with Yote is the root account. The account can be created by calling `$.yote.create_login( 'handle', 'password', 'email' )`

### Unit Tests

There are additional unit tests that cannot be performed by the installer. These are tests that make sure the javascript can connect correctly to the back end. To run the unit tests, start Yote and open up a browser to `http://localhost/yote/unit_tests.html`
The last few tests take a few seconds, so wait until the browser reports 'passed all tests'.

### App Visibility

App libraries are visible to Yote if they are in the perl classpath or are in the `lib` directory off of the yote base directory.
HTML pages are visible to Yote if they are in the `html` directory off of the yote base directory.