Changes between Version 20 and Version 21 of MacSingleStepInstaller


Ignore:
Timestamp:
May 1, 2019 2:50:29 PM (2 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • MacSingleStepInstaller

    v20 v21  
    11== Installing GSAS-II with a Single-Step Download ==
    22
    3 A new approach for downloading and installing GSAS-II, along with required prerequisites has been developed using tools from Continuum Analytics, Inc. and their Anaconda free product. Downloading
     3A new approach for downloading and installing GSAS-II, along with required prerequisites has been developed using tools from Continuum Analytics, Inc. and their free Anaconda product. Downloading
    44this file
    5 (~200 Mb) provides, Python, a number of Python packages, and subversion, which is used to install and update GSAS-II. This is a new installation process, so please report problems, unclear instructions to [mailto:toby@anl.gov Brian Toby] (notes about success are also appreciated). Note that a much more detailed version of these instructions, with lots of screen images, [MacSingleStepInstallerFigs is found here.]
     5(200-300 Mb) provides, Python, a number of Python packages, and subversion, which is used to install and update GSAS-II. This is a new installation process, so please report problems, unclear instructions to [mailto:toby@anl.gov Brian Toby] (notes about success are also appreciated). Note that a much more detailed version of these instructions, with lots of screen images, [MacSingleStepInstallerFigs is found here.]
    66
    77=== Step 1: ===
    88
    9 Download **one** of the following (which have different versions of Python & packages, but will all provide the latest version of GSAS-II):
     9Download this file:
    1010
     11* https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-MacOSX-x86_64.sh (provides Python 3.7, all required Python packages and a recent version of GSAS-II which will be updated via the internet; can be installed on computers without an internet connection, but without that update.)
    1112
    12 * https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-1.0.1-MacOSX-x86_64.sh
    13    * g2conda-1.0.1-MacOSX-x86_64.sh has contains the latest intercompatible Python packages, including Python 3.7, wxPython 4.0.3, !NumPy 1.51.1, !SciPy 1.1.0, matplotlib 2.2.3,... Since the code has not been fully tested with this environment, there is some chance for finding compatibility bugs we have not yet seen (but will certainly fix if reported.)
     13These links offer an older distributions that have worked for many people, if you have trouble with the previous (but please do report problems). Note that these installers require an internet connection:
    1414
    15 * https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-py27-1.0.2-MacOSX-x86_64.sh
    16    * g2conda-py27-1.0.2-MacOSX-x86_64.sh has mostly the same packages as the above, but contains Python 2.7.x and an older version of wxPython (3.0.0). This may be a bit more safe with regards to bugs, but we are now recommending Python 3.x rather than this dist.
    17 
    18 or this older installation file (there have been reports that the files above do not operate properly on 10.14.x, Mojave, which is too new for us to test)
    19  * Download file ```g2conda-0.1.2-MacOSX-x86_64.sh``` from this URL https://anl.box.com/v/GSASII4mac12
    20    * as this is older, its use is not recommended unless you have problems with the previous installers. This contains an older version of bootstrap.py, which does not handle proxies perfectly. (In case of problems, after the bootstrap.py fails, use  ​​https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt to download an update, replace the bootstrap.py file in the GSASII subdirectory and run it in the recently-installed python, [https://subversion.xray.aps.anl.gov/trac/pyGSAS/wiki/InstallMac#OverviewforManualInstallation see here].)
     15* https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-1.0.1-MacOSX-x86_64.sh (Python 3.7, wxPython 4.0.3, !NumPy 1.51.1, !SciPy 1.1.0, matplotlib 2.2.3,...)
     16* https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-py27-1.0.2-MacOSX-x86_64.sh (Python 2.7.x, wxPython 3.0.0...)
     17* ```g2conda-0.1.2-MacOSX-x86_64.sh``` from this URL https://anl.box.com/v/GSASII4mac12 (quite old, not recommended)
    2118
    2219=== Step 2: ===
     
    2421Execute this file.
    2522This should be done by typing the command
    26    ```bash <path>/g2conda-*-MacOSX-x86_64.sh```
     23   ```bash <path>/gsas2full-Latest-MacOSX-x86_64.sh```
    2724in a terminal window. One easy way to to this is to open a terminal (!Applications/Utilities/Terminal.app) type "```bash ```" (leaving a space), then use finder to drag the downloaded file to the terminal window. Then press Enter to run the command.
    2825 ([wiki:MacSingleStepInstallerFigs#Step2: click here to see screen images].)
     
    4542=== Step 4:===
    4643
    47 After Python and packages are installed, the ```GSASII/bootstrap.py``` file (also called ```bin/gsas2-install.py```) is invoked to install the GSAS-II files using program svn (subversion) from the APS server ```https://subversion.xray.aps.anl.gov/pyGSAS```
     44After Python and packages are installed, the ```GSASII/bootstrap.py``` file (also called ```bin/gsas2-install.py```) is invoked to create shortcuts and update the GSAS-II files using program svn (subversion) from the APS server ```https://subversion.xray.aps.anl.gov/pyGSAS```
    4845
    4946This script requests the name of a proxy server. Most people will use the default and press return. However, some sites block web traffic unless it is passed through a particular computer. If needed, enter that computer name or IP address here (e.g. proxyout.lanl.gov); you will be then be requested to also supply a port number, which defaults to 8080.
    5047
    51 Note that the location of the Python image is shown here (```/Users/toby/g2conda/bin/python```) this is worth noting in case you have installation problems and need to rerun the bootstrap.py script ([wiki:MacSingleStepInstaller#Incaseofproblems see below]).
     48Note that the location of the Python image is shown here (```/Users/toby/g2full/bin/python```) this is worth noting in case you have installation problems and need to rerun the bootstrap.py script ([wiki:MacSingleStepInstaller#Incaseofproblems see below]).
    5249
    5350Once the svn command is executed a large number of files are downloaded ending with display of the current GSAS-II version number.
     
    7572== In case of problems ==
    7673
    77 If you are able to download the ```g2conda-0.1.1-MacOSX-x86_64.sh``` file, but have a problem installing it, you may not be executing the command properly. Please make sure you are typing ```bash``` correctly and leaving a space between that and the file name, also be sure you are allowed to write files to the location you choose for installation.
     74If you are able to download the ```gsas2full-Latest-MacOSX-x86_64.sh``` file, but have a problem installing it, you may not be executing the command properly. Please make sure you are typing ```bash``` correctly and leaving a space between that and the file name, also be sure you are allowed to write files to the location you choose for installation.
    7875
    79 If you are able to install the Python files, but the downloading of GSAS-II fails ([#Step4: Step 4]), you may need to specify a proxy; contact a computer/network support person for your institution. While it may be simpler to delete the directory where you have installed the files (typically ```.../g2conda```) and resume from Step 2, it is also possible to rerun the bootstrap.py file using a command such as
     76If you are able to install the Python files, but the updating of GSAS-II fails ([#Step4: Step 4]), you may need to specify a proxy; contact a computer/network support person for your institution. While it may be simpler to delete the directory where you have installed the files (typically ```.../g2full```) and resume from Step 2, it is also possible to rerun the bootstrap.py file using a command such as
    8077
    8178   ''<path>''```/bin/python``` ''<path>''```/GSASII/bootstrap.py```