Changes between Initial Version and Version 1 of LinuxSingleStepInstaller


Ignore:
Timestamp:
Nov 1, 2016 4:22:28 PM (5 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • LinuxSingleStepInstaller

    v1 v1  
     1== Installing GSAS-II with a Single-Step Download ==
     2
     3A new approach for downloading and installing GSAS-II, along with required prerequisites has been developed using tools from Continuum Analytics, Inc. and their Anaconda free product. Downloading [https://anl.box.com/v/GSASII4linux12 this file]
     4(~280 Mb) provides, Python, a number of Python packages, and subversion, which is used to install and update GSAS-II. This is a new installation process, so please report problems, unclear instructions to [mailto:toby@anl.gov Brian Toby] (notes about success are also appreciated).
     5
     6=== Step 1: ===
     7Download file ```g2conda-0.1.2-Linux-x86_64.sh``` from this URL https://anl.box.com/v/GSASII4linux12
     8
     9=== Step 2: ===
     10
     11Execute this file.
     12This should be done by typing the command
     13   ```bash <path>/g2conda-0.1.2-Linux-x86_64.sh```
     14in a terminal window. Then press Enter to run the command.
     15
     16=== Step 3:===
     17Answer prompts from the install script.
     18
     19 1. Press enter to start the procedure
     20
     21 2. Press enter to read through the copyright notice
     22
     23 3. type "```yes```" to accept the copyright information and start the installation.
     24
     25 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. Note that no tests have been done with paths that contain spaces.
     26
     27 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.
     28
     29=== Step 4:===
     30
     31After Python and packages are installed, the ```GSASII/bootstrap.py``` file (also called ```bin/gsas2-install.py```) is invoked to install the GSAS-II files using program svn (subversion) from the APS server ```https://subversion.xray.aps.anl.gov/pyGSAS```
     32
     33This 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.
     34
     35Note that the location of the Python image is displayed (typically ```~/g2conda/bin/python```) this is worth noting in case you have installation problems and need to rerun the bootstrap.py script.
     36
     37Once the svn command is executed a large number of files are downloaded ending with display of the current GSAS-II version number.
     38
     39The final question to be asked is should the installation location be placed into your system's path. If you plan to run other Python scripts from the command line, you may want to type "yes", but this is not needed for GSAS-II, so the suggested answer is "no".
     40
     41The Python and GSAS-II installation is now complete, and you can close the terminal window.
     42
     43On 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
     44
     45   ```~/g2conda/bin/python ~/g2conda/GSASII/GSASII.py```
     46
     47
     48== In case of problems ==
     49
     50If you are able to download the ```g2conda-0.1.2-MacOSX-x86_64.sh``` file, but have a problem installing it, 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.
     51
     52If you are able to install the Python files, but the downloading 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 ```.../g2conda```) and resume from Step 2, it is also possible to rerun the bootstrap.py file using a command such as
     53
     54   ```~/g2conda/bin/python ~/g2conda/GSASII/bootstrap.py```
     55
     56where ```~/g2conda` may need to be changed to the  location where these files have been installed.