When running under Linux, Aptana Studio relies on the Firefox browser and there are a few additional steps to get it running.
Contents |
Standard Installation Instructions
Setup Aptana Studio
- Unzip Aptana Studio to /usr/local/aptana. Note: If you install Aptana Studio in a directory accessible only to the root user, you will need to run it as root to install updates.
- Install xulrunner 1.8.* (You can use Synaptic Package Manager to install this.)
- You can download Xulrunner 1.8 from https://developer.mozilla.org/En/XULRunner
- Once installed, make sure you $MOZILLA_FIVE_HOME is pointing to your xulrunner 1.8 dir
- You may also need to install compat-libstdc++ if you are running into a libstdc++.so.5: cannot open shared object file: No such file or directory when running xulrunner-bin from command line.
- Check your /usr/lib/xulrunner.... and note the full name of xulrunner. Is some case it is simply "xulrunner" while in other cases the name includes the version.
- Create a script that sets up the Aptana Studio environment, call it runAptana:
export MOZILLA_FIVE_HOME=/usr/lib/xulrunner /usr/local/aptana/AptanaStudio
- Make your script executable:
$ chmod +x runAptana
- Run the script
Alternatively, you may add the export statement to .bashrc or .bash_profile in your home directory and create an icon on your desktop pointing to the Aptana Studio executable. To set MOZILLA_FIVE_HOME for all users systemwide, add it to /etc/profile (on most systems).
Setup JRE 1.6.x
The JRE distributed in the varios Linux distros can vary and may require you download an alternative jre. We recommend jre1.6.
ls -l /usr/local/aptana/jre /usr/local/aptana/jre -> /usr/java/jre1.6.0_03
alternative you can export your JAVA_HOME system variable in your runAptana.
Other Common Problems
Running Aptana Studio on 64-bit Linux
The standalone version of Aptana Studio does not currently support 64-bit Linux so to use Studio on this type of distro, please install it as a plugin into a 64-bit version of Eclipse.
If your Eclipse installation is shared (installed via package manager into /usr/lib), give your login account root permissions on the /usr/lib/ecplise folder because running an update copies files to the /usr/lib/eclipse features and plugins directories. If you have Eclipse installed as a tarball into your home dir (or any writable area), you won't need to run as root.
Some users have found the following workaround helpful:
- Install 32-bit Sun Java (in Ubuntu: sudo aptitude install ia32-libs ia32-sun-java6-bin)
- Select as the Java version to be used (again in Ubuntu: sudo update-alternatives --config java and choose the 32-bit version)
Firefox already has Firebug installed
The first time you launch a debug session in Aptana Studio, Firefox is scanned to see if the plugin required is installed. The Aptana plugin is based on Firebug, and an existing installed version of Firebug will create a conflict, so uninstall Firebug if you previously installed it.
Firefox must be shutdown after the uninstall since the uninstall isn't completed until Firefox restarts.
Fedora
You must use Sun's JRE rather than the GNU JRE in order for several Aptana features to work correctly.
Ubuntu Intrepid Ibex
As of this release, Ubuntu no longer includes Firefox 2 in the distribution or in it package manager. Instead you need to install XULRunner and create a startup script called, say, runAptana.sh in /usr/local/aptana as described in the Setup section of this page.
To install XULRunner:
sudo apt-get install xulrunner
Error: "The bundle could not be resolved. Reason: Missing Constraint" (Fedora Core 8, IcedTea JVM)
Change your JRE; Fedora Core 8 ships with a beta version 1.7 of Java. To fix, create a logical link to an earlier version of Java (preferably JRE 1.6 from Sun).
ls -l /usr/local/aptana/jre /usr/local/aptana/jre -> /usr/java/jre1.6.0_03
Getting help
If you need further help installing Aptana Studio on your Linux machine, please file a request in ourRelated Topics