OldScriptFinder: Documentation: The Multi-Server Report Tool

The Multi-Server Report Tool allows you to see the results of scans from multiple different servers. You need to have Old Script Finder installed on each server (and a Pro license for each server, as the Free version doesn't allow multiple servers), and you probably also want to set up Old Script Finder to run automatically by cron on your servers, so you don't have to run it manually on each.

There are two versions of the Multi-Server Report Tool - one for servers with cPanel®/WHM, and one for all other servers. The WHM version only requires cPanel®/WHM on your main server - the other servers don't have to use it. You only need to install the Multi-Server Report Tool on one server - the server that you wish to view the results on. To install the Multi-Server Report Tool:

For cPanel®/WHM servers:

• Download the WHM version of the multi server report tool from the Subscribers Area.
• Create a new hosting account for the Old Script Finder report files. You can use an existing account if you prefer, but make sure to create a seperate directory for the report files, and set the "cwd" option later. If you use the username "oldscrip" (and create it on /home), you won't need to edit the script's config later, as that's the default.
• Decompress the multireport archive into /usr/local/cpanel/whostmgr/docroot/cgi:

  cd /usr/local/cpanel/whostmgr/docroot/cgi
  tar -xpzf multireport-whm-1.*.tgz

• Make sure addon_oldscriptfindermulti.cgi has execute permissions (usually 700).
• If you used "oldscrip" as the username when creating your hosting account, and your Old Script Finder setup will deposit the report files in /home/oldscrip/public_html, then you don't need to edit the cgi file. If the FTP account is for a different directory, however, you need to edit addon_oldscriptfindermulti.cgi, and change the $path variable to the path that the FTP account will upload files to:

  my $path = '/home/oldscrip/public_html';

  For example:

  my $path = '/home/reports/xml';

• Set up your Old Script Finder config files (on each server) to generate an XML report, and send it to the FTP account you set up in step 1. The filename must be "report-<hostname>-<time>.xml". Here's an example config file:

  [oldscripts]
  usehttpdconf=1
  httpdconf=/usr/local/apache/conf/httpd.conf
  xmlout=/var/oldscripts/report-<hostname>-<time>.xml
  delxmlreport=1
  faster=1
  [reportftp]
  xml=1
  hostname=host.something.example.com
  username=oldscrip
  password=password
  cwd=/public_html

• Run Old Script Finder regularly using this config file, on each server. Results will be sent to the FTP server and displayed when you visit the Old Script Finder Multi-Server Report Tool link in your WHM.

That's it!

For servers without cPanel®/WHM:

• Download the standard version of the multi server report tool from the Subscribers Area.
• Create a new FTP account for the Old Script Finder report files. You can use an existing FTP account if you prefer, but make sure to create a seperate directory for the report files, and set the "cwd" option later. If your FTP account uses the directory /home/oldscrip/public_html you won't need to edit the script's config later, as that's the default.
• Decompress the multireport archive into a web-accessible directory - preferably one which only allows access to your sysadmins.
• Make sure multireport.cgi has execute permissions (usually 755).
• If you used "/home/oldscrip/public_html" as the directory when creating your FTP account, and your Old Script Finder setup will deposit the report files there, then you don't need to edit the cgi file. If the FTP account is for a different directory, however, you need to edit multireport.cgi, and change the $path variable to the path that the FTP account will upload files to:

  my $path = '/home/oldscrip/public_html';

  For example:

  my $path = '/home/reports/xml';

• Set up your Old Script Finder config files (on each server) to generate an XML report, and send it to the FTP account you set up in step 1. The filename must be "report-<hostname>-<time>.xml". Here's an example config file:

  [oldscripts]
  usehttpdconf=1
  httpdconf=/usr/local/apache/conf/httpd.conf
  xmlout=/var/oldscripts/report-<hostname>-<time>.xml
  delxmlreport=1
  faster=1
  [reportftp]
  xml=1
  hostname=host.something.example.com
  username=oldscrip
  password=password
  cwd=/public_html

• Run Old Script Finder regularly using this config file, on each server. Results will be sent to the FTP server and displayed when you visit the multireport.cgi script in your web browser.

That's it!