commit b362029580dc9ad8cd968bc622b947479335ed7b
parent 2afe5e8e589571a1dad90bf1e3ba0c26dfb02571
Author: Felicitus <felicitus@felicitus.org>
Date: Sat, 12 May 2012 10:47:50 +0200
Merge branch 'master' of github.com:partkeepr/PartKeepr
Diffstat:
2 files changed, 122 insertions(+), 89 deletions(-)
diff --git a/documentation/developer-installation/UBUNTU b/documentation/developer-installation/UBUNTU
@@ -0,0 +1,122 @@
+Step-by-Step Guide for Ubuntu
+=============================
+
+This guide explains how to setup your workstation so that you can develop using PartKeepr.
+
+Tested with:
+- Ubuntu 11.04
+- Ubuntu 12.04
+
+In this guide, I've used "/var/www" as web server root.
+
+
+-------------
+SYSTEM CONFIG
+-------------
+
+# NOTE: These steps require root access.
+# Prefix all commands with 'sudo' or run as the root user.
+
+# Install apache, mysql, php, imagemagick and git
+apt-get install apache2 mysql-server mysql-client libapache2-mod-php5 php5-mysql php5-curl php5-cli php-pear php5-imagick php5-xsl php-apc php5-dev imagemagick git
+
+# On Ubuntu Server, you need to install ia32-libs (installed automatically on Ubuntu Desktop)
+# Note: This is only required with 64-bit Ubuntu (not 32-bit)
+apt-get install ia32-libs
+
+# Install Java SDK
+apt-get install default-jdk
+
+# Update PEAR
+pear update-channels
+pear upgrade
+
+# Install phpunit, phing, doctrine components and twig
+pear config-set auto_discover 1
+pear channel-discover pear.phpunit.de
+pear install phpunit/PHPUnit
+pear channel-discover pear.phing.info
+pear install phing/phing
+
+pear install pear.doctrine-project.org/DoctrineORM
+pear install phpunit/phpcpd
+# (the required domain 'components.ez.no' seems to be unavailable quite often)
+
+pear install --alldeps phpmd/PHP_PMD-alpha
+
+pear install doctrine/DoctrineSymfonyYaml
+pear install doctrine/DoctrineSymfonyConsole
+
+pear channel-discover pear.twig-project.org
+pear install twig/Twig
+
+
+------------------
+# PARTKEEPR CONFIG
+------------------
+
+# NOTE: These steps can be performed as a regular user.
+$ Steps requiring root permission
+
+# Create a new database and user 'partkeepr'
+mysql -uroot -p
+CREATE DATABASE partkeepr CHARACTER SET utf8;
+grant usage on *.* to partkeepr@localhost identified by 'partkeepr';
+grant all privileges on partkeepr.* to partkeepr@localhost;
+quit
+
+# Test if you can connect
+mysql -upartkeepr -ppartkeepr
+quit
+
+# Setting up the PartKeepr repository
+# NOTE: You should secure the PartKeepr directory with appropriate permissions once setup is complete
+cd /var/www
+sudo mkdir PartKeepr
+sudo chmod 777 PartKeepr
+
+# Cloning will take a while, approx 50MB repository will be downloaded
+git clone git://github.com/partkeepr/PartKeepr.git
+
+cd /var/www/PartKeepr
+
+# This will update the submodules. Another 400MB will be downloaded
+git submodule sync
+git submodule init
+git submodule update
+
+# Copy the default configuration file
+cp config.php.template config.php
+
+# You have now two choices: Proceed with or without sample data.
+
+# ==== WITH SAMPLE DATA ====
+mysql -uroot -p
+CREATE DATABASE partdb;
+grant usage on *.* to partdb@localhost identified by 'partdb';
+grant all privileges on partdb.* to partdb@localhost;
+FLUSH PRIVILEGES;
+quit
+
+mysql -upartdb -ppartdb partdb < testing/setup.sql
+cd testing
+php SetupDatabase.php --yes --migrate
+
+# ==== WITHOUT SAMPLE DATA ====
+cd testing
+php SetupDatabase.php --yes
+
+# ==== Issuing migrations ====
+# Ignore all messages about "was executed but did not result in any SQL statements"
+cd /var/www/PartKeepr/
+php doctrine.php migrations:migrate
+
+# Build the frontend
+phing build
+
+# Restart apache2 to make sure php5 is enabled (requires root permission)
+sudo /etc/init.d/apache2 restart
+
+# Open up your browser and navigate to http://localhost/PartKeepr/frontend
+# The frontend should now appear
+
diff --git a/documentation/developer-installation/UBUNTU-11.04 b/documentation/developer-installation/UBUNTU-11.04
@@ -1,89 +0,0 @@
-Step by Step Guide für Ubuntu 10.04
-===================================
-
-This guide explains how to setup your workstation so that you can develop using PartKeepr.
-
-This guide assumes that you are working as user root. Usually this isn't recommended, but to make it easier for you, we'll omit that.
-
-In this guide, I've used "/var/www" as web server root.
-
-apt-get install apache2 php5-mysql php5-curl php5-cli php-pear git php5-imagick php5-xsl php-apc imagemagick mysql-client mysql-server libapache2-mod-php5
-
-# Update PEAR
-
-pear update-channels
-pear upgrade
-
-# On Ubuntu Server, you need to install ia32-libs which are installed automatically on Ubuntu Desktop
-apt-get install ia32-libs
-apt-get install default-jdk
-
-# Install phpunit, phing
-
-pear config-set auto_discover 1
-pear channel-discover pear.phpunit.de
-pear install phpunit/PHPUnit
-pear channel-discover pear.phing.info
-pear install phing/phing
-
-pear install pear.doctrine-project.org/DoctrineORM
-pear install phpunit/phpcpd
-pear install --alldeps phpmd/PHP_PMD-alpha
-
-# You can
-# Create a new database
-mysql -uroot -p
-CREATE DATABASE partkeepr;
-grant usage on *.* to partkeepr@localhost identified by 'partkeepr';
-grant all privileges on partkeepr.* to partkeepr@localhost;
-quit
-
-# Test if you can connect
-mysql -upartkeepr -ppartkeepr
-quit
-
-# Setting up the PartKeepr repository
-cd /var/www
-
-# Cloning will take a while, approx 50MB repository will be downloaded
-git clone git://github.com/partkeepr/PartKeepr.git
-
-cd /var/www/PartKeepr
-
-# This will update the submodules. Another 200MB will be downloaded
-git submodule sync
-git submodule update
-
-cp config.php.template config.php
-
-# You have now two choices: Proceed with or without sample data.
-
-# ==== WITH SAMPLE DATA ====
-mysql -uroot -p
-CREATE DATABASE partdb;
-grant usage on *.* to partdb@localhost identified by 'partdb';
-grant all privileges on partdb.* to partdb@localhost;
-FLUSH PRIVILEGES;
-quit
-
-mysql -upartdb -ppartdb partdb < testing/setup.sql
-cd testing
-php SetupDatabase.php --yes --migrate
-
-# ==== WITHOUT SAMPLE DATA ====
-cd testing
-php SetupDatabase.php --yes
-
-# ==== Issuing migrations ====
-# Ignore all messages about "was executed but did not result in any SQL statements"
-cd /var/www/PartKeepr/
-php doctrine.php migrations:migrate
-
-# Build the frontend
-phing build
-
-# Restart apache2 to make sure php5 is enabled
-/etc/init.d/apache2 restart
-
-# Open up your browser and navigate to http://localhost/PartKeepr/frontend
-# The frontend should now appear
