wiki:InstallWindows
Last modified 20 months ago Last modified on 01/31/18 10:30:37

Installing GSAS & EXPGUI on Windows

As noted on the home page, GSAS & EXPGUI are no longer supported. We recommend use of GSAS-II which does much more and is significantly improved.

There are three ways provided here to install GSAS & EXPGUI. In the second method the latest version of the software is downloaded directly from a subversion repository and at any point later the installed software can be updated at to include any updates using the File/Update?... menu option in EXPGUI or by executing the bootstrap.bat file in the GSAS directory. In the first method files the distribution files may not reflect the latest release, but the Update menu option or the bootstrap.bat file can be used to upgrade to the latest version. Note that since GSAS & EXPGUI will not be updated again, it should not matter which option is used.


Option 1: Install self-upgrading GSAS & EXPGUI with self-installer

This is likely the easiest option for installation of the software. It may require use of administrator privileges. Great thanks are due to Emad Ghanem, who built this self-installing executable.

  1. Download file https://subversion.xray.aps.anl.gov/EXPGUI/install/SetupGSAS_EXPGUI.exe and then run it. (It may be easier to open directory https://subversion.xray.aps.anl.gov/EXPGUI/install in a browser and then click on the file to download it.) The exact steps needed either way will depending on which browser you use, which version of Windows and your security settings.
  2. Run through the installer pages, selecting options as needed. Most defaults options are good choices. You should be able to install the files in a user directory, such as C:\Documents & Settings\<username>\gsas, but this has not been tested.
  3. After completing all pages through the installer, installation will be complete and GSAS & EXPGUI can now be run from the desktop icons.

Option 2: Install self-upgrading GSAS & EXPGUI from a zip file

This install option works for all Windows systems, except for at a few locations where a proxy server may be blocking access to our svn (subversion) server. See the discussion on proxies for more on configuring that.

