About RWhois
Recent IPAM plugin update introduces ability to run your own RWhois server compatible with rwhois protocol v1.0 / v1.5.
RWhois server should work on port 4321 and this document explains how to set this service on your server with IPAM plugin
Configuring IPAM
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:
- 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 - Default POC contact details:
If customer assigned to IP/network does not have his own contact for POC contact, default one will be used, you can set it here:- Name
- Phone
- Default Tech contact details:
If customer assigned to IP/network does not have his own contact for Tech contact, default one will be used, you can set it here:- Name
- Phone
- 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
- 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 source of details for Tech/POC contacts.
- To add said registration field for marking RWhois Tech contact, proceed to Clients→Registration fields in your HostBill
- Click Add new field
- Enter field name, set type to checkbox
- Under Advanced tab, set field variable to rwhoistech, here you can also decide if this field is admin-only or if customer controls this field
- 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
Please note that description below is for servers where HostBill is located under /home/hostbill/public_html/ directory, adjust details below if you use different location for your HostBill install.
Install xinetd
For CentOS 7 call:yum install xinetd
Add file: /etc/xinetd.d/rwhois with following content:
service rwhois { protocol = tcp disable = no wait = no server = /home/hostbill/public_html/includes/modules/Other/ipam/rwhois.php port = 4321 user = hostbill group = hostbill socket_type = stream type = UNLISTED instances = UNLIMITED }
Start/enable xinetd:
systemctl start xinetd systemctl enable xinetd