How to Install Evergreen on macOS
Evergreen is an open-source integrated library system that provides flexible and scalable solutions for library management. This tutorial will guide you through the installation process of Evergreen on macOS.
Prerequisites
Before you start, you need to ensure the following is installed on your system:
- macOS version 10.14 or later
- Homebrew package manager
Step 1: Install PostgreSQL
To install PostgreSQL, open the Terminal app on your macOS and run the following command:
brew install postgresql
Once the installation is complete, start the PostgreSQL server with the following command:
pg_ctl -D /usr/local/var/postgres start
You can also add PostgreSQL to startup items so that it starts automatically after a reboot.
Step 2: Install Evergreen Dependencies
Next, you need to install the dependencies required by Evergreen. To do this, open the Terminal app and run the following command:
brew install git automake autoconf libtool pcre perl gettext libxml2 libxslt openldap readline
Step 3: Clone Evergreen Repository
To clone the Evergreen repository, you need to run the following command:
git clone https://github.com/evergreenils/evergreen.git
Once the repository has been cloned, switch to the cloned directory using the following command:
cd evergreen
Step 4: Configure and Install Evergreen
To configure and install Evergreen, run the following commands:
./autogen.sh
./configure --prefix=/usr/local/evergreen
make
sudo make install
The above commands will configure and install Evergreen on your macOS system.
Step 5: Configure Evergreen Database
To configure the Evergreen database, you need to run the following command:
createdb evergreen
Once the database has been created, you can configure Evergreen to use PostgreSQL as its database by modifying the database configuration file. This file is located at /usr/local/evergreen/conf/OpenILS/global.tt2.
In this file, find the following line:
__DBI_dsn = "dbi:mysql:database=evergreen;host=localhost;port=3306"
Replace it with the following:
__DBI_dsn = "dbi:Pg:dbname=evergreen;host=localhost"
Step 6: Start Evergreen
Finally, you can start Evergreen by running the following command:
/usr/local/evergreen/bin/OpenSRF-extras start
Once Evergreen has started, you can access it by opening your web browser and entering the following URL:
http://localhost:8080/
Congratulations, you have successfully installed Evergreen on your macOS system!