General

Service-Proxy is comprised of three elements:

  • Service-Proxy runtime - which deals with request processing, execution of plugins, etc. This is a standard Java web application that is deployed on a servlet container.
  • Service-Proxy core plugins - a set of core functionality plugins developed by IndexData, packaged and deployed along the Service-Proxy runtime
  • Service-Proxy plugin API - a set of interfaces and classes that allow to develop new plugins for SP.

    All those elements can be acquired via the IndexData maven repository where latest SP proxy artifacts are always deployed. The SP runtime web application acquired this way will require additional efforts (both in SP and third party elements configuration) and for that reason IndexData also supplies OS-dependent packages for Debian/Ubuntu and RHEL/CentOS operating systems.

Installation on Debian/Ubuntu

To install Service-Proxy on Debian (squeeze) and Ubuntu (lucid) IndexData APT repository has to be added to the sources list. This is best done by placing the following contents in a file located at /etc/apt/sources.list.d/indexdata.list:

  deb http://ftp.indexdata.dk/debina squeeze main restricted
  deb-src http://ftp.indexdata.dk/debian squeeze main restricted

Afterwards, SP (along with the Tomcat6 suport) can be installed with:

  apt-get install masterkey-service-proxy-tomcat6

Installation on RHEL/CentOS

Instructions for the redhat-based systems are similar to Debian:

The following should be included under /etc/yum.repo.d/indexdata.repo:

  [indexdata-main]
  name=Index Data Main Repository
  baseurl=http://ftp.indexdata.com/pub/yum/centos/5.5/main/$basearch
  failovermethod=priority
  gpgcheck=1
  gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-indexdata
  enabled=1
  priority=12

  [indexdata-restricted]
  name=Index Data Restricted Repository
  baseurl=http://ftp.indexdata.com/pub/yum/centos/5.5/restricted/$basearch
  failovermethod=priority
  gpgcheck=1
  gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-indexdata
  enabled=1
  priority=12

The Service-Proxy (along with Tomcat6 integration) can be installed using:

  yum install masterkey-service-proxy-tomcat6

Tomcat 5 packages are alos available for redhat.

Maven 2 artifacts

IndexData Maven 2 repository can be acceseed with the following maven configuration:

  <repository>
    <id>id-maven-repo</id>
    <url>http://maven.indexdata.com</url>
  </repository>

Service-Proxy contains the following artifacts:

  <dependency>
    <groupId>com.indexdata</groupId>
    <artifactId>service-proxy-plugin-api</artifactId>
    <version>${sp-version}</version>
    <type>jar</type>
  </dependency>

  <dependency>
    <groupId>com.indexdata</groupId>
    <artifactId>service-proxy-plugins</artifactId>
    <version>${sp-version}</version>
    <type>jar</type>
  </dependency>

  <dependency>
    <groupId>com.indexdata</groupId>
    <artifactId>service-proxy-runtime</artifactId>
    <version>${sp-version}</version>
    <type>war</type>
  </dependency>

At the time being IndexData is only providing snapshot releases this way.