So, an alternate process is available to install the same mechanism, but starting from a .zip repository. However, this method requires more steps. Directions below are for Windows XP and might need to be slightly different on other versions of Windows. This process requires that the files from the zip package must be loaded into an empty directory. If you opt to keep an old GSAS/EXPGUI version, create a new folder for this install (or rename the older version). This process will fail if used in the location where the package has already been loaded.

  1. Download file http://11bm.xray.aps.anl.gov/downloads/gsas/svnload/gsas+expgui_svn.zip
  2. Open the file in the windows file browser, you should see six files and a folder.
  3. Create a directory where these files should go. I recommend C:\GSAS, but any drive can be used.
  4. Drag (Copy) the contents of the zip file to the new GSAS directory.
  5. Run the BOOTSTRAP.BAT file in the GSAS directory to download the GSAS & EXPGUI files from the server. Note, this file 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.
  6. (optional) Run the MAKEREGISTRY.BAT file to make registry entries that change the icon associated with .EXP files and to link GSAS applications to these files. By default, a double-click on a .EXP file will start EXPGUI, but this can be changed by editing the batch file (see comments inside).
  7. (optional) Make a desktop shortcut to run EXPGUI (see How to Create a Shortcut below).
    1. Use command c:\gsas\exe\ncnrpack.exe c:\gsas\expgui\expgui (modify path from c:\gsas, as needed
    2. Use name EXPGUI
    3. Use as icon the expgui.ico file in c:\gsas (or wherever)
  8. (optional) Make a desktop shortcut to run PC-GSAS (see How to Create a Shortcut below).
    1. Use command c:\gsas\exe\pc-gsas.exe (modify path from c:\gsas, as needed
    2. Use name PC-GSAS
    3. Use as icon the gsas.ico file in c:\gsas (or wherever)
  9. (optional) Add shortcut(s) to Start Menu.
    1. Right-click on Start Menu, select open from list of choices
    2. Left-click on Programs folder
    3. Right-click on a blank section of folder and select new->folder to create place for shortcuts, name the new folder GSAS or GSAS+EXPGUI, etc.
    4. Copy the shortcut(s) created above from the desktop to the new folder in Start Menu\Programs

Note that if you do not create shortcuts using the above steps, the batch files StartEXPGUI.bat and StartPC-GSAS.bat can be used to start EXPGUI and GSAS respectively. These files cannot be moved from the GSAS directory, but shortcuts to these files can be made and those shortcuts can be moved and can have their starting directory changed.

How to create a shortcut

  1. On a blank part of the Windows desktop, click the right mouse button and then select NEW and then shortcut and click with the left mouse button. Find the file to be run. If the command has two or more parts (such as c:\gsas\exe\ncnrpack.exe c:\gsas\expgui\expgui, you will need to edit this, see below.

(modify previous paths, if you have located the files in different places)

  1. click on NEXT with the left mouse button.
  2. Enter name (for example EXPGUI)
  3. click on FINISH with the left mouse button.
  4. Right-click on the newly created shortcut, from the menu select Properties
  5. Change the icon for the shortcut using the "Change Icon..." button to select an icon file (for example expgui.ico)
  6. If the command has two or more parts (such as c:\gsas\exe\ncnrpack.exe c:\gsas\expgui\expgui) edit the information in the Target box. Use quotes (") around file names that contain spaces.
  7. (optional) Change the default starting directory by changing the contents of the "Start in" box.
  8. Click on FINISH with the left mouse button.

Option 3: Install non-updating GSAS & EXPGUI from a zip file

If the above two options will not work for you, then this should. The resulting installation is not-self updating, and provides a version that has not been updated for quite some time.

If you need to download a single file that will be used to install GSAS & EXPGUI onto a computer where a connection cannot be made to the subversion server, a smaller all-in-one download is available. Directions below are for Windows XP and might need to be slightly different on other versions of Windows. This process can be used to overwrite an older GSAS/EXPGUI install.

  1. Download file http://11bm.xray.aps.anl.gov/downloads/gsas/windows/gsas+expgui_win.zip
    1. Note that the subversion version number for this distribution can be determined by noting the latest number gsas+expgui_win_Vxxxx.zip in directory http://11bm.xray.aps.anl.gov/downloads/gsas/windows/
  2. Open the file in the windows file browser, you should see a gsas folder.
  3. Drag that folder to where you want to install GSAS & EXPGUI. Any drive on your computer is fine, but you may encounter problems if you use your desktop or My Documents folder. I recommend C:\GSAS, but any drive can be used.
  4. (optional) Run the MAKEREGISTRY.BAT file to make registry entries that change the icon associated with .EXP files and to link GSAS applications to these files. By default, a double-click on a .EXP file will start EXPGUI, but this can be changed by editing the batch file (see comments inside).
  5. (optional) Make a desktop shortcut to run EXPGUI (see How to Create a Shortcut above).
    1. Use command c:\gsas\exe\ncnrpack.exe c:\gsas\expgui\expgui (modify path from c:\gsas, as needed
    2. Use name EXPGUI
    3. Use as icon the expgui.ico file in c:\gsas (or wherever)
  6. (optional) Make a desktop shortcut to run PC-GSAS (see How to Create a Shortcut above).
    1. Use command c:\gsas\exe\pc-gsas.exe (modify path from c:\gsas, as needed
    2. Use name PC-GSAS
    3. Use as icon the gsas.ico file in c:\gsas (or wherever)
  7. (optional) Add shortcut(s) to Start Menu.
    1. Right-click on Start Menu, select open from list of choices
    2. Left-click on Programs folder
    3. Right-click on a blank section of folder and select new->folder to create place for shortcuts, name the new folder GSAS or GSAS+EXPGUI, etc.
    4. Copy the shortcut(s) created above from the desktop to the new folder in Start Menu\Programs

Upgrades

If one of the first two options is used to install GSAS and EXPGUI, the software can download and install later upgrades from a menu or by running a batch file: From 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. This menu item will not be present if the non-updating method was used to install GSAS & EXPGUI.

If you do not use EXPGUI, you can update by opening the C:\GSAS folder and clicking on the bootstrap.bat file or click on Start, then Run... and then type/browse to c:\gsas\bootstrap.bat (replace c:\GSAS with the installation location you used.) See bootstrap_upgrade.png attachment for what this looks like. This file is not present when GSAS & EXPGUI are installed using the non-updating method.

One other option for upgrades is to use the free Tortoise SVN package (http://tortoisesvn.net/), which I recommend highly to windows users. Note that if you make any modifications to any files distributed as part of GSAS or EXPGUI, these files may not be fully upgraded, should these changes conflict with changes made in the distribution files. If you are in the practice of modifying the programs, you should learn to use Tortoise SVN to do your upgrades.

If you install using the zip file, to upgrade you must download and install a newer gsas+expgui_win.zip file, if it exists.

Attachments