Installing Orca on Debian Linux

Note:

Reviewed for release 9.11.

These are detailed instructions for installing Orca on Debian Linux. They are known to work for a system using Debian Testing distribution. They are also applicable to Ubuntu/Kubuntu 8.10 (Intrepid). See Download and Install Orca for general guidelines.

Build Essential

# apt-get install build-essential

CMake

Minimum version required 2.6-patch 3 (latest tested: 2.6-patch 4).

# apt-get install cmake cmake-curses-gui

Note:

You may also choose to install a GUI version of ccmake (package name = cmake-qt-gui ).

Ice

Minimum version required 3.3.0 (latest tested: 3.3.1).

Note:

These instructions install Ice using a Debian package. In some cases you may still want to build Ice from source, see orca_doc_install_debian_opt_icefromsource for Debian-specific instructions.

# apt-get install libzeroc-ice-dev ice-translators ice-slice icestorm icegrid icebox icepatch2

GearBox

Minimum version required 9.11

• If you haven't yet, download GearBox source archive and un-tar it.
• Configure using with CMake (note the dot after cmake), compile, and install.
• The default installation directory is /usr/local (see below on how to change it).

  $ tar -zxf gearbox-x.x.x.tar.gz
  $ cd gearbox
  $ cmake .
  $ make
  # make install
  

Orca

Build and install Orca distribution.

• If you haven't yet, download Orca source archive and un-tar it.
• Configure using with CMake (note the dot after cmake), compile, and install.
• The default installation directory is /usr/local (see below on how to change it).

  $ tar -zxf orca-x.x.x.tar.gz
  $ cd orca
  $ cmake .
  $ make
  # make install
  

We are done. For a quick check that everything worked as expected, try this (actual versions may be different):

$ laser2d --version
$ orca: Versions: Ice=3.2.1  Orca=2.9.0+

Customizing installation

Installation process can be customized with a few variables which can be supplied on the command-line, e.g.

$ cmake -D[VARIABLE_NAME]=[VARIABLE_VALUE] .

The following are the names of available variables for each distribution:

• GearBox
  • GEARBOX_INSTALL - where to install Hydro installation, e.g. "cmake -DHYDRO_INSTALL=/home/myuser/temp ."
  • ICEUTIL_HOME - where to find IceUtil installation, e.g. "cmake -DICEUTIL_HOME=/home/myuser/temp ."
• Orca
  • ORCA_INSTALL - where to install Orca, e.g. "cmake -DORCA_INSTALL=/home/myuser/temp ."
  • ICE_HOME - where to find Ice installation, e.g. "cmake -DICE_HOME=/home/myuser/temp ."
  • GEARBOX_HOME - where to find Gearbox installation, e.g. "cmake -DGEARBOX_HOME=/home/myuser/temp ."
  • HYDRO_HOME - where to find Hydro installation, e.g. "cmake -DHYDRO_HOME=/home/myuser/temp ."

Example: installing into your home directory

Each distribution needs to be told where to install. In addition, each dependent distribution needs to be told where its dependents are installed. One way to do it is to add the following to your .bashrc file and then use CMake as usual. Note that we also modify the PATH variable.

DIR=/home/myuser/install
alias cmake='cmake -DGEARBOX_INSTALL=$DIR -DGEARBOX_HOME=$DIR -DORCA_INSTALL=$DIR'
export PATH=$DIR/bin:$PATH

See also:

You may also want to check out notes on Installing optional dependencies on Debian Linux