1.6. Testing the installation

Once the installation is finished, you may want to check that it was successful.

There are several levels of testing the installation:

  • a check of running processes,

  • a smoke test that will check that all FRED’s interfaces are correctly configured and responding,

  • a zone test that will check that a registrar can access the zone, make registrations and that the registered domain is generated into the zone file and available via the public interface.

1.6.1. Check of running processes

The following daemons should start automatically after the FRED was installed:

  • fred-adifd

  • fred-akmd

  • fred-logd

  • fred-msgd

  • fred-pifd

  • fred-pyfred

  • fred-rifd

  • fred-webadmin

  • fred-accifd

  • fred-backend-logger

  • fred-backend-registry

  • fred-dbifd

  • fred-rsifd

  • fred-zone-services

  • apache2

You can check the running FRED processes with the command ps -ef | grep "fred-".

1.6.2. Smoke test of an uninitialized system

To test the plain installation (just to check that all interfaces respond as they should), try to open these sites in a browser:

  • http://localhost:4444 (Web Whois) and attempt a search

    Desired result: loads without errors, search responds with the “Handle not found” message without errors

and/or try to run these programs in a terminal:

  • whois -h localhost whatever

    Desired result: outputs Whoisd server version and ERROR:101

  • fred-zone-generator whatever

    Desired result: outputs this error: “Unknown zone requested”

If everything goes smoothly (websites open and programs finish as desired), then all system interfaces are available.

1.6.3. Test of registrations in a zone

You can use the following set of commands to test registrations on your system after the initialization with the config-zone script.

# Connect to the server via EPP and login with the specified username and password
eppic --username=REG-CZ --password=passwd --hostname=epp.nic.cz --port=700 --cert-file=/etc/fred/REG-CZNIC_cert.pem --key-file=/etc/fred/REG-CZNIC_key.pem
# Connect + run command that will create a contact with given credentials
eppic --session-id=REG-CZ -- create-contact --id=TEST-CONTACT --postal-info.name=Name --postal-info.addr.street-1=Street --postal-info.addr.city=City --postal-info.addr.pc=12345 --postal-info.addr.cc=CZ --email=example@example.com
# Connect + run command that will create a set of nameservers with the contact assigned as a technical contact
eppic --session-id=REG-CZ -- create-nsset --id=TEST-NSSET --nss-1.name=ns1.test-domain.cz --nss-1.addrs-1=111.222.111.222 --nss-2.name=ns2.test-domain.cz --nss-2.addrs-2=222.111.222.111 --tech-1=TEST-CONTACT
# Create a domain with the contact as the domain owner and with the NS set
eppic --session-id=REG-CZ -- create-domain --name=test-domain.cz --registrant=TEST-CONTACT --nsset=TEST-NSSET
# Ask about the domain via the command-line whois
whois -h localhost -- test-domain.cz
# Generate a zone file and check that it contains the domain
fred-zone-generator; cat db.cz

# Ask about the domain via RDAP and check the JSON response
curl -k -L https://localhost:4445/domain/test-domain.cz | json_pp