Linux -ubuntu- & Mac Setup

While I know that most *nix users knows far more about computers and development that I ever will, here I add some simple to follow steps to start working with Tequila!

This instructions are tested on an Ubuntu 8.04 'hardy' system. I followed the netbeans tutorial to do it and discover a couple of issues that a beginner might have problems doing.

A. Setting up LAMP development environment

1. Update apt-get

sudo apt-get update

2. Do you have your root account?

To configure apache/PHP you will need root access. if you don't know it in Ubunty perhaps you havent's set it.

sudo passwd root

su-

You actually don't need root access, just start your instructions with sudo and enter your normal user/pwd

You can also try:

Alt + F2: gksudo nautilus

3. Knowing how to edit a file that needs privileges

You don't need to do it now, in the next step (4), you will be required to edit xdebug.ini and later on some other files, you can do this by:

Alt + F2

gksudo gedit /etc/php5/conf.d/xdebug.ini

Replace the /etc... for the path and name of the file you want to edit

4. Set up LAMP and xdebug (optional)

Once I solve those 2 issues, I just follow this amazing page that explains the process in detail.

http://blogs.sun.com/netbeansphp/entry/ubuntu_php_netbeans

5. Installing netbeans editor (Optional)

a) We'll download this file instead of using a package manager to get the latest version (now 6.8)

Download: http://bits.netbeans.org/netbeans/6.8/m2/

b) Once you download the file, change the permissions to make it executable and run it.

To change mode either in terminal or Alt + F2:

chmod +x <paht/installer-file-name>

c) Double click the file to execute it

For more detailed instructions check: http://www.netbeans.org/community/releases/68/install.html

B. Setting up tequila.

1. Getting Tequila source

You can get Tequila source from sourceforge or from mercurial

1.1 Getting Tequila source from mercurial

Open a terminal window: Applications > Accesories > Terminal

Install mercurial:

apt-get install mercurial

Go to the directory where you want to setup tequila (Somewhere in your apache directory)

cd /home/your-user-name/public_html/tequila

* Replace for your directory

hg clone http://tequila.hg.sourceforge.net/hgweb/tequila/cleanapp

hg clone http://tequila.hg.sourceforge.net/hgweb/tequila/core

1.2 Getting Tequila source from sourceforge

Download the latest source here

Unzip to your selected directory

2. Change permissions for the /cleanapp folder

Feel free to rename this folder, then run

sudo chmod -R 777 cleanapp

3. Setup your Database

Using your favorite tool (phpmyadmin / MySQL Quert Browser / TOra / Any other)

a) Create a database (Tequila or any)

b) Import or copy the SQL script in cleanapp/db/tequila.sql

c) Execute the script

4. Configure your application

a) Edit the config file located in:

/home/your-user/public_html/Tequila/cleanapp/includes/config.php

* Use with your path

b) Change the DB connection information, user, pwd, dbname

c) Optionally change the path of core if required (just in case you renamed or moved it)

5. Test, run

a) Browse to: localhost/yourpath/yourapplication/index.php

b) If everything went fine you should see a login screen

c) Login using the default user/pwd: admin/admin

Now you might want to follow the your first application tutorial to generate your app in one click!