If you're using the pre-configured Jaxer Package, you're all set. On Windows, just double-click the "Aptana Jaxer\StartServers.bat" file to start the servers, and browse to http://localhost:8081/aptana/ or http://localhost:8081/your_page. On Mac OS X, just double-click the Jaxer launcher. You can see what these will look like for Windows and for for Mac OS X.

Step 1. Getting the Jaxer Distro

The Jaxer Zip installer is available from the download page at 'http://www.aptana.com/jaxer/download'

Download your Platform of choice and move to the next step.

Step 2. Installing the Jaxer files

Once you have unpacked the distro into a known location, the next step is to pull out the contained jaxer folder and place it in the folder you'd like it to be run from.

Step 3. Apache Configuration

To have Jaxer work with an existing Apache 2.x installation, you'll need to add a section to your Apache's httpd.conf file. You can simply add this at the bottom of that file: The httpd.conf file is usually found in the conf folder of your Apache install. <Directory "PATH_TO_JAXER_FOLDER/jaxer/aptana"> Order Deny,Allow Deny from all Allow from 127.0.0.1 </Directory> Alias /aptana PATH_TO_JAXER_FOLDER/jaxer/aptana <Directory "PATH_TO_JAXER_FOLDER/jaxer/framework"> Deny from all <Files clientFramework_compressed.js> Allow from 127.0.0.1 </Files> </Directory> Alias /jaxer/framework/clientFramework_compressed.js PATH_TO_JAXER_FOLDER/jaxer/framework/clientFramework_compressed.js LoadModule jaxer_module "PATH_TO_JAXER_FOLDER/jaxer/connectors/mod_jaxer.so" <IfModule jaxer_module> DefaultInitEnv "SystemRoot" "PATH_TO_WINDOWS_FOLDER" # Configures the (only) one worker in the form of # JaxerWorker <workerName> <JaxerServerHost> <JaxerServerPort> JaxerWorker localManagerWorker 127.0.0.1 4327 # Configuration for the connection pool used communicating with Jaxer Manager # # Timeout (secs) before giving up on obtaining a connection # Default is 5 # WaitConnectionTimeOutSec 5 # # Size of the connection pool. # Defaults: MinConnectionPoolSize = 10% of thread pool size (but no less than 1) # MaxConnectionPoolSize = thread pool size. This cannot be to more than # the thread pool size # MaxConnectionPoolSize 1 # MinConnectionPoolSize 1 # Route all requests with jaxer-server in their path to Jaxer, in particular callbacks <Location "/jaxer-server"> SetHandler JAXER Order Deny,Allow Deny from all Allow from 127.0.0.1 </Location> <Directory "PATH_TO_JAXER_FOLDER/jaxer/aptana"> JaxerFilter localManagerWorker .html JaxerFilter localManagerWorker .xhtml JaxerFilter localManagerWorker .htm JaxerFilter localManagerWorker .php Order Deny,Allow Deny from all Allow from 127.0.0.1 </Directory> # Place any files that are to be served only to Jaxer (usually to be included), # and that are not to be processed by Jaxer before they're served to Jaxer, # in a folder structure that has /jaxer-include/ somewhere in the hierarchy above them. <LocationMatch "/jaxer-include/"> # prevents processing by Jaxer before it's served back to Jaxer JaxerPassThrough Order Deny,Allow Deny from all Allow from 127.0.0.1 </LocationMatch> </IfModule>

The "PATH_TO_JAXER_FOLDER" token should be replaced with the folder that will contains the jaxer files which you copied in step 2.

The "PATH_TO_WINDOWS_FOLDER" token should be replaced with the location of your windows folder, usually "c:\windows"

The JaxerServerPort parameter as shown on line 25, should be set to the same value as appears in the bat file 'StartJaxer.bat' found in the Jaxer folder. If the port is already in use you can change this value to reflect a sensible setting for your environment.

Step 4. Creating the expected folder locations

For Jaxer to run correctly a few folders need to be manually created.

• data : this folder will contain the automatically created Sqlite database tables
• logs : this folder will contain the log files created by Jaxer for debugging.

OK that should be the installation complete, we can now start the servers.

Step 5. Starting The Jaxer Server

To start jaxer you first need to start (or restart) Apache so that it can read the changes to the httpd.conf file that we just made. Once you have restarted the web server, you can start the jaxer server by double clicking on the 'StartJaxer.bat' file, which can be found in the 'jaxer' folder.

If everything has gone according to plan you should now see a dos console window like below.

OK the acid test, to run some content through jaxer. Open your browser of choice and got to the base url of your webserver, in my case http://localhost/ works fine. Do you see the page you expected, GOOD, that means Apache has started and is serving pages.

Now point your browser to the 'aptana' folder which we configured to be off documentRoot in httpd.conf. you should see a screen that looks a lot like the one below.

Welcome to Jaxer, and the brave new world of End to End Ajax.

Step 6. Checking the Installation was a success

Jaxer ships with a set of diagnostic tests, now would be a good time to run them to make sure that your installation is in good shape.

To Run the tests simply click on the link 'Server Diagnostics' on the sidebar, and the basic test suite will run.

All the tests should pass, the fourth test will show an exclamation point as we haven't set up an override config file, but this is an optional configuration step, and can be ignored for the time being.

Next you'll probably want to run the unit tests we ship for a deeper validation that everything is up and running the way we expect

To run these tests click on the link to the 'Component Diagnostics' and you should see a screen like the one below, Click the 'Run All' button to run the testsuite (FYI - these tests can take a few seconds to complete)

Once these tests have completed, your Jaxer instance is configured and ready for use.

Next steps

Now that you have your Jaxer instance you may want to make further adjustments to the httpd.conf file. In this example text we only set up jaxer to process content from the 'jaxer/aptana' folder

To add another folder for use with jaxer simply place a folder directive like the one shown below in the <ifModule jaxer_module> and change the 'PATH_TO_MY_FOLDER' token to your absolute folder location.

<Directory "PATH_TO_MY_FOLDER"> JaxerFilter localManagerWorker .html JaxerFilter localManagerWorker .xhtml JaxerFilter localManagerWorker .htm JaxerFilter localManagerWorker .php Order Deny,Allow Deny from all Allow from 127.0.0.1 </Directory>