Fusion Registry - .6 3 Configuring Fusion Registry 3.1 Maintenance Tool Registry settings are maintained

  • View
    213

  • Download
    0

Embed Size (px)

Text of Fusion Registry - .6 3 Configuring Fusion Registry 3.1 Maintenance Tool Registry settings are...

  • Fusion Registry: 8.4.x Document Last Updated: May 27th 2015

    FUSION REGISTRY Setup Guide

    FUSION REGISTRY Setup Guide

    This guide explains how to install Fusion Registry in a Java Application Server and how to configure it.

  • 1

    Contents

    1 Fusion Registry Dependencies ........................................................................................................ 3

    1.1 Java (required) ........................................................................................................................ 3

    1.2 Servlet Container (required) ................................................................................................... 3

    1.3 SQL-92 Compliant Database (required) .................................................................................. 3

    1.4 Fusion Security (optional) ....................................................................................................... 3

    1.5 Fusion Audit (optional) ........................................................................................................... 3

    2 Deployment..................................................................................................................................... 4

    2.1 Important issue regarding multiple Web Application deployment ........................................ 5

    3 Configuring Fusion Registry ............................................................................................................ 6

    3.1 Maintenance Tool ................................................................................................................... 6

    3.2 General .................................................................................................................................... 7

    3.2.1 Registry Name ................................................................................................................. 7

    3.2.2 Sender Id ......................................................................................................................... 7

    3.2.3 Default Language ............................................................................................................ 7

    3.2.4 Default Agency ................................................................................................................ 7

    3.3 Change Database Connection ................................................................................................. 8

    3.4 Change Email Server ............................................................................................................... 8

    3.5 Security ................................................................................................................................... 9

    3.6 SDMX Endpoint ..................................................................................................................... 10

    3.6.1 What is an Endpoint ...................................................................................................... 10

    3.6.2 Endpoint Maintenance.................................................................................................. 10

    3.7 Backup and Recovery ............................................................................................................ 13

    4 Fusion Registry Properties File ...................................................................................................... 15

    4.1 Changing the location of the properties file ......................................................................... 15

    4.2 Contents of the properties file .............................................................................................. 16

    4.2.1 Database Settings.......................................................................................................... 17

    4.2.2 Security Credentials ...................................................................................................... 17

    4.2.3 Memory Limit ................................................................................................................ 18

    4.2.4 Settings Modification Enabled ...................................................................................... 18

    4.2.5 Server URL ..................................................................................................................... 18

    4.2.6 Audit Properties ............................................................................................................ 18

    4.2.7 Sweep Properties .......................................................................................................... 19

    5 Securing Registry Login with HTTPS .............................................................................................. 20

  • 2

    5.1 Choose a port number to use as your secure port ............................................................... 20

    5.2 Configuring your Application Server ..................................................................................... 20

    5.2.1 Security Certificate ........................................................................................................ 20

    5.2.2 Tomcat Configuration ................................................................................................... 21

    5.2.3 Fusion Registry Configuration ....................................................................................... 21

    5.3 Testing HTTPS ........................................................................................................................ 22

    6 Logging .......................................................................................................................................... 22

    7 Annex 1 - Alternative Database Platforms .................................................................................... 24

    7.1.1 Oracle Database Connection......................................................................................... 24

    7.1.2 SQL Server Database Connection .................................................................................. 24

  • 3

    1 Fusion Registry Dependencies Fusion Registry is distributed as a single Web Application Archive (war) file: FusionRegistry.war it

    should be deployed to a servlet container such as Apache Tomcat (a free product).

    To run a secure Registry with a number of user accounts then Fusion Security must be used to create

    and administer the users in the system. Fusion Security configuration is documented in the Fusion

    Security setup guide.

    If auditing is required, then Fusion Audit must be configured in order to capture audit information.

    Fusion Audit configuration is documented in the Fusion Audit setup guide.

    The Fusion Registry by default uses an in-memory database, this is only recommended for evaluation

    or testing purposes as the database will be dropped when the application server is terminated. To

    persist structures to a permanent storage a database connection is required. The Fusion Registry

    supports MYSQL, Oracle, and SQL Server.

    1.1 Java (required) Java Runtime Environment (JRE) 1.6 or higher is required.

    1.2 Servlet Container (required) Fusion Registry is deployed to a Servlet Container. Apache Tomcat is a popular, open source servlet

    container, download links and installation instructions can be found at the following URL.

    http://tomcat.apache.org/

    It is recommended to use the latest version of Apache Tomcat as it will include the latest security

    patches. The Fusion products will not run in any Apache Tomcat version lower than version 6.0.

    1.3 SQL-92 Compliant Database (required) Fusion Registry makes use of an Object Relational Mapping (ORM) library called Hibernate. This

    allows Fusion Registry to communicate with any SQL-92 compliant database.

    The database must be installed and running and Fusion Registry must be configured to connect to

    the database, this is covered in section 3.3. The Fusion Registry will automatically create the

    database tables on connection.

    NOTE: Fusion Registry has only been tested with MySQL, Oracle, and SQL Server.

    1.4 Fusion Security (optional) By default Fusion Registry provides the ability to secure the Registry only allowing a trusted user to

    perform changes. If you wish to have a number of users with different access credentials, then

    Fusion Security is required. Please refer to the Fusion Security Setup and User guides as well as the

    section on Security in this document (section 3.5).

    1.5 Fusion Audit (optional) If a connection to RabbitMQ is configured in the registry properties file, then the Fusion Registry will

    send audit and logging information to RabbitMQ which can be processed by Fusion Audit. Fusion

    Audit is a separate web application which should be running in order to receive messages from the

    message queue. Fusion Audit provides its own Setup and User guides.

    http://tomcat.apache.org/

  • 4

    2 Deployment Fusion Registry consists of a single .war file called FusionRegistry.war. This file needs to be copied

    into the directory: /webapps then the Tomcat server should be started. As the

    Tomcat application server starts, the contents of the Fusion Registry war file will be unpacked into

    the directory:

    /webapps/FusionRegistry

    Fusion Registry will default to using an in-memory database. All database, e-mail, security, and

    general settings can be modified via the web interface provided by Fusion Regist