You are here: Home > Manage IPs and ASNs > RIPE Database > RIPE Test Database

RIPE Test Database

Table of Contents

Introduction

The RIPE NCC has a test database where users may learn how to use the software. This database uses the same software as the RIPE Database, but is completely separate. You cannot change anything in the RIPE Database by changing an object in the TEST database.

The data in the TEST database is not a copy of the data in the RIPE Database. Also, it is not authoritative data. No value should be put on the data in the TEST database. The database is reset to a default state each night.

You can create objects in the TEST database to simulate a part of your real network. You can then experiment with different situations in this TEST environment safely.

Creating Objects in the TEST Database

There are different ways to create an object in the TEST database.

Web interface         

For creating a single object using a form.
Go to https://apps-test.db.ripe.net/db-web-ui/#/webupdates/select

To get started, create a role and maintainer pair.
Go to https://apps-test.db.ripe.net/db-web-ui/webupdates/create/TEST/role/self

Mailupdates Email your object to test-dbm _at_ ripe _dot_ net.
You will receive an acknowledgement message with the result.
Syncupdates

For creating one or more objects at a time, using a single field to edit objects.
Go to https://apps-test.db.ripe.net/db-web-ui/syncupdates

You can also submit updates from the command line (or script) via:
https://syncupdates-test.db.ripe.net/

REST API

Software API to create a single object at a time.

Documented in the Whois wiki https://github.com/RIPE-NCC/whois/wiki/WHOIS-REST-API

The base URL for the TEST environment is https://rest-test.db.ripe.net/test

 

 

Finding Objects in the TEST Database

There are different ways to find objects in the TEST database.

Web interface Go to https://apps-test.db.ripe.net/db-web-ui/query
Command line

Do

whois -h whois-test.ripe.net <Search String>

e.g.

whois -h whois-test.ripe.net PB3-RIPE

The query flags that work in the RIPE Database also work in the TEST Database. We invite you to try them.

REST API

Software API to search Whois or lookup a single object.

Documented in the Whois wiki https://github.com/RIPE-NCC/whois/wiki/WHOIS-REST-API

 

MNTNER Objects in the TEST Database

You can create your own mntner objects in the TEST database. This mntner object only maintains objects in the TEST database.

There are different ways to create a mnter object in the TEST database.

Web interface 

To create a single object (choose mntner from the dropdown):

(a) Go to https://apps-test.db.ripe.net/db-web-ui/webupdates/select

(b) Choose mntner from the dropdown and click Create

(c) Complete the form and click Submit

REST API

Software API to create, update or delete a single object.

Documented in the Whois wiki https://github.com/RIPE-NCC/whois/wiki/WHOIS-REST-API

Mailupdates

(a) complete (fill in) a mntner object template;

(b) email the completed template to test-dbm _at_ ripe _dot_ net

(c) You will receive an email reply with the result.

 

There are some RIPE NCC maintainers in the TEST database which can be used for authentication.

TEST-DBM-MNT

Maintainer for TEST DBM objects.

The maintainer password is "emptypassword" without the quotes.

TEST-NCC-HM-MNT

Hostmaster maintainer.

The maintainer password is "emptypassword" without the quotes. 

Creating INETNUM Allocations in the TEST Database

For this example, use the web interface to create an inetnum.

If you did not create your own mntner object, please use TEST-NCC-HM-MNT as the mntner of the inetnum.

After typing in the inetnum field value, you will be prompted to choose a mntner to authenticate the update operation. Choose TEST-DBM-MNT and deselect the checkmark that says “Also authorise my RIPE NCC Access account for this maintainer”.

For example, create an inetnum with a /21 prefix in the 2/8 range.

The “org:” (organisation) attribute is required for an inetnum object with the status ‘ALLOCATED PA’ or ‘ALLOCATED PI’. The mntner password for the organisation "mnt-ref:" attribute must be known in order to make a reference to the organisation. The organisation object must have an “org-type:” attribute with the value ‘LIR’ for the 'ALLOCATED PA' status (for example, use ORG-EIPB1-TEST as an LIR and authenticate with the TEST-DBM-MNT password).

 

Creating AUT-NUM Objects in the TEST Database

Aut-num objects in the RIPE database are only assigned by the RIPE NCC. However, you are free to create aut-num objects in the TEST database.

You can create an aut-num object from the Create an Object page.

You can also create an aut-num object using the Syncupdates page by pasting in the aut-num RPSL object.

You need to authenticate with the TEST-DBM-MNT password, which maintains the root as-block object.