This page presents the procedure to install, setup and test the Ophidia Terminal from sources and binary packages.
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:
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.
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
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
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