Changes between Version 26 and Version 27 of MacSingleStepInstallerFigs

Timestamp:

Jan 8, 2021 10:44:58 PM (4 years ago)

Author:

toby

Comment:

--

MacSingleStepInstallerFigs

@@ -27 +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. 
 
-[[Image(n0.png, 700)]]
+ [[Image(n0.png, 700)]]
 
 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).
 
-[[Image(n1.png, 700)]]
+ [[Image(n1.png, 700)]]
+
 
 
@@ -80 +81 @@
 === Step 3:===
 
-Once the proxy information is entered, `bootstrap.py` is run to update GSAS-II. This will fail with an error message (see example in [#InstallerOutput output shown below] if a network connection is not present, but the installation will still continue. Some additional processing 
-
-additional processing is done, including creation of an AppleScript to launch GSAS-II. Apple security in Big Sur (MacOS 11.0) will not allow the file. The only way that I (Brian) know to change that is to edit 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). Note that OK must be pressed within 2 minutes or the request times out (should this happen, in Script Editor, select the GSAS-II window and then in the File menu, select Save). 
-
-
-[[Image(n2.png, 300)]]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-=== Step 3: ===
-
-  The installation procedure creates an app to help launch GSAS-II and places that app in the GSAS-II folder. It also opens a Finder window, showing that app (labeled as GSAS-II), as below. This app will not run if moved to another location, but it can be dragged to the toolbar, as is shown below. It may not appear with the GSAS-II icon, as shown in the figure (the reason for this is not yet understood.)
-
-  Confirm that GSAS-II can run from this app by double-clicking on it. The first time this is done, you will likely be asked to confirm this app should have access to the Terminal app with this message:
-
- [[Image(permissons.png, 250)]]
+Once the proxy information is entered, `bootstrap.py` is run to update GSAS-II. An error message (see example in [#InstallerOutput output shown below] if a network connection is not present or proxy information is needed, but the installation will still continue. If the computer is connected to the internet later it will be possible to run updates from inside the GSAS-II help menu. Likewise proxy information can be supplied within GSAS-II and then updates will also be possible, see [#BrowserDownload below]. 
+
+
+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). 
+
+ [[Image(n2.png, 400)]]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+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). 
+
+
+At this point, the installation process ends, where the terminal window appears as immediately 
+below and a finder window opened with the newly created GSAS-II application selected. 
+
+
+
+ [[Image(n3.png, 700)]]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+=== Step 4 ===
+
+
+**//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). 
+
+ [[Image(permissons.png, 250)]]  [[Image(n-permissons.png, 250)]]
+
 
 Click OK and three windows should open (the terminal window, the GSAS-II main window and the GSAS-II Plots window). 
 
-
-
-
-
-
-
-
-
-
-=== Step 4: (drag to dock, optional) ===
-
-  The GSAS-II app created by the installation procedure can be dragged to the dock to make launching GSAS-II simple. Note the app will not run if moved to another location, such as the desktop. See the next step on how to create a desktop icon. 
-
+For reasons I do not understand, sometimes the installer does not succeed is setting permissions and this message is displayed:
+
+ [[Image(n-app-edit.png, 250)]]
+
+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 
+repeat this step and the initial message allowing you to grant permission for GSAS-II to access Terminal should be displayed. 
+
+
+=== Step 5 (Optional) ===
+
+**//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. 
 
  [[Image(12.jpg, 400)]]
@@ -172 +191 @@
 
 
-
-
-=== Step 5: (Desktop icon, optional) ===
-
-If you would like place the GSAS-II app in another location (for example your computer's desktop) to make it convenient to start GSAS-II, you need to make an alias. This alias file can be moved. Press control and click on the GSAS-II app (or use right-click with a 2 or 3 button mouse) and a menu of options is shown. Click on "Make Alias" and a new file, "GSAS-II alias" is created in that folder.
+=== Step 6 (Optional) ===
+
+**//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:
 
  [[Image(13.jpg, 400)]]
 
-Note that the "GSAS-II alias" file can be dragged to the desktop, or wherever it is convenient for your use. It can also be renamed after the file is moved. 
+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.  
 
  [[Image(14.jpg, 400)]]
@@ -225 +242 @@
 
 
-[=#InstallError]
-== Update Error Message ==
-
-After Python and packages are installed, the ```GSASII/bootstrap.py``` file is invoked. This tests that the 
-GSAS-II binaries files work, creates shortcuts and updates the GSAS-II files using program svn (subversion) from the APS server ```https://subversion.xray.aps.anl.gov/pyGSAS```. The svn update
-requires a working internet connection. If the svn program is not able to update properly then this error message is shown:
-
- [[Image(err.png, 400)]]
-
-
-If the computer does not have an internet connection, this error is expected and can be ignored. If the computer is later connected to the internet, you are recommended to use the !Help/Update command to obtain the latest version of GSAS-II and continue updating periodically. 
-
-If the computer does have a working internet connection, it is likely that the update failed due to your network requiring an internet proxy (discussed in the next section). 
-
-Note the message for recreating the error:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+=== Shortcuts ===
+
+Note that it is also possible to start GSAS-II with terminal commands such as these:
+
 {{{
-/<your location>/bin/python /<your location>/GSASII/bootstrap.py --noinstall
+source <condapath>/bin/activate G2
+python <condapath>/envs/G2/GSASII/GSASII.py
 }}}
 
-If GSAS-II is installed, but the installation process is unable to update, create an app, etc., it may be worthwhile to run this command again by copying the information from your error message into a Terminal.app window (the flag such as --noinstall may be omitted.) This will provide better warning and error messages than above. 
+  Where `<condapath>` is the location where GSAS-II was installed (`~/g2full` unless something else was selected). The installer places these commands in file `<condapath>/start_GSASII.sh`
+
+Likewise, it is sometimes useful to rerun the bootstrap.py process. This can be done with terminal commands: 
+
+{{{ 
+source <condapath>/bin/activate
+python <condapath>/GSASII/bootstrap.py
+}}}
+
+  The installer places these commands in file `<condapath>/start_G2_bootstrap.sh`. 
+
+
+
+
+= Seeking help =
+
+There must be better ways to control application permissions in MacOS than what is done here, but I have not been able to determine how to control this either from !AppleScripts or from command line programs. I would very much welcome information on better ways to do this. Please contact brian.toby at ANL.gov if you can offer some knowledge. 
+
+
+= Older installers =
+
+See [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. 
 
 [=#BrowserDownload]
@@ -314 +378 @@
 
 
+[=#Prompted]
+= Prompted Installation =
+
+If the installer is is run without 
+
+
+ [[Image(0.png, 600)]]
+
+
+Answer prompts from the install script. 
+
+ 1. Press enter to start the procedure
+
+
+ 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. 
+
+ [[Image(4.jpg, 400)]]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 3. Type "```yes```" to accept the copyright information and start the installation.
+
+ [[Image(5.jpg, 400)]]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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. 
+
+  Make a note of where you have installed GSAS-II; this will be needed if you have problems with the software. 
+
+ [[Image(6.jpg, 400)]]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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: 
+
+ [[Image(7.jpg, 400)]]
+
+  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].
+
+ 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):
+
+ [[Image(8.jpg, 400)]]
+
 
 
 [=#Logfiles]
-== Debugging ==
-Two files are created as the GSAS-II installation is done. 
-* File {{{/tmp/bootstrap1.log}}} contains the output when creating the app and making other installation steps.  
-* File {{{/tmp/bootstrap2.log}}} contains the output when performing an update.
-
-If installation fails and you want to get help, please include these files in your e-mail. Note they will deleted during your next reboot. 
-
 
 = Licenses =
@@ -441 +588 @@
 }}}
 
-[=#Prompted]
-== Prompted Installation ==
-
- [[Image(0.png, 600)]]
-
-
-Answer prompts from the install script. 
-
- 1. Press enter to start the procedure
-
-
- 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. 
-
- [[Image(4.jpg, 400)]]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3. Type "```yes```" to accept the copyright information and start the installation.
-
- [[Image(5.jpg, 400)]]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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. 
-
-  Make a note of where you have installed GSAS-II; this will be needed if you have problems with the software. 
-
- [[Image(6.jpg, 400)]]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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: 
-
- [[Image(7.jpg, 400)]]
-
-  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].
-
- 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):
-
- [[Image(8.jpg, 400)]]
-
-
-== Older installers ==
-
-See [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. 
+
 
 == Installer Output ==