How to Install Evergreen on NetBSD

Evergreen is a web-based library automation software that provides a wide range of functionalities for managing libraries. In this tutorial, we will guide you through the process of installing Evergreen on NetBSD.

Prerequisites

Before we proceed, make sure that the following prerequisites are met on your system:

  • You have a NetBSD-based system up and running
  • You have root access to the system
  • You are connected to the internet

Installing Evergreen

Step 1: Update the System

Before installing any new packages, it's always a good idea to update the system to the latest version. Run the following command to update your NetBSD system: 

# pkgin update

Step 2: Install Dependencies

Evergreen has a number of dependencies that need to be installed before we can proceed with the installation. Run the following command to install the required dependencies: 

# pkgin install build-essential autoconf automake libtool \
postgresql-server postgresql-client postgresql-plpython \
apache httpd npm nodejs

Step 3: Configure PostgreSQL

Evergreen requires a PostgreSQL database to store its data. We need to create and configure a PostgreSQL database before proceeding with the installation.

Run the following commands to create a new database and user: 

# su - postgres
$ psql
postgres# CREATE USER evergreen WITH PASSWORD 'password';
postgres# CREATE DATABASE evergreen OWNER evergreen;
postgres# \q
$ exit

Now, edit the pg_hba.conf file to allow connections from the evergreen user: 

# vi /var/postgresql/data/pg_hba.conf

Add the following line to the bottom of the file: 

host    evergreen        evergreen       127.0.0.1/32            md5

Save the file and exit.

Next, restart the PostgreSQL service: 

# /etc/rc.d/postgresql restart

Step 4: Install Evergreen

We are now ready to install Evergreen on our NetBSD system.

Run the following commands to download and install Evergreen: 

# cd /usr/local/src
# git clone https://github.com/evergreen-library/evergreen.git
# cd evergreen
# ./autogen.sh
# ./configure --prefix=/usr/local/evergreen \
--sysconfdir=/usr/local/evergreen/etc \
--localstatedir=/usr/local/evergreen/var \
--with-database=postgresql
# make
# make install

Step 5: Configure Apache

Evergreen runs as a web application, and we need to configure Apache to serve the evergreen web pages.

Create a new Apache configuration file for Evergreen: 

# vi /usr/pkg/etc/httpd/evergreen.conf

Add the following lines to the file: 

ProxyPass /evergreen/ http://localhost:8080/evergreen/
ProxyPassReverse /evergreen/ http://localhost:8080/evergreen/

<Location /evergreen>
    ProxyPassReverse /
    ProxyPreserveHost on
</Location>

Save the file and exit.

Now, enable the Apache proxy module and restart the Apache service: 

# /usr/pkg/sbin/httpd -M | grep proxy
# /usr/pkg/sbin/httpd -M | grep proxy_http
# /etc/rc.d/httpd restart

Step 6: Configure Evergreen

We need to configure Evergreen before we can start using it.

Run the following command to generate the Evergreen configuration files: 

# /usr/local/evergreen/bin/genesis.sh -v

Now, edit the evergreen.conf file: 

# vi /usr/local/evergreen/etc/evergreen.conf

Update the following parameters in the file: 

open_ils.storage.password = password
open_ils.storage.direct_db_login = true
open_ils.storage.pg.host = localhost
open_ils.storage.pg.database = evergreen
open_ils.storage.actor = open-ils.superuser

Save the file and exit.

Step 7: Start Evergreen

We are now ready to start Evergreen.

Run the following command to start Evergreen: 

# /usr/local/evergreen/bin/Open-ILS-CGI

Open your web browser and navigate to http://localhost/evergreen/. You should now see the Evergreen login page.

Conclusion

In this tutorial, we have shown you how to install Evergreen on NetBSD. We hope that you found this tutorial helpful. If you have any questions or feedback, please leave a comment below.