wiki:GettingStarted

Getting started with Bonmin

How to run Bonmin

Bonmin executables are only distributed experimentally at this point. Therefore, to install Bonmin on your machine requires you to download all the code, its dependencies and perform the compilation process. Depending on your knowledge of computers this process may be quite easy or very painful.

Fortunately, for those who don't want to go through the compilation process, the NEOS Server for optimization provides a very easy to use web interface to Bonmin which anybody can use. Also, Bonmin is available in the GAMS modeling system (since release 22.5).

Tested platforms

Bonmin has been installed and used on the following systems:

  • Linux using gcc version 4.5
  • Windows using Cygwin version 1.5.18 (see the Cygwin packages required in CygwinInstall)
  • Mac OS X using gcc 4.2.1 (follow the instruction for Ipopt there to configure)
  • Solaris on Intel processors using gcc version 4.3

Bonmin should be relatively easy to install on most un*x's provided that you have a C++ and a Fortran compiler.

We don't know anybody who has yet tried to build it in the Microsoft Development Studio, the contribution of anybody who uses Microsoft Development Studio and has good knowledge of it will be very appreciated.

Bonmin installation follows the guidelines of COIN-OR. We provide here only very brief instructions, please refer to the BuildTools wiki for more details.

Download

First you need to know which version of the code you would like to obtain.

  • If you don't know how to use subversion (and don't want to learn it) or if you want to have a version of the code which will remain identical over time, we recommend that you get the latest release which is Bonmin http://www.coin-or.org/LatestRelease/Bonmin-latest-release.png here.
  • If you want to stay up to date with bug-fixes and improvements, we recommand that you use subversion to get the version http://www.coin-or.org/LatestRelease/Bonmin-latest-stable.png of the stable branch. As bug are found and fixed, the stable branch will be updated by us and by using subversion you can easily obtain the latest bugfixes.

To obtain the latest release just download Bonmin http://www.coin-or.org/LatestRelease/Bonmin-latest-release.png here.

In Un*x environments, to download the latest stable version of Bonmin (http://www.coin-or.org/LatestRelease/Bonmin-latest-stable.png). Issue the following subversion command

 svn co https://projects.coin-or.org/svn/Bonmin/stable/1.5 Bonmin-stable

This copies all the necessary COIN-OR files to compile Bonmin to Bonmin-stable].

Obtain third party code

Unfortunately it is required to obtain some ThirdParty code (follow the link for instructions).

Install

To install Bonmin issue the following command in the main Bonmin distribution (Bonmin-1.3 above) directory:

  1. mkdir build
  2. cd build
  3. ../configure -C
  4. make
  5. make test
  6. make install

Step 1 Create a directory used to build the code (note that this step is optional but is strongly recommended).

Step 3 Runs a configuration script which creates the Makefiles for Bonmin.

Step 4 Builds the Bonmin library and executable (if ASL was obtained).

Step 5 Builds the test program and runs it.

Step 6 Installs the Bonmin library libbonmin, the bonmin executable (if ASL was obtained), and the required header file to use the Bonmin library.

Additional help

If the above procedure did not work, you might find additional help:

In any case do not hesitate to submit installation problems to Bonmin mailing list or to report an eventual new bug.

Last modified 17 months ago Last modified on Sep 15, 2016 12:55:23 PM