Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Configuring Eclipse to Edit your eclipse.org Website
Phoenix Test Runtime Environment for Windows XP Setup
This document takes you through the steps that you need to follow to configure your workstation to run an Apache runtime environment similar to the environment running the [eclipse.org] website. This environment is similar to the production environment but is not exact. It includes a minimally configured Apache web server along with PHP 4.3.4. This environment does not include MySQL or any other services.
Download and Installation
Need to include directions for installing and configuring Apache+PHP 4.3.4
ll the steps in this document assume that the test runtime environment is installed in the root of the "C:" drive of your workstation. Unzip this file into the root (everything is packed tidily into one directory.
Configuration
This document assumes that you have a project named "www" containing the website contents in your Eclipse workspace.
Step 1: Configure Apache. Open the
"http.conf" file (located in
c:\phoenix_runtime\apache\conf\http.conf
). Scroll to the
bottom and locate the following section:
<VirtualHost local.phoenix.eclipse.org:80> DocumentRoot <em>c:/eclipse311/workspace/www</em> ServerName local.phoenix.eclipse.org:80 ErrorLog logs/phoenix CustomLog logs/phoenix common </VirtualHost>
Change the "DocumentRoot" entry to point to the location
of your www directory. The above entry assumes that the workspace is
located in c:/eclipse311/workspace
. If you used the
default workspace when you first started Eclipse, you'd change this
value to c:\Documents and Settings\Wayne Beaton\workspace\www
(that is, assuming your name is "Wayne Beaton".
It may look something like the following:
<VirtualHost local.phoenix.eclipse.org:80> DocumentRoot <em>c:\Documents and Settings\Wayne Beaton\workspace\www</em> ServerName local.phoenix.eclipse.org:80 ErrorLog logs/phoenix CustomLog logs/phoenix common </VirtualHost>
Save the file.
Step 2: Configure the host. The previous setting
configures a virtual host on your workstation named
"local.phoenix.eclipse.org"; in this step, you need to configure
your workstation to know about the host. Open your hosts file using your
favourite text editor. This file is likely located at
c:\windows\system32\drivers\etc\hosts
. Add the following
line to this file:
127.0.0.1 local.phoenix.eclipse.org
Save the file.
This line tells Windows that when a browser makes a request to [local.phoenix.eclipse.org], that the local machine will handle it. Your configuration of Apache has ensured that all requests coming into that address on the default port (80) will be handled by Apache using documents found in your workspace.
Step 3: Start Apache. You can start Apache from
the command line using the apache_start.exe
. Stop Apache
by typing Ctrl-C at the command prompt that started Apache. You can
also install Apache as a Windows service which will make it start
automatically when the workstation starts up.