Changes between Version 28 and Version 29 of MacSingleStepInstallerFigs


Ignore:
Timestamp:
Jan 9, 2021 11:04:37 PM (9 months ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • MacSingleStepInstallerFigs

    v28 v29  
    66
    77=== Step 1:===
    8 In 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 
    10 In that window cut and paste the two 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 spotlight or finder search box should find this for you).
     9
     10In the Terminal window, cut and paste the two commands below:
    1111
    1212{{{
     
    1818A few notes on this step.
    1919
    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].
     20  * By using the `-b` option in the command above, you are agreeing to the Python and GSAS-II licenses [#AnacondaLicense as below]; the text of the [#G2license GSAS-II license is also below].
    2121  * 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.
    2222  * 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.
     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 for updates, but usually only very minor amounts of information will be transferred. Installation will complete properly even without network access, but then a not quite up-to-date version of GSAS-II will be will installed.
    2424
    2525=== Step 2:===
    2626
    27 As soon as enter is pressed after the second command, the download starts, as shown immediately below. The file downloaded is circa 250 Mb, so you may see this complete in seconds or minutes.
     27As soon as enter is pressed after the second command is entered, the download starts, as shown immediately below. The file downloaded is circa 250 Mb, so you may see this complete in seconds or minutes depending on your connection.
    2828
    2929 [[Image(n0.png, 700)]]
    3030
    31 Once the file is downloaded, Python and GSAS-II are installed from the downloaded file and a significant amount of information is displayed ([#InstallerOutput shown below]). The installation will then pause and you will be asked to supply a proxy address, as shown below. The need for a proxy is rare, so most people will only need to press enter here (see ProxyInfo for more details).
     31Once the file is downloaded, Python and GSAS-II are installed from the downloaded file and a significant amount of information is displayed ([#InstallerOutput shown below]). The installation will then pause and you will be asked to supply a proxy address, as shown immediately below. The need for a proxy is rare, so most people will only need to press enter here (see ProxyInfo for more details).
    3232
    3333 [[Image(n1.png, 700)]]
     
    8585
    8686After this step, `bootstrap.py` is run again, but this time the processing is done to speed up application startup and to create a !AppleScript to launch GSAS-II (`GSAS-II.app`). Apple security rules introduced in Big Sur (MacOS 11.0) block running `GSAS-II.app`. The only way that I (Brian) have found to change that is to edit the file it in the Script Editor. This is implemented in the installation process, but the first time this is done, MacOS asks for permission to run this (as shown immediately below).
    87 
    88  [[Image(n2.png, 400)]]
    89 
    90 
    91 
    92 
    93 
    94 
    95 
    96 
    97 
    98 
    99 
    100 
    101 
    102 
    103 
    104 
    105 
    106 Note that OK must be pressed within 2 minutes or the request times out. (Should that happen, in Script Editor, select the GSAS-II window and then in the File menu, select Save).
    107 
    10887
    10988At this point, the installation process ends, where the terminal window appears as immediately
     
    149128
    150129
    151 **//App permissions//**: Note that again Apple security rules restrict the use of the new app. The first time it is used by double-clicking on the app, you will be asked to grant permission for it to create a terminal, as shown below (depending on the MacOS version).
    152 
    153  [[Image(permissons.png, 250px, valign=top)]]     [[Image(n-permissions.png, 180)]]
     130**//App permissions//**: Apple's security rules restrict the use of the new app. The first time it is used by double-clicking on the app, you will be asked to grant permission for it run with prompts shown below (depending on the MacOS version).
     131
     132 Catalina (10.15): [[Image(permissons.png, 250px, valign=top)]]     
     133
     134 Big Sur (11.0): [[Image(np1.png, 180, top )]] [[Image(np1.png, 180, top)]]
     135
    154136
    155137
    156138Click OK and three windows should open (the terminal window, the GSAS-II main window and the GSAS-II Plots window).
    157139
    158 For reasons I do not understand, sometimes the installer does not succeed is setting permissions and this message is displayed:
    159 
    160  [[Image(n-app-edit.png, 250)]]
    161 
    162 When this occurs, press the Edit button, which opens the app in the Script Editor. Use the File/Save command in the Script Editor and then close the window (quitting the Script Editor is a good idea). Then
    163 repeat this step and the initial message allowing you to grant permission for GSAS-II to access Terminal should be displayed.
    164 
    165 As noted below, I am seeking advice on better ways to manage application permissions in MacOS. Please contact Brian dot Toby at ANL dot gov if you can offer any.
    166140
    167141=== Step 5 (Optional) ===
    168142
    169 **//Drag to Dock//**: if desired, the GSAS-II app created before can be dragged to the Dock to make launching GSAS-II simple, as diagrammed below.
     143**//Drag to Dock//**: if desired, the GSAS-II app created here can be dragged to the Dock to make launching GSAS-II simple, as diagrammed below.
    170144
    171145 [[Image(12.jpg, 400)]]
     
    194168=== Step 6 (Optional) ===
    195169
    196 **//Create Alias//**: Note that while the GSAS-II.app file can be dragged to the dock, it cannot be moved or renamed. Should you wish to have a shortcut to run GSAS-II in another location (such as on your desktop) or wish to use another name, you need to make an alias to it. To create an alias, hold down the  control button and click on the GSAS-II app (or use right-click with a 2 or 3 button mouse), this causes a menu of options to be shown, as seen below:
     170**//Create Alias//**: Note that while the GSAS-II.app file can be dragged to the dock, it cannot be moved. Should you wish to have a shortcut to run GSAS-II that you can place in another location (such as on your desktop), you need to make an alias to it. To create an alias, hold down the control button and then click on the GSAS-II app (or use right-click with a 2 or 3 button mouse), this causes a menu of options to be shown, as seen below:
    197171
    198172 [[Image(13.jpg, 400)]]
    199173
    200 When "Make Alias" is selected, an alias with name `GSAS-II alias` is created in the same folder, as seen below. This alias file can be moved and/or renamed. 
     174When "Make Alias" is selected, an alias created in the same folder with name `GSAS-II alias`, as seen below. This alias file can be moved and/or renamed. 
    201175
    202176 [[Image(14.jpg, 400)]]
     
    321295=== Step A1: ===
    322296
    323 Download this file in a web browser:
    324 
    325 * 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.) This file is also available here https://anl.app.box.com/v/GSASIIdistributions, where you will need to use the "..." menu to the right of entry gsas2full-latest-MacOSX-x86_64.sh to download that file.
     297Download this file in a web browser: https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-MacOSX-x86_64.sh
    326298
    327299=== Step A2:===
    328 Execute this file.
     300Execute the downloaded file inside bash.
    329301
    330302 Type "bash " into a terminal window (note space after "h"), then drag the downloaded file from a finder window into the terminal window. 
     
    336308 [[Image(2.jpg, 400)]]
    337309
     310 You can optionally add the `-b -p ~/g2full` option at the end of the line. If you do not, you will have to follow the steps in a prompted installation as below. 
    338311
    339312
     
    382355= Prompted Installation =
    383356
    384 If the installer is is run without
     357If the installer is is run without including `-b -p ~/g2full` option at the end of the command line, a few extra steps are needed.
    385358
    386359
     
    435408
    436409
    437  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.
     410 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 rerun the bash command above to install in a different location and delete the old copy.
    438411
    439412  Make a note of where you have installed GSAS-II; this will be needed if you have problems with the software.
     
    465438  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].
    466439
    467  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):
     440 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. This not always a proble, but some poorly designed software may make assumptions that a particular python version has been installed as the default version.
     441
     442 The installation completes with these messages (which can be ignored):
    468443
    469444 [[Image(8.jpg, 400)]]