OldScriptFinder: Documentation: Quick Start guide

This guide will help you to begin using Old Script Finder as easily as possible.


If you haven't already, install Old Script Finder. On machines that support RPM, the easiest way to do this is with this command (as root):

$ rpm -ivh http://www.oldscriptfinder.com/oldscriptfinder-current.rpm

That should be all you need to do to complete the installation. If your machine doesn't support RPM, see the full Installation Guide.

Pro (paid) Licenses: Register your IP

If you have paid for a Pro license, you need to register your server's IP with us, so you get the pro features. You can do this by running this command:

$ oldscriptfinder --regip --username=USER --password=PASSWORD

Replace USER with the username, and PASSWORD with the password, that you were given when you paid for your license. Free licenses do not need to register their IP.

Running A Basic Scan

If your httpd.conf file is located at /usr/local/apache/conf/httpd.conf, then the Old Script Finder installation will have detected it, and have set up your config file automatically to use it. Therefore, you can simply run:

$ oldscriptfinder

If your httpd.conf file is not located at /usr/local/apache/conf/httpd.conf, but elsewhere, you need to tell Old Script Finder where it is. You can either create the file /var/oldscripts/default.conf, or pass the path directly on the command line:

$ oldscriptfinder --usehttpdconf --httpdconf=/var/www/conf/httpd.conf

Or, you can scan just certain directories, without using the httpd.conf feature:

$ oldscriptfinder /home/liz/www /home/ann/www

Whichever method you use, you should see a list of old scripts detected as the scan progresses. By default, no warning emails will be sent, and nothing will be disabled. Note that the very first time that you run Old Script Finder, it may take a while to finish. On subsequent executions, it will only scan the scripts that've changed, so it'll be faster.

The --faster option

If you have the "locate" program (and keep the databases regualarly updated with "updatedb"), you might wish to use the --faster option when performing larger scans. This makes the scan use the locate program, which can be much quicker for larger scans (but slower if you're just scanning a single directory). For example:

$ oldscriptfinder --usehttpdconf --httpdconf=/var/www/conf/httpd.conf --faster


Old Script Finder includes many options to allow you to control the scan, output in various different formats, send warning emails to your users, etc. To see all of the available options, see the List of Config Options, or to learn about some of the more useful ones, continue to More Advanced Usage Instructions.