ISO XXXX1:2019(E)

ISO/TC 211/WG 9

Secretariat: SIS

Geographic information — Geodetic register installation guide
Information géographique — Guide d’installation du registre géodésique

 


 



Foreword

ISO (the International Organization for Standardization) is a worldwide federation of national standards bodies (ISO member bodies). The work of preparing International Standards is normally carried out through ISO technical committees. Each member body interested in a subject for which a technical committee has been established has the right to be represented on that committee. International organizations, governmental and non-governmental, in liaison with ISO, also take part in the work. ISO collaborates closely with the International Electrotechnical Commission (IEC) on all matters of electrotechnical standardization.

Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. ISO shall not be held responsible for identifying any or all such patent rights. Details of any patent rights identified during the development of the document will be in the Introduction and/or on the ISO list of patent declarations received (see www.iso.org/patents).

Any trade name used in this document is information given for the convenience of users and does not constitute an endorsement.

This document was prepared by Technical Committee ISO/TC 211, Geographic information.

This document is amongst a series of International Standards dealing with the conversion of systems of writing produced by Technical Committee ISO/TC 211, Geographic information, WG 9 Information management.

This is the second edition of this document.

Copyright © 2014-2018 Statens kartverk. 2019 ISO/TC 211.


0  Introduction

0.1 General

This document describes installation requirements and procedures for the ISO Geodetic Registry.

The intended audiences are operators and developers of the ISO Geodetic Registry system.

0.2 The ISO Geodetic Registry

The ISO Geodetic Registry is a structured database of coordinate reference systems and transformations that is accessible through an on-line registry system.

This Registry is provided under the auspices of ISO Technical Committee 211 on geographic information/geomatics and conforms to ISO standards:

Geographic information — Geodetic register installation guide

1  Scope

This document describes installation requirements and procedures for the ISO Geodetic Registry.

2  Normative references

The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.

ISO 19127, Geographic information — Geodetic register

3  Terms, definitions, symbols and abbreviated terms

For the purposes of this document, the terms and definitions given in ISO 19127 apply.

ISO and IEC maintain terminological databases for use in standardization at the following addresses:

3.1 Symbols

3.1.1 <Tomcat7>

path to Apache Tomcat 7

EXAMPLE  /var/lib/tomcat7

3.1.2 <dbserver>

host name or IP address of the PostgreSQL server

3.1.3 <dbport>

port of the PostgreSQL server

3.1.4 <dbname>

name of the PostgreSQL database

3.1.5 <dbuser>

PostgreSQL login role that has full rights on the <dbname> database

3.1.6 <dbpassword>

password of <dbuser>

3.1.7 <host>

host name or IP address of the installation server

3.1.8 <port>

port where Apache Tomcat listens for HTTP requests

EXAMPLE  8080

4  Prerequisites

4.1 Hardware requirements

Server load is difficult to predict, therefore live testing remains the best way to determine what hardware the ISO Registry instance will require in production. The values given below refer to the minimum available hardware to run the ISO Registry instance with five concurrent users.

  • 2 GHz+ CPU

  • 2048 MB RAM

  • 10 GB database space

4.2 System requirements

Table 1

Java version

Oracle JRE / JDK

1.7

OpenJDK (IcedTea)

2.4

Operating systems for server

  • Microsoft Windows

  • Linux (Ubuntu LTS 14.04+)

Application server

Apache Tomcat

7.0.x

Database

PostgreSQL

9.1, 9.2, 9.3

Web browsers – desktop

Microsoft Internet Explorer (Windows)

10, 11

Mozilla Firefox (all platforms)

latest stable version

Google Chrome (Windows and Mac)

latest stable version

Web browsers – mobile

Android (Android)

the default Android browser

Chrome (Android and iOS)

latest stable version

4.3 Skill requirements

This document assumes that you:

  • are familiar with administrating Linux systems

  • have root access to the server used for installation

5  Installation

5.1 Prerequisites

