This page presents the procedure to install, setup and test the Ophidia Terminal from sources and binary packages.
Note
Before proceeding with the following steps, check that you have the required pre-requisites installed. In particular system developmente libraries.
Installation from source can be used on most Linux distros (i.e. CentOS6, CentOS7, Ubuntu 14, Ubuntu 18).
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 libreadline-dev libreadline7 libssl-dev libssl1.1 libcurl4 libcurl4-openssl-dev curl
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. Check WPS installation page for the server-side WPS interface.
To install the Ophidia Terminal package on CentOS7 download the ophidia-terminal rpm from https://download.ophidia.cmcc.it/rpm/1.5/ and run
yum install ophidia-terminal-1.5*.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 18 download the ophidia-terminal deb from https://download.ophidia.cmcc.it/deb/1.5/ and run
sudo dpkg -i ophidia-terminal_1.5*_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.
Test the terminal installation launching a simple command:
>> help
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"