|
a/README.markdown |
|
b/README.markdown |
| 1 |
# Sandbox Creation
|
1 |
# Sandbox Creation
|
| 2 |
|
2 |
|
| 3 |
We'll use [VirtualBox](http://www.virtualbox.org) and [Ubuntu 10.10](http://ubuntu.com) to create a disposable sandbox for Forge development/testing.
|
3 |
We'll use [VirtualBox](http://www.virtualbox.org) and [Ubuntu 11.10](http://ubuntu.com) to create a disposable sandbox for Forge development/testing.
|
| 4 |
|
4 |
|
| 5 |
* Download and install [VirtualBox](http://www.virtualbox.org/wiki/Downloads) for your platform.
|
5 |
* Download and install [VirtualBox](http://www.virtualbox.org/wiki/Downloads) for your platform.
|
| 6 |
|
6 |
|
| 7 |
* Download a minimal [Ubuntu 10.10](https://help.ubuntu.com/community/Installation/MinimalCD) ISO (~15MB).
|
7 |
* Download a minimal [Ubuntu 11.10 64-bit ISO](https://help.ubuntu.com/community/Installation/MinimalCD).
|
| 8 |
|
8 |
|
| 9 |
* Create a new virtual machine in Virtual Box, selecting Ubuntu (64 bit) as the OS type. The rest of the wizards' defaults are fine.
|
9 |
* Create a new virtual machine in Virtual Box, selecting Ubuntu (64 bit) as the OS type. The rest of the wizards' defaults are fine.
|
| 10 |
|
10 |
|
| 11 |
* When you launch the virtual machine for the first time, you will be prompted to attach your installation media. Browse to the `mini.iso` that you downloaded earlier.
|
11 |
* When you launch the virtual machine for the first time, you will be prompted to attach your installation media. Browse to the `mini.iso` that you downloaded earlier.
|
|
|
12 |
|
|
|
13 |
* After a text-only installation, you may end up with a blank screen and blinking cursor. Press Alt-F1 to switch to the first console.
|
| 12 |
|
14 |
|
| 13 |
* Consult [available documentation](https://help.ubuntu.com/) for help installing Ubuntu.
|
15 |
* Consult [available documentation](https://help.ubuntu.com/) for help installing Ubuntu.
|
| 14 |
|
16 |
|
| 15 |
|
17 |
|
| 16 |
# Forge Installation
|
18 |
# Forge Installation
|
| 17 |
|
19 |
|
| 18 |
Before we begin, you'll need the following additional packages in order to work with the Forge source code.
|
20 |
Before we begin, you'll need the following additional packages in order to work with the Forge source code.
|
| 19 |
|
21 |
|
| 20 |
~$ sudo apt-get install git-core gitweb subversion python-svn libtidy-0.99-0
|
22 |
~$ sudo aptitude install git-core subversion python-svn libtidy-0.99-0
|
| 21 |
|
23 |
|
| 22 |
You'll also need additional development packages in order to compile some of the modules.
|
24 |
You'll also need additional development packages in order to compile some of the modules. [Use google for additional PIL/jpeg help.](http://www.google.com/search?q=ubuntu+pil+jpeg+virtualenv)
|
| 23 |
|
25 |
|
| 24 |
~$ sudo apt-get install default-jdk python-dev libssl-dev libldap2-dev libsasl2-dev
|
26 |
~$ sudo aptitude install default-jdk python-dev libssl-dev libldap2-dev libsasl2-dev libjpeg8-dev zlib1g-dev
|
|
|
27 |
~$ sudo ln -s /usr/lib/x86_64-linux-gnu/libz.so /usr/lib
|
| 25 |
|
28 |
|
| 26 |
And finally our document-oriented database, MongoDB, and our messaging server, RabbitMQ. Note that RabbitMQ is optional, but will make messages flow faster through our asynchronous processors. By default, rabbitmq is disabled in development.ini.
|
29 |
And finally our document-oriented database, MongoDB, and our messaging server, RabbitMQ. Note that RabbitMQ is optional, but will make messages flow faster through our asynchronous processors. By default, rabbitmq is disabled in development.ini.
|
| 27 |
|
30 |
|
| 28 |
~$ sudo apt-get install mongodb rabbitmq-server
|
31 |
~$ sudo aptitude install mongodb-server rabbitmq-server
|
| 29 |
|
32 |
|
| 30 |
## Setting up a virtual python environment
|
33 |
## Setting up a virtual python environment
|
| 31 |
|
34 |
|
| 32 |
The first step to installing the Forge platform is installing a virtual environment via `virtualenv`. This helps keep our distribution python installation clean.
|
35 |
The first step to installing the Forge platform is installing a virtual environment via `virtualenv`. This helps keep our distribution python installation clean.
|
| 33 |
|
36 |
|
| 34 |
~$ sudo apt-get install python-setuptools
|
37 |
~$ sudo aptitude install python-setuptools
|
| 35 |
~$ sudo easy_install-2.6 -U virtualenv
|
38 |
~$ sudo easy_install -U virtualenv
|
| 36 |
|
39 |
|
| 37 |
Once you have virtualenv installed, you need to create a virtual environment. We'll call our Forge environment 'anvil'.
|
40 |
Once you have virtualenv installed, you need to create a virtual environment. We'll call our Forge environment 'anvil'.
|
| 38 |
|
41 |
|
| 39 |
~$ virtualenv anvil
|
42 |
~$ virtualenv anvil
|
| 40 |
|
43 |
|
| 41 |
This gives us a nice, clean environment into which we can install all the forge dependencies. In order to use the virtual environment, you'll need to activate it. You'll need to do this whenever you're working on the Forge codebase so you may want to consider adding it to your `~/.bashrc` file.
|
44 |
This gives us a nice, clean environment into which we can install all the forge dependencies. In order to use the virtual environment, you'll need to activate it. You'll need to do this whenever you're working on the Forge codebase so you may want to consider adding it to your `~/.bashrc` file.
|
| 42 |
|
45 |
|
| 43 |
~$ . anvil/bin/activate
|
46 |
~$ . anvil/bin/activate
|
| 44 |
|
|
|
| 45 |
Now that that's out of the way, we'll go ahead and install TurboGears.
|
|
|
| 46 |
|
|
|
| 47 |
(anvil)~$ easy_install pylons==0.9.7
|
|
|
| 48 |
(anvil)~$ easy_install -i http://www.turbogears.org/2.1/downloads/2.1b2/index/ tg.devtools==2.1b2 TurboGears2==2.1b2
|
|
|
| 49 |
|
|
|
| 50 |
|
47 |
|
| 51 |
## Installing the Forge code and dependencies
|
48 |
## Installing the Forge code and dependencies
|
| 52 |
|
49 |
|
| 53 |
Now we can get down to actually getting the Forge code and dependencies downloaded and ready to go.
|
50 |
Now we can get down to actually getting the Forge code and dependencies downloaded and ready to go.
|
| 54 |
|
51 |
|