This Page Has Moved

The latest version is on GitHub.


NicToolServer Installation

There are more specific instructions for FreeBSD 10 and CentOS.

1. Download the sources: NicToolServer

2. Expand the sources:

tar -xzf NicToolServer-X.XX.tar.gz

3. Install dependencies

NicTool requires that Apache and mod_perl be installed. There's a brief which Apache discussion here.

cd NicToolServer-X.XX
bin/nt_install_deps.pl

The nt_install_deps.pl script will attempt to install the required perl modules via ports on FreeBSD/Darwin and via CPAN on everything else. If ports are unavailable, CPAN is used.

4. Install the perl modules:

perl Makefile.PL
make install clean

5. Move the distribution to our DocumentRoot:

mv ../NicToolServer-X.XX /usr/local/nictool/server

6. Configure Apache

This will vary from system to system, and dependent on what version of Apache you are using. A typical configuration for use with Apache 2 listening on localhost is what I shall present below. If you run NicToolClient on a seperate server, then you'll want your vhost to listen on an external IP address instead. These are additions to make to your httpd.conf file:

<IfDefine !MODPERL2> 
   PerlFreshRestart On
</IfDefine>
PerlTaintCheck Off
    
Listen 8082

PerlRequire /usr/local/nictool/server/lib/nictoolserver.conf

<VirtualHost 127.0.0.1:8082>
    KeepAlive Off
    <Location />
        SetHandler perl-script
        PerlResponseHandler NicToolServer
    </Location>
    <Location /soap>
        SetHandler perl-script
        PerlResponseHandler Apache::SOAP
        #PerlResponseHandler Apache2::SOAP
        PerlSetVar dispatch_to "/usr/local/nictool/server, NicToolServer::SOAP"
    </Location>
</VirtualHost>

There is a bug in the current version of SOAP::Lite. You may need this patch for Bug #81471.

If you are using NicTool with Apache 2, you may be interested in this patch for SOAP::Lite and this patch for Apache::DBI. There is a thread on the support forums regarding the SOAP::Lite patch which has been deprecated! See the Apache2::SOAP thread in the discussion forums.

7. Create MySQL database and permissions.

cd /usr/local/nictool/server/sql
perl create_tables.pl

8. Configure nictoolserver.conf

vi /usr/local/nictool/server/lib/nictoolserver.conf

9. Restart Apache

10. Optionally Test Installation

Begin by creating a "test.com" subgroup in nictool, with a user in it. Then edit t/test.cfg to match the user/pass you chose.

cd /usr/local/nictool/server
vi t/test.cfg
perl Makefile.PL
make test **

** You should probably not do this on existing installs. Or if you really want to, back up your database tables first, test, and then restore them.

11. Set up nameserver exports

Visit the tinydns export page, the BIND Export page, or the PowerDNS Export page.