Linux tarball

  • To build coan from source, you must have installed the GNU Build System with C++ support. It is assumed you have done this.
  • Download the tarball to a location under your home directory
  • Extract the directory coan from the tarball. Do not rename it.
  • To install from source with the default GCC compiler:
    • Open a command console and cd into the coan directory
    • Run ./configure
    • If all is well, run make
    • If all is well, run make check if you want to run the test scripts. N.B. This will take a long time. If the make check is successful it will print

      All 5 tests passed

    • If make check fails, capture its output and send it with a bug report.
    • Run make install
  • To install from source with the Clang C++ compiler >= v3.1:-
    • You must have installed Clang, as well as the GNU build system with C++ support. You must have clang++ on your PATH.
    • Then, follow the same procedure as for GCC, but instead of running ./configure, run:-

      ./configure CXX=clang++ CXXFLAGS=-isystem=/usr/include/c++/X.Y.Z

      where X.Y.X is the GCC version number whose C++ library you wish to use.
  • To test that Coan is installed:
    • Run coan -v, and expect output like:

      coan, version 5.1.2 for 64 bit Unix/Linux (built Jun 4 2012,11:23:05) coan: while parsing options: progress 0x02101: Completed, exit code 0x00

    • Run man coan, and expect to see the coan man page.

Linux DEB

  • Download the appropriate binary DEB for your system:
    • For X86 machines, coan_X.Y.Z-for-Ubuntu_10.04_i386.deb
    • For X86_64 machines, coan_X.Y.Z-for-Ubuntu_10.04_amd64.deb
  • Your Linux system probably provides a graphical installer for DEBSs. In that case just click on the DEB to invoke the graphical installer.
  • To install the binary DEB from the commandline, e.g. for the X86 architecture, run dpkg –i coan_X.Y.Z-for-Ubuntu_10.04_i386.deb. The same command suffices to upgrade an existing installation. Consult man dpkg for documentation.

Linux RPM

  • Download the appropriate binary RPM for your system:
    • E.g. for X86 machines, coan-X.Y.Z-for-Fedora_15.i386.rpm
    • E.g. for X86_64 machines, coan-X.Y.Z-for-Fedora_16.x86_64.rpm
  • Your Linux system probably provides a graphical installer for RPMs. In that case just click on the RPM to invoke the graphical installer.
  • To install the binary RPM from the commandline, e.g. for the X86 architecture, run rpm –ivh coan-X.Y.Z-for-Fedora_15.i386.rpm. To upgrade an existing installation replace the -i option with -U. Consult man rpm for documentation.

Windows

  • Download the Windows binary coan-X.Y.Z.x86.exe or coan-X.Y.Z.x86_64.exe to a location of your choice.
  • Rename it to coan.exe.
  • If neccessary, modify the PATH environment variable on your system to include the path where coan.exe is located. (You will need to be logged in as an administrator to do this).
  • To test that Coan is installed, run coan -v, and expect output like:

    coan, version 5.1.2 for 64 bit Windows (built Jun 4 2012,11:23:05) coan: while parsing options: progress 0x02101: Completed, exit code 0x00