Installing MinGW & MSYS on Windows
Installing MSYS/MinGW
Further help can be found at:
Install MinGW before MSYS.
Installing MinGW
- Download the MinGW Installer:
- Select Save File when prompted.
- Open the downloaded exe.
- Click Yes when Windows asks if you want to allow it.
- Click Next > on the Welcome screen.
- Select Download and Install and click Next >
- Read the License Agreement and click I agree
- Select Current to install the current MinGW package and click Next >
- Check the MinGW base tools and g++ compiler click Next
- Destination Folder should be C:\MinGW
- Click Next >
- Leave the default folder and click Install
- When Installation is complete, click Next >
- Click Finish
Installing MSYS
- Download MSYS
- Run the downloaded exe.
- Click Yes when Windows asks if you want to allow it.
- Click Yes you want to install in the Setup pop-up.
- Click Next in the Welcome Window.
- Read the License Agreement and click Yes
- Read the Information and click Next >
- The Default Destination of C:\msys\1.0 is fine, so click Next >
- The default folder of MinGW is fine, so click Next >
- Click Install
- A cmd shell will pop-up asking if you want to continue with the post install, enter y enter
- Answer y you do have MinGW Installed.
- Enter c:/mingw as the path where MinGW is installed.
- It should confirm that you have make.exe installed, press any key to continue.
- Click Finish you are done the installation. (It is up to you if you want to open the documents.)
Optional Version Control
There are many types of version control that you can use to track changes to files. Git is one of those types.
Version control is not required, but it can be useful.
Git for MSYS
Only necessary if you want to use git version control on windows.
Installing Git for MSYS
- Download msysgit from http://code.google.com/p/msysgit/ by clicking the exe under Featured download
- Click Save File in the pop-up.
- Run the downloaded executable.
- Click Run in the Open File - Security Warning pop-up.
- Click Yes in the allow to make changes pop-up.
- Click Next > in the Welcome window.
- Read the License and click Next >
- Accept the Default Install Location by clicking Next >
- Accept the default Start Menu folder by clicking Next >
- Click Next > on the Additional Tasks screen - I left all items checked.
- I left the PATH environment to be set to Use Git Bash only and click Next >
- Modified the CR/LF beahavior to be Use Unix style line endings and click Next >
- Click Finish on the completion screen
Using Git for MSYS
Git Bash and Git Gui should now be installed.
- To use msysgit, run, Git Bash this will open an msys terminal that allows the use of git.
- Right click on the Git window title bar and select Properties
- In the Options tab, check QuickEdit Mode - this will allow copy and paste. (Highlight to copy, Insert button to paste)
- I made a software subfolder: mkdir software; cd software
- Type:
git clone wonderland.sph.umich.edu:/home/pipeline
- I have not yet really integrated git and my msys/mingw - so I use the git bash window for git, and a general msys window for compiling.
Additional Optional Library Installations
The following installations are optional and are only required if the software you are compiling requires them.
Install MSYS DTK
This is not necessary, but may include openssl and other stuff that some users need.
- Install MSYS DTK: http://sourceforge.net/projects/mingw/files/MSYS%20Supplementary%20Tools/msysDTK-1.0.1/msysDTK-1.0.1.exe/download
- Click Save File
- Run the downloaded exe.
- Click Yes allow the program to make changes.
- Click Yes to install.
- Click Next > on the Welcome screen.
- Read the License Agreement and click Yes
- Confirm the Destination Directory is set to C:\msys\1.0 and click Next >
- Click Next on the Select Components screen.
- Click Install
- To continue the Setup, click Next >
- Click Finish
zlib
zlib is a compression library used for compressing/decompressing files from code. You only need to download this if your software uses this library.
I forget exactly what I did here – I downloaded zlib from zlib.org.... I probably did
./configure --prefix=/mingw make make install
(I'm not sure this actually built correctly...TBD...)
curses
curses is a library used by samtools, so may be required for compiling samtools and programs using samtools.
I downloaded and installed curses from: http://sourceforge.net/projects/mingw/files/User%20Contributed/pdcurses/Current%20Release_%20pdcurses-2.6.0/pdcurses-2.6.0-2003.07.21-1.exe/download
Sorry, I had step-by-step instructions but I lost them.
You should install it either into C:\MinGW or C:\MinGW\pdcurses. You want the libraries and h files to install into /mingw/lib/ and /mingw/include/ You will probably need to do ln -s /mingw/include/libpdcurses.a /mingw/include/libcurses.a.
I'm not sure if this was done via a build, but I don't think so...if it was a build, maybe it required --prefix=/mingw
Openssl
OpenSSL is a library for Secure Sockets Layer (SSL), Transport Layer Security (TLS) protocols, and cryptography. Some tools require openSSL, if so, here are some instructions:
I downloaded an openssl installer from: http://www.slproweb.com/products/Win32OpenSSL.html I installed into /mingw/openssl/. I then linked the includes:
cd /mingw/include ln -s ../openssl/include/openssl openssl
You may or may not need to link libraries – I haven't done this yet.