Changes between Version 24 and Version 25 of InstallWindows


Ignore:
Timestamp:
May 25, 2014 3:09:35 PM (8 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallWindows

    v24 v25  
    11= Installing GSAS & EXPGUI on Windows =
    22
    3 There are three ways provided here to install GSAS & EXPGUI. The first two are preferred since they download 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 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.bat 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 (~50 Mb) is critical, a .zip file is also provided with all files, but this requires that upgrades be performed by downloading the entire .zip file each time an upgrade will be installed and this distribution will not be updated as frequently.
     3There are two ways provided here to install GSAS & EXPGUI. A third is listed for historical reasons, but is not recommended. 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.
     4
     5-----
     6== Option 1: Install self-upgrading GSAS & EXPGUI with self-installer == #Option1
     7
     8  ''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.
     9
     10 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.
     11 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.
     12 3. After completing all pages through the installer, installation will be complete and GSAS & EXPGUI can now be run from the desktop icons.
    413
    514----
    6 == Option 1: Install self-upgrading GSAS & EXPGUI from a zip file == #Option1
     15== Option 2: Install self-upgrading GSAS & EXPGUI from a zip file == #Option2
    716
    817  ''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 [wiki:News2012May4 the discussion on proxies] for more on configuring that.''
    9 
    10 Since, the packaging program used for Option 2 getting a bit old and fails with a runtime error on some computers,
    11 an alternate process is available to install in the same fashion. 
    12 (I am seeking a volunteer to repackage GSAS and EXPGUI with a more modern installer, please contact  [mailto:brian.toby@anl.gov].)
     18 
    1319So, 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.
    1420
     
    4955   f. Click on FINISH with the left mouse button.
    5056
    51 -----
    52 == Option 2: Install self-upgrading GSAS & EXPGUI with self-installer ==
     57----
     58== Install non-updating GSAS & EXPGUI from a zip file (Not a preferred method) ==
    5359
    54   ''This option is easier than the above, but it does not work on all computers. It appears that the self-installer does not even run on at least some 64-bit versions of Windows. On other computers, depending on how security is set up, you may get a 'Access denied writing HKEY-LOCAL_MACHINE...' error, unless run from an admin account, particularly in Windows-7. If errors occur please try using [#Option1 Option 1], above.''
    55 
    56 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. If you opt to keep the old version, load this version in a new location (or rename the older version). This process will fail if used in the location where the package has already been loaded.
    57 
    58  1. download and run http://11bm.xray.aps.anl.gov/downloads/gsas/svnload/gsas+expgui_svn.exe (this may require more than one step depending on your browser, OS and security settings.)
    59  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. [[BR]]
    60       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@anl.gov
    61  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.
    62  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.
    63 
    64 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. On some windows systems, for reasons unknown, the gsas+expgui_svn.exe program crashes with a runtime error. If this happens for you, see the next step.
    65 
    66 ----
    67 == Option 3: Install non-updating GSAS & EXPGUI from a zip file ==
    68 
    69   ''If the above two options will not work for you, then this should. The resulting installation is not-self updating, and may not reflect the latest releases, which is why this is the last choice.''
     60  ''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.''
    7061
    7162If 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.
     
    10091One 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.
    10192
    102 If you install using Option 3, to upgrade you must download and install a newer gsas+expgui_win.zip file.
     93If you install using the zip file, to upgrade you must download and install a newer gsas+expgui_win.zip file, if it exists.