Ophidia Terminal Installation

This page presents the procedure to install, setup and test the Ophidia Terminal from sources and binary packages.

Installation from sources

Installation from source can be used on most Linux distros (i.e. CentOS6, CentOS7 and Ubuntu 14). Before proceeding with the following steps, check that you have all the pre-requisites installed.

As ophidia user create a folder to download and build Ophidia source code.

mkdir /usr/local/ophidia/src

Download Ophidia Terminal release from https://github.com/OphidiaBigData/ophidia-terminal/releases. Alternatively you can get the latest development version from the git repository:

git clone https://github.com/OphidiaBigData/ophidia-terminal

Install the required dependencies:

  • graphviz and devel libraries
  • GTK2 devel libraries
  • jansson and related devel libraries
  • libXML2 devel libraries
  • openssl devel libraries
  • curl and related devel libraries
  • readline devel libraries

For example on CentOS

sudo yum install graphviz\* gtk2\* jansson\* libxml2\* openssl-devel curl libcurl-devel policycoreutils-python readline\*

on Ubuntu

sudo apt-get install graphviz-dev libgtk2.0-dev libjansson-dev libxml2 libxml2-dev libssl-dev curl libcurl3 libcurl4-openssl-dev libreadline-dev

Build and install Ophidia Terminal:

cd /usr/local/ophidia/src/ophidia-terminal
./bootstrap
./configure --prefix=/usr/local/ophidia/oph-terminal
make
make install

Note

In case of GSI support, install the prerequisites and append the following configuration parameters to arguments of command configure:

--with-interface-type=gsi --with-globus-include=/usr/include/globus --with-globus-libs=/usr/lib64 --enable-voms --with-voms-include=/usr/include/voms --with-voms-libs=/usr/lib64

In case of GSI support, install user certificates (public key usercert.pem and private key userkey.pem) in ~/.globus (create the folder if not exists) and assign them the appropriate access privileges:

mkdir -p ~/.globus
chmod 644 ~/.globus/usercert.pem
chmod 400 ~/.globus/userkey.pem

Create a proxy certificate for Ophidia Terminal

su - ophidia
voms-proxy-init

and start Ophidia Terminal as described below.

Note

In case of WPS support, append the following configuration parameters to arguments of command configure:

--with-interface-type=wps

With the default installation/configuration, OPH_TERM_PORT has to be set to 443 as WPS service accepts HTTPS requests.

Installation from RPM

To install the Ophidia Terminal package on CentOS7 download the ophidia-terminal rpm from https://download.ophidia.cmcc.it/rpm/1.2/ and run

yum install ophidia-terminal-1.2*.x86_64.rpm

Change owner of the installation folders

sudo chown -R ophidia:ophidia /usr/local/ophidia

Installation from DEB

To install the Ophidia Terminal package on Ubuntu 14 download the ophidia-terminal deb from https://download.ophidia.cmcc.it/deb/1.2/ and run

sudo dpkg -i ophidia-terminal_1.2*_amd64.deb

Change owner of the installation folders

sudo chown -R ophidia:ophidia /usr/local/ophidia

Test the instance

As ophidia user start the Ophidia terminal (specify the connection parameters of the running Ophidia Server):

/usr/local/ophidia/oph-terminal/bin/oph_term -H 127.0.0.1 -u oph-test -p abcd -P 11732

For more details about the Terminal parameters, see the Ophidia Terminal configuration page.

To avoid typing the whole executable path, you may add it to the PATH environmental variable with:

export PATH="/usr/local/ophidia/oph-terminal/bin:$PATH"

Test the correctness of the entire installation launching a simple command:

oph_list level=2