Changes between Version 8 and Version 9 of LinuxSingleStepInstaller


Ignore:
Timestamp:
Jan 6, 2021 5:02:58 PM (9 months ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • LinuxSingleStepInstaller

    v8 v9  
    99* https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-Linux-x86_64.sh
    1010
    11 These are older installers that have worked:
     11These are older installers that have worked, but please avoid them if possible:
    1212
    1313* 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,...)
     
    2727in a terminal window. Then press Enter to run the command.
    2828
     29Note that alternately it is possible to use command
     30{{{
     31bash <path>/gsas2full-Latest-Linux-x86_64.sh -b -p ~/g2full
     32}}}
     33This 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.
     34
    2935=== Step 3:===
    3036Answer prompts from the install script.
    3137
    32  1. Press enter to start the procedure
     38  A. Press enter to start the procedure
    3339
    34  2. Press enter to read through the copyright notice
     40  B. Press enter to read through the copyright notice
    3541
    36  3. type "```yes```" to accept the copyright information and start the installation.
     42  C. type "```yes```" to accept the copyright information and start the installation.
    3743
    38  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.
     44  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.
    3945
    40  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.
     46  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.
     47
     48  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)
     49
     50  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".)
    4151
    4252=== Step 4:===
    4353
    44 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```
    45 
    46 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.
    47 
    48 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.
    49 
    50 Once the svn command is executed, updated versions of GSAS-II files are downloaded to provide the current GSAS-II version.
    51 
    52 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".)
    53 
    5454The Python and GSAS-II installation is now complete, and you can close the terminal window.
    5555
    56 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
     56On 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.
     57
     58Alternately, the command to run GSAS-II will be something like this
    5759{{{
    5860~/g2full/bin/python ~/g2full/GSASII/GSASII.py
    5961}}}
    6062
    61 but the prefix ```~/g2full/``` will vary depending on where you install GSAS-II.
     63changing 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
     64
     65{{{
     66bash <condapath>/start_G2_bootstrap.sh
     67}}}
     68The file can be copied and used.
    6269
    6370== In case of problems ==
    6471
    65 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).
     72There 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
     73[InstallLinux#III.InstallingPythonetc.Manually manual installation] instructions for other ways install on Linux.
    6674
    6775If 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
    6876the installation fails, delete the previous installation directory before trying again.
    6977
    70 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
     78== Rerun bootstrap.py ==
     79
     80With 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:
    7181{{{
    7282~/g2full/bin/python ~/g2full/GSASII/bootstrap.py
    7383}}}
     84changing the prefix ```~/g2full/``` to reflect your choice for {{{<condapath>}}}.
    7485
    75 where ```~/g2full` may need to be changed to the  location where these files have been installed.
     86If 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].