Changes between Version 22 and Version 23 of MacSingleStepInstallerFigs


Ignore:
Timestamp:
Jan 8, 2021 5:52:20 PM (9 months ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • MacSingleStepInstallerFigs

    v22 v23  
    11== Installing GSAS-II with a Single-Step Download (with figures) ==
    22
    3 This process downloads an installer that will place a working version of Python and the required packages onto your computer, it will then initially install a slightly out-of-date version of GSAS-II including the binaries files needed for running on a Mac. Finally, the distribution site will be checked and updates will be applied to bring GSAS-II up to date (usually with minor download requirements). This installer can be moved to computers without an internet connection and then run on them. This will provide a working, but not quite up-to-date version of GSAS-II. Transferring this installer can also be used to decrease the amount of downloads needed where network access is slow or expensive.
     3This process downloads an installer that will place a working version of Python and the required packages onto your computer, it will then initially install a slightly out-of-date version of GSAS-II including the binaries files needed for running on a Mac. If internet access is available, the GSAS-II distribution site will be checked and updates will be applied to bring GSAS-II up to date. If the installer is moved to a computer without an internet connection, this will provide a working, though slightly out-of-date, copy of GSAS-II.
    44
    55Use the following steps to install GSAS-II on a Mac:
    66
    77=== Step 1:===
    8 Open a terminal window (use the Terminal app in !Applications/Utilities folder; typing terminal.app into the finder search box should find this for you).
    9 
    10 In that window cut and paste the three commands below:
     8In this step you will ​download a file and then use bash to run it. A simple way to do this is to open a terminal window (use the Terminal app in !Applications/Utilities folder; typing terminal.app into the finder search box should find this for you).
     9
     10In that window cut and paste the two commands below:
    1111
    1212{{{
    13 mkdir -p ~/.conda
    1413g2="https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-MacOSX-x86_64.sh"
    15 curl "$g2" > /tmp/g2.sh; bash /tmp/g2.sh
     14curl "$g2" > /tmp/g2.sh; bash /tmp/g2.sh -b -p ~/g2full
    1615}}}
    1716
    18  [[Image(0.png, 600)]]
    19 
    20 
    21 Note that this will fail if your network requires a proxy to access
    22 the internet. In that case you can download the file with a browser and run it [#BrowserDownload using steps listed below.] Note that you will need to know the proxy information in order to get GSAS-II to properly update. Should the `subversion.xray.aps.anl.gov` server fail, a backup copy (perhaps older) can be found here: https://anl.app.box.com/v/GSASIIdistributions. Download and follow [#BrowserDownload using steps below.]
    23 If you want to install GSAS-II onto a computer that does not have an internet connection (or has a slow or expensive connection, subsequent downloads will be small), use those steps and then move the downloaded file on a USB stick, etc.
    24 
    25 
    26 
    27 
    28 
    29 
    30 
    31 
    32 
    33 
    34 
    35 
    36 [=#Step2]
     17
     18A few notes on this step.
     19
     20  * By using the `-b` option in the command above, you are agreeing to the Python and GSAS-II license [#AnacondaLicense shown below]; the text of the [#G2license GSAS-II license is also below].
     21  * The `-p` option specifies where GSAS-II is installed. Note that `-p ~/g2full` installs GSAS-II into directory `g2full` in your home folder. Change `~/g2full` if desired.
     22  * The `curl` command will likely fail if your network requires a proxy to access the internet. In that case you can download file https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-MacOSX-x86_64.sh by clicking on it here in your browser and run it [#BrowserDownload using steps listed below.] Note though that you will need to know the proxy settings in order to get GSAS-II to properly update, see ProxyInfo for more.
     23  * If you want to install GSAS-II onto a computer that does not have an internet connection (or has a slow or expensive connection), download file https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-MacOSX-x86_64.sh on a computer with better access and move the downloaded file on a USB stick, etc to where you wish to install it. Note that the installation process will use the internet if access is available, but usually only very minor amounts of information will be transferred. Installation will complete properly even without network access, but a not quite up-to-date version of GSAS-II will be will installed.
     24
    3725=== Step 2:===
    38 Answer prompts from the install script.
    39 
    40  1. Press enter to start the procedure
    41 
    42 
    43  2. Press space several times to page through the copyright notice. For convenience the full text [#AnacondaLicense from this screen] and the [#G2license GSAS-II license] are shown below.
    44 
    45  [[Image(4.jpg, 400)]]
    46 
    47 
    48 
    49 
    50 
    51 
    52 
    53 
    54 
    55 
    56 
    57 
    58 
    59 
    60 
    61 
    62 
    63 
    64 
    65  3. Type "```yes```" to accept the copyright information and start the installation.
    66 
    67  [[Image(5.jpg, 400)]]
    68 
    69 
    70 
    71 
    72 
    73 
    74 
    75 
    76 
    77 
    78 
    79 
    80 
    81 
    82 
    83 
    84 
    85  4. Enter a location for where the files should be installed, if the default is not what you prefer. The default will usually be OK, in which case you can simply press enter. Installation has not been tested where paths contain spaces or special characters, so it is a good idea to install GSAS-II in an alternate location if the default has spaces or Unicode characters. Note that GSAS-II cannot be moved once installed. If you need it to move it please reinstall and delete the old copy.
    86 
    87   Make a note of where you have installed GSAS-II; this will be needed if you have problems with the software.
    88 
    89  [[Image(6.jpg, 400)]]
    90 
    91 
    92 
    93 
    94 
    95 
    96 
    97 
    98 
    99 
    100 
    101 
    102 
    103 
    104 
    105 
    106 
    107 
    108 
    109  5. Pressing enter to accept the default installation location or providing a installation location will trigger installation of the software with a series of messages. If the installation progresses normally, the final messages will appear as below:
    110 
    111  [[Image(7.jpg, 400)]]
    112 
    113   If error or warning messages are seen, it is suggested that you save a screen image or use cut and paste to save the text in the window to a file. The most common [#InstallError error message is discussed below].
    114 
    115  6. It is recommended that you type "no" for the question about initializing gsas2full using conda init as it is not needed to run GSAS-II. If you say "yes" or use the default, then the version of Python installed by GSAS-II becomes the default version, which usually will not cause problems either. The installation completes with these messages (which can be ignored):
    116 
    117  [[Image(8.jpg, 400)]]
    118 
    119 
    120 
    121 
    122 
     26
     27
     28
     29
     30
     31
     32
     33
     34
     35
     36
     37[
    12338
    12439
     
    473388}}}
    474389
    475 
     390[=#Prompted]
     391== Prompted Installation ==
     392
     393 [[Image(0.png, 600)]]
     394
     395
     396Answer prompts from the install script.
     397
     398 1. Press enter to start the procedure
     399
     400
     401 2. Press space several times to page through the copyright notice. For convenience the full text [#AnacondaLicense from this screen] and the [#G2license GSAS-II license] are shown below.
     402
     403 [[Image(4.jpg, 400)]]
     404
     405
     406
     407
     408
     409
     410
     411
     412
     413
     414
     415
     416
     417
     418
     419
     420
     421
     422
     423 3. Type "```yes```" to accept the copyright information and start the installation.
     424
     425 [[Image(5.jpg, 400)]]
     426
     427
     428
     429
     430
     431
     432
     433
     434
     435
     436
     437
     438
     439
     440
     441
     442
     443 4. Enter a location for where the files should be installed, if the default is not what you prefer. The default will usually be OK, in which case you can simply press enter. Installation has not been tested where paths contain spaces or special characters, so it is a good idea to install GSAS-II in an alternate location if the default has spaces or Unicode characters. Note that GSAS-II cannot be moved once installed. If you need it to move it please reinstall and delete the old copy.
     444
     445  Make a note of where you have installed GSAS-II; this will be needed if you have problems with the software.
     446
     447 [[Image(6.jpg, 400)]]
     448
     449
     450
     451
     452
     453
     454
     455
     456
     457
     458
     459
     460
     461
     462
     463
     464
     465
     466
     467 5. Pressing enter to accept the default installation location or providing a installation location will trigger installation of the software with a series of messages. If the installation progresses normally, the final messages will appear as below:
     468
     469 [[Image(7.jpg, 400)]]
     470
     471  If error or warning messages are seen, it is suggested that you save a screen image or use cut and paste to save the text in the window to a file. The most common [#InstallError error message is discussed below].
     472
     473 6. It is recommended that you type "no" for the question about initializing gsas2full using conda init as it is not needed to run GSAS-II. If you say "yes" or use the default, then the version of Python installed by GSAS-II becomes the default version, which usually will not cause problems either. The installation completes with these messages (which can be ignored):
     474
     475 [[Image(8.jpg, 400)]]
    476476
    477477
    478478== Older installers ==
    479479
    480 These links offer an older distributions that have worked for many people, if you have trouble with the previous (but please do report problems). They may be needed for systems with older versions of OS X. Note that these installers do require an internet connection to complete the installation:
    481 
    482 * 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,...)
    483 * 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...)
    484 
    485 
     480See [MacSingleStepInstaller these older instructions] for infomation on older distributions. They may be needed for systems with older versions of MacOS. Note that these installers do require an internet connection to complete the installation.