wiki:MacSingleStepInstaller

Version 22 (modified by toby, 2 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 free Anaconda product. Downloading this file (200-300 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 this file:

These links offer an older distributions that have worked for many people, if you have trouble with the previous (but please do report problems). Note that these installers require an internet connection:

Step 2:

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

bash <path>/gsas2full-Latest-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 installed, if the default is not what you prefer. If the default is OK, simply press enter. This will likely fail if you use a path 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 is invoked to create shortcuts and update the GSAS-II files using program svn (subversion) from the APS server https://subversion.xray.aps.anl.gov/pyGSAS

Note that the location of the Python image is shown here (/Users/toby/g2full/bin/python) this is worth noting in case you have installation problems and need to rerun the bootstrap.py script (see below).

There will be a brief delay while the installer script processes the files and creates a shortcut app for starting GSAS-II.

Then an svn command is executed an update to the current GSAS-II version number and newer files are downloaded (if an internet connection is available.) 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 requested to also supply a port number, which defaults to 8080.

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 answer is "no".

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 gsas2full-Latest-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 updating 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 .../g2full) 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).