Installation NotesRequired files - SURE.pm
- OAIPMH.pm
- sureconfig.txt
- sure-generate.pl
- sure-oai.cgi
- sure.pl
Preparation - Make sure that the web server whose usage data need to be recorded has a cgi-bin directory which can hold executable files called with CGI. If the server does not yet have such a directory, create one.
- Install all the PERL Modules which are mentioned in appendix 1.
- Identify the location on your repository system where the log files are written. Make sure that external scripts have the rights to read the files in this directory.
Installation Follow the steps below: - Copy all the required files, except for “sure-oai.cgi” and “OAIPMH.pm” to a directory on the repository system whose usage data you want to record. The exact location is not relevant.
- The files “sure-oai.pl” and “OAIPMH.pm” must be copied to the CGI directory of your repository system.
- Create a directory which can function as the cache directory for the standardised usage data that will be created by the SURE software. Make sure that external scripts have the rights to read the files in this directory.
- Make a number of adjustments in the file “sureconfig.txt”: − Provide the complete path to the cache directory (see step 4), after “cachedirectory =”
- Provide the baseURL of the repository after “resolver =”.
- Provide the full path to the directory where the log files reside, after “log_directory =”
- After “log_file_format.1 =”, provide a regular expression for the name of the log file. For example: log_file_format.1 = ssl_request_log$
- After “log_file_format.2 =”, capture the year, month and day in the log file in a regular expression. For example: log_file_format.2 = ssl_request_log- (\d\d\d\d)(\d\d)(\d\d)
- Make a number of adjustments in the file “sure-oai.cgi”:
- After ‘repositoryName’, provide the name of the repository whose usage data are captured.
- After ‘adminEmails’, provide the e-mail of the person who can be contacted in case of problems.
- Create a cronjob that ensures that the file “sure.pl” is executed on a daily basis.
|
Where is the link to "appendix 1" , mentioned in the preparation section?
See: SURE-DataProviderSoftware?-InstallationNotes?.pdf in the download file.