Context Navigation

Changes between Version 20 and Version 21 of InstallMacHardWay

Timestamp:: Mar 28, 2016 12:29:35 PM (7 years ago)
Author:: toby
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

InstallMacHardWay

-                      v20
+                      v21
 = Installing GSAS-II on Mac OS X =
+A new single-step installer has been developed for GSAS-II on Macs. Please try this first [MacSingleStepInstaller using the instructions here] and report any problems.
+**Try this First:** A new single-step installer has been developed for GSAS-II on Macs. Please try this first [MacSingleStepInstaller using the instructions here] and report any problems.
+== Detailed installation information ==
 Prerequisite: Before GSAS-II can be used on your computer, you must have Python 2.7.x installed with a number of [PythonPackages required Python packages] (see below.)
+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. Testing in 10.9 (Mavericks) 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.
+GSAS-II has been tested by us on Intel (i386) Macs running 10.5-10.11. 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.
 [InstallNotesMavericks 10.9 Users, please see these notes] (probably appropriate for 10.8, too) before reading farther.
 === Quick Install Instructions ===
+=== Overview for Step-by-step Installation ===
+**''Please try the new procedure [MacSingleStepInstaller here] before using the instructions below.''**
+''Note that we are now recommending the  [MacSingleStepInstaller new procedure here] rather than the instructions below.''
+.   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.
+.   We have made extensive 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/.) Alternates are the 64-bit Canopy Express from [https://www.enthought.com/downloads/ Enthought downloads] and [https://www.continuum.io/downloads Anaconda from Continuum]. Be sure to download Python 2.7. **''GSAS-II does not yet support Python 3.x.''**
+ At present, both EPDfree and Canopy Express require administrator privileges to install.
 . (For 10.7 or earlier, skip this step.) Install Subversion, if running Mountain Lion (OS X 10.8) or Mavericks (OS X 10.9), type svn in at a terminal window to get a prompt from OS X to download and install this directly from Apple.
+. (For 10.7 or earlier, skip this step.) Install Subversion, if running Mountain Lion (OS X 10.8+) or later type svn in at a terminal window to get a prompt from OS X to download and install this directly from Apple.
 . 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.
 …
 . Run GSAS-II with the GSASII.app file created by the bootstrap procedure.
+== Background Information on Installation ==
 === Python ===
 …
 Alternately, 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.
+= GSAS-II Installation =
+We prefer that GSAS-II be installed using subversion so that it is easy to get updates (which are frequent). Fortunately, with OS X 10.5, 10.6 or 10.7, Macs come with subversion installed. (10.8 see above.) This procedure loads GSAS-II using subversion:
+.  Create a folder where you want to install GSAS-II.
+. Download file {{{bootstrap.py}}} file using this link:
+   https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt
+    or use this command:
+   {{{curl https://subversion.xray.aps.anl.gov/pyGSAS/install/bootstrap.py > bootstrap.py}}}
+. Move the {{{bootstrap.py}}} file into the newly created GSAS-II folder
+. Run the bootstrap.py file by double-clicking on it or using the command {{{<path>python <path>bootstrap.py}}}
+. This creates a GSAS-II.app file that can be used to start GSAS-II either by clicking on the app or by dragging a file onto the app. Note that the app file can be dragged to the doc, but it cannot be moved to another folder. Instead, create an alias and move the alias where desired.
+Note that GSAS-II can be updated at any time by reusing the {{{bootstrap.py}}} file. This will download any newly created and modify any updated program files.
+=== Updated GSAS-II.app ===
+As of GSAS-II version 983 (July 7, 2013), a new app builder is used. This can be rerun using the supplied ``makeMacApp.py`` file manually (be sure to use the Python needed for GSAS-II with a command like
+{{{<path>python <path>makeMacApp.py}}})
 === Compiling Fortran Code ===
 …
 If you need to change any options, type "{{{scons help}}}" to see a list of the possible command-line arguments and the values for the options. For testing, help can be used with command-line options to see how they will change the variables.
-= Installation =
-We prefer that GSAS-II be installed using subversion so that it is easy to get updates (which are frequent). Fortunately, with OS X 10.5, 10.6 or 10.7, Macs come with subversion installed. (10.8 see above.) This procedure loads GSAS-II using subversion:
-.  Create a folder where you want to install GSAS-II.
-. Download file {{{bootstrap.py}}} file using this link:
-   https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt
-    or use this command:
-   {{{curl https://subversion.xray.aps.anl.gov/pyGSAS/install/bootstrap.py > bootstrap.py}}}
-. Move the {{{bootstrap.py}}} file into the newly created GSAS-II folder
-. Run the bootstrap.py file by double-clicking on it or using the command {{{python bootstrap.py}}}
-. This creates a GSAS-II.app file that can be used to start GSAS-II either by clicking on the app or by dragging a file onto the app. Note that the app file can be dragged to the doc, but it cannot be moved to another folder. Instead, create an alias and move the alias where desired.
-Note that GSAS-II can be updated at any time by reusing the {{{bootstrap.py}}} file. This will download any newly created and modify any updated program files.
-=== Updated GSAS-II.app ===
-As of GSAS-II version 983 (July 7, 2013), a new app builder is used. This causes the name of the program to be listed as GSAS-II in the Mac menus and has better drag and drop support. If you downloaded a prior version of [https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt bootstrap.py], update this file or else run the new makeMacApp.py file manually (be sure to use the Python needed for GSAS-II).
 ----