Changes between Version 20 and Version 21 of InstallMacHardWay


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

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallMacHardWay

    v20 v21  
    11= Installing GSAS-II on Mac OS X =
    22
    3 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.
     3**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.
     4
     5== Detailed installation information ==
    46
    57Prerequisite: 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.)
    68
    7 
    8 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.
     9GSAS-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.
    910
    1011[InstallNotesMavericks 10.9 Users, please see these notes] (probably appropriate for 10.8, too) before reading farther.
    1112
    12 === Quick Install Instructions ===
     13=== Overview for Step-by-step Installation ===
    1314
    14 **''Please try the new procedure [MacSingleStepInstaller here] before using the instructions below.''**
     15''Note that we are now recommending the  [MacSingleStepInstaller new procedure here] rather than the instructions below.''
    1516
    1617
    17 1.   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.
     181.   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.''**
     19 At present, both EPDfree and Canopy Express require administrator privileges to install.
    1820
    19 2. (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.
     212. (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.
    2022
    21233. 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.
     
    2426
    25275. Run GSAS-II with the GSASII.app file created by the bootstrap procedure.
     28
     29== Background Information on Installation ==
    2630
    2731=== Python ===
     
    5761Alternately, 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.
    5862
     63= GSAS-II Installation =
     64
     65We 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:
     66
     67 1.  Create a folder where you want to install GSAS-II.
     68
     69 2. Download file {{{bootstrap.py}}} file using this link:
     70
     71   https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt
     72
     73    or use this command: 
     74
     75   {{{curl https://subversion.xray.aps.anl.gov/pyGSAS/install/bootstrap.py > bootstrap.py}}}
     76
     77 3. Move the {{{bootstrap.py}}} file into the newly created GSAS-II folder
     78
     79 4. Run the bootstrap.py file by double-clicking on it or using the command {{{<path>python <path>bootstrap.py}}}
     80
     81 5. 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.
     82
     83Note 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.
     84
     85=== Updated GSAS-II.app ===
     86
     87As 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
     88{{{<path>python <path>makeMacApp.py}}})
     89
    5990=== Compiling Fortran Code ===
    6091
     
    72103If 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.
    73104
    74 = Installation =
    75 
    76 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:
    77 
    78  1.  Create a folder where you want to install GSAS-II.
    79 
    80  2. Download file {{{bootstrap.py}}} file using this link:
    81 
    82    https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt
    83 
    84     or use this command: 
    85 
    86    {{{curl https://subversion.xray.aps.anl.gov/pyGSAS/install/bootstrap.py > bootstrap.py}}}
    87 
    88  3. Move the {{{bootstrap.py}}} file into the newly created GSAS-II folder
    89 
    90  4. Run the bootstrap.py file by double-clicking on it or using the command {{{python bootstrap.py}}}
    91 
    92  5. 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.
    93 
    94 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.
    95 
    96 === Updated GSAS-II.app ===
    97 
    98 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).
    99 
    100105----
    101106