Context Navigation

Changes between Version 29 and Version 30 of SingleStepWindowsIllustrated

Timestamp:: Jan 7, 2020 2:15:16 PM (4 years ago)
Author:: toby
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

SingleStepWindowsIllustrated

-                      v29
+                      v30
+== 64-bit Windows: Installing GSAS-II with a single download ==
+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].
+= 64-bit Windows: Installing GSAS-II with a single download =
+A 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.)
+{{{#!comment
+[SingleStepWindowsNew Click here to see this page without screen images].
+}}}
 Download this .exe file (~0.4 Gb):
 …
 [[Image(1.png, 600px)]]
 === Install Python ===
 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.
+== Install Python & GSAS-II ==
+Run 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.
 [[Image(2a.png, 300px)]] [[Image(2b.png, 300px)]]
 …
    [[Image(4.png, 350px)]]
 *  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.
 * 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.
+*  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.
+* 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.
    [[Image(5.png, 350px)]]
 …
 * The '''Installation Location''' needs some special discussion. The default works for most people, but there are times where this may not work.
  * **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}}}.
  * **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.
+ * **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.
  * **new**: Whatever location you supply must be a directory that does not already exist or if it exists, must be empty.
 * '''''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}}}
+* '''''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}}}
    [[Image(7.png, 350px)]]
 …
 * 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.
+* 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.
  [[Image(8.png, 300px)]] [[Image(8a.png, 300px)]]
 …
 * 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.
+* 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)].
   [[Image(9.png, 300px)]]
 …
 * After that message appears, several steps will happen with no displayed messages. As the installation completes, several step occur in the background.
+* 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.)
    *  A script {{{<Prefix>\GSASII\RunGSASII.bat}}} that launches GSAS-II in the location where it has been installed will be created.
+   *  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)
+   * A desktop icon is created that allows GSAS-II to be started. (See note below for re-installation)
+   [[Image(10.png, 300px)]]
+   * A The last step will be to download the latest version of GSAS-II.
+[[Image(13.png, 400px)]]
+Then click on "Next" and "Finish". to complete the installation.
+Feedback on installation instructions is welcomed. E-mail Brian dot Toby at ANL dot gov.
+   *  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])
+   * A desktop icon is created that allows GSAS-II to be started. (See [#Reinstallation note below for reinstallation])
+   [[Image(10.png, 100px)]]
+   * 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.
+[[Image(11.png, 400px)]] [[Image(13.png, 400px)]]
+Then 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.
+Feedback on these installation instructions is welcomed. E-mail Brian dot Toby at ANL dot gov.
+[=#Reinstallation]
 == Reinstallation or installation of multiple copies of GSAS-II ==
+[[Image(re1.png, 250px)]]
+[[Image(re2.png, 400px)]]
+I 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.
+If you attempt to install GSAS-II twice, only one version can be selected to open
+.gpx (project) files by clicking on them. If you already have a GSAS-II
+installed (unless the package has been deleted or moved) you will get this message:
+  [[Image(re1.png, 250px)]]
+Click Yes to use the newly-installed GSAS-II version and No if the previous version should be used when clicking on .gpx files.
+Likewise, 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.
+  [[Image(re2.png, 400px)]]
+[=#Logfiles]
 == Debugging ==
+== Recovering After an update problem ==
+== Sites requiring and Internet Proxy ==
+== Licenses ==
+Several files are created as the GSAS-II customization is done.
+* File {{{<Prefix>\GSASII\RunGSASII.bat}}} contains a script for running GSAS-II
+* File {{{<Prefix>\GSASII\InstallLog.txt}}} contains the output when creating the above
+  script, the registry entry and the desktop icon.
+* 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.
+If installation fails and you want to get help, please include these files in your e-mail.
+[=#bootstrap]
+== Recovering after an install problem ==
+If 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:
+   {{{<Prefix>\Scripts\activate.bat}}}
+   {{{<Prefix>\python.exe <Prefix>\GSASII\bootstrap.bat}}}
+A 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.
+== Sites requiring an Internet Proxy ==
+Some 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.)
+The 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.
+= Licenses =
 [=#AnacondaLicense '''GSAS-II Information & Anaconda license:''']
 …
 These links offer an older distributions that has worked for many people, if you have trouble with the previous:
  * 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)
+These 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.
+ * 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)
  * https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-1.0.1-Windows-x86_64.exe (Python 3.7, Oct 2018)
+ * https://anl.box.com/v/GSASII4windows12
+ * https://www.aps.anl.gov/files/download/CXS/GSASIIdists/g2conda-0.1.2-Windows-x86_64.exe
+ * 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)