Chapter 3 of the IREn InGrid User Guide
Installation
3.1. Required Software
IREn InGrid runs on any operating system that has TCP sockets, and Java Virtual Machine. Since IREn also uses Java, and IREn InGrid is usually installed with one of its worker engines, you may already have Java installed. The installer of IREn InGrid is Java-based; it also includes setup.bat for Windows users convenience.
Installing IREn InGrid in Toaster mode also requires a Web server able to run CGI scripts.
3.2. Installation procedure
In order to install IREn InGrid, launch
setup.jar
or on Windows run:
setup.bat
Follow setup Wizard and complete the installation.
Note: Make sure that the user account who performs the installation has appropriate permissions, sufficient for modifying the system.
After the installation, IREn InGrid requires proper configuring in order to run. This includes creation of a configuration file. Actinia mode also requires working directories to be created and properly configured (user permissions and access mode). See example conf files in etc/, they are in XML format and contain all options commented with detailed descriptions. Uncomment required options and adjust values according to your requirements. IREn InGrid installed as Windows service uses ingrid.conf from the root installation directory. Installing IREn InGrid as Windows service will create basic ingrid.conf based on fairy.conf.example located at etc/ directory for testing purposes, adjust it to your requirements.
3.3. Installation directories
IREn InGrid installation has three types of installed content: programs and configuration files, working directories and program log.
Working directories
Actinia requires three folders for user files: input, output, and quarantine. It monitors the input folder for new work, places the formatted result into the output folder, and keeps a copy of all files not yet formatted in the quarantine folder so that if the system fails, all files are preserved and can be reprocessed. A temporary working directory, tmp is also used.
On Unix, these folders are in /var/spool/ingrid/; suggested folder names are inp/, out/, qua/, and tmp/. IREn InGrid requires write permission to the directories. All users [1] who will be submitting files for formatting must have write permission to the input directory (and probably also to the output one so that they may delete the formatted files after retrieving them).
Program logs
IREn InGrid writes detailed logs, to detect and resolve problems and tune performance. On Unix, /var/log/ingrid/ may be used to store them. The user running IREn InGrid must have a write permission on the logs directory.
[1] "users" in the Unix sense, that is, owners of processes; users do not have to access these folders directly.