[GRASS-SVN] r39315 - in grass-web/trunk/grass64/binary/mswindows: . cygwin

Mon Sep 28 15:22:56 EDT 2009

Author: neteler
Date: 2009-09-28 15:22:53 -0400 (Mon, 28 Sep 2009)
New Revision: 39315

Added:
   grass-web/trunk/grass64/binary/mswindows/cygwin/
   grass-web/trunk/grass64/binary/mswindows/cygwin/README.html
   grass-web/trunk/grass64/binary/mswindows/cygwin/setup.ini
Log:
new cygwin version from Glynn

Added: grass-web/trunk/grass64/binary/mswindows/cygwin/README.html
===================================================================

--- grass-web/trunk/grass64/binary/mswindows/cygwin/README.html	                        (rev 0)
+++ grass-web/trunk/grass64/binary/mswindows/cygwin/README.html	2009-09-28 19:22:53 UTC (rev 39315)
@@ -0,0 +1,220 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML> <BODY BGCOLOR=#FFFFFF>
+
+<h3>Installation instructions for GRASS on MS Windows with Cygwin (winGRASS)</h3>
+
+<OL>
+<LI><a href="#prereq">Program installation</a>
+<LI><a href="#data">Installing data</a>
+<LI><a href="#icon">Setting up an icon on the Desktop</a>
+<LI><a href="#trouble">Troubleshooting</a>
+<LI><a href="#manually">Manually installing packages</a>
+<LI><a href="#bugs">Reporting bugs</a>
+</OL>
+
+
+<a name="prereq"></a>
+<h4>Prerequisites:</h4>
+<P>
+This UNIX oriented GRASS 6.4 for Windows version requires the Free 
+<a href="http://www.cygwin.com">Cygwin UNIX compatibility</a> software.
+Alternatively, there is a native WinGRASS available.
+<P>
+Due to the Cygwin dependency GRASS 6.4 can not be installed directly.
+Fortunately the Cygwin setup program is fairly easy to use, and both
+it and GRASS can be installed by following a few simple instructions.
+<BR>(Don't panic!)
+<P>
+For installation of Cygwin, see
+<a href="http://geni.ath.cx/grass.html#_Cygwin_setup_package">http://geni.ath.cx/grass.html#_Cygwin_setup_package</a>.
+
+The instructions given there can be used with slight modification.
+<ul>
+ <li>Due to a
+   <a href="http://cygwin.com/ml/cygwin-announce/2008-08/msg00001.html">recent
+   change within the Cygwin installer program</a> you must now start Cygwin's
+   <tt>setup.exe</tt> from the command line as "<tt>setup.exe -X</tt>".
+
+ <li>At step #3 use
+   <tt>http://grass.ibiblio.org/grass64/binary/mswindows/cygwin/</tt>
+   (or a <a href="http://grass.ibiblio.org/mirrors.php">local mirror</a>)
+   instead of <tt>http://geni.ath.cx/grass</tt>.
+
+ <li>In step #5 the version is 6.4.0.RC5 instead of 6.0.cvs-1, and there's
+   no grass.bat script.
+</ul>
+
+<h5>Required packages:</h5>
+These should all be selected for install automatically when you select
+the GRASS package (Database section).
+Look inside the <tt>setup.ini</tt> file to see the specific package requirements.
+
+<h5>Optional packages:</h5>
+In addition to the core requirements these packages are quite useful and
+some GRASS modules won't work without them:
+<UL>
+<li><b>bc</b> - command line calculator
+<li><b>file</b> - determines file types
+<li><b>netpbm</b> - image format conversions
+<li><b>unzip</b> - decompress file archives
+<li><b>util-linux</b> - provides "more", nice for g.list
+<li><b>wget</b> - command line WWW download utility
+</UL>
+
+A good text editor, such as <b>nedit</b>, which can translate between
+DOS and UNIX end-of-line text formats is also handy to have around.
+
+<P><BR>
+To start GRASS, double-click on the Cygwin icon and run "<tt>startx</tt>" at
+the command prompt. This will start X-Windows and open a new xterm window.
+At the xterm prompt type "<tt>grass64</tt>".
+<P>
+To start GRASS from an icon on the Desktop, <a href="#icon">see below</a>.
+<P>
+In case of problems see the <a href="#trouble">troubleshooting section</a>
+below.
+
+<br><br>
+<hr>
+<br>
+<a name="data"></a>
+<h4>Installing data:</h4>
+
+Create a new directory in your Cygwin home directory called
+"<tt>grassdata/</tt>" for your data.<BR> For example, using the
+<a href="http://grass.ibiblio.org/download/data.php">Spearfish sample dataset</a>:
+<BR>(<i>assumes you have already downloaded the dataset and put the file in
+your Cygwin home directory [aka "~" or c:\cygwin\home\$USER\]</i>)
+
+<DD>
+<pre>
+$ cd ~
+$ mkdir grassdata/
+$ cd grassdata/
+$ tar xzf ~/spearfish_grass60data-0.3.tar.gz
+</pre>
+</DD>
+
+Then start GRASS using <tt>/home/$USER/grassdata/</tt> as your GIS data
+directory.
+
+<br><br>
+<hr>
+<BR>
+
+<a name="icon"></a>
+<h4>Starting Cygwin GRASS from an icon on the desktop:</h4>
+
+copy c:\cygwin\cygwin.bat to c:\cygwin\cygwin_grass.bat
+<P>
+edit c:\cygwin\cygwin_grass.bat so it looks like this:
+  (add "set GRASS_AUTOSTART=1" and "-c startx")
+<BR>
+<DD><PRE>
+ at echo off
+
+C:
+chdir C:\cygwin\bin
+
+set GRASS_AUTOSTART=1
+bash --login -i -c startx
+</PRE></DD>
+<BR>
+<P>
+Next in your cygwin home dir add this to the end of ~/.bashrc :
+<DD><PRE>
+#################
+# Start GRASS
+if [ -n "$DISPLAY" ] && [ -n "$GRASS_AUTOSTART" ] ; then
+   unset GRASS_AUTOSTART
+   exec grass64
+fi
+#################
+</PRE></DD>
+<BR>
+<P>
+Finally make a shortcut from cygwin_grass.bat to the Desktop.
+<P>
+<a href="http://freegis.org/cgi-bin/viewcvs.cgi/*checkout*/grass6/lib/init/grass.ico?rev=HEAD">
+Download the GRASS icon</a> and select it by right-clicking on the desktop
+shortcut and in "Preferences" click on Change Icon and Browse.
+<P>
+done!
+
+<br><br>
+<hr>
+<br>
+
+<a name="trouble"></a>
+<h4>Troubleshooting:</h4>
+
+If some modules mysteriously fail there are a few things you can do to help
+diagnose the problem. If the GUI fails (for example with a "child process
+exited abnormally" error) your first check should be the region settings
+module. Try typing "<tt>g.region -p</tt>" at the command line and make sure
+you get reasonable values for north, south, east, west and resolution.
+If a module returns you to the command prompt with no activity at all,
+try typing "<tt>echo $?</tt>" immediately after to query the module's exit
+code. If that says "53" you are most likely missing a library (DLL). To find
+out which one run "<tt>cygcheck g.region</tt>" (replace g.region with the
+offending module's name). You can then search for the name of the package
+that contains the missing file at the <a href="http://cygwin.com/packages/">
+Cygwin package search page</a>. Re-run the Cygwin installer to load the
+missing package; it will have remembered your earlier selections.
+Feel free to file a bug report as well (<a href="#bugs">see below</a>).
+<P>
+If the GRASS mapset selection startup screen doesn't load at all, you can
+attempt to bypass it by giving the path to the mapset directly on the command
+line. For example:
+<pre>
+  grass64 grassdata/spearfish60/user1
+</pre>
+<P>
+From outside of GRASS you can run <tt>cygcheck</tt> to check for missing
+DLL libraries by first changing to GRASS's library directory:
+<pre>
+  cd /usr/local/grass-6.4.0.RC5/lib
+  cygcheck ../bin/g.region
+</pre>
+
+<br><br>
+<hr>
+<br>
+<a name="manually"></a>
+<h4>Installing packages by hand:</h4>
+
+(<i>only required if you didn't install via a GRASS mirror (with "setup.ini")
+from within the Cygwin installer</i>)
+
+<P>
+The winGRASS package is just a .tar.bz2 file. It can be extracted into Cygwin's
+root directory (or use setup.ini as explained in <a href="#prereq">above</a>
+external notes),
+e.g.:
+
+<DD>
+<pre>
+$ cd /
+$ tar xjf /path/to/grass-6.4.0.RC5-1.cygwin.tar.bz2
+</pre>
+</DD>
+
+Everything will be /usr/local/grass-6.4.0.RC5, except for the grass64
+script which is in /usr/local/bin.
+<p>
+Regarding external dependencies: the only dependencies which aren't
+provided by Cygwin are GDAL and Tcl/Tk. They can be downloaded
+above and they have to be extracted into Cygwin's root directory
+as well (or use setup.ini as explained in <a href="#prereq">above</a>
+external notes).
+
+<BR><BR>
+<hr>
+<a name="bugs"></a>
+Please help us and report bugs:
+<a href="http://grass.osgeo.org/bugtracking/">Bug report form</a>
+<P>
+Last changed: $Date: 2008-01-17 04:55:17 +0100 (Thu, 17 Jan 2008) $
+</P>
+</BODY>
+</HTML>

Added: grass-web/trunk/grass64/binary/mswindows/cygwin/setup.ini
===================================================================
--- grass-web/trunk/grass64/binary/mswindows/cygwin/setup.ini	                        (rev 0)
+++ grass-web/trunk/grass64/binary/mswindows/cygwin/setup.ini	2009-09-28 19:22:53 UTC (rev 39315)
@@ -0,0 +1,6 @@
+@ grass
+sdesc: "GRASS - Geographic Resources Analysis Support System"
+category: Database
+requires: cygwin gdal libfftw3_3 lapack lapack libGL1 libGLU1 libX11_6 libXm2 libXmu6 libcairo2 libfreetype6 libiconv2 libintl8 libncurses9 libpng12 libpq5 libproj1 libreadline6 libsqlite3_0 libtiff5 zlib0
+version: 6.4.0.RC5-1
+install: grass-6.4.0.RC5-1.cygwin.tar.bz2 18190241 6db7186f257d25187d88adc219c36aa0

