Changes between Version 8 and Version 9 of InstallWindows


Ignore:
Timestamp:
Apr 16, 2010 4:50:21 PM (11 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallWindows

    v8 v9  
    11= Installing GSAS & EXPGUI on Windows =
    22
    3 This procedure describes a new way to install GSAS & EXPGUI directly from a subversion repository. In this method the distribution files
    4 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.
     3There are three ways provided here to install GSAS & EXPGUI. The first two are preferred since the 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. This method does ~double the files 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, a .zip file is also provided with all files, but this requires that upgrades be performed by downloading the entire .zip file each type an upgrade will be installed.
    54
    6 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.
    7 
    8 == How to install GSAS & EXPGUI (preferred) ==
     5== How to install self-upgrading GSAS & EXPGUI with self-installer (preferred) ==
    96
    107 * 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.
     
    2017 * 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.
    2118
    22 == How to install GSAS & EXPGUI from a zip file ==
     19Note 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 is us, see the next step.
    2320
    24 The packaging program used above is getting a bit old and does not run properly on some computers. So, it is also possible to install the same files with different process. However, this method requires more steps. Directions below are for Windows XP and might need to be slightly different on other versions of Windows.
     21
     22== How to install self-upgrading GSAS & EXPGUI from a zip file ==
     23
     24The packaging program used above is getting a bit old and does not run properly on some computers. So, an alternate process is available to install the same files 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.
    2525
    2626 * Step 1: Download file http://11bm.xor.aps.anl.gov/downloads/gsas/svnload/gsas+expgui_svn.zip
     
    3232 * Step 4. Drag (Copy) the contents of the zip file to the new GSAS directory.
    3333
    34  * 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.
     34 * Step 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, when ever it is run, it will check the files on your computer against those on the repository and will download any updates.
    3535
    36  * Step 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)
     36 * Step 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).
    3737
    38  * Step 7 (optional). Make a desktop shortcut to run EXPGUI
     38 * Step 7 (optional). Make a desktop shortcut to run EXPGUI:
    3939
    4040    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
     
    6868    Copy the shortcut(s) created above from the desktop to the new folder in Start Menu\Programs
    6969
     70== How to install non-upgrading GSAS & EXPGUI from a zip file ==
     71
     72If you need to download a file that will be used to install GSAS & EXPGUI onto a computer where a connection can not be made to the subversion server, a smaller all-in-one download is available.
     73The packaging program used above is getting a bit old and does not run properly on some computers. So, an alternate process is available to install the same files 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.
     74
     75 * Step 1. Download file http://11bm.xor.aps.anl.gov/downloads/gsas/windows/gsas+expgui_win.zip
     76
     77 * Step 2. Open the file in the windows file browser, you should see a gsas folder.
     78
     79 * Step 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.
     80
     81 * Step 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).
     82
     83 * Step 5 (optional). Make a desktop shortcut to run EXPGUI:
     84
     85    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
     86            c:\gsas\exe\ncnrpack.exe c:\gsas\expgui\expgui
     87
     88      (modify previous paths, if you have located the files in different places)
     89
     90    click on NEXT with the left mouse button.
     91
     92    Enter name EXPGUI
     93
     94    Change the icon for the shortcut to use the expgui.ico button
     95
     96    click on FINISH with the left mouse button.
     97
     98      You may want to modify the shortcut by modifying the properties to change the icon or the default properties.
     99
     100 * Step 6 (optional). Make a desktop shortcut to run PC-GSAS.
     101    see above, except the command to enter for the shortcut is
     102           c:\gsas\exe\pc-gsas.bat
     103    and use the gsas.ico file as an icon
     104
     105 * Step 7 (optional). Add shortcut(s) to Start Menu.
     106
     107    Right-click on Start Menu, select open from list of choices
     108
     109    Left-click on Programs folder
     110
     111    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.
     112
     113    Copy the shortcut(s) created above from the desktop to the new folder in Start Menu\Programs
     114
    70115== Upgrades ==
    71116
    72 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.
     117In 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.
    73118
    74 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.
     119If 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.
    75120
    76 One other option for upgrades is to use the free Tortoise SVN package (http://tortoisesvn.net/), which I recommend highly to windows users.
    77 
    78 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.
    79 
    80 
    81 
    82 
     121One 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.