Remote eXecution Server Maintenance (RXSM, pronounced \ˈrɑksɪm\) is a small bundle of scripts used to manage services and run reports on the Raritan Public Library's main server.
First, download or clone the latest version of this repository. Once you have the repository downloaded in a suitable location, run the following commands to check to make sure you have Node.js and npm installed.
node --version
npm --version
Then, run the following command to install the necessary npm packages.
npm install
To use the log-parsing features in the webstat script, you will need to install AWStats. Paste the contents of the wwwroot folder in RXSM's scripts/webstat/awstats directory.
You will need to set up a configuration file (cgi-bin/awstats.model.conf). Change the line that defines the logfile's location as so:
LogFile="<PATH_TO_RXSM_ROOT>/scripts/webstat/tmp/full.log"logresolvemerge.pl, a script included in the AWStats tools directory, is needed for the webstat script as well. Move it from the tools directory into the cgi-bin directory.
Perl is required to run AWStats. Verify the installation using the command line:
perl --version
Once you have the repository downloaded in a suitable location, you'll need to set up an .env file with the following variables before running any scripts.
root- The root folder containing this repository (UNIX-style).web_h,web_u,web_p- The URL, username, and password used to connect to the webhost control panel.ils_h,ils_u,ils_p- The URL, username, and password used to access the administrator tools of the Library's integrated library system (ILS).
npm run webstat
A report of website statistics will be prepared using AWStats and saved to the scripts/webstat/reports/YYMM directory.
Pull requests are encouraged by the Raritan Public Library to ensure our software is of the highest quality possible. If you would like to suggest major changes or restructuring of this repository, please open an issue. It is also strongly suggested you email us at info@raritanlibrary.org with any additional questions or concerns.