Table of Contents
Occasionally, you may need to restart Evergreen. It is imperative that you understand the basic
commands to stop and start the Evergreen server. You can start and stop Evergreen from the command line of
the server using the osrf_ctl.sh script located in the
openils/bin directory.
The osrf_ctl.sh command must be run as the opensrf user.
To view help on osrf_ctl.sh and get all of its options, run:
osrf_ctl.sh -h
To start Evergreen, run:
osrf_ctl.sh -l -a start_all
The -l flag is used to indicate that Evergreen is configured to use localhost as
the host. If you have configured opensrf.xml to use your real hostname, do not use the -l flag. The -a
option is required and indicates the action of the command. In this case
start_all.
If you receive the error message: osrf_ctl.sh: command not found, then your environment variable
PATH does not include the
/openils/bin directory. You can set it using the following command:
export PATH=$PATH:/openils/bin
If you receive the error message Can't locate OpenSRF/System.pm in @INC … BEGIN
failed–compilation aborted, then your environment variable PERL5LIB does not
include the /openils/lib/perl5 directory. You can set it
using the following command:
export PERL5LIB=$PERL5LIB:/openils/lib/perl5
It is also possible to start a specific service. For example:
osrf_ctl.sh -l -a start_router
will only start the router service.
If you decide to start each service individually, you need to start them in a specific order for Evergreen to start correctly. Run the commands in this exact order:
osrf_ctl.sh -l -a start_router
osrf_ctl.sh -l -a start_perl
osrf_ctl.sh -l -a start_c
After starting or restarting Evergreen, it is also necessary to restart the Apache web server
for the OPAC to work correctly.
To stop Evergreen, run:
osrf_ctl.sh -l -a stop_all
As with starting, you can choose to stop services individually.
To restart Evergreen, run:
osrf_ctl.sh -l -a restart_all