===== Akelos on Windows quickstart =====









==== XAMPP installation ====

Get [[http://www.apachefriends.org/en/xampp.html|XAMPP]], it's an easy to use package including everything needed to run Akelos and the Booklink tutorial (apache, mysql, php, phpmyadmin)

install xampp at the root of a disk, ie:

    c:\xampp

There's a bug in xampp (as of ver. 1.6.3) that prevents php from being used from the commandline.  Change the file c:\xampp\php\php.ini, editing the following line:

    extension=php_svn.dll

to make it look like

    ;extension=php_svn.dll

**as of 30/08/2008** with XAMPP for Windows ver 1.6.7  (of 2008/07/06) the ;extension=php_svn.dll is already commented out with ';' in both php.ini and php5.ini, and remember the running php.ini is found here:
\xampp\apache\bin\php.ini
(with the apache actually running php version) 

now start XAMPP by double-clicking
    c:\xampp\xampp_start.exe

**Note**: You can switch from PHP4 to PHP5 or vice versa executing
    C:\xampp\php-switch.bat

Install mod rewrite???
Somebody else confirm this and clean it up....  But it has caused a lot of trouble.  You will also need to uncomment this line "#LoadModule rewrite_module modules/mod_rewrite.so" in the file xampp\apache\conf\httpd.conf for the url rewrites to work.
**as of 30/08/2008** with XAMPP for Windows ver 1.6.7 (of 2008/07/06) the line 'LoadModule rewrite_module modules/mod_rewrite.so' is already uncommented ;-) and hence mod_rewrite should work. 



php-switch.bat not working (am using latest version of xamp)


==== Get Akelos ====

Get [[http://akelos.org/download|Akelos]] and uncompress it, say in the following directory:

    c:\dev\akelos

Now open a Command Prompt ('accessories' menu), and go to that directory

    cd c:\dev\akelos

DELETEME :?: => Wht next.... dude  after this..??????

DELETEME :?: => man big procedure is missing here to proceed to next step :(

If you extracted it right, you should see the "akelos_framework" folder below the "akelos".

DELETEME :?: => When I unzipped it there was a directory below akelos, so

Move you prompt to that directory:

    cd c:\dev\akelos\akelos_framework





==== Creating a new application ====

We will create the Booklink application in the webserver document root.
Type from your prompt :

(:!: Your prompt as above will be like : C:\dev\akelos\akelos_framework>_ ) :

    c:\xampp\php\php.exe script/setup -d c:\xampp\htdocs\booklink

The PHP will search in the **c:\dev\akelos\akelos_framework\script\** file named "setup" and run it. You can also write the **script/setup** part as a full/dynamic path to the "setup" file in the akelos unzipped folder with "\" as the folder separator.

This will create the following structure for the **booklink** application:

    booklink/
        app/ << The application including controllers, views, models and installers
        config/ << Boring configuration files (will do the config via web)
        public/ << This is the only folder made public under /www/htdocs/booklink softlink
        script/ << Utils for code generation and running tests    

**Note:**

before you run the above syntax, maybe you should turn off the Apache web server and MySQL engine,
since in some case after running the syntax, either the Apache or the MySQL engine could cause some problems. If you want, you can make a batch file that automatically turn off the web server, then running the php syntax, and turn on the web server again after it; since there going to be a lot more syntax like the above to run when you building your web.

FIXME :?: => The creation of booklink caused some problems. The MySQL server would not restart. The error referenced the value "innodb_log_arch_dir" and the fact that it is no longer a valid argument. I checked the my.cnf file and this line is commented out. However, the booklink setup process rewrites my.cnf and uncomments the line. When I removed the line completely the error went away and MySQL continued to run.


==== Creating the database ====

First you need to create your database by using the phpMyAdmin web interface at:

    http://localhost/phpmyadmin

You will need these databases

    booklink
    booklink_dev
    booklink_tests





==== Generating the configuration file ====

You can now point your browser to

    http://localhost/booklink/public

Follow the steps in the wizard to set up your database, locales and file permissions and generate a configuration file.

**Note**: on XAMPP, the default database username is 'root' and the password is empty

On your command line, change your directory to go into your application

    cd c:\xampp\htdocs\booklink

You can now continue the regular Booklink tutorial, starting at the "The booklink database structure" section. Remember that whenever the instruction states that you should do something like this:

    ./script/generate scaffold Book

you will have to type it that way

    c:\xampp\php\php.exe script/generate scaffold Book



==== Note ====

If you add PHP to your path, you will be able to type commands like:

    php script/generate scaffold book

Heres how to do it: Right click on `My Computer`, go to the `Advanced` tab and then click the button `Environnment Variables`. In the `System variables` section, select `path` and click `edit`. At the end of the line, add
    ;C:\xampp\php

Open a new Command Prompt and voila!