Home › Administer

Configuration of the LoST server

Overview


We present here the installation steps for the LoST server implementation developed by by Wonsang Song in order to be interfaced with the LRF component of the Open IMS Core.

Prerequisites

The steps to download and install the necessary components are:

  • download and install Tomcat following this tutorial. If you install it from a root user, for example using apt-get install on Ubuntu, you will get errors when a client will send requests, because the LoST server application might not have write access to create a new TCP connection. So just to be on the safe side, install it as a normal user on your machine
  • download the LoST server (implemented as a tomcat application)
  • download the Postgres scripts for creating the sample dataset
  • install PostgreSQL 8.x with JDBC driver and PostGIS 1.x extension, see lost-server-1.0.0/README and lost-db-1.0.0/README

    • Creating the Postgres database

    The database will contain sample data for mapping location information (civic or geodetic) and name of service (e.g. "urn:service:sos.police") from an emergency INVITE. For how to create the database see lost-db-1.0.0/README.

    By default, the location informations sent to the LoST server will be mapped in the database as SIP URIs from the domain irt.cs.columbia.edu, for example psap_nj@irt.cs.columbia.edu. You can use sed tool to modify the scripts civic_us.sql and geo_us.sql to switch the PSAP SIP URIs to the open-ims.test domain.

    sed s/"irt.cs.columbia.edu"/"open-ims.test"/ civic_us.sql > new_civic_us.sql
sed s/"irt.cs.columbia.edu"/"open-ims.test"/ geo_us.sql > new_geo_us.sql

    Now you must use these files to create the databases.

    $mv new_civic_us.sql civic_us.sql
$mv new_geo_us.sql geo_us.sql

    Verify that the owner of the database (configured in the scripts create_db.sh, create_as.sh and create_resoler.sh) is the same you are using in the LoST server, or that the user from the LoST server has been granted SELECT access to the database.
    You can now run the scripts: create_db.sh, create_as.sh and create_resoler.sh to create the Postgres database for the LoST server.

    Configuring and installing the LoST server

    Configuring the interface LoST server - Postgres database

    Read lost-server-1.0.0/README.
    To adjust the type of connection (pooling or not) you have to modify the lost.properties file, that can be found in lost-1.0.0/src/, the lost-server README is erroneous on the filepath of lost.properties.

    Configuring the interface LoST server - LRF

    You must configure it before installing, so that the application is copied in the right tomcat folder and running on the wanted path and port.
    The LoST server must not interfere with the HSS server of the Open IMS Core, running by default on the localhost on the port 8080.

    1. The port can be configured from the tomcat in the file tomcat/conf/server.xml: Connector port.
      For example: <Connector port="8180" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443"/>
    2. The tomcat folder must be set in the lost-server-1.0.0/build.xml.
      For example: <property name="catalina.home" value="/usr/local/tomcat"/>
    3. To configure the path the LoST servlet will use you must modify the file lost-server-1.0.0/web/WEB-INF/web.xml. By default the path is "LoSTServlet".

    Do not forget to copy the jars postgresql-jdbc4.jar and servlet-api.jar in a lib directory from the tomcat folder. (see lost-server-1.0.0/README)

    Installing the LoST server

    The classes of the LoST application must be compiled and installed in the configured tomcat folder.

          $cd lost-server-1.0.0/
      $ant install

    Running the LoST server

    The tomcat server must be started as in the tutorial here, for example:

       /usr/local/tomcat/bin/startup.sh