The steps in this section depend on the following assumptions.

  • The following components have been installed on the server:

    • OpenJDK 7 or Oracle JDK/JRE 7

    • Apache Tomcat 7.0.x

  • The server can connect to a PostgreSQL instance and:

    • the database <dbname> for the ISO Registry was created

    • the database user <dbuser> with password <dbpassword> exists and has full rights on the <dbname> database

  • The server can connect to an SMTP server that will deliver mails sent by the registry software.

The commands shown work on servers running Ubuntu LTS 14.04 (and possibly later Ubuntu versions). In case your server runs a different distribution you must modify the commands to fit that platform.

5.2 Steps

  1. Load the database dump iso-gcp-minimal.backup into the isoreg database (for example, through PgAdmin).

    The dump contains a minimal version of the ISO Registry of Geodetic Codes and Parameters, including example users. For further details, see configuration.

  2. Copy the web archive iso-registry-client.war to <Tomcat7>/webapps, the directory that contains Tomcat’s webapps (e.g. /var/lib/tomcat7/webapps).

  3. Apache Tomcat should unpack the web archive to the sub-directory iso-registry-client.

  4. Stop Apache Tomcat

    service tomcat7 stop
  5. Change to the directory iso-registry-client/WEB-INF/classes and edit the following configuration files:

    • registry.configuration.xml

    • client.configuration.xml

    • hibernate.connection.xml and

    • hibernate.properties.xml.

    For a list of all configuration settings, see section 1.6.

  6. Start Apache Tomcat +

    service tomcat7 start
  7. To access the ISO Registry of Geodetic Codes and Parameters, open a browser and navigate to http:// server URL>/iso-registry-client. For example, with Tomcat running on port 8080 on localhost, the URL would be http://localhost:8080/iso-registry-client. == Configuration

5.3 Database connection (hibernate.connection.xml)

hibernate.connection.username

<dbuser>

hibernate.connection.password

<dbpassword>

hibernate.connection.url

jdbc:postgresql://<dbhost>:<dbport>/isoreg

5.4 Database parameters (hibernate.properties.xml)

hibernate.hbm2ddl.auto
  • validate – for standard production use

  • update – when performing a software update

  • create – when installing for the time

5.5 Registry configuration (registry.configuration.xml)

mail.enabled
  • true – mail sending is enabled

  • false – mail sending is disabled

mail.from.name

Mail name used in From header

mail.from.address

E-mail address used in From header

mail.smtp.auth

Switch to activate SMTP authentication (true, false)

mail.smtp.starttls.enable

Switch to activate STARTTLS SMTP authentication (true, false)

mail.smtp.host

Host name or IP address of SMTP server

mail.smtp.port

Port number of SMTP server (TLS: 587, plain: 25)

mail.smtp.user

User name used for SMTP authentication

mail.smtp.password

Password used for SMTP authentication (plain text)

5.6 Registry client configuration (client.configuration.xml)

basePath

If you run Apache Tomcat behind a reverse proxy this parameters must be set to the context path used by external clients, preceded by a tilde.

If e.g. the registry is accessed from the outside via the URL http://registry.isotc211.org/gcp the parameter must be set to ~/gcp.

In environments without a reverse proxy this parameters must be left empty.


Annex A
(informative)

Default users

The minimal database in iso-gcp-minimal.backup contains the following users:

Table A.1

Login (e-mail) Password Roles

admin@example.org

a

Administrator

controlbody@example.org

c

Control Body

regman@example.org

r

Register Manager

owner@example.org

o

Register Owner

submitter@example.org

s

Submitter

poc@example.org

p

Point of Contact of “Example Organization”


Bibliography

[1]  ISO 19111:2007, Geographic information — Spatial referencing by coordinates

[2]  ISO 19135:2005, Geographic information — Procedures for item registration

[3]  ISO 19135-1, Geographic information — Procedures for item registration — Part 1: Fundamentals

[4]  ISO 19135-2:2012, Procedures for item registration — Part 2: XML schema implementation