alpar@5: Installation Instructions alpar@5: ========================= alpar@5: kpeter@318: Since you are reading this I assume you already obtained one of the release alpar@5: tarballs and successfully extracted it. The latest version of LEMON is ladanyi@245: available at our web page (http://lemon.cs.elte.hu/). alpar@5: kpeter@526: LEMON provides two different build environments, one is based on "autotool", kpeter@526: while the other is based on "cmake". This file contains instructions only for kpeter@526: the former one, which is the recommended build environment on Linux, Mac OSX kpeter@526: and other unices or if you use Cygwin on Windows. For cmake installation kpeter@526: instructions visit http://lemon.cs.elte.hu. kpeter@526: kpeter@318: In order to install LEMON from the extracted source tarball you have to alpar@5: issue the following commands: alpar@5: ladanyi@245: 1. `cd lemon-x.y.z' alpar@5: ladanyi@245: This command changes to the directory which was created when you ladanyi@245: extracted the sources. The x.y.z part is a version number. alpar@5: ladanyi@245: 2. `./configure' alpar@5: ladanyi@245: This command runs the configure shell script, which does some checks and ladanyi@245: creates the makefiles. alpar@5: ladanyi@245: 3. `make' alpar@5: ladanyi@245: This command compiles the non-template part of LEMON into libemon.a ladanyi@611: file. It also compiles the programs in the tools subdirectory by ladanyi@611: default. alpar@5: ladanyi@245: 4. `make check' alpar@5: ladanyi@245: This step is optional, but recommended. It runs the test programs that ladanyi@245: we developed for LEMON to check whether the library works properly on ladanyi@245: your platform. alpar@5: ladanyi@245: 5. `make install' alpar@5: ladanyi@245: This command installs LEMON under /usr/local (you will need root ladanyi@245: privileges to be able to do that). If you want to install it to some ladanyi@245: other location, then pass the --prefix=DIRECTORY flag to configure in ladanyi@245: step 2. For example: `./configure --prefix=/home/username/lemon'. alpar@5: ladanyi@245: 6. `make install-html' alpar@5: ladanyi@245: This command installs the documentation under share/doc/lemon/docs. The ladanyi@245: generated documentation is included in the tarball. If you want to ladanyi@245: generate it yourself, then run `make html'. Note that for this you need ladanyi@245: to have the following programs installed: Doxygen, Graphviz, Ghostscript, ladanyi@245: Latex. alpar@5: alpar@5: ladanyi@245: Configure Options and Variables ladanyi@245: =============================== ladanyi@245: kpeter@318: In step 2 you can customize the actions of configure by setting variables ladanyi@245: and passing options to it. This can be done like this: ladanyi@245: `./configure [OPTION]... [VARIABLE=VALUE]...' ladanyi@245: kpeter@318: Below you will find some useful variables and options (see `./configure --help' kpeter@318: for more): ladanyi@245: ladanyi@245: CXX='comp' alpar@5: alpar@5: Change the C++ compiler to 'comp'. alpar@5: alpar@5: CXXFLAGS='flags' alpar@5: ladanyi@245: Pass the 'flags' to the compiler. For example CXXFLAGS='-O3 -march=pentium-m' ladanyi@245: turns on generation of aggressively optimized Pentium-M specific code. ladanyi@245: ladanyi@245: --prefix=PREFIX ladanyi@245: ladanyi@245: Set the installation prefix to PREFIX. By default it is /usr/local. alpar@5: ladanyi@245: --enable-tools ladanyi@245: ladanyi@245: Build the programs in the tools subdirectory (default). ladanyi@245: ladanyi@245: --disable-tools ladanyi@245: ladanyi@245: Do not build the programs in the tools subdirectory. alpar@5: alpar@5: --with-glpk[=PREFIX] alpar@5: alpar@5: Enable GLPK support (default). You should specify the prefix too if alpar@5: you installed GLPK to some non-standard location (e.g. your home alpar@5: directory). If it is not found, GLPK support will be disabled. alpar@5: alpar@5: --with-glpk-includedir=DIR alpar@5: alpar@5: The directory where the GLPK header files are located. This is only alpar@5: useful when the GLPK headers and libraries are not under the same alpar@5: prefix (which is unlikely). alpar@5: alpar@5: --with-glpk-libdir=DIR alpar@5: alpar@5: The directory where the GLPK libraries are located. This is only alpar@5: useful when the GLPK headers and libraries are not under the same alpar@5: prefix (which is unlikely). alpar@5: alpar@5: --without-glpk alpar@5: alpar@5: Disable GLPK support. alpar@5: alpar@5: --with-cplex[=PREFIX] alpar@5: alpar@5: Enable CPLEX support (default). You should specify the prefix too alpar@5: if you installed CPLEX to some non-standard location alpar@5: (e.g. /opt/ilog/cplex75). If it is not found, CPLEX support will be alpar@5: disabled. alpar@5: alpar@5: --with-cplex-includedir=DIR alpar@5: alpar@5: The directory where the CPLEX header files are located. This is alpar@5: only useful when the CPLEX headers and libraries are not under the alpar@5: same prefix (e.g. /usr/local/cplex/cplex75/include). alpar@5: alpar@5: --with-cplex-libdir=DIR alpar@5: alpar@5: The directory where the CPLEX libraries are located. This is only alpar@5: useful when the CPLEX headers and libraries are not under the same alpar@5: prefix (e.g. alpar@5: /usr/local/cplex/cplex75/lib/i86_linux2_glibc2.2_gcc3.0/static_pic_mt). alpar@5: alpar@5: --without-cplex alpar@5: alpar@5: Disable CPLEX support. ladanyi@245: ladanyi@245: --with-soplex[=PREFIX] ladanyi@245: ladanyi@245: Enable SoPlex support (default). You should specify the prefix too if ladanyi@245: you installed SoPlex to some non-standard location (e.g. your home ladanyi@245: directory). If it is not found, SoPlex support will be disabled. ladanyi@245: ladanyi@245: --with-soplex-includedir=DIR ladanyi@245: ladanyi@245: The directory where the SoPlex header files are located. This is only ladanyi@245: useful when the SoPlex headers and libraries are not under the same ladanyi@245: prefix (which is unlikely). ladanyi@245: ladanyi@245: --with-soplex-libdir=DIR ladanyi@245: ladanyi@245: The directory where the SoPlex libraries are located. This is only ladanyi@245: useful when the SoPlex headers and libraries are not under the same ladanyi@245: prefix (which is unlikely). ladanyi@245: ladanyi@245: --without-soplex ladanyi@245: ladanyi@245: Disable SoPlex support. ladanyi@615: ladanyi@615: --with-coin[=PREFIX] ladanyi@615: ladanyi@615: Enable support for COIN-OR solvers (CLP and CBC). You should ladanyi@615: specify the prefix too. (by default, COIN-OR tools install ladanyi@615: themselves to the source code directory). This command enables the ladanyi@615: solvers that are actually found. ladanyi@615: ladanyi@615: --with-coin-includedir=DIR ladanyi@615: ladanyi@615: The directory where the COIN-OR header files are located. This is ladanyi@615: only useful when the COIN-OR headers and libraries are not under ladanyi@615: the same prefix (which is unlikely). ladanyi@615: ladanyi@615: --with-coin-libdir=DIR ladanyi@615: ladanyi@615: The directory where the COIN-OR libraries are located. This is only ladanyi@615: useful when the COIN-OR headers and libraries are not under the ladanyi@615: same prefix (which is unlikely). ladanyi@615: ladanyi@615: --without-coin ladanyi@615: ladanyi@615: Disable COIN-OR support.