wiki:MacSingleStepInstaller

Version 14 (modified by toby, 5 years ago) (diff)

--

Installing GSAS-II with a Single-Step Download

A 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 this file (~220 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 Brian Toby (notes about success are also appreciated). Note that a much more detailed version of these instructions, with lots of screen images, is found here.

Step 1:

Download file g2conda-0.1.1-MacOSX-x86_64.sh from this URL https://anl.box.com/v/GSASII4mac

Step 2:

Execute this file. This should be done by typing the command

bash <path>/g2conda-0.1.1-MacOSX-x86_64.sh

in a terminal window. One easy way to to this is to open a terminal (Applications/Utilities/Terminal.app) type "bash " (leaving a space), then use finder to drag the downloaded file to the terminal window. Then press Enter to run the command.

(click here to see screen images.)

Step 3:

Answer prompts from the install script.

  1. Press enter to start the procedure
  1. Press enter to read through the copyright notice
  1. type "yes" to accept the copyright information and start the installation.
  1. 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.
  1. 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.

(click here to see screen images.)

Step 4:

After 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

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 shown here (/Users/toby/g2conda/bin/python) this is worth noting in case you have installation problems and need to rerun the bootstrap.py script (see below).

Once the svn command is executed a large number of files are downloaded ending with display of the current GSAS-II version number.

There will be a brief delay while the installer script processes the files and creates a shortcut app for starting GSAS-II. Note that the warning message "Sorry, failed to find..." is expected for this installation (and will eventually be removed).

The 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

The Python and GSAS-II installation is now complete, and you can close the terminal window, but there are some optional steps you may want to complete.

(click here to see screen images.)

Step 5: (optional)

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, as below. This app will not run if moved to another location, but it can be dragged to the toolbar, as is shown below.

(click here to see screen images.)

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. The alias 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.

Note that the "GSAS-II alias" file can be dragged to the desktop, or wherever it is convenient for your use.

(click here to see screen images.)

In case of problems

If you are able to download the g2conda-0.1.1-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.

If you are able to install the Python files, but the downloading of GSAS-II fails (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

<path>/bin/python <path>/GSASII/bootstrap.py

where <path> is the location where these files have been installed (/Users/toby/g2conda in the previous example).