Changes between Version 28 and Version 29 of SingleStepWindowsIllustrated


Ignore:
Timestamp:
Jan 7, 2020 10:37:46 AM (22 months ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • SingleStepWindowsIllustrated

    v28 v29  
    11== 64-bit Windows: Installing GSAS-II with a single download ==
    22
    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- or later is required. [SingleStepWindowsNew Click here to see this page without screen images].
     3A 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].
    44
    55Download this .exe file (~0.4 Gb):
     
    1111=== Install Python ===
    1212
    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. You will likely see some sort of message protecting you from this "unknown and possibly malicious app".
     13Run 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.
    1414
    1515[[Image(2a.png, 300px)]] [[Image(2b.png, 300px)]]
     
    4242
    4343
    44 Click on "More Info" and a "Run anyway" button is displayed, as above. Click on "Run anyway" and the installer will start:
    45 
    46 [[Image(4.png, 350px)]]
     44* With the standard warning, click on "More Info" and a "Run anyway" button is displayed, as above. Click on "Run anyway" and the installer will start:
     45   [[Image(4.png, 350px)]]
    4746
    4847*  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.
    4948
    5049* 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.
    51 
    52 [[Image(5.png, 350px)]]
     50   [[Image(5.png, 350px)]]
    5351
    5452* We have only tested with install for "Just Me". Use of "All users" is probably not an ideal choice in any case, as likely only the installer would be able to save options and do updates.
    55 
    56 [[Image(6.png, 350px)]]
    57 
    58 
    59 
    60 
    61 
    62 
    63 
    64 
    65 
    66 
    67 
    68 
    69 
    70 
    71 
    72 
    73 
    74 
    75 
    76 
    77 
    78 
    79 
    80 
    81 
    82 
    83 
    84 
    85 
    86 
    87 
    88 
    89 
    90 
    91 
    92 
    93 
    94 
    95 
    96 
    97 
    98 
    99 
    100 
    101 
    102 
    103 
    104 
    105 
    106 
    107 
    108 
    109 
    110 
    111 
    112 
    113 
    114 
    115 
    116 
    117 
    118 
    119 
    120 
    121 
    122 
    123 
    124 
    125 
    126 
    127 
    128 
    129 * The '''Installation Location''' may need some attention. The default works for most people, but 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:\GSASII}}}. Whatever location you supply must be a directory that does not already exist or must not contain any files. '''''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 and will be referenced below as {{{<Prefix>}}} so that if you install as {{{C:\GSASII}}} then {{{<Prefix>\subdir\file.txt}}} means {{{C:\GSASII\subdir\file.txt}}}
    130 
    131 [[Image(7.png, 350px)]]
     53   [[Image(6.png, 350px)]]
     54
     55
     56
     57
     58
     59
     60
     61
     62
     63
     64
     65
     66
     67
     68
     69
     70
     71
     72
     73
     74
     75
     76
     77
     78
     79
     80
     81
     82
     83
     84
     85
     86
     87
     88
     89
     90
     91
     92
     93
     94
     95
     96
     97
     98
     99
     100
     101
     102
     103
     104
     105
     106
     107
     108
     109
     110
     111
     112
     113
     114
     115
     116
     117
     118
     119
     120
     121
     122
     123
     124
     125
     126* The '''Installation Location''' needs some special discussion. The default works for most people, but there are times where this may not work.
     127 * **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.
     129 * **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}}}
     131   [[Image(7.png, 350px)]]
    132132
    133133* If you choose a location with spaces in the name you will get a warning. You can use the "Back" button to select a new installation location.
    134 
    135 [[Image(7a.png, 250px)]]
     134   [[Image(7a.png, 250px)]]
    136135
    137136
     
    163162* 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.
    164163
    165 [[Image(8.png, 300px)]] [[Image(8a.png, 300px)]]
    166 
    167 * 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 several minutes will be needed before much happens.
    168  
    169 [[Image(9.png, 300px)]]
    170 
    171 * After that message appears, several steps will happen with no displayed messages.
    172 
    173 A script RunGSASII.bat will be created
    174 
    175 An icon for start
    176 
    177 A The last step will be to download the latest version of GSAS-II.
     164 [[Image(8.png, 300px)]] [[Image(8a.png, 300px)]]
     165
     166
     167
     168
     169
     170
     171
     172
     173
     174
     175
     176
     177
     178
     179
     180
     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.
     182
     183  [[Image(9.png, 300px)]]
     184
     185
     186
     187
     188
     189
     190
     191
     192
     193
     194
     195
     196
     197
     198
     199
     200
     201
     202
     203
     204
     205
     206
     207
     208
     209
     210* After that message appears, several steps will happen with no displayed messages. As the installation completes, several step occur in the background.
     211   *  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.
    178216
    179217[[Image(13.png, 400px)]]
     
    184222
    185223Feedback on installation instructions is welcomed. E-mail Brian dot Toby at ANL dot gov.
     224
     225
     226== Reinstallation or installation of multiple copies of GSAS-II ==
     227[[Image(re1.png, 250px)]]
     228[[Image(re2.png, 400px)]]
     229
    186230
    187231
     
    207251run the bootstrap.py script to create shortcuts and will use svn to
    208252update to the latest version of GSAS-II, if an internet connection is
    209 available. Noet that the bootstrap.py script can be rerun manually to
     253available. Note that the bootstrap.py script can be rerun manually to
    210254obtain updates.
    211255