RedDog Demo Server

Index

1. Introduction
2. Download
3. Running the demo
4. Available features
5. Available configuration
6. Dummy data
   1. Domain data
   2. Entity data
   3. Nameserver data

Introduction

Before you begin a full installation of RedDog, you can try its features out using our demo server. It is a standalone Tomcat binary packaged with RedDog and an embedded (H2-based) database populated with dummy data.

The only requirement is Java 8 or superior.

Download

You can download the demo server from this page.

Running the demo

Expand the compressed zip and run the jar normally:

unzip rdap-server-demo-1.4.1.zip
cd rdap-demo-1.4.1
java -jar demo.jar

The server will run at http://localhost:8080/rdap-server/ by default. You can change the binding IP and port, using the java -jar demo.jar [your-IP-address [your-port]] syntax. As an example:

java -jar demo.jar 127.0.0.5 9090

When the server starts, the console will log messages as shown below. As long as you don’t get SEVEREs (as opposed to INFOs), the server is underway.

The demo server is now ready to answer requests. In your browser, query the address that you set up and you should see a welcome page:

Available features

As a demo version, this server has limited features compared to the ones defined in RFC 7482 (excluding ASN and IPs queries), as well as the ones from the full server. Here are examples of queries that should be successful. See the tables below for more options.

• Domain query*: domain/goldfish.com
• Entity query: entity/mr_fish
• Nameserver query: nameserver/ns2.chopsuey.net
• Domains search*: domains?name=cone*
• Entities search: entities?handle=don_*
• Nameservers search: nameservers?name=ns1.*
• Help request: help

* Because of the shipped configuration of zones (see below), only ‘.com’ and ‘.com.example’ domains will yield success.

Available configuration

Although this a demo version with limited features, some configurations can be customized so that you can learn more about the server behavior. The following list mentions the files that can be used to configure the demo server:

• WEB-INF/configuration.properties is RedDog’s global configuration file, to tweak it learn more at Configuring RedDog’s Server Behavior.
• WEB-INF/data-access.properties is the implementation configuration file, to tweak it learn more at Configuring RedDog’s reference implementation.
• WEB-INF/shiro.ini is Apache Shiro’s configuration file used by RedDog, useful for security settings such as: resources protection, user authentication, user roles, etc. To tweak it learn more at Using Apache Shiro.
• WEB-INF/privacy is the folder where privacy settings can be configured, goes along with security configurations. To tweak it learn more at Configuring Response Privacy.
• WEB-INF/notices/help.xml is the file where the ‘help’ response can be customized, to tweak it learn more at Configuring RedDog’s Help Response.
• Optionally a file WEB-INF/notices/tos.xml can be added to set the server’s terms of service, learn more at Configuring RedDog’s Terms of Service.

Notice that tweaks to any of these files require a server restart to go live.

Dummy data

The demo database ships with the following test data:

Domain data

Entity data

Nameserver data