Content Comparison

...

After IPAM update, new tab should be available in your IPAM module - RWhois, as can be seen below:

Using this page, configure following for your RWhois server:

1. Server hostname - it will most likely your HostBill server (if rwhois service will run on same machine as HostBill). It will be displayed on rwhois "greeting" response

2. Default POC contact details:
   If customer assigned to IP/network does not have their own contact for POC contact, default one will be used, you can set it here:

   • Name

   • Email

   • Phone

3. Default Tech contact details: 
   If customer assigned to IP/network does not have their own contact for Tech contact, default one will be used, you can set it here:

   • Name

   • Email

   • Phone

4. Network ID prefix 
   When sending response about network:ID, IPAM will use following template: {PREFIX}{ID}.{NETWORK}, where:

   • {PREFIX} can be configured here

   • {ID} is internal network ID in HostBill database

   • {NETWORK} is network/IP address

5. Tech contact prefix 
   When sending response about network:Tech-Contact, IPAM will use following template: {PREFIX}{ID}.{NETWORK}, where:

   • {PREFIX} can be configured here

   • {ID} is internal network ID in HostBill database

   • {NETWORK} is network/IP address

Configuring HostBill

...

Your clients may want to be a POC and/or Tech contacts for their networks. You can add new checkbox registration field to HostBill (can be admin-only) that will allow to point contact/main profile as a source of details for Tech/POC contacts. 

1. To add said registration field for marking RWhois Tech contact, proceed to Clients → Registration fields in your HostBill

2. Click Add new field
   

3. Enter field name, set type to checkbox
   Image Modified
   

4. Under Advanced tab, set field variable to rwhoistech, here you can also decide if this field is admin-only or if customer can control this field
   Image Modified
   

5. Repeat steps above for RWhois POC contact, using rwhoispoc variable in step 4

Customer/profile details with checkboxes above enabled that are assigned to network will be used in contact: rwhois response part.

Configuring server

...

...

...

1. Ensure /includes/modules/Other/ipam/rwhois.php is executable:

   Code Block
   language bash

...

1. chmod

...

1. a+x /home/hostbill/public_html/includes/modules/Other/ipam/rwhois.php

2. Add file:

...

1. /etc/

...

1. systemd/system/rwhois@.service with following content:

   Code Block

...

...

1. [Unit] Description=RWhois Service After=network.target [Service] ExecStart=/usr/bin/php /home/hostbill/public_html/includes/modules/Other/ipam/rwhois.php

...

1. User=hostbill Group=hostbill Restart=always StandardInput=socket

2. Add file: /etc/systemd/system/rwhois.socket with following content:

   Code Block
   language bash
   [Unit] Description=Socket for RWhois Service [Socket] ListenStream=4321 Accept=yes [Install] WantedBy=sockets.target

3. Add permission to files:

   Code Block
   language bash
   chmod a+x /etc/systemd/system/rwhois.socket chmod a+x /etc/systemd/system/rwhois@.service

4. Run the following commands to reload systemd, enable and start the socket:

   Code Block
   language bash
   systemctl daemon-reload systemctl

...

1. enable

...

1. rwhois.socket systemctl

...

1. start

...

1. rwhois.socket

Testing RWhois IPAM

...

• Assign IP address in your IPAM to a customer

• Issue whois command in linux shell.
  Replace rwhois.hostbillapp.com with your actual HostBill hostname and IP address with one assigned in the step above:

  Code Block
  language bash
  whois -h rwhois.hostbillapp.com -p4321 192.168.0.2

• Your RWhois server should reply with something simmilar to:

  Code Block
  language bash
  %rwhois V-1.0,V-1.5:002090:00 rwhois.hostbillapp.com (HostBill RWhois Server V-1.0.0) autharea=192.168.0.0/28 xautharea=192.168.0.0/28 network:Class-Name:network network:Auth-Area:192.168.0.0/28 network:ID:NET-3.192.168.0.2 network:Network-Name: network:IP-Network:192.168.0.2 network:IP-Network-Block:192.168.0.2 network:Org-Name:Christopher Nolun network:Street-Address:Another network:City:Another network:State:Alabama network:Postal-Code:Another network:Country-Code:US network:Tech-Contact:TECH-3.192.168.0.2 network:Created:20171108110858000 network:Updated:20171108111756000 network:Updated-By:noc@hostbillapp.com contact:POC-Name:Network Administrator contact:POC-Email:noc@hostbillapp.com contact:POC-Phone: contact:Tech-Name:Christopher Nolun contact:Tech-Email:test@test.com contact:Tech-Phone:+1-123-12312311 %ok