Changes between Version 29 and Version 30 of SingleStepWindowsIllustrated


Ignore:
Timestamp:
Jan 7, 2020 2:15:16 PM (22 months ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • SingleStepWindowsIllustrated

    v29 v30  
    1 == 64-bit Windows: Installing GSAS-II with a single download ==
    2 
    3 A single download installer can be used to install the latest version of GSAS-II. If the file downloaded file is moved to a computer not connected to the internet it will install a working, but slightly out-of-date GSAS-II version. Note that 64-bit Windows is required (currently Windows-7 or later.) [SingleStepWindowsNew Click here to see this page without screen images].
     1= 64-bit Windows: Installing GSAS-II with a single download =
     2
     3A single download installer can be used to install the latest version of GSAS-II. To install GSAS-II on a computer not connected to the internet, download this file and move it to desired computer; running it will install a working, but slightly out-of-date GSAS-II version. Note that 64-bit Windows is required (currently Windows-7 or later.)
     4{{{#!comment
     5[SingleStepWindowsNew Click here to see this page without screen images].
     6}}}
    47
    58Download this .exe file (~0.4 Gb):
     
    912[[Image(1.png, 600px)]]
    1013
    11 === Install Python ===
    12 
    13 Run the downloaded file (gsas2full-*.exe). This can be done by pressing the "Run" button in the web browser if that is an option or you may need to click on the file once downloaded. You will likely see some sort of message protecting you from this "unknown and possibly malicious app" as below. This may be different depending on what antivirus software is installed on your computer. It is possible that you may need help from your local system administrators, etc. in running a downloaded .exe file.
     14== Install Python & GSAS-II ==
     15
     16Run the downloaded file (gsas2full-*.exe). This can be done by pressing the "Run" button in the web browser, if your browser provides that option or you may need to double-click on the file once downloaded. You will likely see some sort of message protecting you from this "unknown and possibly malicious app" as below. This may be different depending on what antivirus software is installed on your computer. It is possible that you may need help from your local system administrators, etc. to run a downloaded .exe file.
    1417
    1518[[Image(2a.png, 300px)]] [[Image(2b.png, 300px)]]
    16 
    17 
    18 
    1919
    2020
     
    4545   [[Image(4.png, 350px)]]
    4646
    47 *  This screen shows the version number of GSAS-II that is contained in the installer. Later this will be updated, if an internet connection is available. The installer suggests closing all applications. It is wise to save work in other applications, but closing them seems a bit excessive. You will need to pass through several windows by pressing "Next", selecting options as you go.
    48 
    49 * Pressing Next the 1st time brings you to the License Agreement window shows you the article we ask you to cite, as well as the use terms for Python and packages, as below. You must agree to continue. The License for use of GSAS-II is found in the source code for the package; for convenience the full text [#AnacondaLicense from this screen] and the [#G2license GSAS-II license] are shown below.
     47*  This screen shows the version number of GSAS-II that is contained in the installer. Note that GSAS-II will be updated later, if an internet connection is available. The installer suggests closing all applications. It is wise to save work in other applications, but closing them seems a bit excessive. You will need to pass through several windows by pressing "Next", selecting options as you go.
     48
     49* Pressing Next the first time brings you to the License Agreement window. This shows you the article we ask you to cite, as well as the use terms for Python and packages, as below. You must agree to continue. The License for use of GSAS-II is found in the source code for the package; for convenience the full text [#AnacondaLicense from this screen] and the [#G2license GSAS-II license] are shown below.
    5050   [[Image(5.png, 350px)]]
    5151
     
    126126* The '''Installation Location''' needs some special discussion. The default works for most people, but there are times where this may not work.
    127127 * **special characters and spaces**: there have been problems reported with Python installations when the install location contains spaces and or non-ASCII characters. GSAS-II has been tested and appears to work fine in locations with spaces in the name (like {{{C:\Users\Brian Toby\GSASII}}}) but this has not been tested with other types of text. You may wish to install in {{{C:\GSAS2}}}.
    128  * **removeable drives**: You can install GSAS-II anywhere you wish, including on removable and network drives, but the name cannot change (if yon install it on drive F: and that drive is later reloaded as E: the software may not run properly; you also must reinstall rather than move the installation to another location.
     128 * **removable drives**: You can install GSAS-II anywhere you wish, including on removable and network drives, but the installation location cannot change (if you install on drive F: and that drive is later reloaded as E:, the software may not run properly; if you need to move the installation to a new location, you should reinstall.
    129129 * **new**: Whatever location you supply must be a directory that does not already exist or if it exists, must be empty.
    130 * '''''Please make a note of where you install GSAS-II''''' (use of right-click will allow you to copy the text.) This can be useful to recover from an incomplete installation or look at error logs. The location you use will be referenced below as {{{<Prefix>}}} so that if you install as {{{C:\G2}}} then {{{<Prefix>\subdir\file.txt}}} means {{{C:\G2\subdir\file.txt}}}
     130* '''''Please make a note of where you install GSAS-II''''' (use of right-click will allow you to copy the text.) This can be useful to recover from an incomplete installation or look at error logs. The location you use will be referenced below as {{{<Prefix>}}} so that if your install location is set to be {{{C:\G2}}} then {{{<Prefix>\subdir\file.txt}}} means {{{C:\G2\subdir\file.txt}}}
    131131   [[Image(7.png, 350px)]]
    132132
     
    160160
    161161
    162 * The Advanced Installation Options are not that important, but the suggestion is that you do not select either option. The default for the second option is usually to have the second option selected. This makes lets other packages make use of the version of Python you are installing for GSAS-II. This is not likely to cause any problems with GSAS-II, but if you are using Python for code development, you are suggested to install another copy of Python and work with that.
     162* The Advanced Installation Options are not that important, but the suggestion is that you make sure both options are unchecked. The default is usually to have the second option selected (unless you already have Python registered). If the second option is selected, this allows other packages make use of the copy of Python you are installing for GSAS-II. This is not likely to cause any problems with GSAS-II, but if you are using Python for code development, you are suggested to install another copy of Anaconda Python and work with that so you can add packages to and update Python without affecting GSAS-II.
    163163
    164164 [[Image(8.png, 300px)]] [[Image(8a.png, 300px)]]
     
    179179
    180180
    181 * At this point, click on the "Install" button and allow the installation of files to start. Expect the installation to speed along until the "Setting up package cache ..." message is displayed, and at that point things slow down and at least several minutes will be needed before much happens. Clicking on "Show details" will show you that the installation is actually running various steps.
     181* At this point, click on the "Install" button and allow the installation of files to start. Expect the installation to speed along until the "Setting up package cache ..." message is displayed, and at that point things slow down and perhaps five minutes will be needed before much happens. Clicking on "Show details" will show you that the installation is actually running various steps. If installation stalls at "Setting up the base environment" look for an obscured window with [#Reinstallation re-installation questions (see below)].
    182182
    183183  [[Image(9.png, 300px)]]
     
    208208
    209209
    210 * After that message appears, several steps will happen with no displayed messages. As the installation completes, several step occur in the background.
     210* After that message appears, several steps will happen with no displayed messages. As the installation completes, several steps occur in the background to customize the installation to run GSAS-II ([#Logfiles see debugging information on log files] created during these steps.)
    211211   *  A script {{{<Prefix>\GSASII\RunGSASII.bat}}} that launches GSAS-II in the location where it has been installed will be created.
    212    *  A Registry entry is created that causes the above above script to be run when double-clicking on .gpx (GSAS-II project) files. (See note below for re-installation)
    213    * A desktop icon is created that allows GSAS-II to be started. (See note below for re-installation)
    214    [[Image(10.png, 300px)]]
    215    * A The last step will be to download the latest version of GSAS-II.
    216 
    217 [[Image(13.png, 400px)]]
    218 
    219 
    220 Then click on "Next" and "Finish". to complete the installation.
    221 
    222 
    223 Feedback on installation instructions is welcomed. E-mail Brian dot Toby at ANL dot gov.
    224 
    225 
     212   *  A Registry entry is created that causes the above above script to be run when double-clicking on .gpx (GSAS-II project) files. (See [#Reinstallation note below for reinstallation])
     213   * A desktop icon is created that allows GSAS-II to be started. (See [#Reinstallation note below for reinstallation])
     214   [[Image(10.png, 100px)]]
     215   * A The last step will be to download the latest version of GSAS-II. This will fail if your  computer is not connected to the internet or a proxy is needed. The installation will not show an error message should this be the case.
     216
     217[[Image(11.png, 400px)]] [[Image(13.png, 400px)]]
     218
     219
     220Then click on "Next" and "Finish". to complete the installation. Test the installation by clicking on the desktop icon and confirming that GSAS-II starts. The Help/"Check for Updates" menu command can be used to check if GSAS-II was able to update to the latest version.
     221
     222Feedback on these installation instructions is welcomed. E-mail Brian dot Toby at ANL dot gov.
     223
     224
     225
     226
     227
     228
     229
     230
     231
     232
     233
     234
     235
     236
     237
     238
     239
     240
     241
     242
     243
     244
     245
     246
     247
     248
     249
     250
     251
     252
     253
     254
     255
     256
     257
     258
     259
     260
     261
     262
     263
     264
     265
     266
     267
     268
     269
     270
     271
     272
     273
     274
     275
     276
     277
     278[=#Reinstallation]
    226279== Reinstallation or installation of multiple copies of GSAS-II ==
    227 [[Image(re1.png, 250px)]]
    228 [[Image(re2.png, 400px)]]
    229 
    230 
    231 
     280
     281I commonly hear from people who are having problems with GSAS-II and try reinstalling as a way to fix the problems. That rarely helps. However, you may want to have more than one copy of GSAS-II on your computer so you can compare how different versions behave. While this can be done with a lot less use of space by duplicating the {{{<Prefix>\GSASII\}}} folder under another name and then running the {{{<Prefix>\GSASII\bootstrap.py}}} or {{{<Prefix>\GSASII\MakeBat.py}}} file ([#bootstrap see Recovery] below), it is much easier to simply install again. Installing a new release also potentially provides a newer version of Python and associated packages. This is also not a bad thing.
     282
     283If you attempt to install GSAS-II twice, only one version can be selected to open
     284.gpx (project) files by clicking on them. If you already have a GSAS-II
     285installed (unless the package has been deleted or moved) you will get this message: 
     286  [[Image(re1.png, 250px)]]
     287Click Yes to use the newly-installed GSAS-II version and No if the previous version should be used when clicking on .gpx files.
     288
     289Likewise, if the desktop shortcut file exists (no check is made to see if the shortcut still works), you will see the dialog below. Specifiy a new name if you want to keep the older shortcut and create a new one. To overwrite the previous shortcut, simply press save and confirm that you want to overwrite the old file. If you use Cancel no shortcut is created.
     290  [[Image(re2.png, 400px)]]
     291
     292
     293
     294
     295
     296
     297
     298
     299
     300
     301
     302
     303
     304
     305
     306
     307
     308
     309
     310
     311
     312
     313
     314
     315
     316
     317
     318[=#Logfiles]
    232319== Debugging ==
    233 
    234 
    235 == Recovering After an update problem ==
    236 
    237 
    238 == Sites requiring and Internet Proxy ==
    239 
    240 
    241 == Licenses ==
     320Several files are created as the GSAS-II customization is done.
     321* File {{{<Prefix>\GSASII\RunGSASII.bat}}} contains a script for running GSAS-II
     322* File {{{<Prefix>\GSASII\InstallLog.txt}}} contains the output when creating the above
     323  script, the registry entry and the desktop icon.
     324* File {{{<Prefix>\GSASII\UpdateLog.txt}}} contains the output when trying to update GSAS-II to the latest version. If this ends with text saying {{{GSAS-II failed to be installed...}}} either the network was inaccessible or a proxy is required.
     325If installation fails and you want to get help, please include these files in your e-mail.
     326
     327
     328
     329
     330[=#bootstrap]
     331== Recovering after an install problem ==
     332If the installation has completed far enough to give you a working Python but the GSAS-II installation fails to complete open a command prompt (cmd.exe) window, and type in these commands:
     333
     334   {{{<Prefix>\Scripts\activate.bat}}}
     335   {{{<Prefix>\python.exe <Prefix>\GSASII\bootstrap.bat}}}
     336
     337A convenient way to do this that avoids spelling errors is to find and drag the file to the window. Be sure to type a space between dragging the {{{<Prefix>\python.exe}}} and the {{{<Prefix>\GSASII\bootstrap.bat}}} files.
     338
     339
     340== Sites requiring an Internet Proxy ==
     341
     342Some sites route traffic to the internet via a proxy computer. Finding a network administrator who knows what your site is doing can be tough. The web site http:/www.whatismyproxy.com/ may help. If you have a proxy, you will need to know either the name or IP address of the proxy computer and you will need to know the IP port (usually 80 but sometimes something else, such as 8080 or 8000.)
     343
     344The easiest way to set the proxy is to start GSAS-II and use the File/"Edit Proxy" menu command; check if the values work using the Help/"Check for Updates" menu command.
     345
     346= Licenses =
    242347
    243348[=#AnacondaLicense '''GSAS-II Information & Anaconda license:''']
     
    357462
    358463
    359 These links offer an older distributions that has worked for many people, if you have trouble with the previous:
    360 
    361  * https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-py27-1.0.2-Windows-x86_64.exe (Python 2.7 version & wxpython 3.0)
     464These links offer an older distributions that have worked in the past, if you have trouble with the previous. They require an internet connection to work and will install the latest GSAS-II version, but with older versions of Python. For these, ignore the "Failed to run postinstall script" error message.
     465
     466 * https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-py27-1.0.2-Windows-x86_64.exe (Python 2.7 version & wxpython 3.0, July 2018)
    362467 * https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-1.0.1-Windows-x86_64.exe (Python 3.7, Oct 2018)
    363  * https://anl.box.com/v/GSASII4windows12
    364  * https://www.aps.anl.gov/files/download/CXS/GSASIIdists/g2conda-0.1.2-Windows-x86_64.exe
    365 
     468 * https://www.aps.anl.gov/files/download/CXS/GSASIIdists/g2conda-0.1.2-Windows-x86_64.exe (even older, may work with pre-Windows 7)
     469