Version: #VERSION# Date: #DATE#

OktDB is a cool web application.

It comes complete with a classic "configure - make - install" setup.

In your app source directory and start building.

./configure --prefix=$HOME/opt/oktdb
make

Configure will check if all requirements are met and give hints on how to fix the situation if something is missing.

Any missing perl modules will be downloaded and built.

While developing the application it is convenient to NOT have to install it before runnning. You can actually serve the Qooxdoo source directly using the built-in Mojo webserver.

./bin/oktdb-source-mode.sh

You can now connect to the CallBackery app with your web browser.

If you need any additional perl modules, write their names into the PERL_MODULES file and run ./bootstrap.

To install the application, just run

make install

You can now run oktdb.pl in reverse proxy mode.

cd $HOME/opt/oktdb/bin
./oktdb.pl prefork

Before releasing, make sure to update CHANGES, VERSION and run ./bootstrap.

You can also package the application as a nice tar.gz file, it uses carton to install dependent module. If you want to make sure that your project builds with perl 5.22, make sure to set the PERL environment variable to a perl 5.22 interpreter, make sure to delete any PERL5LIB environment variable, and run make clean && make. This will cause a cpanfile-5.22.1.snapshot file to be included with your tar ball, when building the app this snapshot will be used to make sure all the right versions of the dependent modules get installed.

make dist

Enjoy!

Tobias Oetiker [email protected]