Version 29 (modified by andreasw, 15 years ago) (diff)

adapted simple download instructions to new releases procedure

General Configuration and Installation Instructions for COIN projects

Note that these project webpages are based on Wiki, which allows webusers to modify the content to correct typos, add information, or share their experience and tips with other users. You are welcome to contribute to these project webpages. To edit these pages or submit a ticket you must first register and login.

These webpages are intended to give users as well as developers of many COIN projects information on how to use and modify the COIN code. These pages apply to COIN projects that are using subversion as the source code repository and autotools for configuring, building and installing.

The COIN projects that these pages apply to are:

  • Alps
  • Bonmin
  • Cbc
  • Cgl
  • Clp
  • CoinUtils
  • Dylp
  • FlopC++
  • Ipopt
  • Osi
  • Smi
  • Vol

Information For Users

Minimal Download and Installation Instructions

NOTE: Please check the current issues page before trying to configure and compile the code.

The very short version of the download and installation instructions for UNIX-like system (including Linux and Cygwin) is this:

  1. Get the code for the desired package Pkg (where Pkg needs to be replaced by the name of the COIN package you want to install) and for a releases x.y.z (again, x.y.z is to be replaced by the version number string, such as 2.4.1):

1.1 As tarball: Download the tarball Pgk-x.y.z.tgz from the COIN Tarballs site and extract it, for example with

gunzip Pgk-x.y.z.tgz
tar xvf Pgk-x.y.z.tar

1.1 Via subversion: Go into the directory where you want to have a subdirectory with the downloaded source code and type

svn co  Pkg-x.y.z
  1. Go into the downloaded directory, create a subdirectory for the compiled code, and run the configuration script
    cd Pkg-x.y.z
    mkdir build
    cd build
    Make sure the last line of output says that the configuration was successful.
  2. Compile the code
  3. Test the compiled code
    make test
  4. Install the generated libraries, executables, and header files
    make install

This will create subdirectories bin, lib, and include in the download directory with the product of the compilation.

The configure script has many customization features. To see them, type ./configure --help. In particular, to install a COIN package at a location accessible to all users on your machine, you can run ./configure --prefix=/usr/local.

The COIN-OR FAQ page has a brief explanation of how to use a Windows subversion client to download the code. The MSVisualStudio project describes how several COIN-OR projects can be built with Microsoft Visual Studio.

Detailed Information

The above commands work in most cases if you don't have particular requirements, but it is probably a good idea to read the information on the home page for the desired COIN project, and to learn more using the links below.

Information for project managers

The information behind the links below is mostly intended for people working on COIN projects, i.e., project managers as well as contributors.

More Information

If you have questions or problems related to the usage of subversion and the Autotools, please submit a Ticket to the BuildTools project, using the "New Ticket" link on top of this page (after logging in).