Difference between revisions of "Windows"

From Madagascar
Jump to navigation Jump to search
Line 7: Line 7:
 
'''NOTE''': If you are unfamiliar with Unix-like systems, a good place to start is Greg Wilson's [http://www.osl.iu.edu/~lums/swc/www/shell.html Software Carpentry] course.  
 
'''NOTE''': If you are unfamiliar with Unix-like systems, a good place to start is Greg Wilson's [http://www.osl.iu.edu/~lums/swc/www/shell.html Software Carpentry] course.  
  
[[Image:cygwin-icon.gif|right|]] You will need to install several additional Cygwin components before Madagascar can run. To get these, rerun the installer program (called <b>Setup</b> and represented by an icon with a black "C" shape enclosing a green arrow).  
+
[[Image:cygwin-icon.gif|right|]] You will need to install several additional Cygwin components before Madagascar can run. To get these, rerun the installer program (called '''Setup''' and represented by an icon with a black "C" shape enclosing a green arrow).  
  
# Start <b>Setup</b> program.  
+
# Start '''Setup''' program.  
 
# Keep clicking (defaults should work, but please choose a mirror on your own continent) until you see a collapsed list (boxed "+" signs) in a selection box.  
 
# Keep clicking (defaults should work, but please choose a mirror on your own continent) until you see a collapsed list (boxed "+" signs) in a selection box.  
# You will want to expand the download window to full screen before proceeding. Choose all of the following before downloading.
+
# Choose all of the following before downloading.
 
+
## '''Open the "Devel" section and select the following:'''
'''Open the "Devel" section and select the following:'''
 
 
 
 
* gcc
 
* gcc
* libnetpbm-devel
 
* swig
 
 
 
If you are developing for Madagascar, also choose
 
If you are developing for Madagascar, also choose
 
 
* subversion
 
* subversion
 
+
## If you have a favorite unix editor, also choose it under '''"Editors"''' (novices may wish to work with Notepad for a while). Both <tt>vim</tt> and <tt>emacs</tt> are available.
If you don't already have an xterm program installed also choose
+
## '''Open "Interpreters" and select'''
 
 
* mingw-runtime
 
 
 
You may choose any other packages, including compiled languages other than C you wish to support. (Note that Python is considered an interpreted language by cygwin; see below)
 
 
 
If you have a favorite unix editor, also choose it (novices may wish to work with Notepad for a while). Both vim, emacs and xemacs are available.
 
 
 
If you want python:
 
 
 
'''Open "Interpreters" and select'''
 
 
 
* numpy
 
 
* python
 
* python
 
+
## '''Open "Libs" and select'''
'''Open "Libs" and select'''
 
 
 
 
* sunrpc
 
* sunrpc
 
+
# '''Next, click "Next>"'''
'''Now click "NEXT"'''
 
 
 
 
Your download will proceed.
 
Your download will proceed.
 
+
# When done, click '''"Finish"'''.
When done, click "FINISH".
 
  
 
You will need to ensure that X applications can be started from the cygwin command line. Type xterm and ensure that an X terminal appears.
 
You will need to ensure that X applications can be started from the cygwin command line. Type xterm and ensure that an X terminal appears.

Revision as of 14:28, 29 October 2008

Madagascar has been run on Microsoft Windows machines, but there are several dependencies.

Madagascar runs under Cygwin, which provides a Unix-like environment under Windows.

To obtain Cygwin, go to its web page, download and run the installer. This should create a Cygwin program, which when run, creates a POSIX shell window similar-looking to the Windows command window but which behaves in a more Unix-like way.

NOTE: If you are unfamiliar with Unix-like systems, a good place to start is Greg Wilson's Software Carpentry course.

Cygwin-icon.gif

You will need to install several additional Cygwin components before Madagascar can run. To get these, rerun the installer program (called Setup and represented by an icon with a black "C" shape enclosing a green arrow).

  1. Start Setup program.
  2. Keep clicking (defaults should work, but please choose a mirror on your own continent) until you see a collapsed list (boxed "+" signs) in a selection box.
  3. Choose all of the following before downloading.
    1. Open the "Devel" section and select the following:
  • gcc

If you are developing for Madagascar, also choose

  • subversion
    1. If you have a favorite unix editor, also choose it under "Editors" (novices may wish to work with Notepad for a while). Both vim and emacs are available.
    2. Open "Interpreters" and select
  • python
    1. Open "Libs" and select
  • sunrpc
  1. Next, click "Next>"

Your download will proceed.

  1. When done, click "Finish".

You will need to ensure that X applications can be started from the cygwin command line. Type xterm and ensure that an X terminal appears.

If you use xming, it is necessary to ensure that the environment variable DISPLAY is set to :0 before trying to run xterm.

Once you have verified that you can display xwindows from cygwin, you should be ready to do a normal Madagascar Installation

To set environment variables

on a per-session basis, type:

export <variablename>=<variablevalue>, for example

export DISPLAY=:0

sets the value of DISPLAY to ":0" which is appropriate for xming.

To make this selection "sticky" (permanent until you change the file) change to your cygwin home by typing

cd

and edit the file ".bash_profile" putting the desired environment variables in there.

NOTE: Windows and subversion cannot handle the same paths. Be sure you install madagascar into a path where there is no whitespace in the directory names.