Draupne EPP Client
User guide

http://draupnegui.sourceforge.net/

May 14, 2008

Contents

• About
• History
• Software requirements
• Installation
  • Java Runtime
  • Download software
  • Running software
  
  
• Usage
  • Adding a domain
  • Renew a domain
  • Transfer a domain to you
  • Delete a domain
  • Withdraw a domain
  
  
• Maintenance
• Troubleshooting
  • Reporting a bug
  
  
• Credits

About

Draupne EPP Client is a desktop application for editing domain records in the Norwegian Internet Registry database. The intended users are .no domain registrars.

History

The client was developed as a student assignment in the spring of 2008. The Norwegian Internet Registry (NORID) was an important stakeholder and set the requirements.

To help further development Open Source development methods are used.

Software requirements

Draupne EPP Client requires a modern computer able to run a Java 6 run-time environment. It is being developed on Windows XP and Linux. Mac OS is not supported.

The Sun Java 6 run-time is preferred. (Java(TM) SE Runtime Environment (build 1.6.0-b105))

Installation

Java Runtime

Draupne EPP Client requires a Java6 Runtime Environment. The client is developed under Sun Java, and only tested with this version.

This software is available for free at http://www.java.com/en/download/index.jsp

If you are using Linux it is probably an option to let the built-in package system install Java for you.

For Ubuntu Gutsy or Ubuntu Hardy the following command should work:

 
    user@host:~$ sudo apt-get install sun-java6-jre

Make sure you have the multiverse package source enabled. (System - Administration - Software sources)

Download software

Download the latest version of Draupne EPP Client from http://draupnegui.sourceforge.net/
Choose the .jar download and save the file to disk.
On Windows the path C:Program Filesdraupnegui is recommended.

On Linux the file can be put into /opt/draupnegui/ or $HOME.

Running software

In Windows start the software by double-clicking on the .jar -file.

In Linux you start the software by running java -jar JARFILE.jar in the directory where you downloaded the software.

A login window should appear shortly.

Usage

Adding a domain

This is a very high level description on how to use Draupne EPP Client to create a new domain.

The procedure described here is correct as of May 2008. There are some high-level business logic described, which the registry (NORID) may have changed. See http://www.norid.no/registrar/ for updated procedures.

1. Find your host handles
   
   Make sure you know your host handles. Host handles are the name servers that is authoritative for the domain. If you do not know these handles, use the Search button in the Host tab. If you are unable to find them, create new ones. Note down the handles on a piece of paper for later use.

2. Create an organization handle
   
   A domain under .no is required to have a Norwegian Business Organization Number, which is managed by Brønnøysund Register Centre. (http://www.brreg.no) Write down the new organization handle on a piece of paper.

3. Create Contact handles
   
   All domains shall have an administrative contact (Admin-C) and a technical contact (tech-c). These handles must be created before a domain can be added. Some registrars are Tech-C for their customers. If this is the case only an admin-c must be created for each owning organisation.

4. Create the domain
   1. Choose Create Domain in the Domain tab.
   2. Enter the wanted domain name and the organization handle just created.
   3. Add the Administrative Contact, Tech Contact and Name Servers.
   4. Press Done to create the domain.

The domain is now created.

Renew a domain

To renew a domain that is about to expire, execute the following steps:

1. In the Domain tab, choose Renew.
2. Enter the domain name to renew.
3. Press Renew.

Renewals are per registry policy for 1 year.

Transfer a domain to you

Only Domain objects can be transferred. Content of Host and Contact records will be created automatically during the transfer operation.

This section will be further detailed at a later date.

Delete a domain

To delete an unwanted domain or one registered by mistake:

1. In the Domain tab, choose Delete
2. Enter the domain name to be deleted
3. Press Delete.

Domain deletions may be queued by the server for administrative review.

Withdraw a domain

Withdraw Domain is a NORID EPP extension. It transfers a domain from the current registrar to the registry. It is used in situations where a registrar don't want to sponsor the domain (or customer) any more.

The authenticated user must be the sponsoring registrar for the domain, this can be verified with Lookup.

1. In the Domain tab press Withdraw.
2. Enter the domain name
3. Press Withdraw.

Maintenance

Draupne EPP Client is designed and implemented to be without maintenance for the users.
The client will create some small log files on the hard drive. These may grow over time, but is not required for the client to function. These files are there to help debugging in case of serious errors and can safely be deleted if there is a shortage of disk space.

Troubleshooting

If you experience problems with the software, check the following:

• Java Runtime version
  This software is developed and tested on Sun Java 1.6. Other Java implementations may be a cause of problems.
• Network connectivity
  Verify that your Internet connection is operational.
• Registrar handle
  Verify with the registry that your registrar account is still valid.

Reporting a bug

This software is community supported. If you find problems you are not able to solve yourself, try creating a bug report on the web page.
A proper bug report should mention:

• Operating system and patch level
• JRE version and software version
• A description on what you are trying to do
• What happens that shouldn't, and what you think should happen
• Any visible stack traces

Upload this content as a bug, and remember to add your email address so the developers are able to contact you.

Credits

This manual is copyrighted Draupne EPP Client developers (2008).
Draupne EPP Client developers are:

Fredrik Skolmli

Lasse Karstensen

Ola M Olsberg

Jørgen Bøhnsdalen

See the software web page at http://draupnegui.sourceforge.net/ for more details.

This manual is released under a Creative Commons Attribution-Share Alike 3.0 Unported License. See http://creativecommons.org/licenses/by-sa/3.0/ for more information.

About this document ...

Draupne EPP Client
User guide

This document was generated using the LaTeX2HTML translator Version 2002-2-1 (1.71)

Copyright © 1993, 1994, 1995, 1996, Nikos Drakos, Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999, Ross Moore, Mathematics Department, Macquarie University, Sydney.

The command line arguments were:
latex2html -local_icons -split 0 -address '(C)2008 Draupne EPP Client developers. See web page for details.' userguide.tex

The translation was initiated by Lasse Karstensen on 2008-05-14