Changes between Version 28 and Version 29 of MacSingleStepInstallerFigs
- Timestamp:
- Jan 9, 2021 11:04:37 PM (2 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
MacSingleStepInstallerFigs
v28 v29 6 6 7 7 === 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 th at windowcut and paste the two commands below: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 spotlight or finder search box should find this for you). 9 10 In the Terminal window, cut and paste the two commands below: 11 11 12 12 {{{ … … 18 18 A few notes on this step. 19 19 20 * By using the `-b` option in the command above, you are agreeing to the Python and GSAS-II license [#AnacondaLicense shownbelow]; 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]. 21 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 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, buta 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. 24 24 25 25 === Step 2:=== 26 26 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.27 As 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. 28 28 29 29 [[Image(n0.png, 700)]] 30 30 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).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 immediately below. The need for a proxy is rare, so most people will only need to press enter here (see ProxyInfo for more details). 32 32 33 33 [[Image(n1.png, 700)]] … … 85 85 86 86 After 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 108 87 109 88 At this point, the installation process ends, where the terminal window appears as immediately … … 149 128 150 129 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 154 136 155 137 156 138 Click OK and three windows should open (the terminal window, the GSAS-II main window and the GSAS-II Plots window). 157 139 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). Then163 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.166 140 167 141 === Step 5 (Optional) === 168 142 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. 170 144 171 145 [[Image(12.jpg, 400)]] … … 194 168 === Step 6 (Optional) === 195 169 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 causesa 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: 197 171 198 172 [[Image(13.jpg, 400)]] 199 173 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.174 When "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. 201 175 202 176 [[Image(14.jpg, 400)]] … … 321 295 === Step A1: === 322 296 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. 297 Download this file in a web browser: https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-MacOSX-x86_64.sh 326 298 327 299 === Step A2:=== 328 Execute th is file.300 Execute the downloaded file inside bash. 329 301 330 302 Type "bash " into a terminal window (note space after "h"), then drag the downloaded file from a finder window into the terminal window. … … 336 308 [[Image(2.jpg, 400)]] 337 309 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. 338 311 339 312 … … 382 355 = Prompted Installation = 383 356 384 If the installer is is run without 357 If the installer is is run without including `-b -p ~/g2full` option at the end of the command line, a few extra steps are needed. 385 358 386 359 … … 435 408 436 409 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 re installand 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. 438 411 439 412 Make a note of where you have installed GSAS-II; this will be needed if you have problems with the software. … … 465 438 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]. 466 439 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): 468 443 469 444 [[Image(8.jpg, 400)]]