Surveys of system administrators suggest that phpIPAM is the most popular IPAM implementation in the country. This might be because it’s so easy to install. The software installs on Debian servers with only a minimum of effort. The same steps should also work on Ubuntu, which is quickly replacing Debian throughout the Anglophone provinces. Ubuntu shares a great deal of code with Debian, which also means that the same IPAM shell scripts should work on either platform.
Configuring MySQL and Apache
Apache and MySQL packages have to be installed before IPAM can interface with the server. Preparing an environment for IPAM deployment is generally easy. It doesn’t involve much more than using apt-get to download pre-compiled binaries. Make sure to run apt-get update before installing these two pieces of vital software in order to get the latest versions of them. Fire up nano or vi once the packages are installed. The config.php contains the default user name and password for the IPAM system, which should be set to something more secure. Passwords should include at least one upper case letter, one lower case letter and one number. Many installations won’t accept anything less.
Working with mod_rewrite
Dreaded 404 errors are usually caused by problems with the Apache mod_rewrite subroutine. Administrators dealing with these errors should search for a directory called directive in the default Apache folder structure. Create a file called 000-default with either nano or vi, and add AllowOverride all to it. Run the a2enmod rewrite command to restart the database. It might also be a good idea to reboot the system at this point in order to ensure that there weren’t any memory leaks in the process. This also ensures that the entire Apache Web Services system is restarted in the process.
Booting Up the Database
If everything has been properly configured on the local level, then it’s time to install the final database files. Point a browser to http://server/phpipam/ in order to start the install script. While this appears to be a Web link, it will actually open up yet another local client script from the server’s file system. Use the local MySQL root password in order to activate the install link.
Man is the Final Word
There shouldn’t be any need for troubleshooting. These steps work in the majority of cases. Don’t forget about the man pages if there were any problems. Typing man followed by any command at the CLI is an excellent way to get information. This works every bit as well for IPAM commands as it does for standard Bash commands. Most users shouldn’t have any problems with the platform, and the vast majority report that it works as soon as installation is finished.