Jaxer Installation Guide (Linux Standalone)

This page discusses the known supported Linux platforms for Jaxer. This page also includes installation instructions and special procedures for certain platforms.

Known Supported Platforms

This section lists the Linux platforms that Jaxer has successfully been confirmed to run on. If you have successfully run Jaxer on a Linux platform not listed here, please contact us so we can add it to the list. Be sure to include any special instructions that may be required to get the installation up and running:

  • CentOS 5.0
  • Ubuntu 7.04, 7.10
  • Fedora 8 - see the troubleshooting section below for possible post-install changes

Installing a Standalone Jaxer Server

These instructions describe how to get the sand-boxed version of Linux up and running. The sand-boxed install includes its own Apache instance, which should not interfere with an existing Apache install. You can download the Linux version of Jaxer from the Jaxer download page.

Quick Instructions

mv Jaxer_package_withApache.zip /opt
cd /opt
unzip Jaxer_package_withApache.zip
chmod -R a+x AptanaJaxer

In /opt/AptanaJaxer/Apache22/conf/httpd.conf, set "ServerName localhost" and add "User <user-name>" where <user-name> is the user under which you want Apache to run.

Detailed Instructions

  1. Download the Jaxer_package_withApache.zip file from the Jaxer download page to the host where Jaxer will be installed.
  2. Move this file to /opt and move to this directory on the command-line.
  3. Unzip the file using "unzip Jaxer_package_withApache.zip" on the command-line. This will create an /opt/AptanaJaxer directory.
  4. Open up access privileges on AptanaJaxer using 'chmod -R a+x AptanaJaxer'.
  5. Edit /opt/AptanaJaxer/Apache22/conf/httpd.conf:
    • Find the line that looks like "#ServerName www.example.com:80"
    • Remove the leading "#" and change "www.example.com:80" to "localhost". The line should look like "ServerName localhost"
    • Move to the end of the file and add "User <user-name>" where <user-name> should be replaced with the user you wish Apache to run under. It is advised that you do not use root as the user name
    • Save the file

Configuring Jaxer for Outside Access

By default, the Jaxer Standalone installation only allows connections from 127.0.0.1 and localhost. The instructions below describe the configuration changes needed to open up access to other machines, if so desired.

  • Edit /opt/AptanaJaxer/jaxer/confs/jaxer-linux.httpd.conf
  • Change all instances of "Deny all" to "Allow all" except for the last section for /jaxer-include/ and save the file. Note that jaxer-include contains files that may be loaded by your pages on the server. Since these files may contain sensitive information, the directory should not be accessible outside of the server.
  • Edit /opt/AptanaJaxer/jaxer/framework/config.js
  • Find the line near the bottom containing "REWRITE_RELATIVE_URL". Uncomment this line, change the URL to "http://localhost:8081" and save the file. Note that the port needs to match the port Apache is using. The port may be omitted entirely if Apache is using port 80.
  • You will need to stop and start Jaxer to activate these changes if Jaxer is already running.

Running Jaxer

  • Move into /opt/AptanaJaxer/scripts and type "./start.sh" on the command-line
  • Jaxer should be up and running. The easiest way to see Jaxer running is by navigating to "http://localhost:8081/aptana/" in your favorite browser. You should see something like the following.

Validating Your Jaxer Installation

To validate that Jaxer is correctly installed on your system, click the Server Diagnostics link in the sidebar to run the diagnostics application. If everything is correctly installed and configured, your the page should look like the one below:

Review the Installed Content

Click the Samples and Tools link in the sidebar to view our bundled sample applications. The source code for the sample applications is shipped with the system and is located in the /opt/AptanaJaxer/jaxer/aptana folder. Use these examples to learn how to put together your own Jaxer applications.

Troublehshooting

This section gives tips for common troubleshooting issues.

CentOS 5.1 Issues

On CentOS 5.1 if you get a stream of "Jaxer creation failed" messages when running start.sh from the command line, then you may need to install the sqlite and firefox-devel packages. You can do that with the following commands:

  • yum install sqlite
  • yum install firefox-devel

Fedora 8 Issues

On Fedora 8 if you get an error message about a missing libexpat.so.1 library, then you will need to create a symlink where libexpat.so.1 points to libexpat.so.0.

Community Involvement

We've been working with volunteer beta testers within the Jaxer community to add support for Linux. Since the various Linux platforms have so many nuances, some platforms could still have some issues. We invite you to participate in the Jaxer forums to lets us know how we can improve Linux support and the Linux installation process. You can help us determine which platforms to focus on next by placing your vote on the forums: http://forums.aptana.com/viewtopic.php?t=4844. Likewise, if you have Jaxer running on a distro not listed on this page, let us know so we can add it to the list.