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


Installing GSAS & EXPGUI on Windows

This procedure describes a new way to install GSAS & EXPGUI directly from a subversion repository. In this method the distribution files do 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 required). Subsequently, if there are updates to GSAS or EXPGUI, an update can be made where only the modified or added files are downloaded and installed. This update can be done using the File/Update?... menu option in EXPGUI or by executing the bootstrap.bat file in the GSAS directory.

Note this distribution is for Windows-XP or later. Windows-2000 might work; Windows-95, -98 & -ME are not supported. Also, this distribution does not include an option to uninstall the software. This was removed since it seemed to cause security conflicts for some non-sysadmin users. If you want to uninstall the software you can delete the folder and shortcuts. A few registry items will remain, but they cause no effect and are a lot of work to remove.

How to install GSAS & EXPGUI (preferred)

  • Step 0: If you have a previous version of GSAS & EXPGUI installed, this will not update that version. You can either delete that version or keep it, but note that shortcuts to the older version will likely be overwritten and the registry keys (for right-click options) certainly will be replaced.
  • Step 2: Run through the installer pages, selecting options as needed. Most defaults options are good choices, though some people might prefer to install shortcuts in their Start menu and might prefer no desktop shortcuts.

Note: I am trying to get information on what does not work when one loads GSAS into a directory path that contains spaces (such as C:\Documents & Settings\username\gsas). Please send them to mailto:toby@…

  • Step 3: After you press the Install button on the last page of the installer, the bootstrap.bat file is started in a cmd.exe window.
  • Step 4: In the cmd.exe window, the names of files will stream by as they are loaded (see cmdout.png attachment for what the window will look like at the end). Press Enter in this window and then click on Finish in the "Setup Complete" window. Installation is now complete. GSAS & EXPGUI can now be run.

How to install GSAS & EXPGUI from a zip file

The packaging program used above is getting a bit old and does not run properly on some computers. It is also possible to install the same files with different process. However, this method requires more work.

  • Step 2: Open the file in the windows file browser, you should see four files and a folder.
  • Step 3: Create a directory where these files should go. I recommend C:\GSAS, but any drive can be used.
  • Step 4. Drag (Copy) the contents of the zip file to the new GSAS directory.
  • Step 5. Run the BOOTSTRAP.BAT file in the GSAS directory to download the GSAS & EXPGUI files from the server. This file can safely be rerun if a problem occurs in the download. In fact, it can also be rerun to update the distribution.
  • Step 6. 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)
  • Step 7. Make a shortcut to run EXPGUI

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

c:\gsas\exe\ncnrpack.exe c:\gsas\expgui\expgui

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

click on NEXT with the left mouse button. Enter name EXPGUI Change the icon for the shortcut to use the expgui.ico button click on FINISH with the left mouse button.

You may want to modify the shortcut by modifying the properties to change the icon or the default properties.

  • Step 8. Make a shortcut to run PC-GSAS.

see above, except the command to enter for the shortcut is


and use the gsas.ico file as an icon


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

One other option for upgrades is to use the free Tortoise SVN package (, 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 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 Tortoise SVN to do your upgrades.

Attachments (2)

Download all attachments as: .zip