Changes between Version 9 and Version 10 of InstallOSX


Ignore:
Timestamp:
Apr 16, 2010 6:35:28 PM (11 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallOSX

    v9 v10  
    11= Installing GSAS & EXPGUI on Mac OS X =
    22
    3 This page describes a new method for installing GSAS & EXPGUI where a small disk image is downloaded, which  contains a script that loads the latest versions of GSAS and EXPGUI. When GSAS & EXPGUI are loaded in this fashion, a menu item is activated in EXPGUI that allows it to check for updates and install them. Different distributions are available for Macs with Intel processors or with older PPC (G4 & G5) processors.
     3There 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.
    44
    5 The software installation is done using a program called subversion (svn), in addition the installation script 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.
     5== How to install self-updating GSAS & EXPGUI ==
    66
    7 == How to install GSAS & EXPGUI ==
     7The 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''', [#10dot4 see the note below].
    88
    99Here is the procedure needed to load GSAS & EXPGUI:
     
    1919 * 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)
    2020
    21  * 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 not connected to the .py extension, it is possible to open a terminal window, use 'cd' to change to the approiate directory and then type 'python bootstrap.py'
     21 * 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.
    2222
    23  * 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. 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.
     23
     24 * 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.
    2425
    2526EXPGUI 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.
     
    3334Note 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.
    3435
    35 == Note for Users of 10.4 (Tiger) ==
     36=== Note for Users of 10.4 (Tiger) === #10dot4
    3637Users of 10.4 will need to install subversion. This can be done with [http://www.finkproject.org/ Fink] or [http://www.macports.org/ 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.
    3738If 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).
     39
     40== How to install non-updating GSAS & EXPGUI ==
     41
     42  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.
     43
     44 * Download distribution file
     45      Intel: http://11bm.xor.aps.anl.gov/downloads/gsas/macOSX/gsas+expgui_osxi86.dmg [[BR]]
     46      PPC:   http://11bm.xor.aps.anl.gov/downloads/gsas/macOSX/gsas+expgui_osxppc.dmg
     47    a. 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/
     48
     49 * If the file does not automatically open in finder showing a volume containing a single gsas folder, click on the downloaded gsassvn .dmg file.
     50
     51 * 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.
     52
     53 * 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.
     54
     55EXPGUI is started by clicking on the expgui icon, or by dragging .EXP files or directories onto the expgui icon.