View Source

PREREQUISITES

Before you begin, you must have done the following:
{panel}
\\
* Installed and configured XAMPP following the instructions give in either:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [Install and configure XAMPP 1.7.1.|Install and configure XAMPP 1.7.1] or [Install and configure XAMPP 1.7.2.|Install and configure XAMPP 1.7.2]\\
\\
* linkd.exe has been installed on your workstation.&nbsp;&nbsp;If you haven't already done so, you can [download linkd.exe|Use SymLinks with XAMPP^linkd.exe] now.\\
\\
{panel}

ASSUMPTIONS

{panel}
\\
* This is an example of how the change apache's default *DocumentRoot* to a user defined *DocumentRoot*.  This example will demonstrate how to change the default *DocumentRoot* to a user defined *DocumentRoot* of *c:/var/www/html*.\\
\\
Follow this example to change the *DocumentRoot*, replacing *c:/var/www/html* with a directory path of your choosing.\\
\\
{panel}

1. Create the new directories

{panel}
\\
Using *Windows Explorer*, create the directories for *c:\var\www\html*.\\
\\
{panel}

2. Change apache's DocumentRoot

{panel}
\\
Edit *c:\xampp\apache\conf\httpd.conf* and change:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;From:\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *DocumentRoot "C:/xampp/htdocs"*\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;To:\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *DocumentRoot "C:/var/www/html"*\\
\\
and change:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;From:\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *<Directory "C:/xampp/htdocs">*\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;To:\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *<Directory "C:/var/www/html">*\\
\\
Save the changes.\\
\\
{panel}

3. Create SymLinks

{panel}
\\
Create the following SymLinks in the *c:\var\www\html directory*.&nbsp;&nbsp;This can be done by opening a CMD window, changing the working direcory to  *c:\var\www\html*, and executing the following command lines:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *linkd xampp c:\xampp\htdocs\xampp*\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *linkd phpMyAdmin c:\xampp\phpMyAdmin*\\
\\
and if you have *drupal* installed, create the addition link:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *linkd drupal c:\drupal-6.13*\\
\\
adjusting the drupal version number as needed.\\
\\
{panel}

4. Verify the installation

{panel}
\\
*Restart apache*, open a web browser and go to the following URL’s:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; http://localhost/xampp \\
and\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; http://localhost/phpMyAdmin \\
and if drupal is installed\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; http://localhost/drupal \\
\\
{panel}
h2.{color:red}*A NOTE OF IMPORTANCE*{color}
{indent:1}
{panel}
\\
* What to do when you encounter the following error during item 4 above:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; !badSymLink.jpg! \\
\\
The above error indicates the *installed version of XAMPP does not support SymLinks*.\\
\\
To reconfigure XAMPP do the following:\\
\\
* Remove the SymLinks that were created in 3. above..&nbsp;&nbsp;This can be done by opening a CMD window, changing the working direcory to  *c:\var\www\html*, and executing the following command lines:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *linkd xampp /D*\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *linkd phpMyAdmin /D*\\
\\
&nbsp;&nbsp; and if you have *drupal* installed, remove the addition link:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *linkd drupal /D*\\
\\
* Open *Windows Explorer* and do the following:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *copy the xampp directory from the c:\xampp\htdocs directory to the c:\var\www\html directory*.\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *copy the phpMyAdmin directory from the c:\xampp directory to the c:\var\www\html directory*.\\
\\
&nbsp;&nbsp; and if you have *drupal* installed:\\
\\
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; *copy the drupal-6.13 directory for c:\ to the c:\var\www\html directory and rename the newly created drupal-6.13 directory to drupal*.\\
\\
{panel}