| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html" charset="iso-8859-1"/> |
| <title>Installing Photran</title> |
| <link rel="stylesheet" type="text/css" href="../help.css"/> |
| </head> |
| <body> |
| <div><h1> System Requirements |
| </h1><p>To install Photran 6.0... |
| You must have |
| <b>Eclipse 3.6 (Helios) |
| </b> installed. |
| </p><ol><li>You should have the |
| <b>C/C++ Development Tools (CDT) 7.0 |
| </b> installed. If you do not... |
| <ol><li>If you downloaded Eclipse from eclipse.org |
| <b>and |
| </b> you will be following the instructions below for "Installing on a Machine With Internet Access," then CDT should be installed automatically when you install Photran. |
| </li><li>Otherwise, CDT probably |
| <i>will not |
| </i> be installed automatically. You will need to install CDT manually. Follow the instructions below for "Installing on a Machine Without Internet Access." You should also follow these instructions if you did not download Eclipse from eclipse.org (e.g., if you installed it from a Linux distribution like Ubuntu). |
| </li></ol></li><li>Eclipse must be running on a |
| <b>Java 1.5 or later Java Virtual Machine (JVM). |
| </b> To get reasonable performance, we recommend Sun's JVM |
| <a href="http://java.com/en/download/manual.jsp">http://java.com/en/download/manual.jsp</a> or IBM's J9 |
| <a href="http://wiki.eclipse.org/index.php/J9">http://wiki.eclipse.org/index.php/J9</a>. OpenJDK (the default JVM on newer versions Fedora Linux) also works well, although GNU Classpath (the default JVM on older versions of Fedora) is generally too slow to be useful. |
| </li><li>If you want to compile and build Fortran applications, you must have a |
| <b>make |
| </b>program (such as GNU Make) and a |
| <b>Fortran compiler |
| </b> (such as gfortran, the GNU Fortran compiler) in your system path. Many Linux/Unix systems include these; details on installing them in Windows and Mac are below. |
| </li></ol><h1> Installation Procedure |
| </h1><h2>Installing on a Machine With Internet Access |
| </h2><p>To install Photran, start Eclipse, then...<br> |
| </p><ol><li>Click on Help > Install New Software... |
| </li><li>Click on the "Add..." button |
| </li><li>In the Location field, type |
| <b>http://download.eclipse.org/tools/ptp/releases/helios |
| </b></li><li>Click OK to close the Add Site dialog. This will return you to the Install dialog. |
| </li><li>Expand "Fortran Development Tools (Photran)" and check the box next to "Photran End-User Runtime" |
| </li><li>If you are running Linux and have the Intel Fortran Compiler installed, or if you are on a Macintosh and have the IBM XL Fortran compiler installed, expand "Fortran Compiler Support" and select the appropriate compiler. |
| <i>Note that you |
| <b>cannot |
| </b> install Intel Fortran compiler support unless you are running Linux! |
| </i></li><li>Click on the "Next" button |
| </li><li>If you get an error message, see below for troubleshooting information. |
| </li><li>Click the Finish button and agree to the license to complete the installation. |
| </li></ol><p><br> |
| </p><h2>Installing on a Machine Without Internet Access |
| </h2><p>You will the following files: |
| </p><ol><li>If you do not have CDT installed, you will need to download the latest 7.0.x "CDT master update archive" from |
| <a href="http://download.eclipse.org/tools/cdt/releases/helios/">http://download.eclipse.org/tools/cdt/releases/helios/ |
| </a>). This should be a file named |
| <b>cdt-master-7.0.x.zip |
| </b> (for some value of |
| <i>x |
| </i>) |
| </li><li>To install Photran, you will need the latest PTP update site archive from |
| <a href="http://wiki.eclipse.org/PTP/builds/4.0.0">http://wiki.eclipse.org/PTP/builds/4.0.0 |
| </a>). This should be a file named |
| <b>ptp-master-4.0.0-I2010xxxxxxxx.zip |
| </b></li></ol><p>If you do not have CDT installed, start Eclipse, then...<br> |
| </p><ol><li>Click on Help > Install New Software... |
| </li><li>Click on the "Add..." button |
| </li><li>Click on the "Archive..." button |
| </li><li>Point it to the file |
| <i>cdt-master-7.0.x.zip |
| </i></li><li>Click OK to close the Add Site dialog. This will return you to the Install dialog. |
| </li><li>Expand "CDT Main Features" and check the box next to "Eclipse C/C++ Development Tools" |
| </li><li>Click on the "Next" button |
| </li><li>Click the Finish button and agree to the license to complete the installation. |
| </li><li>After CDT is installed, you will be asked to restart Eclipse. You may then proceed to install Photran. |
| </li></ol><p>To install Photran, start Eclipse, then...<br> |
| </p><ol><li>Click on Help > Install New Software... |
| </li><li>Click on the "Add..." button |
| </li><li>Click on the "Archive..." button |
| </li><li>Point it to the file |
| <i>ptp-master-4.0.0-I2010xxxxxxxx.zip |
| </i></li><li>Click OK to close the Add Site dialog. This will return you to the Install dialog. |
| </li><li>Expand "Fortran Development Tools (Photran)" and check the boxes next to "Photran End-User Runtime" |
| <b>and |
| </b> "Rephraser Engine End-User Runtime" (the latter is a supporting component) |
| </li><li>If you are running Linux and have the Intel Fortran Compiler installed, or if you are on a Macintosh and have the IBM XL Fortran compiler installed, expand "Fortran Compiler Support" and select the appropriate compiler. |
| <i>Note that you |
| <b>cannot |
| </b> install Intel Fortran compiler support unless you are running Linux! |
| </i></li><li>Click on the "Next" button |
| </li><li>If you get an error message, see below for troubleshooting information. |
| </li><li>Click the Finish button and agree to the license to complete the installation. |
| </li></ol><p><br> |
| </p><h2>Troubleshooting |
| </h2><blockquote>Eclipse's installer gives notoriously cryptic error messages, which, unfortunately, are out of Photran's control. Some of the more common ones are below. If you run into a different error message and cannot resolve it, please ask for help on the |
| <a href="http://www.eclipse.org/photran/mailinglists.php">Photran mailing list |
| </a>. |
| </blockquote><p><br> |
| </p><blockquote><b>Problem: |
| </b> You receive the following error message during installation. |
| </blockquote><blockquote><blockquote>Cannot complete the install because one or more required items could not be found. |
| </blockquote></blockquote><blockquote><blockquote>Missing requirement: 125xxxxxxxxxx 0.0.0.125xxxxxxxxxx requires 'org.eclipse.photran.intel.feature.group |
| <a href="5.0.0.xxxx">5.0.0.xxxx</a>' but it could not be found |
| </blockquote></blockquote><blockquote><b>Solution: |
| </b> You are attempting to install support for the Intel Fortran compiler, but you are not running Linux. Go back in the installation wizard, and |
| <i>uncheck |
| </i> "Linux Intel(R) Fortran Compiler Support." |
| </blockquote><p><br> |
| </p><blockquote><b>Problem: |
| </b> You receive the following error message during installation. |
| </blockquote><blockquote><blockquote>Cannot complete the install because one or more required items could not be found. |
| </blockquote></blockquote><blockquote><blockquote> Software being installed: Photran End-User Runtime 6.0.x.xxxxxxxxxxxx (org.eclipse.photran.feature.group 6.0.x.xxxxxxxxxxxx) |
| </blockquote></blockquote><blockquote><blockquote> Missing requirement: Photran VPG CDT Interface Plug-in 6.0.x.xxxxxxxxxxxx (org.eclipse.photran.cdtinterface.vpg 6.0.x.xxxxxxxxxxxx) requires 'bundle org.eclipse.cdt.core 0.0.0' but it could not be found |
| </blockquote></blockquote><blockquote><blockquote> Cannot satisfy dependency: |
| </blockquote></blockquote><blockquote><blockquote> From: Photran End-User Runtime 6.0.x.xxxxxxxxxxxx (org.eclipse.photran.feature.group 6.0.x.xxxxxxxxxxxx) |
| </blockquote></blockquote><blockquote><blockquote> To: org.eclipse.photran.cdtinterface.vpg |
| <a href="6.0.x.xxxxxxxxxxxx">6.0.x.xxxxxxxxxxxx</a></blockquote></blockquote><blockquote><b>Solution: |
| </b> You do not have CDT 7.0 installed, and it couldn't be downloaded and installed automatically. Try installing CDT 7.0 first, then retry installing Photran. |
| </blockquote><h1> Additional Instructions for Windows Users |
| </h1><p>To compile and run Fortran programs in Photran, you will need to have a Fortran compiler and make utility installed. |
| <a href="http://gcc.gnu.org/fortran/">gfortran |
| </a> and |
| <a href="http://www.gnu.org/make">GNU Make |
| </a> are commonly used (and free). Most Linux/Unix distributions include these. Under Windows, you will need to install Cygwin |
| <a href="http://www.cygwin.com/">http://www.cygwin.com/</a> (which optionally includes gfortran and GNU Make) or MinGW |
| <a href="http://www.mingw.org/">http://www.mingw.org/</a> and put them on your Windows PATH. |
| </p><h2>Instructions for Cygwin |
| </h2><ol><li>Install |
| <a href="http://www.cygwin.com/">Cygwin |
| </a>; the defaults are mostly OK, but you will need to explicitly tell it to include the "Devel" packages (at least gcc4-fortran, gdb, and make) when the installer asks you to select what packages to install. (If gcc4-fortran is not listed under the "Devel" packages, you may have chosen a bad mirror; restart the Cygwin installation, and choose a different mirror instead. Georgia Tech's mirror at gtlib.gatech.edu is generally quite fast and reliable, for example.) |
| </li><li>Add the Cygwin directories to your Windows PATH. Under Windows XP, the process is as follows: |
| <ol><li>Make sure you are logged in under an administrator account. |
| </li><li>Open the Control Panel. |
| </li><li>Double-click the System icon. |
| </li><li>Switch to the Advanced tab. |
| </li><li>Click the Environment Variables button. |
| </li><li>Under System Variables, find the variable "Path" in the list, and click on it. |
| </li><li>Click Edit. |
| </li><li>At the end of the "Variable Value" text, add <pre>;C:\Cygwin\bin;C:\Cygwin\usr\bin;C:\Cygwin\usr\local\bin;C:\Cygwin\lib;C:\Cygwin\usr\lib</pre> |
| </li><li>Click OK, click OK, click OK, and close the Control Panel. |
| </li><li>Close and re-open Photran. Windows should now search C:\Cygwin\bin, C:\Cygwin\usr\bin, etc. when it's looking for executables (including make.exe, gcc.exe, and gfortran.exe). |
| </li></ol></li></ol><h1> Additional Instructions for Mac OS X Users |
| </h1><p>If you install gfortran on Mac OS X, it may be installed in /usr/local/bin, which is not (by default) on the PATH. If you are launching Eclipse from a Terminal, the PATH can be set by modifying /etc/paths. However, if you are launching Eclipse from the Finder (by double clicking on it) or the Dock, then the PATH is not obtained from the shell or /etc/paths. Instead, it's obtained from ~/.MacOSX/environment.plist. The format of the environment.plist file is as follows (change the path appropriately). |
| <i>If you create or edit this file, you will need to log out (or reboot) before the changes will take effect. |
| </i><pre><?xml version="1.0" encoding="UTF-8"?> |
| <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> |
| <plist version="1.0"> |
| <dict> |
| <key>PATH</key> |
| <string>/usr/local/mpi/bin:/usr/local/bin:/bin:/sbin:/usr/bin:/usr/sbin:/sbin:/usr/sbin:/Developer/Tools:/usr/texbin:/Users/greg/bin</string> |
| </dict> |
| </plist> |
| </pre> |
| </p></div> |
| </body> |
| </html> |