Changes between Version 8 and Version 9 of LinuxSingleStepInstaller

Timestamp:

Jan 6, 2021 5:02:58 PM (3 years ago)

Author:

toby

Comment:

--

LinuxSingleStepInstaller

@@ -9 +9 @@
 * https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-Linux-x86_64.sh
 
-These are older installers that have worked: 
+These are older installers that have worked, but please avoid them if possible: 
 
 * https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-1.0.1-Linux-x86_64.sh (Python 3.7, wxPython 4.0.3, !NumPy 1.51.1, !SciPy 1.1.0, matplotlib 2.2.3,...)
@@ -27 +27 @@
 in a terminal window. Then press Enter to run the command.
 
+Note that alternately it is possible to use command
+{{{
+bash <path>/gsas2full-Latest-Linux-x86_64.sh -b -p ~/g2full
+}}}
+This will install the files at location {{{g2full}}} in your home directory and will skip Step 3, below. Note that this location is labeled as {{{<condapath>}}} in discussions below. 
+
 === Step 3:===
 Answer prompts from the install script. 
 
- 1. Press enter to start the procedure
+  A. Press enter to start the procedure
 
- 2. Press enter to read through the copyright notice
+  B. Press enter to read through the copyright notice
 
- 3. type "```yes```" to accept the copyright information and start the installation.
+  C. type "```yes```" to accept the copyright information and start the installation.
 
- 4. Enter a location for where the files should be loaded, if the default is not OK and press enter. If the default is OK, simply press enter. Problems have been reported when the directory name includes spaces.
+  D. Enter a location for where the files should be loaded, if the default is not OK and press enter. Note that this location is labeled as {{{<condapath>}}} in discussions below. If the default is OK, simply press enter. Problems have been reported when {{{<condapath>}}} includes spaces.
 
- 5. Wait while the installation of Python, etc occurs. There will typically be a long delay while nothing happens followed by a series of messages as packages are installed. 
+  E. Wait while the installation of Python, etc occurs. There will typically be a long delay while nothing happens followed by a series of messages as packages are installed. 
+
+  F. After Python and packages are installed, the ```GSASII/bootstrap.py``` file is invoked to update the GSAS-II files using program svn (subversion) from the APS server ```https://subversion.xray.aps.anl.gov/pyGSAS```. Once the svn command is executed, updated versions of GSAS-II files are downloaded to provide the current GSAS-II version. If you have transferred the {{{gsas2full-Latest-Linux-x86_64.sh}}} file to a computer that does not have an internet connection or requires a proxy server to access the internet, this will fail. The installation will still complete, but you will have a somewhat older GSAS-II version. To update or establish proxy server information, rerun ```bootstrap.py``` (see below)
+
+  G. The final question to be asked is should the installation location be placed into your system's path. Answering "no" is recommended (unless you plan to run other Python scripts from the command line with this version of Python, in which case you may want to type "yes".)
 
 === Step 4:===
 
-After Python and packages are installed, the ```GSASII/bootstrap.py``` file is invoked to update the GSAS-II files using program svn (subversion) from the APS server ```https://subversion.xray.aps.anl.gov/pyGSAS```
-
-This 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. 
-
-Note that the location of the Python image is displayed (typically ```~/g2full/bin/python```) this is worth noting in case you have installation problems and need to rerun the bootstrap.py script.
-
-Once the svn command is executed, updated versions of GSAS-II files are downloaded to provide the current GSAS-II version. 
-
-The final question to be asked is should the installation location be placed into your system's path. Answering "no" is recommended (unless you plan to run other Python scripts from the command line with this version of Python, in which case you may want to type "yes".)
-
 The Python and GSAS-II installation is now complete, and you can close the terminal window. 
 
-On some Linux distributions a shortcut will be created to run GSAS-II, for example on the desktop. On others you will need to do this yourself. Note that the command to run GSAS-II will be something like this
+On some Linux distributions a shortcut will be created to run GSAS-II, for example on the desktop. On most others you will need to do this yourself. 
+
+Alternately, the command to run GSAS-II will be something like this
 {{{
 ~/g2full/bin/python ~/g2full/GSASII/GSASII.py
 }}}
 
-but the prefix ```~/g2full/``` will vary depending on where you install GSAS-II. 
+changing the prefix ```~/g2full/``` to reflect your choice for {{{<condapath>}}}. With gsas2full-Latest-Linux-x86_64.sh from January 2021 and later, the installer creates file {{{<condapath>/start_GSASII.sh}}}. This file can be run to start GSAS-II with command 
+
+{{{
+bash <condapath>/start_G2_bootstrap.sh
+}}} 
+The file can be copied and used. 
 
 == In case of problems == 
 
-This installation process is undergoing revisions, so please report problems, unclear instructions to [Brian dot Toby at ANL dot gov] (notes about success are also appreciated). 
+There are many, many versions of Linux and some are too new or old and will not have compatible .so libraries with either the GSAS-II code and/or Python. Sometimes installing compatibily libraries are needed. See the
+[InstallLinux#III.InstallingPythonetc.Manually manual installation] instructions for other ways install on Linux. 
 
 If you are able to download the ```gsas2full-Latest-Linux-x86_64.sh``` file, but the install does not run properly, 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. If 
 the installation fails, delete the previous installation directory before trying again. 
 
-If you are able to install the Python files, but the update 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 
+== Rerun bootstrap.py == 
+
+With gsas2full-Latest-Linux-x86_64.sh from January 2021 and later, the installer creates file {{{<condapath>/start_G2_bootstrap.sh}}} which can be run in bash to launch the bootstrap process. Otherwise a command like this is needed:
 {{{
 ~/g2full/bin/python ~/g2full/GSASII/bootstrap.py
 }}}
+changing the prefix ```~/g2full/``` to reflect your choice for {{{<condapath>}}}. 
 
-where ```~/g2full` may need to be changed to the  location where these files have been installed. 
+If GSAS-II is installed, this will complete any remaining installation steps and will update GSAS-II to the latest version. Note that this script requests the name of a proxy server. For most people, none is needed and they should simply use the the default by  pressing 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. If you are able to download files but updates fail, see the discussion of [ProxyInfo web proxies].