Publish - How to install Magento on Ubuntu

6 files changed, 61 insertions, 6 deletions

diff --git a/_site_build/_posts/2012-04-21-how-to-install-magento-on-ubuntu.markdown b/_site_build/_posts/2012-06-03-how-to-install-magento-on-ubuntu.markdown
index 00b5428..48f3f27 100644
--- a/_site_build/_posts/2012-04-21-how-to-install-magento-on-ubuntu.markdown
+++ b/_site_build/_posts/2012-06-03-how-to-install-magento-on-ubuntu.markdown
@@ -9,7 +9,7 @@ comments: true
 google_plus: true
 twitter_share: true
 facebook_like: true
-published: false
+published: true
 licensed: true
 ---
 By the end of this guide you will have installed Magento, and some sample data, locally on Ubuntu. This will allow you to get to grips with the software before installing it onto a production server. In addition to Magento I will take you through installing Apache, PHP and MySQL. I'm going to assume that you are using Ubuntu 12.04 (Precise Pangolin) and that you wish to install version 1.7.0.0 of Magento. You're results may vary if you are using different versions.
@@ -18,11 +18,12 @@ As this is quite a long post I have broken it down into various sections. Feel f
 
 * [Getting started.](#start)
 * [Installing and configuring the Apache HTTP server.](#apache)
-* [Installing the PHP scripting language.](#php)
+* [Installing PHP.](#php)
 * [Installing the MySQL database server.](#mysql)
 * [Creating the directory from which Magento will be served from.](#directory)
 * [Configuring the Apache Virtual Host.](#vhost)
 * [Installing Magento.](#magento)
+* [Running the Magento setup wizard](#wizard.)
 
 <h2 id="start">Getting started.</h2>
 
@@ -91,7 +92,7 @@ sudo a2enmod rewrite
 sudo service apache2 restart
 {% endhighlight %}
 
-<h2 id="php">Installing the PHP scripting language.</h2>
+<h2 id="php">Installing PHP.</h2>
 As can be seen from the list of system <a href="http://www.magentocommerce.com/system-requirements" rel="external nofollow" target="_blank" title="Go to the list of Magento requirements">requirements</a>, Magento needs PHP version 5.2.13 or later with the following extensions.
 
 * PDO_MySQL
@@ -139,7 +140,7 @@ mkdir /home/dev/public_html
 chgrp www-data /home/dev/public_html
 {% endhighlight %}
 
-As both you and Apache need read and write access to the directory we have used the `chgrp` command to change its group to be `www-data`. However any new files or directories that you create within `public_html` will not inherit the same group. We therefore need to change the permissions to include the &quot;setgid&quot; bit.
+As both you and Apache need read and write access to the directory we have used the `chgrp` command to change its group to be `www-data`. However, any new files or directories that you create within `public_html` will not inherit the same group. We therefore need to change the permissions to include the &quot;setgid&quot; bit.
 
 {% highlight bash %}
 sudo chmod 2750 /home/dev/public_html
@@ -193,7 +194,7 @@ EOF"
 If everything has gone according to plan you should be able to open a browser and navigate to `localhost.magento-store.com` where you will see a directory listing as shown below.
 
 <figure>
-![Browser showing the directory listing when going to localhost.magento-store.com](/img/localhost.magento-store.com.jpg "Visiting localhost.magento-store.com for the first time.")
+![Browser showing the directory listing when going to localhost.magento-store.com](/img/localhost.magento-store.com.png "Visiting localhost.magento-store.com for the first time.")
 </figure>
 
 <h2 id="magento">Installing Magento.</h2>
@@ -277,7 +278,61 @@ rm -r magento-sample-data-1.6.1.0
 rm data.sql
 {% endhighlight %}
 
+When you run Magento for the first time you will be taken through the setup wizard. This needs to have permission to create files and directories where necessary. We therefore need to ensure that the correct write permission is set on the following.
+ 
+* The directory `var`
+* The file `var/.htaccess`
+* The directory `app/etc`
+* All directories under `var/package`
+* All directories under `media`
+
+Since the Apache process runs under the `www-data` group we can use the `chmod` command to give write permission to the this group.
+
 {% highlight bash %}
-chmod g+w var var/connect/ var/.htaccess app/etc
+chmod g+w var var/.htaccess app/etc
 chmod -R g+w var/package/ media
 {% endhighlight %}
+
+<h2 id="wizard">Running the Magento setup wizard.</h2>
+
+Now that everything is setup, open your browser and navigate to `localhost.magento-store.com` where you will start the setup wizard as show below. 
+
+<figure>
+![Browser showing the Magento setup wizard](/img/magento-setup-wizard-step-1.png "Starting the Magento setup wizard.")
+</figure>
+
+You need to accept the terms and conditions before you can continue. Once that's done fill in the localization settings with the values that are relevant to you.
+
+Next up is the database connection settings which should be filled in with the following information.
+
+* Database Type: *MySQL*
+* Host: *localhost*
+* Database Name: *magento*
+* User Name: *magento*
+* Password: *magento*
+* Tables Prefix: *Leave blank*
+
+On the same page you will also need to specify the web access options.
+
+* Base URL: *http://localhost.magento-store.com/*
+* Admin Path: *admin*
+* Select the *Use Web Server (Apache) Rewrites* option.
+
+The next step is where you create the Admin user. Fill in the required details and choose to let the software generate an encryption key for you. Proceed to the next step and you will have finished installing Magento. 
+
+At this point you can view your store at `http://localhost.magento-store.com`
+
+<figure>
+![Browser showing a new Magento store](/img/magento-store.png "Magento store.")
+</figure>
+
+To access the admin section of the store navigate to `http://localhost.magento-store.com/admin/` where you can login using the details set up during the installation.
+
+<figure>
+![Browser showing the Admin login page for a Magento store](/img/magento-store-admin.png "Magento store Admin login page.")
+</figure>
+
+##Conclusion.
+
+Hopefully you had no trouble in following this very lengthy post. I welcome any thoughts or opinions via the comments below.
+
diff --git a/_site_build/img/localhost.magento-store.com.jpg b/_site_build/img/localhost.magento-store.com.jpg
deleted file mode 100644
index c7e6387..0000000
--- a/_site_build/img/localhost.magento-store.com.jpg
+++ /dev/null
diff --git a/_site_build/img/localhost.magento-store.com.png b/_site_build/img/localhost.magento-store.com.png
new file mode 100644
index 0000000..872ccb8
--- /dev/null
+++ b/_site_build/img/localhost.magento-store.com.png
diff --git a/_site_build/img/magento-setup-wizard-step-1.png b/_site_build/img/magento-setup-wizard-step-1.png
new file mode 100644
index 0000000..bed2e9c
--- /dev/null
+++ b/_site_build/img/magento-setup-wizard-step-1.png
diff --git a/_site_build/img/magento-store-admin.png b/_site_build/img/magento-store-admin.png
new file mode 100644
index 0000000..e612538
--- /dev/null
+++ b/_site_build/img/magento-store-admin.png
diff --git a/_site_build/img/magento-store.png b/_site_build/img/magento-store.png
new file mode 100644
index 0000000..923d0bf
--- /dev/null
+++ b/_site_build/img/magento-store.png