wiki:MacSingleStepInstallerFigs

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

--

Installing GSAS-II with a Single-Step Download (with figures)

Step 1:

Download one of the following:

or

  • Download file g2conda-0.1.2-MacOSX-x86_64.sh from this URL https://anl.box.com/v/GSASII4mac12
    • this is older and is not recommended, unless you have problems with the previous installers (older OS X versions?). This contains an older version of bootstrap.py, which does not handle proxies perfectly.

Step 2:

Execute this file.

Type "bash " into a terminal window, then drag the downloaded file from a finder window into the terminal window.

This places the file name with full path name into the terminal window, then press Enter.

Step 3:

Answer prompts from the install script.

  1. Press enter to start the procedure

  1. Press enter again to read through the copyright notice

start of "license" information

  1. Type "yes" to accept the copyright information and start the installation.

End of "license" information

  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.

enter install location

  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.

after successful install

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 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).

after successful install completed

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

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.

Step 6: (optional)

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.

Attachments (24)

Download all attachments as: .zip