Difference between revisions of "Windows"

From Madagascar
Jump to navigation Jump to search
 
(39 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<tt>Madagascar</tt> has been run on Microsoft Windows machines, but there are several dependencies.
+
<tt>Madagascar</tt> has been run on Microsoft Windows machines under various types of environments:
  
 
==Cygwin==
 
==Cygwin==
  
[[Image:cygwin-icon.gif|left|]] <tt>Madagascar</tt> can run under [http://cygwin.com Cygwin], which provides a Unix-like environment under Windows.
+
[[Image:cygwin-icon.gif|left|]] <tt>Madagascar</tt> can run under [http://cygwin.com Cygwin], which provides a Unix 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.
 
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.
Line 12: Line 12:
  
 
# Start '''Setup''' 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 you can choose a mirror on your own continent) until you see a collapsed list (boxed "+" signs) in a selection box.  
# Choose all of the following before downloading.
+
# Choose the following before downloading.
## Open the '''Devel''' section and select the following:
+
## Open the '''Devel''' section and select
##* gcc
+
##* gcc-core
##: If you want to use the development version of <tt>Madagascar</tt>, also choose
+
##* gcc-g++
 +
##* gcc-gfortran
 +
##* make
 +
## If you want to use the development version of <tt>Madagascar</tt>, also choose one of the following:
 
##* 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.
+
##* git
 +
## Open the '''Libs''' section and select
 +
##* libtirpc-devel
 +
##* libXaw-devel
 +
##* libX11-devel
 +
## If you have a favorite unix editor, choose it under '''Editors''' (novices may wish to work with Notepad for a while). Both <tt>vim</tt> and <tt>emacs</tt> are available.
 
## Open '''Interpreters''' and select
 
## Open '''Interpreters''' and select
 
##* python
 
##* python
## Open '''Libs''' and select
+
## For X-window  display with <tt>oglpen</tt>, open '''X11''' and select
##* sunrpc
+
##* libglut-devel
## Open '''X11''' and select
+
##* libGLU-devel
##* xorg-x11-devel
+
## If you intend to use LaTeX, open '''Publishing''' and select
 +
##* texlive
 +
##* texlive-collection-latexextra
 +
##* texlive-collection-fontutils
 +
## If you intend to use <tt>ppmpen</tt>, open '''Graphics''' and select
 +
##* libnetpbm-devel
 +
## If you intend to use <tt>tiffpen</tt>, open '''Libs''' and select
 +
##* libtiff-devel
 +
## If you intend to use <tt>gdpen</tt>, open '''Libs''' and select
 +
##* libgd-devel
 +
## For Xwin server installation, open '''X11''' and select
 +
##* xinit
 
# Next, click '''Next>'''
 
# Next, click '''Next>'''
 
#: Your download will proceed.
 
#: Your download will proceed.
Line 32: Line 51:
  
 
For running X applications such as '''xtpen''', make sure to run '''startx''' first to open an X terminal window.
 
For running X applications such as '''xtpen''', make sure to run '''startx''' first to open an X terminal window.
 +
 +
===Troubleshooting===
 +
 +
If you get errors "unable to remap...", note the following:
 +
 +
A proper work of a Cygwin installation may require running '''rebaseall''', a program that fixes library dependencies. You only need to run it once.
 +
# Quit all Cygwin processes
 +
# Start '''ash''' (<tt><cygroot>\bin\ash.exe</tt>)
 +
# Execute <tt>/usr/bin/rebaseall</tt>
 +
 +
===Screenshots===
 +
 +
* Running Cygwin's '''setup''' program
 +
 +
[[Image:setup.png|600px]]
 +
 +
* Selecting packages
 +
 +
[[Image:select.png|600px]]
 +
 +
* Running Cygwin's '''bash''' program
 +
 +
[[Image:bash.png|600px]]
 +
 +
* Testing <tt>Madagascar</tt> installation
 +
 +
[[Image:test.png|600px]]
 +
 +
[[Image:welcome.png|600px]]
 +
===Matlab API===
 +
To use the Matlab API with Madagascar under Cygwin, make sure you have Mex installed, and create a symbolic link, i.e.:
 +
<bash>
 +
ln -s /location/of/mex.bat /usr/bin/mex
 +
</bash>
  
 
==Interix==
 
==Interix==
 
[http://en.wikipedia.org/wiki/Interix Interix] is the name of the Unix environment for Windows provided by Microsoft through the following software packages:
 
[http://en.wikipedia.org/wiki/Interix Interix] is the name of the Unix environment for Windows provided by Microsoft through the following software packages:
* [http://en.wikipedia.org/wiki/Microsoft_Windows_Services_for_UNIX Services For Unix] (SFU), available as a [http://www.microsoft.com/downloads/details.aspx?FamilyID=896c9688-601b-44f1-81a4-02878ff11778&DisplayLang=en free download] for the Windows NT family of operating systems up to and including Windows XP Professional ([http://www.reproducibility.org/rsflog/uploads/PS0001.jpg screenshot of m8r running on SFU] from an [http://www.reproducibility.org/rsflog/index.php?/archives/68-RSFMadagascar-on-Windows-using-SFU.html April 2006 entry on the m8r blog]). SFU availability will be discontinued in 2009.
+
* [http://en.wikipedia.org/wiki/Microsoft_Windows_Services_for_UNIX Services For Unix] (SFU), available as a [http://www.microsoft.com/downloads/details.aspx?FamilyID=896c9688-601b-44f1-81a4-02878ff11778&DisplayLang=en free download] for the Windows NT family of operating systems up to and including Windows XP Professional ([http://www.reproducibility.org/rsflog/uploads/PS0001.jpg screenshot of m8r running on SFU] from an [http://www.reproducibility.org/rsflog/index.php?/archives/68-RSFMadagascar-on-Windows-using-SFU.html April 2006 entry on the m8r blog]). SFU availability was discontinued in 2009.
* [http://technet.microsoft.com/en-us/library/cc779522.aspx Subsystem for UNIX-based Applications] (SUA), included with Windows Server 20003 R2 and Windows Vista.
+
* [http://technet.microsoft.com/en-us/library/cc779522.aspx Subsystem for UNIX-based Applications] (SUA), included with Windows Server 2003 R2 and Windows Vista.
  
 
==SSH + X server==
 
==SSH + X server==
If you can count on a network connection to a full UNIX machine while you run Madagascar, you actually need to install under MS Windows just a SSH client and a X server, and just run the m8r installed on the UNIX machine. Cygwin provides both, but it is big and slow. A much more lightweight and fast alternative is using [http://en.wikipedia.org/wiki/Xming Xming] as a X server and [http://en.wikipedia.org/wiki/PuTTY PuTTY] as a SSH client (remember to check the "Tunnel X11 connections" box when saving the session configuration).
+
If you can count on a network connection to a full UNIX machine while you run Madagascar, you actually need to install under MS Windows just a SSH client and a X server, and just run the Madagascar installed on the UNIX machine. Cygwin provides both, but it is big and slow. Faster and more lightweight alternatives are:
 +
* [http://mobaxterm.mobatek.net/en/ MobaXterm], an enhanced terminal with an X server and a set of Unix commands (GNU/Cygwin) packaged in a single portable exe file;
 +
* [http://sourceforge.net/projects/xming/ Xming] as X server and [http://en.wikipedia.org/wiki/PuTTY PuTTY] as SSH client (remember to check the "Tunnel X11 connections" box when saving the session configuration).

Latest revision as of 08:48, 26 August 2018

Madagascar has been run on Microsoft Windows machines under various types of environments:

Cygwin

Cygwin-icon.gif

Madagascar can run under Cygwin, which provides a Unix 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.

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 you can choose a mirror on your own continent) until you see a collapsed list (boxed "+" signs) in a selection box.
  3. Choose the following before downloading.
    1. Open the Devel section and select
      • gcc-core
      • gcc-g++
      • gcc-gfortran
      • make
    2. If you want to use the development version of Madagascar, also choose one of the following:
      • subversion
      • git
    3. Open the Libs section and select
      • libtirpc-devel
      • libXaw-devel
      • libX11-devel
    4. If you have a favorite unix editor, choose it under Editors (novices may wish to work with Notepad for a while). Both vim and emacs are available.
    5. Open Interpreters and select
      • python
    6. For X-window display with oglpen, open X11 and select
      • libglut-devel
      • libGLU-devel
    7. If you intend to use LaTeX, open Publishing and select
      • texlive
      • texlive-collection-latexextra
      • texlive-collection-fontutils
    8. If you intend to use ppmpen, open Graphics and select
      • libnetpbm-devel
    9. If you intend to use tiffpen, open Libs and select
      • libtiff-devel
    10. If you intend to use gdpen, open Libs and select
      • libgd-devel
    11. For Xwin server installation, open X11 and select
      • xinit
  4. Next, click Next>
    Your download will proceed.
  5. When done, click Finish.

After performing this steps, proceed to a normal Madagascar Installation.

For running X applications such as xtpen, make sure to run startx first to open an X terminal window.

Troubleshooting

If you get errors "unable to remap...", note the following:

A proper work of a Cygwin installation may require running rebaseall, a program that fixes library dependencies. You only need to run it once.

  1. Quit all Cygwin processes
  2. Start ash (<cygroot>\bin\ash.exe)
  3. Execute /usr/bin/rebaseall

Screenshots

  • Running Cygwin's setup program

Setup.png

  • Selecting packages

Select.png

  • Running Cygwin's bash program

Bash.png

  • Testing Madagascar installation

Test.png

Welcome.png

Matlab API

To use the Matlab API with Madagascar under Cygwin, make sure you have Mex installed, and create a symbolic link, i.e.: <bash> ln -s /location/of/mex.bat /usr/bin/mex </bash>

Interix

Interix is the name of the Unix environment for Windows provided by Microsoft through the following software packages:

SSH + X server

If you can count on a network connection to a full UNIX machine while you run Madagascar, you actually need to install under MS Windows just a SSH client and a X server, and just run the Madagascar installed on the UNIX machine. Cygwin provides both, but it is big and slow. Faster and more lightweight alternatives are:

  • MobaXterm, an enhanced terminal with an X server and a set of Unix commands (GNU/Cygwin) packaged in a single portable exe file;
  • Xming as X server and PuTTY as SSH client (remember to check the "Tunnel X11 connections" box when saving the session configuration).