[GRASS-SVN] r31053 - grass-web/trunk/grass63/binary/mswindows/cygwin

Sun Apr 20 05:14:08 EDT 2008

Author: neteler
Date: 2008-04-20 05:14:08 -0400 (Sun, 20 Apr 2008)
New Revision: 31053

Added:
   grass-web/trunk/grass63/binary/mswindows/cygwin/README.html
   grass-web/trunk/grass63/binary/mswindows/cygwin/setup.ini
Log:
instructions (may need further update)

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

--- grass-web/trunk/grass63/binary/mswindows/cygwin/README.html	                        (rev 0)
+++ grass-web/trunk/grass63/binary/mswindows/cygwin/README.html	2008-04-20 09:14:08 UTC (rev 31053)
@@ -0,0 +1,212 @@
+<!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.3 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.3 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#toc5">http://geni.ath.cx/grass.html#toc5</a>.
+
+These instructions can be used, but at step #3 use
+<tt>http://grass.ibiblio.org/grass63/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>.
+
+Also, in step #5 the version is 6.3.0-1 instead of 6.0.cvs-1, and there's no
+grass.bat script.
+
+<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>grass63</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 grass63
+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>
+  grass63 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.3.0/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.3.0-1.cygwin.tar.bz2
+</pre>
+</DD>
+
+Everything will be /usr/local/grass-6.3.0, except for the grass63
+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/grass63/binary/mswindows/cygwin/setup.ini
===================================================================
--- grass-web/trunk/grass63/binary/mswindows/cygwin/setup.ini	                        (rev 0)
+++ grass-web/trunk/grass63/binary/mswindows/cygwin/setup.ini	2008-04-20 09:14:08 UTC (rev 31053)
@@ -0,0 +1,20 @@
+@ grass
+sdesc: "GRASS - Geographic Resources Analysis Support System"
+category: Database
+requires: cygwin gdal libintl8 libiconv2 freetype2 libpng12 fftw3 ncurses libncurses8 proj readline libtiff5 xterm xorg-x11-base lesstif tcltk-grass
+version: 6.3.0-1
+install: grass-6.3.0-1.cygwin.tar.bz2 20083227 f3c2e777d31a6c847a4cb06b68d6e819
+
+@ gdal
+sdesc: "GDAL - Geospatial Data Abstraction Library"
+category: Graphics Libs
+requires: cygwin jasper libpng12 libpq4 libtiff5
+version: 1.5.1-1
+install: gdal-1.5.1-1.cygwin.tar.bz2 13712600 96da8bd5ad121919a7f2e0af0be915e5
+
+@ tcltk-grass
+sdesc: "Tcl/Tk for GRASS"
+category: Libs
+requires: xorg-x11-base
+version: 8.4.7-1
+install: tcltk-grass-8.4.7-1.tar.bz2 2736137 d28cb500f0edc594d43abd27e9033cbc

