Changes between Version 14 and Version 15 of InstallMacHardWay


Ignore:
Timestamp:
May 21, 2014 2:22:54 PM (8 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallMacHardWay

    v14 v15  
    11= Installing GSAS-II on Mac OS X =
    22
    3 Prerequisite: Before GSAS-II can be used on your computer, you must have Python installed with a number of [PythonPackages required Python packages] (see below.) You must also have the subversion (svn) package installed, which is standard on all Macs prior to Mountain Lion (10.8).
     3Prerequisite: Before GSAS-II can be used on your computer, you must have Python installed with a number of [PythonPackages required Python packages] (see below.) You must also have the subversion (svn) package installed, which is standard on all Macs prior to Mountain Lion (10.8), but can be loaded easily at least on 10.9.
    44
    5 GSAS-II has been tested by us on Intel (i386) Macs running 10.5 (Leopard), 10.6 (Snow Leopard) and 10.7 (Lion). We have heard from people running with 10.8 (Mountain Lion) but have not tested this ourselves yet. Getting GSAS-II to run on Macs running 10.4 or with a PPC (G4/G5) processor is likely possible, but will require considerable work since you would need to build python and its packages from source code and compile the GSAS-II Fortran code; this is not recommended except to the cognoscenti.
     5GSAS-II has been tested by us on Intel (i386) Macs running 10.5 (Leopard), 10.6 (Snow Leopard) and 10.7 (Lion). We have heard from people running with 10.8 (Mountain Lion) but have not tested this ourselves yet. Testing in 10.9 is in progress. Getting GSAS-II to run on Macs running 10.4 or with a PPC (G4/G5) processor is likely possible, but will require considerable work since you would need to build python and its packages from source code and compile the GSAS-II Fortran code; this is not recommended except to the cognoscenti.
     6
    67
    78=== Quick Install Instructions ===
    89
    9 1.   Install 32-bit Canopy Express from [https://www.enthought.com/store/ the Enthought web page]; (For the older 32-bit EPDfree, download [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the EPDfree 32-bit Mac installer] from web page https://www.enthought.com/repo/free/.) EPDfree requires administrator privileges to install; not sure about Canopy Express.
     101.   We are recommending use of the older 32-bit EPDfree Python distribution; download [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the EPDfree 32-bit Mac installer] from web page https://www.enthought.com/repo/free/.) Users on 10.8 and 10.9 may want to try the 64-bit Canopy Express from [https://www.enthought.com/downloads/ Enthought downloads], but expect some bugs. At present both EPDfree and Canopy Express require administrator privileges to install.
    1011
    11 2. (For 10.7 or earlier, skip this step.) Install Subversion, if running Mountain Lion (OS X 10.8) using http://www.wandisco.com/get/?f=subversion-binaries/1.7/Subversion-1.7.7_10.8.x.pkg or see below for distributions from Apple.
     122. (For 10.7 or earlier, skip this step.) Install Subversion, if running Mountain Lion (OS X 10.8), type svn in at a terminal window to get a prompt from OS X to download and install this directly from Apple.
    1213
    13143. Download file bootstrap.py file from ​https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt and move it to the location where you want GSAS-II to be installed.
     
    1920=== Python ===
    2021
    21 Python is a computer scripting language, which means that one must have the Python interpreter installed on your Mac to run a Python program. Macs do come with python installed, but not with all the [PythonPackages Python packages required by GSAS-II], so some Python software installation is required. '''Note that GSAS-II requires 32-bit Python''' because the !WxPython package, at present does not run in 64-bit on the Mac.
     22Python is a computer scripting language, which means that one must have the Python interpreter installed on your Mac to run a Python program. Macs do come with python installed, but not with all the [PythonPackages Python packages required by GSAS-II], so some Python software installation is required.  Note that GSAS-II has not been fully tested on the Mac with wxPython 2.9 which is the first Mac release to support 64-bit Python.
    2223
    23 We use the [http://www.enthought.com/products/epd.php Enthought Python Distribution] (EPD) package for our code development (Argonne has a site license) and have done a bit of testing with the newer product, Enthought Canopy. The free versions of these packages will run GSAS-II, with addition of one small package that is self-installed (see below). While OS X does come with installed versions of python, they are pretty old and do not contain all the packages GSAS-II needs, so adding the missing packages is probably not a good idea. Use of the Fink or !DarwinPorts versions of Python is also not the best choice -- the GUI and graphics will be shown in X-windows rather than in Mac style. Note that at this time, Python 2.7 is recommended for GSAS-II; version 2.6 of Python might work, 2.5 or earlier will not. GSAS-II does not yet support Python 3.0+.
     24We use the [http://www.enthought.com/products/epd.php Enthought Python Distribution] (EPD) package for our code development (Argonne has a site license) and have done just a bit of testing with the newer product, Enthought Canopy. The free versions of these packages will run GSAS-II, with addition of one small package that is self-installed (see below). While OS X does come with installed versions of Python, they are pretty old and do not contain all the packages GSAS-II needs, so adding the missing packages is probably not a good idea. Use of the Fink or !DarwinPorts versions of Python is also not the best choice -- the GUI and graphics will be shown in X-windows rather than in Mac style. Note that at this time, Python 2.7 is recommended and probably required for GSAS-II. GSAS-II does not yet support Python 3.0+.
    2425
    25  * The freely distributed [http://www.enthought.com/products/epd_free.php Enthought Canopy Express Python package] provides everything one needs to run GSAS-II, except the interface needed for OpenGL graphics ([http://pypi.python.org/pypi/PyOpenGL PyOpenGL]) which is distributed with GSAS-II; GSAS-II will attempt to install this package for you when first started. The subscription versions of Canopy do contain this package and also work fine. To get Canopy Express, use the "Get Canopy Express" button on http://www.enthought.com/products/epd_free.php (or use [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the older EPDfree 32-bit Mac installer] from web page https://www.enthought.com/repo/free/). This is a ~72Mb .dmg file that requires admin privs to install. Installation from the .dmg is easy: click on the file to open it (that might happen automatically when you download it). In that new volume, you will see the EPD_free.mpkg installer. Click on that to start the installation process. It works best to run this from the account where you will run GSAS-II and supply the name of the admin account and its password when requested, as this will cause your login shell setup file to be updated so that directory {{{/Library/Frameworks/Python.framework/Versions/Current/bin}}} is in your path. (This is done by adding lines like this to file ~/.profile:
     26 * The freely distributed [http://www.enthought.com/products/epd_free.php Enthought Canopy Express Python package] provides everything one needs to run GSAS-II, except the interface needed for OpenGL graphics ([http://pypi.python.org/pypi/PyOpenGL PyOpenGL]) which is distributed with GSAS-II; GSAS-II will attempt to install this package for you when first started. The paid subscription versions of Canopy do contain this package and also work fine. To get Canopy Express, use the "Get Canopy Express" button on http://www.enthought.com/products/epd_free.php (or use [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the older EPDfree 32-bit Mac installer] from web page https://www.enthought.com/repo/free/). This is a ~72Mb .dmg file that requires admin privs to install. Installation from the .dmg is easy: click on the file to open it (that might happen automatically when you download it). In that new volume, you will see the EPD_free.mpkg installer. Click on that to start the installation process. It works best to run this from the account where you will run GSAS-II and supply the name of the admin account and its password when requested, as this will cause your login shell setup file to be updated so that directory {{{/Library/Frameworks/Python.framework/Versions/Current/bin}}} is in your path. (This is done by adding lines like this to file ~/.profile:
    2627{{{
    2728# Setting PATH for EPD-7.2-2
     
    3435=== Subversion ===
    3536
    36 If you are running 10.7 (Lion) or earlier, skip this step. For 10.8 (Mountain Lion) you must install the subversion (svn) package. To do this install one of the following: Apple's Command Line Tools, or Apple's Xcode development environment, a 3rd party SVN package, or build from source code, see http://subversion.apache.org/download/. The Command Line Tools and Xcode can be downloaded from the Apple Developer's web site (https://developer.apple.com/) or can possibly be found on the OS X install DVD. A free 3rd party version of Subversion from WANdisco is here: http://www.wandisco.com/get/?f=subversion-binaries/1.7/Subversion-1.7.7_10.8.x.pkg.
     37If you are running 10.7 (Lion) or earlier, skip this step. For 10.8 (Mountain Lion) you must install the subversion (svn) package. To do this, type svn in a terminal window.
     38
     39Alternately, install one of the following: Apple's Command Line Tools, or Apple's Xcode development environment, a 3rd party SVN package, or build from source code, see http://subversion.apache.org/download/. The Command Line Tools and Xcode can be downloaded from the Apple Developer's web site (https://developer.apple.com/) or can possibly be found on the OS X install DVD. A free 3rd party version of Subversion from WANdisco is here: http://www.wandisco.com/get/?f=subversion-binaries/1.7/Subversion-1.7.7_10.8.x.pkg.
    3740
    3841=== Compiling Fortran Code ===