wiki:InstallOSX

Version 10 (modified by toby, 11 years ago) (diff)

--

Installing GSAS & EXPGUI on Mac OS X

There are two ways provided here to install GSAS & EXPGUI. The first is preferred since is downloads directly from a subversion repository. In this method the distribution .dmg file does not need to change when the program is updated. Instead, the latest version of the programs are downloaded from a server when the program is installed (an internet connection is obviously required). Subsequently, if there are updates to GSAS or EXPGUI, an update can be made where only the modified or added files are ugraded. This update step can be done using the File/Update?... menu option in EXPGUI or by executing the bootstrap.py file in the GSAS directory. However, these methods require ~double the space needed by GSAS & EXPGUI. For users who need to install GSAS & EXPGUI on systems where an internet connection to the server is not possible or where space usage, an alternate .dmg file is also provided containing all GSAS & EXPGUI files, but this requires that upgrades be performed by downloading and installing the all GSAS & EXPGUI files from a future .dmg distribution.

How to install self-updating GSAS & EXPGUI

The software installation is done using a program called subversion (svn) which is called from a installation script that is run using the Python interpreter. I believe that python can be found on OS X in the default installation from 10.4 on. Subversion comes preloaded on Leopard (10.5) and Snow Leopard systems (10.6). Users of 10.4 will need to install subversion, see the note below.

Here is the procedure needed to load GSAS & EXPGUI:

  • Download file

Intel: http://11bm.xor.aps.anl.gov/downloads/gsas/svnload/gsassvn_i86.dmg
PPC: http://11bm.xor.aps.anl.gov/downloads/gsas/svnload/gsassvn_ppc.dmg

  • If the file does not automatically open in finder showing a volume containing a single gsas folder, click on the downloaded gsassvn .dmg file.
  • Drag the gsas folder to where you want it on your computer. I recommend you place this in an area where you have write access without running as admin (you don't login as an admin, routinely -- right?!). If you place this folder in /Applications or any other central location, use an admin account for the next step, as well as to run EXPGUI to perform upgrades.
  • Click on the gsas folder in the location where you have copied it. You should see three files: bootstrap.py (the installation script); expgui (an applescript for running EXPGUI, OS X 10.5 & 10.6); expgui10.4 (an applescript for running EXPGUI, OS X 10.4)
  • click on bootstrap.py. This should launch python, which will open a terminal window and will start downloading the files needed by GSAS & EXPGUI from the network. If python is installed, but is not connected to the .py extension, it is possible to open a terminal window, use 'cd' to change to the appropriate directory and then type python bootstrap.py Note that this script can safely be rerun if a problem occurs in the download. In fact, whenever it is run, it will check the files on your computer against those on the repository and will download any updates.
  • recommended: drag the expgui (expgui.app) AppleScript to the dock. If using 10.4 on a Intel machine, you will likely have better luck with the expgui10.4 script -- this is the default on the PPC dist. Rename this to expgui. On the PPC distribution, this is the default version. These scripts were updated on April 15, 2010. If you have older versions, you are recommended to replace them with versions from the above file.

EXPGUI is started by clicking on the expgui icon, or by dragging .EXP files or directories onto the expgui icon. On occasion, nothing happens when I click on the icon. Closing or restarting X11 seems to fix this problem.

Upgrades

In EXPGUI, one can press the "Upgrade GSAS/EXPGUI" menu button in the File menu. The response to this will be a window that says if there are updates to download or that the programs are "up-to-date". If there are updates, you have the option of installing them and restarting EXPGUI.

If you do not use EXPGUI, you can update by clicking on the bootstrap.py in the gsas folder.

Note that if you make any modifications to any files distributed as part of GSAS or EXPGUI, these files may not be upgraded, should the changes be in the same regions as upgrades made by Bob or myself. If you are in the practice of modifying the programs, you should learn to use svn and do your upgrades by hand.

Note for Users of 10.4 (Tiger) === #10dot4

Users of 10.4 will need to install subversion. This can be done with Fink or MacPorts. Note that all that is needed is the svn client, should you have a choice in package size. Note this needs to be installed in a place where Python and EXPGUI can find it. If you have svn and python can't find it for bootstrap.py, edit that file or modify your path. If EXPGUI can find it, set EXPGUI(pathlist) to hold the path to svn (see customization).

How to install non-updating GSAS & EXPGUI

Users without network access on their Mac, or running 10.4 who do not want to install subversion can use this method to install GSAS & EXPGUI. If this is used, the software cannot fetch the latest upgrades from the server.

  • Download distribution file

Intel: http://11bm.xor.aps.anl.gov/downloads/gsas/macOSX/gsas+expgui_osxi86.dmg
PPC: http://11bm.xor.aps.anl.gov/downloads/gsas/macOSX/gsas+expgui_osxppc.dmg

  1. Note that the subversion version number for this distribution can be determined by noting the latest number gsas+expgui_osc???_Vxxxx.dmg in directory http://11bm.xor.aps.anl.gov/downloads/gsas/windows/
  • If the file does not automatically open in finder showing a volume containing a single gsas folder, click on the downloaded gsassvn .dmg file.
  • Drag the gsas folder to where you want it on your computer. I recommend you place this in an area where you have write access without running as admin (you don't login as an admin, routinely -- right?!). If you place this folder in /Applications or any other central location, you will need to use an admin account for the next step, as well as later to perform upgrades.
  • recommended: drag the expgui (expgui.app) AppleScript to the dock. If using 10.4 on a Intel machine, you will likely have better luck with the expgui10.4 script -- this is the default on the PPC dist. Rename this to expgui. On the PPC distribution, this is the default version. These scripts were updated on April 15, 2010. If you have older versions, you are recommended to replace them with versions from the above file.

EXPGUI is started by clicking on the expgui icon, or by dragging .EXP files or directories onto the expgui icon.