Whois server

Whois server build on top of ruby EventMachine.

Demo Installation

Before demo install, please ensure you have rbenv and postgres installed.

git clone https://github.com/internetee/whois.git
cd whois
bundle
cp config/database-example.yml config/database.yml # and edit it
cp env-example .env # and edit it according to your needs

# create postgres database, example:
# create database whois owner whois encoding 'UTF-8' LC_COLLATE 'et_EE.utf8' LC_CTYPE 'et_EE.utf8' template template0;

ruby whois.rb run # or start for daemon, other commands: status start stop run --help
sudo apt-get install whois
whois hello.ee -h localhost -p 1043 # by default whois run on port 43

You should receive

Hello from whois server!

If you have any issues you can try run whois server on front:

ruby whois.rb stop   # stops running whois
ruby whois.rb run    # runs whois server in terminal for debug
ruby whois.rb --help # for other commands

Docker Installation

To run the WHOIS server using Docker:

1. Clone the repository:

   git clone https://github.com/internetee/whois.git
   cd whois
   

2. Configure the application:

   cp config/database-example.yml config/database.yml
   cp env-example .env
   

   Edit these files according to your environment.

3. Build the Docker image:

   docker build -t whois-server .
   

4. Run the container:

   docker run -d -p 43:43 --name whois-server \
     --env-file .env \
     -v $(pwd)/config/database.yml:/opt/webapps/app/config/database.yml \
     whois-server
   

5. Test the WHOIS server:

   whois hello.ee -h localhost -p 43
   

Production installation

Before production installation, please ensure you have rbenv and postgres installed.

At your local machine:

git clone https://github.com/internetee/whois.git
cd whois
bundle
gem install mina # or any other deploy tool
cp config/deploy-example.rb config/deploy.rb # and edit it
mina pr setup

Add init script and edit it:

sudo cp config/whois-init-example /etc/init.d/whois
sudo chmod +x /etc/init.d/whois

Start server

sudo /etc/init.d/whois start

Additional notes

Request logs are going to syslog, however all daemon related errors are going to log directory because daemon lib currently not supporting syslog, probably in future it will happen.