usingstaffclient.
Add some index terms in several admin chapters.
-<?xml version='1.0' encoding='UTF-8'?>
-<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
- xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="adminmisc">
- <info>
-
- <title>Server Operations and Maintenance</title>
- <abstract>
- <para>This chapter deals with basic server operations such as starting and stopping Evergreen as well wall security, backing up and troubleshooting Evergreen.</para>
- </abstract>
- </info>
- <section xml:id="startingopensrf">
- <title>Starting, Stopping and Restarting</title>
- <para>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 <filename >osrf_ctl.sh</filename> script located in the
- <filename class="directory">openils/bin</filename> directory.</para>
- <note><para>The osrf_ctl.sh script must be run as the <emphasis>opensrf</emphasis> user.</para></note>
- <para>To view help on <filename>osrf_ctl.sh</filename> and get all of its options,
- run:</para>
- <screen>osrf_ctl.sh -h</screen>
- <para>To start Evergreen, run:</para>
- <screen>osrf_ctl.sh -l -a start_all</screen>
- <para>The -l flag is used to indicate that Evergreen is configured to use <emphasis>localhost</emphasis> 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 <emphasis>action</emphasis> of the command. In this case
- <emphasis>start_all</emphasis>.
- </para>
- <note>
- <para>If you receive the error message bash: osrf_ctl.sh:
- command not found, then your environment variable PATH does not include the
- <filename class="directory">/openils/bin</filename> directory.
- You can set it using the following command:</para>
- <screen>export PATH=$PATH:/openils/bin</screen>
- <para>If you receive the error message Can't locate OpenSRF/System.pm in @INC … BEGIN
- failed–compilation aborted, then your environment variable <emphasis>PERL5LIB</emphasis> does not
- include the <filename class="directory">/openils/lib/perl5</filename> directory. You can set it
- using the following command:</para>
- <screen>export PERL5LIB=$PERL5LIB:/openils/lib/perl5</screen>
- </note>
- <para>It is also possible to start a specific service. For example:</para>
- <screen>osrf_ctl.sh -l -a start_router</screen>
- <para>will only start the router service.</para>
- <caution>
- <para>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:</para>
- <screen>osrf_ctl.sh -l -a start_router</screen>
- <screen>osrf_ctl.sh -l -a start_perl</screen>
- <screen>osrf_ctl.sh -l -a start_c</screen>
- </caution>
- <para>After starting or restarting Evergreen, it is also necessary to restart the Apache web server for the
- OPAC to work correctly.</para>
- <para>To stop Evergreen, run:</para>
- <screen>osrf_ctl.sh -l -a stop_all</screen>
- <para>As with starting, you can choose to stop one service</para>
- <para>To restart Evergreen, run:</para>
- <screen>osrf_ctl.sh -l -a restart_all</screen>
- </section>
- <section xml:id="backingup">
- <title>Backing Up</title>
- <para>Backing up your system files and data is a critical task for server and database adminstrators.
- Having a strategy for backing up and recovery could be the difference between a minor annoyance for users and
- a a complete catastrophy.</para>
- <simplesect>
- <title>Backing up the Evergreen Database</title>
- <para>Most of the critical data for an Evergreen system – patrons, bibliographic records, holdings,
- transactions, bills – is stored in the PostgreSQL database. You can therefore use normal PostgreSQL
- backup procedures to backup this data. For example, the simplest method of backing up the Evergreen
- database is to use the pg_dump command to create a live backup of the database without having to
- interrupt any Evergreen services as follows:</para>
- <screen># pg_dump -U [username] -h [hostname] -f [output-file] [database-name]</screen>
- <screen>pg_dump -U evergreen -h localhost -f evergreen_db.backup evergreen</screen>
- <para>To restore the backed up database into a new database, create a new database using the
- template0 database template and the UTF8 encoding, and run the psql command, specifying the new
- database as your target:</para>
- <screen>createdb -T template0 -E UTF8 -U evergreen -h localhost new_evergreen</screen>
- <screen>psql -U evergreen -h localhost -f evergreen_db.backup new_evergreen</screen>
- <note>
- <para>This method of backup is only suitable for small Evergreen instances. Larger sites
- should consider implementing continuous archiving (also known as “log shipping”) to provide
- more granular backups with lower system overhead. More information on backing up PostgreSQL
- databases can be found in the official PostgreSQL documentation.</para>
- </note>
- </simplesect>
- <simplesect>
- <title>Backing up Evergreen Files</title>
- <para>When you deploy Evergreen, you will probably customize many aspects of your system includung
- the system configuration files, Apache configuration files, OPAC and Staff Client. In order to
- protect your investment of time, you should carefully consider the best approach to backing up
- files.</para>
- <para>There are a number of ways of tackling this problem. You could create a script that regularly
- creates a time-stamped tarball of all of these files and copies it to a remote server - but that
- would build up over time to hundreds of files. You could use rsync to ensure that the files of
- interest are regularly updated on a remote server - but then you would lose track of the changes to
- the files, should you make a change that introduces a problem down the road.</para>
- <para>Perhaps one of the best options is to use a version control system like Bazaar, git,
- Subversion, or CVS to regularly push updates of the files you care about to a repository on a
- remote server. This gives you the advantage of quickly being able to run through the history of the
- changes you made, with a commenting system that reminds you why each change was made, combined with
- remote storage of the pertinent files in case of disaster on site. In addition, your team can create
- local copies of the repository and test their own changes in isolation from the production
- system. Using a version control system also helps to recover system customizations after an
- upgrade.</para>
- </simplesect>
- <simplesect>
- <title>Full System Backup</title>
- <para>A full system backup archives every file on the file system. Some basic methods require you
- to shut down most system processes; other methods can use mirrored RAID setups or SAN storage to
- take “snapshot” backups of your full system while the system continues to run. The subject of how
- to implement full system backups is beyond the scope of this documentation.</para>
- </simplesect>
- </section>
- <section xml:id="security">
- <title>Security</title>
- <para>As with an ILS and resource accessible from the world wilde web careful consideration needs to be
- given to the security of your Evergreen servers and database. While it is impossible to cover all aspects
- of security, it is important to take several percautions when setting up production Evergreen site.</para>
- <orderedlist>
- <listitem>
- <para>Change the Evergreen <emphasis>Admin</emphasis> password and keep it secure. The
- default Admin password is known by anyone who has installed Evergreen. It is not a secret
- and needs to be changed by the Administrator. It should also only be shared by those who
- need the highest level access to Evergreen.</para>
- </listitem>
- <listitem>
- <para>Create strong passwords using a combination of numerican and alphatbetical characters
- for all of the Administrative passwords used by Evergreen including the Evergreen
- postgresql user, opensrf linux account, and Admin evergreen users, and of course, any
- superusers on your server.</para>
- </listitem>
- <listitem>
- <para>Open ports in the firewall with Caution - It is necessary to open some ports to the
- server such as port 80 for http and 443 for ssl, and it can be helpful to open ports for
- remote access to the database or staff client. It is also critical for an administrator to
- understand the concepts of network security and take precautions to not allow the server to
- be vulnerable to the outside world.
- </para>
- </listitem>
- <listitem>
- <para>Use permissions and permission groups wisely - it is important to understand the
- purpose of the permissions and to only give users the level of access that they require.
- </para>
- </listitem>
- </orderedlist>
- </section>
- <section xml:id="logfiles">
- <title>Managing Log Files</title>
- <para>Evergreen comes with a sophisticated logging system, but it is important to manage the OpenSRF and Evergreen logs. This section will provide a couple of log management techniques
- and tools.</para>
- <simplesect>
- <title>Using the Log Rotate Utility to Manage Log Size</title>
- <para>Fortunately, this is not a new problem for Unix administrators, and there are a number of ways of keeping your logs under control. On Debian and Ubuntu, for example,
- the logrotate utility controls when old log files are compressed and a new log file is started. logrotate runs once a day and checks all log files that it knows about to see if a
- threshold of time or size has been reached and rotates the log files if a threshold condition has been met.</para>
- <para>To teach logrotate to rotate Evergreen logs on a weekly basis, or if they are > 50MB in size, create a new file <filename>/etc/logrotate.d/evergreen</filename> with the
- following contents: </para>
- <screen>compress</screen>
- <screen>/openils/var/log/*.log {</screen>
- <screen> # keep the last 4 archived log files along with the current log file</screen>
- <screen> # log log.1.gz log.2.gz log.3.gz log.4.gz</screen>
- <screen> # and delete the oldest log file (what would have been log.5.gz)</screen>
- <screen>rotate 5</screen>
- <screen># if the log file is > 50MB in size, rotate it immediately</screen>
- <screen> size 50M</screen>
- <screen> # for those logs that don't grow fast, rotate them weekly anyway</screen>
- <screen> weekly</screen>
- <screen>}</screen>
- </simplesect>
- <simplesect>
- <title>Chaning Logging Level for Evergreen</title>
- <para>Change the Log Levels in your config files. Changing the level of logging will help
- narrow down errors.</para>
- <tip>
- <para>A high logging level is not wise to do in a production environment since it
- will produce vastly larger log files and thus reduce server performance.</para>
- </tip>
- <para>Change logging levels by editing the configuration file
- <filename>/openils/conf/opensrf_core.xml</filename></para>
- <para>you will want to search for lines containing <loglevel>.</para>
- <para> the default setting for loglevel is 3 which will log <emphasis>errors</emphasis>,
- <emphasis>warnings</emphasis> and <emphasis>information</emphasis>.</para>
- <para>The next level is 4 which is for debugging and provides additional information
- helpful for the debugging process.</para>
- <para>Thus, lines with:</para>
- <screen><loglevel>3</loglevel></screen>
- <para>Should be changed to:</para>
- <screen><loglevel>4</loglevel></screen>
- <para>to allow debugging level logging</para>
- <para>Other logging levels inclide <emphasis>0</emphasis> for no logging,
- <emphasis>1</emphasis> for logging errors and <emphasis>2</emphasis> for logging warnings
- and errors.</para>
- </simplesect>
- </section>
-</chapter>
+<?xml version='1.0' encoding='UTF-8'?>\r
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"\r
+ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="adminmisc">\r
+ <info>\r
+ \r
+ <title>Server Operations and Maintenance</title>\r
+ <abstract>\r
+ <para>This chapter deals with basic server operations such as starting and stopping Evergreen as well wall security, backing up and troubleshooting Evergreen.</para>\r
+ </abstract>\r
+ </info> \r
+ <section xml:id="startingopensrf">\r
+ <title>Starting, Stopping and Restarting</title>\r
+ <para>Occasionally, you may need to restart Evergreen. It is imperative that you understand the basic \r
+ commands to stop and start the Evergreen server. You can start and stop Evergreen from the command line of \r
+ the server using the <filename >osrf_ctl.sh</filename> script located in the \r
+ <filename class="directory">openils/bin</filename> directory.</para> \r
+ <note><para>The osrf_ctl.sh script must be run as the <emphasis>opensrf</emphasis> user.</para></note>\r
+ <para>To view help on <filename>osrf_ctl.sh</filename> and get all of its options, \r
+ run:</para>\r
+ <screen>osrf_ctl.sh -h</screen>\r
+ <para>To start Evergreen, run:</para>\r
+ <screen>osrf_ctl.sh -l -a start_all</screen>\r
+ <para>The -l flag is used to indicate that Evergreen is configured to use <emphasis>localhost</emphasis> as \r
+ the host. If you have configured opensrf.xml to use your real hostname, do not use the -l flag. The -a \r
+ option is required and indicates the <emphasis>action</emphasis> of the command. In this case \r
+ <emphasis>start_all</emphasis>. \r
+ </para> \r
+ <note>\r
+ <para>If you receive the error message bash: osrf_ctl.sh: \r
+ command not found, then your environment variable PATH does not include the \r
+ <filename class="directory">/openils/bin</filename> directory. \r
+ You can set it using the following command:</para>\r
+ <screen>export PATH=$PATH:/openils/bin</screen>\r
+ <para>If you receive the error message Can't locate OpenSRF/System.pm in @INC … BEGIN \r
+ failed–compilation aborted, then your environment variable <emphasis>PERL5LIB</emphasis> does not \r
+ include the <filename class="directory">/openils/lib/perl5</filename> directory. You can set it \r
+ using the following command:</para>\r
+ <screen>export PERL5LIB=$PERL5LIB:/openils/lib/perl5</screen>\r
+ </note> \r
+ <para>It is also possible to start a specific service. For example:</para>\r
+ <screen>osrf_ctl.sh -l -a start_router</screen>\r
+ <para>will only start the router service.</para>\r
+ <caution>\r
+ <para>If you decide to start each service individually, you need to start them in a specific order \r
+ for Evergreen to start correctly. Run the commands in this exact order:</para>\r
+ <screen>osrf_ctl.sh -l -a start_router</screen>\r
+ <screen>osrf_ctl.sh -l -a start_perl</screen>\r
+ <screen>osrf_ctl.sh -l -a start_c</screen>\r
+ </caution> \r
+ <para>After starting or restarting Evergreen, it is also necessary to restart the Apache web server for the \r
+ OPAC to work correctly.</para> \r
+ <para>To stop Evergreen, run:</para>\r
+ <screen>osrf_ctl.sh -l -a stop_all</screen>\r
+ <para>As with starting, you can choose to stop one service</para>\r
+ <para>To restart Evergreen, run:</para>\r
+ <screen>osrf_ctl.sh -l -a restart_all</screen>\r
+ </section>\r
+ <section xml:id="backingup">\r
+ <title>Backing Up</title>\r
+ <para>Backing up your system files and data is a critical task for server and database administrators. \r
+ Having a strategy for backing up and recovery could be the difference between a minor annoyance for users and\r
+ a a complete catastrophe.</para> \r
+ <simplesect>\r
+ <title>Backing up the Evergreen Database</title>\r
+ <para>Most of the critical data for an Evergreen system – patrons, bibliographic records, holdings, \r
+ transactions, bills – is stored in the PostgreSQL database. You can therefore use normal PostgreSQL \r
+ backup procedures to backup this data. For example, the simplest method of backing up the Evergreen\r
+ database is to use the pg_dump command to create a live backup of the database without having to \r
+ interrupt any Evergreen services as follows:</para>\r
+ <screen># pg_dump -U [username] -h [hostname] -f [output-file] [database-name]</screen> \r
+ <screen>pg_dump -U evergreen -h localhost -f evergreen_db.backup evergreen</screen>\r
+ <para>To restore the backed up database into a new database, create a new database using the \r
+ template0 database template and the UTF8 encoding, and run the psql command, specifying the new \r
+ database as your target:</para>\r
+ <screen>createdb -T template0 -E UTF8 -U evergreen -h localhost new_evergreen</screen>\r
+ <screen>psql -U evergreen -h localhost -f evergreen_db.backup new_evergreen</screen>\r
+ <note>\r
+ <para>This method of backup is only suitable for small Evergreen instances. Larger sites \r
+ should consider implementing continuous archiving (also known as “log shipping”) to provide \r
+ more granular backups with lower system overhead. More information on backing up PostgreSQL \r
+ databases can be found in the official PostgreSQL documentation.</para>\r
+ </note>\r
+ </simplesect>\r
+ <simplesect>\r
+ <title>Backing up Evergreen Files</title>\r
+ <para>When you deploy Evergreen, you will probably customize many aspects of your system including \r
+ the system configuration files, Apache configuration files, OPAC and Staff Client. In order to \r
+ protect your investment of time, you should carefully consider the best approach to backing up \r
+ files.</para>\r
+ <para>There are a number of ways of tackling this problem. You could create a script that regularly \r
+ creates a time-stamped tarball of all of these files and copies it to a remote server - but that \r
+ would build up over time to hundreds of files. You could use rsync to ensure that the files of \r
+ interest are regularly updated on a remote server - but then you would lose track of the changes to \r
+ the files, should you make a change that introduces a problem down the road.</para>\r
+ <para>Perhaps one of the best options is to use a version control system like Bazaar, git, \r
+ Subversion, or CVS to regularly push updates of the files you care about to a repository on a \r
+ remote server. This gives you the advantage of quickly being able to run through the history of the \r
+ changes you made, with a commenting system that reminds you why each change was made, combined with \r
+ remote storage of the pertinent files in case of disaster on site. In addition, your team can create \r
+ local copies of the repository and test their own changes in isolation from the production \r
+ system. Using a version control system also helps to recover system customizations after an \r
+ upgrade.</para>\r
+ </simplesect>\r
+ <simplesect>\r
+ <title>Full System Backup</title>\r
+ <para>A full system backup archives every file on the file system. Some basic methods require you \r
+ to shut down most system processes; other methods can use mirrored RAID setups or SAN storage to \r
+ take “snapshot” backups of your full system while the system continues to run. The subject of how \r
+ to implement full system backups is beyond the scope of this documentation.</para>\r
+ </simplesect>\r
+ </section>\r
+ <section xml:id="security">\r
+ <title>Security</title>\r
+ <para>As with an ILS and resource accessible from the world wide web careful consideration needs to be \r
+ given to the security of your Evergreen servers and database. While it is impossible to cover all aspects \r
+ of security, it is important to take several precautions when setting up production Evergreen site.</para>\r
+ <orderedlist>\r
+ <listitem>\r
+ <para>Change the Evergreen <emphasis>Admin</emphasis> password and keep it secure. The \r
+ default Admin password is known by anyone who has installed Evergreen. It is not a secret \r
+ and needs to be changed by the Administrator. It should also only be shared by those who \r
+ need the highest level access to Evergreen.</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para>Create strong passwords using a combination of numerical and alphabetical characters \r
+ for all of the Administrative passwords used by Evergreen including the Evergreen \r
+ postgresql user, opensrf Linux account, and Admin evergreen users, and of course, any\r
+ superusers on your server.</para> \r
+ </listitem>\r
+ <listitem>\r
+ <para>Open ports in the firewall with Caution - It is necessary to open some ports to the \r
+ server such as port 80 for http and 443 for ssl, and it can be helpful to open ports for \r
+ remote access to the database or staff client. It is also critical for an administrator to \r
+ understand the concepts of network security and take precautions to not allow the server to \r
+ be vulnerable to the outside world. \r
+ </para>\r
+ </listitem>\r
+ <listitem>\r
+ <para>Use permissions and permission groups wisely - it is important to understand the \r
+ purpose of the permissions and to only give users the level of access that they require.\r
+ </para> \r
+ </listitem>\r
+ </orderedlist> \r
+ </section>\r
+ <section xml:id="logfiles">\r
+ <title>Managing Log Files</title>\r
+ <para>Evergreen comes with a sophisticated logging system, but it is important to manage the OpenSRF and Evergreen logs. This section will provide a couple of log management techniques \r
+ and tools.</para> \r
+ <simplesect>\r
+ <title>Using the Log Rotate Utility to Manage Log Size</title> \r
+ <para>Fortunately, this is not a new problem for Unix administrators, and there are a number of ways of keeping your logs under control. On Debian and Ubuntu, for example, \r
+ the logrotate utility controls when old log files are compressed and a new log file is started. logrotate runs once a day and checks all log files that it knows about to see if a \r
+ threshold of time or size has been reached and rotates the log files if a threshold condition has been met.</para>\r
+ <para>To teach logrotate to rotate Evergreen logs on a weekly basis, or if they are > 50MB in size, create a new file <filename>/etc/logrotate.d/evergreen</filename> with the \r
+ following contents: </para>\r
+ <screen>compress</screen>\r
+ <screen>/openils/var/log/*.log {</screen>\r
+ <screen> # keep the last 4 archived log files along with the current log file</screen>\r
+ <screen> # log log.1.gz log.2.gz log.3.gz log.4.gz</screen>\r
+ <screen> # and delete the oldest log file (what would have been log.5.gz)</screen>\r
+ <screen>rotate 5</screen>\r
+ <screen># if the log file is > 50MB in size, rotate it immediately</screen>\r
+ <screen> size 50M</screen>\r
+ <screen> # for those logs that don't grow fast, rotate them weekly anyway</screen>\r
+ <screen> weekly</screen>\r
+ <screen>}</screen>\r
+ </simplesect>\r
+ <simplesect>\r
+ <title>Changing Logging Level for Evergreen</title>\r
+ <para>Change the Log Levels in your config files. Changing the level of logging will help \r
+ narrow down errors.</para> \r
+ <tip>\r
+ <para>A high logging level is not wise to do in a production environment since it \r
+ will produce vastly larger log files and thus reduce server performance.</para>\r
+ </tip>\r
+ <para>Change logging levels by editing the configuration file \r
+ <filename>/openils/conf/opensrf_core.xml</filename></para>\r
+ <para>you will want to search for lines containing <loglevel>.</para>\r
+ <para> the default setting for loglevel is 3 which will log <emphasis>errors</emphasis>, \r
+ <emphasis>warnings</emphasis> and <emphasis>information</emphasis>.</para>\r
+ <para>The next level is 4 which is for debugging and provides additional information \r
+ helpful for the debugging process.</para>\r
+ <para>Thus, lines with:</para>\r
+ <screen><loglevel>3</loglevel></screen>\r
+ <para>Should be changed to:</para>\r
+ <screen><loglevel>4</loglevel></screen>\r
+ <para>to allow debugging level logging</para>\r
+ <para>Other logging levels include <emphasis>0</emphasis> for no logging, \r
+ <emphasis>1</emphasis> for logging errors and <emphasis>2</emphasis> for logging warnings \r
+ and errors.</para>\r
+ </simplesect>\r
+ </section>\r
+</chapter>\r
-<?xml version='1.0' encoding='UTF-8'?>
-<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
- xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="upgradingevergreen">
- <info>
- <title>Upgrading Evergreen from 1.4 to 1.6</title>
- <abstract>
- <para>This Chapter will explain the step-by-step process of upgrading <application>Evergreen
- </application> from version 1.4 to 1.6, including steps to upgrade <application>OpenSRF</application>. Before
- upgrading, it is important to carefully plan an upgrade strategy to minimise system downtime and
- service interruptions. All of the steps in this chapter are to be completed from the command line.</para>
- </abstract>
- </info>
- <procedure>
- <step>
- <para>Stop Evergreen and back up data.</para>
- <procedure>
- <step>
- <para>As <emphasis>root</emphasis>, stop the <application>Apache</application>
- web server<indexterm><primary>web server</primary><secondary>Apache</secondary></indexterm>.</para>
- </step>
- <step>
- <para>As the <emphasis>opensrf</emphasis> user, stop all
- <application>Evergreen</application>
- and <application>OpenSRF</application> services:</para>
- <screen>osrf_ctl.sh -l -a stop_all</screen>
- </step>
- <step>
- <para>Back up of the <filename class='directory'>/openils</filename>
- directory.</para>
- </step>
- <step>
- <para><link linkend="backupevergreendatabase">Back up the <application>evergreen
- </application> database</link>.</para>
- </step>
- </procedure>
- </step>
- <step>
- <para>Upgrade OpenSRF<indexterm><primary>OpenSRF</primary></indexterm> to 1.2</para>
- <procedure>
- <step>
- <para>As the opensrf user, download and extract the source files for OpenSRF
- 1.2:</para>
- <screen>wget \
- http://open-ils.org/downloads/OpenSRF-1.2.2.tar.gz</screen>
- <screen>tar xzf OpenSRF-1.2.2.tar.gz</screen>
- <para>A new directory OpenSRF-1.2.2 will be created</para>
- <note><para>For the latest edition of OpenSRF, check the Evergreen download page at
- <ulink url="http://www.open-ils.org/downloads.php" />.
- </para></note>
- </step>
- <step>
- <para>As the root user, install the software prerequisites using the automatic
- prerequisite installer.</para>
- <screen>aptitude install make</screen>
- <screen>cd /home/opensrf/OpenSRF-1.2.2</screen>
- <para>Replace <emphasis>[distribution]</emphasis> below with the following value
- for your distribution:</para>
- <itemizedlist>
- <listitem>
- <para><emphasis>debian-etch</emphasis> for Debian Etch (4.0)<indexterm><primary>Linux</primary><secondary>Debian</secondary></indexterm></para>
- </listitem>
- <listitem>
- <para><emphasis>debian-lenny</emphasis> for Debian Lenny (5.0)</para>
- </listitem>
- <listitem>
- <para><emphasis>ubuntu-hardy</emphasis> for Ubuntu Hardy Heron (8.04)<indexterm><primary>Linux</primary><secondary>Ubuntu</secondary></indexterm></para>
- </listitem>
- <listitem>
- <para><emphasis>ubuntu-intrepid</emphasis> for Ubuntu Intrepid Ibex
- (8.10)</para>
- </listitem>
- <listitem>
- <para><emphasis>ubuntu-jaunty</emphasis> for Ubuntu Jaunty Jackalope
- (9.04)</para>
- </listitem>
- <listitem>
- <para><emphasis>ubuntu-karmic</emphasis> for Ubuntu Karmic Koala
- (9.10)</para>
- </listitem>
- </itemizedlist>
- <screen>make -f src/extras/Makefile.install <emphasis>[distribution]</emphasis>
- </screen>
- <para>This will install a number of packages required by OpenSRF on your system,
- including some Perl modules from CPAN<indexterm><primary>programming language</primary><secondary>Perl</secondary><tertiary>CPAN</tertiary>
-</indexterm>. You can say “no” to the initial CPAN
- configuration prompt to allow it to automatically configure itself to download
- and install Perl modules from CPAN. The CPAN installer will ask you a number of
- times whether it should install prerequisite modules - say “yes”.</para>
- </step>
- <step>
- <para>As the opensrf user, configure and compile OpenSRF:</para>
- <note>You can include the –enable-python and –enable-java configure options if
- you want to include support for Python<indexterm><primary>programming language</primary><secondary>Python</secondary>
-</indexterm> and Java<indexterm><primary>programming language</primary><secondary>Java</secondary>
-</indexterm>, respectively.</note>
- <screen>cd /home/opensrf/OpenSRF-1.2.2</screen>
- <screen>./configure --prefix=/openils --sysconfdir=/openils/conf</screen>
- <screen>make</screen>
- </step>
- <step>
- <para>As the root user, return to your OpenSRF build directory and install
- OpenSRF:</para>
- <screen>cd /home/opensrf/OpenSRF-1.2.2</screen>
- <screen>make install</screen>
- </step>
- <step>
- <para>As the root user, change the ownership of the installed files to the opensrf
- user:</para>
- <screen>chown -R opensrf:opensrf /openils</screen>
- </step>
- <step>
- <para>Restart and Test OpenSRF</para>
- <screen>osrf_ctl.sh -l -a start_all</screen>
- <screen>/openils/bin/srfsh</screen>
- <screen>srfsh# request opensrf.math add 2 2</screen>
- <para>You should see output like:</para>
- <screen>Received Data: 4</screen>
- <screen></screen>
- <screen>------------------------------------</screen>
- <screen>Request Completed Successfully</screen>
- <screen>Request Time in seconds: 0.007519</screen>
- <screen>------------------------------------</screen>
- <screen></screen>
- <screen>srfsh#</screen>
- <para>If test <emphasis>Completed Successfully</emphasis> move onto next section.
- If not, refer to <link linkend="troubleshooting">troubleshooting</link> section
- of this documentation.</para>
- </step>
- </procedure>
- </step>
- <step>
- <para>Upgrade <application>Evergreen</application> to 1.6</para>
- <procedure>
- <step>
- <para>As the <emphasis>opensrf</emphasis> user, download and extract Evergreen 1.6
- </para>
- <screen>wget \</screen>
- <screen>http://evergreen-ils.org/downloads/Evergreen-ILS-1.6.0.3.tar.gz</screen>
- <screen>tar xzf Evergreen-ILS-1.6.0.3.tar.gz</screen>
- <note><para>For the latest edition of Evergreen check the Evergreen download page at
- <ulink url="http://www.open-ils.org/downloads.php" /></para></note>
- </step>
- <step>
- <para>As the <emphasis>root</emphasis> user, install the prerequisites:</para>
- <screen>cd /home/opensrf/Evergreen-ILS-1.6.0.3</screen>
- <para>On the next command, replace <emphasis>[distribution]</emphasis> with one of
- these values for your distribution of Debian or Ubuntu:</para>
- <itemizedlist>
- <listitem>
- <para><emphasis>debian-etch</emphasis> for Debian Etch (4.0)</para>
- </listitem>
- <listitem>
- <para><emphasis>debian-lenny</emphasis> for Debian Lenny (5.0)</para>
- </listitem>
- <listitem>
- <para><emphasis>ubuntu-hardy</emphasis> for Ubuntu Hardy Heron
- (8.04)</para>
- </listitem>
- <listitem>
- <para><emphasis>ubuntu-intrepid</emphasis> for Ubuntu Intrepid Ibex
- (8.10)</para>
- </listitem>
- <listitem>
- <para><emphasis>ubuntu-jaunty</emphasis> for Ubuntu Jaunty Jackalope
- (9.04)</para>
- </listitem>
- <listitem>
- <para><emphasis>ubuntu-karmic</emphasis> for Ubuntu Karmic Koala
- (9.10)</para>
- </listitem>
- </itemizedlist>
- <screen>make -f Open-ILS/src/extras/Makefile.install <emphasis>[distribution]</emphasis></screen>
- </step>
- <step>
- <para>As the <emphasis>opensrf</emphasis> user, configure and compile
- <application>Evergreen</application>:</para>
- <screen>cd /home/opensrf/Evergreen-ILS-1.6.0.3</screen>
- <screen>./configure --prefix=/openils --sysconfdir=/openils/conf</screen>
- <screen>make</screen>
- </step>
- <step>
- <para>As the <emphasis>root</emphasis> user, install
- <application>Evergreen</application>:</para>
- <screen>make STAFF_CLIENT_BUILD_ID=rel_1_6_0_3 install</screen>
- </step>
- <step>
- <para>Change to the <application>Evergreen</application> installation
- directory:</para>
- <screen>cd /home/opensrf/Evergreen-ILS-1.6.0.3</screen>
- </step>
- <step>
- <para>As the <emphasis>root</emphasis> user, build live-db-setup.pl for the cgi-bin
- bootstrapping scripts and offline-config.pl for the offline staff client data
- uploader:</para>
- <screen>perl Open-ILS/src/support-scripts/eg_db_config.pl \</screen>
- <screen>--create-bootstrap --create-offline --user evergreen \</screen>
- <screen>--password evergreen --hostname localhost --port 5432 \</screen>
- <screen>--database evergreen</screen>
- </step>
- <step>
- <para>As the <emphasis>root</emphasis> user, change all files to be owned by the
- <emphasis>opensrf</emphasis> user and group:</para>
- <screen>chown -R opensrf:opensrf /openils</screen>
- </step>
- <step>
- <para>Update the Evergreen database</para>
- <screen>psql -U evergreen -h localhost \</screen>
- <screen>-f Open-ILS/src/sql/Pg/1.4.0.5-1.6.0.0-upgrade-db.sql evergreen</screen>
- <screen>psql -U evergreen -h localhost \</screen>
- <screen>-f Open-ILS/src/sql/Pg/1.6.0.0-1.6.0.1-upgrade-db.sql evergreen</screen>
- <screen>psql -U evergreen -h localhost \</screen>
- <screen>-f Open-ILS/src/sql/Pg/1.6.0.1-1.6.0.2-upgrade-db.sql evergreen</screen>
- <screen>psql -U evergreen -h localhost \</screen>
- <screen>-f Open-ILS/src/sql/Pg/1.6.0.2-1.6.0.3-upgrade-db.sql evergreen</screen>
- <screen>psql -U evergreen -h localhost \</screen>
- <screen>psql -U evergreen -h localhost -f 1.6.0-mmbxs-cleanup.sql \
- evergreen</screen>
- </step>
- <step>
- <para>As the <emphasis>opensrf</emphasis> user,
- copy /openils/conf/oils_web.xml.example to /openils/conf/oils_web.xml
- (needed for acquisitions templates).</para>
- <screen>cp /openils/conf/oils_web.xml.example \
- /openils/conf/oils_web.xml</screen>
- </step>
- <step>
- <para>Update opensrf_core.xml and opensrf.xml by copying the new example files (/
- openils/conf/opensrf_core.xml.example and /openils/conf/opensrf.xml).</para>
- <screen>cp /openils/conf/opensrf_core.xml.example \</screen>
- <screen>/openils/conf/opensrf_core.xml</screen>
- <screen>cp /openils/conf/opensrf.xml.example /openils/conf/opensrf.xml</screen>
- </step>
- <step>
- <para>Update opensrf.xml with the database connection info:</para>
- <screen>perl Open-ILS/src/support-scripts/eg_db_config.pl \</screen>
- <screen>--update-config --service all --user evergreen \</screen>
- <screen>--password evergreen --hostname localhost --port 5432 \</screen>
- <screen>--database evergreen</screen>
- </step>
- <step>
- <para>Update /etc/apache2/startup.pl by copying the example from
- Open-ILS/examples/apache/startup.pl.</para>
- </step>
- <step>
- <para>Update /etc/apache2/eg_vhost.conf by copying the example from
- Open-ILS/examples/apache/eg_vhost.conf.</para>
- </step>
- <step>
- <para>Update /etc/apache2/sites-available/eg.conf by copying the example from Open-ILS/
- examples/apache/eg.conf.</para>
- </step>
- <step>
- <para>Recover customizations you have made to the <application>Apache</application>
- configuration files. For example, if you purchased an SSL certificate, you
- will need to edit eg.conf to point to the appropriate SSL certificate files.</para>
- </step>
- </procedure>
- </step>
- <step>
- <para>Restart Evergreen and Test</para>
- <procedure>
- <step>
- <para>As the <emphasis>opensrf</emphasis> user, start all
- <application>Evergreen</application> and <application>OpenSRF</application>
- services:</para>
- <screen>osrf_ctl.sh -l -a start_all</screen>
- </step>
- <step>
- <para>As the <emphasis>opensrf</emphasis> user, run autogen to refresh the static
- organizational data files:</para>
- <screen>cd /openils/bin</screen>
- <screen>./autogen.sh -c /openils/conf/opensrf_core.xml -u</screen>
- </step>
- <step>
- <para>Start srfsh and try logging in using your <application>Evergreen</application>
- username and password:</para>
- <screen>/openils/bin/srfsh</screen>
- <screen>srfsh% login <emphasis>username password</emphasis></screen>
- </step>
- <step>
- <para>Start the <application>Apache</application> web server.</para>
- </step>
- </procedure>
- </step>
- </procedure>
- <note>
- <title>Troubleshooting:</title>
- <para>If you encounter errors, refer to the <link linkend="troubleshooting">troubleshooting
- section</link> of this documentation for tips
- on finding solutions and seeking further assistance from the Evergreen community.</para>
- </note>
-</chapter>
+<?xml version='1.0' encoding='UTF-8'?>\r
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"\r
+ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="upgradingevergreen">\r
+ <info>\r
+ <title>Upgrading Evergreen from 1.4 to 1.6.0.8</title>\r
+ <abstract>\r
+ <para>This Chapter will explain the step-by-step process of upgrading <application>Evergreen\r
+ </application> from version 1.4 to 1.6, including steps to upgrade <application>OpenSRF</application>. Before \r
+ upgrading, it is important to carefully plan an upgrade strategy to minimize system downtime and \r
+ service interruptions. All of the steps in this chapter are to be completed from the command line.</para>\r
+ </abstract>\r
+ </info> \r
+ <simplesect>\r
+ <title>Stop Evergreen and back up data.</title>\r
+ <procedure>\r
+ <step>\r
+ <para>As <emphasis>root</emphasis>, stop the <application>Apache</application> \r
+ web server<indexterm><primary>web server</primary><secondary>Apache</secondary></indexterm>.</para>\r
+ </step>\r
+ <step>\r
+ <para>As the <emphasis>opensrf</emphasis> user, stop all \r
+ <application>Evergreen</application>\r
+ and <application>OpenSRF</application> services:</para>\r
+ <screen>osrf_ctl.sh -l -a stop_all</screen>\r
+ </step>\r
+ <step>\r
+ <para>Back up of the <filename class='directory'>/openils</filename> \r
+ directory.</para>\r
+ </step>\r
+ <step>\r
+ <para><link linkend="backupevergreendatabase">Back up the <application>evergreen\r
+ </application> database</link>.</para>\r
+ </step>\r
+ </procedure>\r
+ </simplesect>\r
+ <simplesect>\r
+ <title>Upgrade OpenSRF<indexterm><primary>OpenSRF</primary><secondary>1.2</secondary></indexterm> to 1.2</title>\r
+ <procedure>\r
+ <step>\r
+ <para>As the opensrf user, download and extract the source files for OpenSRF \r
+ 1.2:</para>\r
+ <screen>wget http://open-ils.org/downloads/OpenSRF-1.2.2.tar.gz</screen>\r
+ <screen>tar xzf OpenSRF-1.2.2.tar.gz</screen>\r
+ <para>A new directory OpenSRF-1.2.2 will be created</para>\r
+ <note><para>For the latest edition of OpenSRF, check the Evergreen download page at \r
+ <ulink url="http://www.open-ils.org/downloads.php" />.\r
+ </para></note>\r
+ </step>\r
+ <step> \r
+ <para>As the root user, install the software prerequisites using the automatic \r
+ prerequisite installer.</para> \r
+ <screen>aptitude install make</screen>\r
+ <screen>cd /home/opensrf/OpenSRF-1.2.2</screen>\r
+ \r
+ <para>Replace <emphasis>[distribution]</emphasis> below with the following value \r
+ for your distribution:</para>\r
+ <itemizedlist>\r
+ <listitem>\r
+ <para><emphasis>debian-etch</emphasis> for Debian Etch (4.0)<indexterm><primary>Linux</primary><secondary>Debian</secondary></indexterm></para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>debian-lenny</emphasis> for Debian Lenny (5.0)</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>ubuntu-hardy</emphasis> for Ubuntu Hardy Heron (8.04)<indexterm><primary>Linux</primary><secondary>Ubuntu</secondary></indexterm></para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>ubuntu-intrepid</emphasis> for Ubuntu Intrepid Ibex \r
+ (8.10)</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>ubuntu-jaunty</emphasis> for Ubuntu Jaunty Jackalope \r
+ (9.04)</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>ubuntu-karmic</emphasis> for Ubuntu Karmic Koala \r
+ (9.10)</para>\r
+ </listitem>\r
+ </itemizedlist>\r
+ <screen>make -f src/extras/Makefile.install <emphasis>[distribution]</emphasis></screen>\r
+ <para>This will install a number of packages required by OpenSRF on your system, \r
+ including some Perl modules from CPAN<indexterm><primary>programming language</primary><secondary>Perl</secondary>\r
+ <tertiary>CPAN</tertiary>\r
+ </indexterm>. You can say <quote>no</quote> to the initial CPAN \r
+ configuration prompt to allow it to automatically configure itself to download \r
+ and install Perl modules from CPAN. The CPAN installer will ask you a number of \r
+ times whether it should install prerequisite modules - say <quote>yes</quote>.</para>\r
+ </step>\r
+ <step> \r
+ <para>As the opensrf user, configure and compile OpenSRF:</para> \r
+ <note>You can include the –enable-python and –enable-java configure options if \r
+ you want to include support for Python<indexterm><primary>programming language</primary><secondary>Python</secondary>\r
+ </indexterm> and Java<indexterm><primary>programming language</primary><secondary>Java</secondary>\r
+ </indexterm>, respectively.</note>\r
+ <screen>cd /home/opensrf/OpenSRF-1.2.2</screen>\r
+ <screen>./configure --prefix=/openils --sysconfdir=/openils/conf</screen>\r
+ <screen>make</screen>\r
+ \r
+ </step>\r
+ <step> \r
+ <para>As the root user, return to your OpenSRF build directory and install \r
+ OpenSRF:</para>\r
+ <screen>cd /home/opensrf/OpenSRF-1.2.2</screen>\r
+ <screen>make install</screen>\r
+ </step>\r
+ <step>\r
+ <para>As the root user, change the ownership of the installed files to the opensrf \r
+ user:</para>\r
+ <screen>chown -R opensrf:opensrf /openils</screen>\r
+ </step>\r
+ <step>\r
+ <para>Restart and Test OpenSRF</para>\r
+ <screen>osrf_ctl.sh -l -a start_all</screen>\r
+ <screen>/openils/bin/srfsh</screen>\r
+ <screen>srfsh# request opensrf.math add 2 2</screen>\r
+ <para>You should see output like:</para>\r
+ <screen>Received Data: 4</screen>\r
+ <screen></screen>\r
+ <screen>------------------------------------</screen>\r
+ <screen>Request Completed Successfully</screen>\r
+ <screen>Request Time in seconds: 0.007519</screen>\r
+ <screen>------------------------------------</screen>\r
+ <screen></screen>\r
+ <screen>srfsh#</screen> \r
+ <para>If test <emphasis>Completed Successfully</emphasis> move onto next section. \r
+ If not, refer to <link linkend="troubleshooting">troubleshooting</link> section \r
+ of this documentation.</para> \r
+ </step> \r
+ </procedure> \r
+ </simplesect>\r
+ <simplesect>\r
+ <title>Upgrade <application>Evergreen</application> to 1.6</title>\r
+ <procedure>\r
+ <step>\r
+ <para>As the <emphasis>opensrf</emphasis> user, download and extract Evergreen 1.6\r
+ </para>\r
+ <screen>wget http://open-ils.org/downloads/Evergreen-ILS-1.6.0.8.tar.gz</screen>\r
+ <screen>tar xzf Evergreen-ILS-1.6.0.8.tar.gz</screen>\r
+ <note><para>For the latest edition of Evergreen check the Evergreen download page at\r
+ <ulink url="http://www.open-ils.org/downloads.php" /> and adjust upgrading instructions accordingly.</para></note>\r
+ </step>\r
+ <step>\r
+ <para>As the <emphasis>root</emphasis> user, install the prerequisites:</para> \r
+ <screen>cd /home/opensrf/Evergreen-ILS-1.6.0.8</screen> \r
+ <para>On the next command, replace <emphasis>[distribution]</emphasis> with one of \r
+ these values for your distribution of Debian or Ubuntu:</para>\r
+ <itemizedlist>\r
+ <listitem>\r
+ <para><emphasis>debian-etch</emphasis> for Debian Etch (4.0)</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>debian-lenny</emphasis> for Debian Lenny (5.0)</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>ubuntu-hardy</emphasis> for Ubuntu Hardy Heron \r
+ (8.04)</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>ubuntu-intrepid</emphasis> for Ubuntu Intrepid Ibex \r
+ (8.10)</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>ubuntu-jaunty</emphasis> for Ubuntu Jaunty Jackalope \r
+ (9.04)</para>\r
+ </listitem>\r
+ <listitem>\r
+ <para><emphasis>ubuntu-karmic</emphasis> for Ubuntu Karmic Koala \r
+ (9.10)</para>\r
+ </listitem>\r
+ </itemizedlist>\r
+ <screen>make -f Open-ILS/src/extras/Makefile.install <emphasis>[distribution]</emphasis></screen>\r
+ </step>\r
+ <step>\r
+ <para>As the <emphasis>opensrf</emphasis> user, configure and compile \r
+ <application>Evergreen</application>:</para>\r
+ <screen>cd /home/opensrf/Evergreen-ILS-1.6.0.8</screen>\r
+ <screen>./configure --prefix=/openils --sysconfdir=/openils/conf</screen>\r
+ <screen>make</screen>\r
+ </step>\r
+ <step>\r
+ <para>As the <emphasis>root</emphasis> user, install \r
+ <application>Evergreen</application>:</para>\r
+ <screen>make STAFF_CLIENT_BUILD_ID=rel_1_6_0_8 install</screen>\r
+ </step>\r
+ <step>\r
+ <para>Change to the <application>Evergreen</application> installation \r
+ directory:</para>\r
+ <screen>cd /home/opensrf/Evergreen-ILS-1.6.0.8</screen>\r
+ </step>\r
+ <step>\r
+ <para>As the <emphasis>root</emphasis> user, change all files to be owned by the \r
+ <emphasis>opensrf</emphasis> user and group:</para>\r
+ <screen>chown -R opensrf:opensrf /openils</screen>\r
+ </step> \r
+ <step>\r
+ <para>As the <emphasis>root</emphasis> user, build live-db-setup.pl for the cgi-bin \r
+ bootstrapping scripts and offline-config.pl for the offline staff client data \r
+ uploader:</para>\r
+ <screen>cd /home/opensrf/Evergreen-ILS-1.6.0.8</screen> \r
+ <screen>perl Open-ILS/src/support-scripts/eg_db_config.pl --create-bootstrap --create-offline --user evergreen \</screen>\r
+ <screen>--password evergreen --hostname localhost --port 5432 --database evergreen</screen>\r
+ </step>\r
+ <step>\r
+ <para>As the opensrf user, update server symlink in <filename class="directory">/openils/var/web/xul/</filename>:</para>\r
+ <screen>cd /openils/var/web/xul/</screen>\r
+ <screen>rm server</screen>\r
+ <screen>ln -s rel_1_6_0_8/server</screen>\r
+ </step>\r
+ \r
+ <step>\r
+ <para>Update the Evergreen database:</para>\r
+ <note><para>it is recommended that you <link linkend="backingup">back up your Evergreen database</link> in order to restore your data if anything goes wrong.</para></note>\r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.4.0.5-1.6.0.0-upgrade-db.sql evergreen</screen> \r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.0-1.6.0.1-upgrade-db.sql evergreen</screen> \r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.1-1.6.0.2-upgrade-db.sql evergreen</screen> \r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.2-1.6.0.3-upgrade-db.sql evergreen</screen> \r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.3-1.6.0.4-upgrade-db.sql evergreen</screen> \r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.4-1.6.0.5-upgrade-db.sql evergreen</screen> \r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.5-1.6.0.6-upgrade-db.sql evergreen</screen> \r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.6-1.6.0.7-upgrade-db.sql evergreen</screen> \r
+ <screen>psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.7-1.6.0.8-upgrade-db.sql evergreen</screen> \r
+ <para>Download and run the the billing view hot-fix script</para> \r
+ <screen>wget http://www.open-ils.org/downloads/1.6.0-mmbxs-cleanup.sql</screen>\r
+ <screen>psql -U evergreen -h localhost -f 1.6.0-mmbxs-cleanup.sql</screen> \r
+ </step>\r
+ <step>\r
+ <para>As the <emphasis>opensrf</emphasis> user, \r
+ copy /openils/conf/oils_web.xml.example to /openils/conf/oils_web.xml \r
+ (needed for acquisitions templates).</para>\r
+ <screen>cp /openils/conf/oils_web.xml.example /openils/conf/oils_web.xml</screen>\r
+ </step>\r
+ <step>\r
+ <para>Update opensrf_core.xml and opensrf.xml by copying the new example files (/\r
+ openils/conf/opensrf_core.xml.example and /openils/conf/opensrf.xml).</para>\r
+ <screen>cp /openils/conf/opensrf_core.xml.example /openils/conf/opensrf_core.xml</screen>\r
+ <screen>cp /openils/conf/opensrf.xml.example /openils/conf/opensrf.xml</screen>\r
+ </step>\r
+ <step>\r
+ <para>Update opensrf.xml with the database connection info:</para>\r
+ <screen>perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config --service all --user evergreen \</screen>\r
+ <screen>--password evergreen --hostname localhost --port 5432 --database evergreen</screen>\r
+ </step>\r
+ <step>\r
+ <para>Update /etc/apache2/startup.pl by copying the example from \r
+ Open-ILS/examples/apache/startup.pl.</para>\r
+ </step>\r
+ <step>\r
+ <para>Update /etc/apache2/eg_vhost.conf by copying the example from \r
+ Open-ILS/examples/apache/eg_vhost.conf.</para>\r
+ </step>\r
+ <step>\r
+ <para>Update /etc/apache2/sites-available/eg.conf by copying the example from Open-ILS/\r
+ examples/apache/eg.conf.</para>\r
+ </step>\r
+ <step>\r
+ <para>Recover customizations you have made to the <application>Apache</application><indexterm><primary>Apache</primary></indexterm> \r
+ configuration files. For example, if you purchased an SSL certificate<indexterm><primary>SSL certificate</primary></indexterm>, you \r
+ will need to edit eg.conf to point to the appropriate SSL certificate files.</para>\r
+ </step> \r
+ </procedure> \r
+ </simplesect>\r
+ <simplesect>\r
+ <para>Restart Evergreen and Test</para>\r
+ <procedure>\r
+ <step>\r
+ <para>As the <emphasis>opensrf</emphasis> user, start all \r
+ <application>Evergreen</application> and <application>OpenSRF</application> \r
+ services:</para>\r
+ <screen>osrf_ctl.sh -l -a start_all</screen>\r
+ </step>\r
+ <step>\r
+ <para>As the <emphasis>opensrf</emphasis> user, run autogen to refresh the static \r
+ organizational data files:</para>\r
+ <screen>cd /openils/bin</screen>\r
+ <screen>./autogen.sh -c /openils/conf/opensrf_core.xml -u</screen>\r
+ \r
+ </step>\r
+ <step>\r
+ <para>Start srfsh and try logging in using your <application>Evergreen</application>\r
+ username and password:</para>\r
+ <screen>/openils/bin/srfsh</screen> \r
+ <screen>srfsh% login <emphasis>username password</emphasis></screen> \r
+ </step> \r
+ <step>\r
+ <para>Start the <application>Apache</application> web server.</para>\r
+ </step>\r
+ </procedure>\r
+ </simplesect>\r
+ <note>\r
+ <para>If you encounter errors, refer to the <link linkend="troubleshooting">troubleshooting \r
+ section</link> of this documentation for tips \r
+ on finding solutions and seeking further assistance from the Evergreen community.</para> \r
+ </note>\r
+</chapter>\r
minimum: </para>\r
<itemizedlist>\r
<listitem><para>Windows (XP, Vista, or 7), Mac OS X, or Linux operating system</para></listitem>\r
- <listitem><para>a reliable high speed internet connection</para></listitem>\r
+ <listitem><para>a reliable high speed Internet connection</para></listitem>\r
<listitem><para>512Mb of RAM</para></listitem>\r
</itemizedlist>\r
<simplesect>\r
</menuchoice>\r
</para>\r
<procedure>\r
- <title>Adding Organization Types</title>\r
+ <title>Adding Organization Types<indexterm><primary>organization types</primary><secondary>adding</secondary></indexterm></title>\r
<step><para>Select an organization type from the organization type tree on the left and \r
click <guibutton>New Child</guibutton>.</para></step>\r
<step><para>Make sure your new type is selected and edit the <guilabel>Type Name</guilabel>, \r
<guilabel>OPAC Label</guilabel> and <guilabel>Parent Type</guilabel>.</para></step>\r
<step><para>Change the <guilabel>Parent Type</guilabel> if necessary.</para></step>\r
- <step><para>Check the <guilabel>Can Have Volumes and Copies</guilabel> checkbox if the \r
+ <step><para>Check the <guilabel>Can Have Volumes and Copies</guilabel> check box if the \r
organization units of this type will have volumes and copies assigned to it.</para></step>\r
- <step><para>Check the <guilabel>Can Have Users</guilabel> checkbox if you will allow users \r
+ <step><para>Check the <guilabel>Can Have Users</guilabel> check box if you will allow users \r
to be have the organization units of this type as their home unit.</para></step>\r
<step><para>Click <guibutton>Save</guibutton> to save your new organization type.\r
</para></step> \r
</procedure>\r
<procedure>\r
- <title>Deleting Organization Types</title>\r
+ <title>Deleting Organization Types<indexterm><primary>organization types</primary><secondary>deleting</secondary></indexterm></title>\r
<step><para>Select the <emphasis>organization type</emphasis> from the <emphasis>Organization Type</emphasis> \r
tree.</para></step>\r
<step><para>Click <guibutton>Delete</guibutton>.</para></step>\r
</note>\r
</procedure>\r
<procedure>\r
- <title>Editing Organization Types</title>\r
+ <title>Editing Organization Types<indexterm><primary>organization types</primary><secondary>editing</secondary></indexterm></title>\r
<step><para>Select the <emphasis>organization type</emphasis> you wish to edit from the \r
organization type tree.</para></step>\r
<step><para>Make the changes in the right pane.</para></step>\r
</simplesect>\r
\r
<simplesect xml:id="orgunits">\r
- <title>Organizational Units</title>\r
+ <title>Organizational Units<indexterm><primary>organization units</primary></indexterm></title>\r
<abstract>\r
<para>Organizational Units are the specific instances of the organization unit types that \r
make up your library's hierarchy. These can include consortia, systems, branches, \r
- etc. The organizational units should have distictive proper names such as \r
+ etc. The organizational units should have distinctive proper names such as \r
<emphasis>Main Street Branch</emphasis> or <emphasis>Townsville Campus</emphasis>.</para>\r
</abstract>\r
- <para>To navigate to the organizational units adminstration page in the staff client select \r
+ <para>To navigate to the organizational units administration page in the staff client select \r
<menuchoice>\r
<guimenu>Admin</guimenu> \r
<guisubmenu>Server Administration</guisubmenu>\r
</menuchoice>\r
</para>\r
<procedure>\r
- <title>Adding Organizational Units</title>\r
+ <title>Adding Organizational Units<indexterm><primary>organization units</primary><secondary>adding</secondary></indexterm></title>\r
<step><para>Select an <emphasis>Organizational Unit</emphasis> from the organizational unit tree on the left and click \r
<guibutton>New Child</guibutton>.</para></step>\r
<step><para>Make sure your new unit is selected and edit the <guilabel>Organizational Unit \r
</step>\r
<step><para>Select the <guilabel>Organization Unit Type</guilabel> and \r
<guilabel>Parent Organization Unit</guilabel>.</para></step>\r
- <step><para>Check the <guilabel>Can Have Volumes and Copies</guilabel> checkbox if the \r
- organization units of this type will have volumes and copies assigned to it.</para></step>\r
- <step><para>Check the <guilabel>OPAC Visible</guilabel> checkbox if you want this location to be \r
- visible in the OPAC for searching.</para></step>\r
+ <step><para>Check the <guilabel>Can Have Volumes and Copies</guilabel> check box if the \r
+ organization units of this type will have volumes and copies assigned to it.<indexterm><primary>organization units</primary><secondary>volumes and copies</secondary></indexterm></para></step>\r
+ <step><para>Check the <guilabel>OPAC Visible</guilabel> check box if you want this location to be \r
+ visible in the OPAC for searching.<indexterm><primary>Organization Units</primary><secondary>opac visible</secondary></indexterm></para></step>\r
<step><para>Click <guibutton>Save</guibutton> to save your new organizational unit.</para></step> \r
</procedure>\r
<procedure>\r
- <title>Deleting Organizational Units</title>\r
- <step><para>Select the <emphasis>organizational unit</emphasis> you wish to delete from the organzational unit tree in the left pane.</para></step>\r
+ <title>Deleting Organizational Units <indexterm><primary>organization units</primary><secondary>deleting</secondary></indexterm></title>\r
+ <step><para>Select the <emphasis>organizational unit</emphasis> you wish to delete from the organizational unit tree in the left pane.</para></step>\r
<step><para>Click<guibutton>Delete</guibutton>.</para></step>\r
<step><para>Click <guibutton>OK</guibutton> on the warning alert box.</para></step>\r
<note>\r
</note>\r
</procedure>\r
<procedure>\r
- <title>Editing Organizational Units</title>\r
+ <title>Editing Organizational Units<indexterm><primary>organization units</primary><secondary>editing</secondary></indexterm></title>\r
<step><para>Select the organizational unit you wish to edit from the \r
organizational unit tree in the left pane.</para></step>\r
<step><para>Edit the fields in the right pane.</para></step>\r
</simplesect>\r
<simplesect xml:id="server-hours">\r
<info>\r
- <title>Library Hours of Operation</title>\r
+ <title>Library Hours of Operation<indexterm><primary>hours of operation</primary><secondary>setting</secondary></indexterm></title>\r
</info>\r
\r
<para>Local System Administrators can use the <guilabel>Organizational Units</guilabel> interface to set the library's hours of operation. These are regular weekly hours;\r
<itemizedlist>\r
<listitem>\r
<formalpara>\r
- <title>Due dates</title>\r
+ <title>Due dates<indexterm><primary>hours of operation</primary><secondary>due dates policy</secondary></indexterm></title>\r
<para>Due dates that would fall on closed days are automatically pushed forward to\r
the next open day. Likewise, if an item is checked out at 8pm, for example, and\r
would normally be due on a day when the library closes before 8pm, Evergreen\r
</listitem>\r
<listitem>\r
<formalpara>\r
- <title>Overdue fines</title>\r
+ <title>Overdue fines <indexterm><primary>hours of operation</primary><secondary>overdue fines policy</secondary></indexterm></title>\r
<para>Overdue fines are not charged on days when the library is closed.</para>\r
</formalpara>\r
</listitem>\r
\r
<simplesect xml:id="server-addresses">\r
<info>\r
- <title>Library Addresses</title>\r
+ <title>Library Addresses <indexterm><primary>library addresses </primary><secondary>setting</secondary></indexterm></title>\r
</info>\r
\r
<para>Addresses set in <menuchoice>\r
<guisubmenu>Server Administrations</guisubmenu>\r
<guimenuitem>Organizational Units</guimenuitem>\r
</menuchoice> appear in patron email notifications, hold slips, and transit slips. Local\r
- System Adminstrators should ensure that the <guilabel>Physical</guilabel>,\r
+ System Administrators should ensure that the <guilabel>Physical</guilabel>,\r
<guilabel>Holds</guilabel>, and <guilabel>Mailing</guilabel> addresses are set\r
correctly.</para>\r
\r
\r
<step>\r
<para>Open the <guilabel>Organizational Units</guilabel> interface as described in the <link\r
- linkend="server-main">previous simplesect</link>.</para>\r
+ linkend="server-main">previous section</link>.</para>\r
</step>\r
<step>\r
<informalfigure>\r
\r
<para>There are four address tabs: <guilabel>Physical</guilabel>,\r
<guilabel>Holds</guilabel>, <guilabel>Mailing</guilabel>, and\r
- <guilabel>ILL</guilabel>. Sitka Support recommends setting the first three at a\r
- minimum. The <guilabel>Holds Address</guilabel> appears on transit slips when items are sent to fulfill holds at another branch.</para>\r
+ <guilabel>ILL</guilabel>. The <guilabel>Holds Address</guilabel> appears on transit slips when items are sent to fulfill holds at another branch.</para>\r
\r
\r
</step>\r
</procedure>\r
\r
<note>\r
- <para>The <guilabel>Valid</guilabel> checkbox is an optional setting that does not affect\r
- current Evergreen functions, but the Sitka Support team recommends checking it for all\r
- correct addresses.</para>\r
+ <para>The <guilabel>Valid</guilabel> check box is an optional setting that does not affect current Evergreen functions.</para>\r
</note>\r
\r
</simplesect>\r
<title>Adjusting Search Relevancy Rankings</title>\r
<info>\r
<abstract>\r
- <para>This simplesect describes indexed field weighting and matchpoint weighting, which\r
- control relevance ranking in Evergreen catalog search results. Adjusting relavancy can only be completed through access to the Evergreen database as of version 1.6.</para>\r
+ <para>This section describes indexed field weighting and matchpoint weighting, which\r
+ control relevance ranking in Evergreen catalog search results. Adjusting relevancy can only be completed through access to the Evergreen database as of version 1.6.</para>\r
<tip>\r
<para>In tuning search relevance, it is good practice to make incremental\r
adjustments, capture search logs, and assess results before making further\r
</abstract>\r
</info>\r
<simplesect>\r
- <title>Indexed-field Weighting</title>\r
+ <title>Indexed-field Weighting<indexterm><primary>relevancy</primary><secondary>indexed-field weighting</secondary></indexterm> </title>\r
<para>Indexed-field weighting is configured in the Evergreen database in the weight column\r
of the config.metabib_field table, which follows the other four columns in this table:\r
field_class, name, xpath, and format.</para>\r
<emphasis role="bold">jaguar</emphasis> in another indexed field. </para>\r
</simplesect>\r
<simplesect>\r
- <title>Matchpoint Weighting</title>\r
- <para> Matchpoint weighting provides another way to fine-tune Evergreen relevance ranking,\r
+ <title>Match point Weighting<indexterm><primary>relevancy</primary><secondary>match point weighting</secondary></indexterm></title>\r
+ <para> Match point weighting provides another way to fine-tune Evergreen relevance ranking,\r
and is configured through floating-point multipliers in the multiplier column of the\r
search.relevance_adjustment table.</para>\r
<para> Weighting can be adjusted for one, more, or all multiplier fields in\r
<para>You can adjust the following three matchpoints:</para> \r
<itemizedlist>\r
<listitem>\r
- <para><indexterm><primary>first_word</primary></indexterm> boosts relevance if the query is \r
+ <para>first_wordboosts relevance if the query is \r
one term long and matches the first term in the indexed field (search for <emphasis \r
role="bold">twain</emphasis>, get a bonus for <emphasis role="bold">twain, mark</emphasis> \r
but not <emphasis role="bold">mark twain</emphasis>)</para>\r
</listitem>\r
<listitem>\r
- <para><indexterm><primary>word_order</primary></indexterm> increases relevance for words \r
+ <para>word_order increases relevance for words \r
matching the order of search terms, so that the results for the search <emphasis \r
role="bold">legend suicide</emphasis> would match higher for the book <emphasis \r
role="italic">Legend of a Suicide</emphasis> than for the book, \r
<emphasis role="italic">Suicide Legend</emphasis></para>\r
</listitem>\r
<listitem>\r
- <para><indexterm><primary>full_match</primary></indexterm> boosts relevance when the full \r
+ <para>full_match boosts relevance when the full \r
query exactly matches the entire indexed field (after space, case, and diacritics are \r
normalized). So a title search for <emphasis role="italic">The Future of Ice</emphasis> \r
would get a relevance boost above <emphasis role="italic">Ice>Ages of the \r
</table>\r
</simplesect>\r
<simplesect>\r
- <title>Combining Index Weighting and Matchpoint Weighting</title>\r
+ <title>Combining Index Weighting and Match point Weighting</title>\r
<para>Index weighting and matchpoint weighting may be combined. The relevance boost of the combined \r
weighting is equal to the product of the two multiplied values. </para>\r
<para>If the relevance setting in the config.metabib_field were increased to 2, and the multiplier \r
</note>\r
</simplesect>\r
<simplesect>\r
- <title>Adjusting Relevancy for Keyword Searches</title>\r
+ <title>Adjusting Relevancy for Keyword Searches<indexterm><primary>relevancy</primary><secondary>keyword searches</secondary></indexterm></title>\r
<para> Searching the out of the box <emphasis>keyword</emphasis> does not boost the ranking for terms appearing in, the title or subject fields since there is just one \r
keyword index which does not distinguish terms that appear in the title field from those in the notes field for example. In comparison, the title index is actually composed of \r
a number of separate indexes: title|proper, title|uniform, title|alternative, title|translated, etc, that collectively form the title index. You can see this in the \r
other fields. </para>\r
<procedure>\r
<step>\r
- <para>From the command line, access the PorstgreSQL command line interface</para>\r
+ <para>From the command line, access the PostgreSQL command line interface</para>\r
<screen>psql -U evergreen</screen>\r
</step> \r
<step>\r
</procedure> \r
</simplesect> \r
</section>\r
- <section xml:id="grouppermissions">\r
- <title>User and Group Permissions</title>\r
+ <section xml:id="permissions">\r
+ <title>User and Group Permissions <indexterm><primary>permissions</primary><secondary>group</secondary></indexterm></title>\r
<abstract>\r
<para>It is essential to understand how user and group permissions can be used to allow staff \r
- to fulfil their roles while ensuring that they only have access to the appropriate level.</para> \r
+ to fulfill their roles while ensuring that they only have access to the appropriate level.</para> \r
<para>Permissions in <application>Evergreen</application> are applied to a specific location and system depth based on the home \r
library of the user. The user will only have that permission within the scope provided by the \r
<emphasis>Depth</emphasis> field in relation to his/her working locations.</para> \r
</abstract>\r
<simplesect>\r
<title>User Permissions</title>\r
- <tip><para>Ihe User permissions editor allows an administrator to set up permission fopr an individual user. However, In most cases, permissions can be controlled more \r
+ <tip><para>The User permissions editor allows an administrator to set up permission for an individual user. However, In most cases, permissions can be controlled more \r
efficiently at the group level with individuals being assigned to specific groups based on their roles in the library.</para></tip> \r
<para>To open the user permission editor, select <menuchoice><guimenu>Admin</guimenu> \r
<guisubmenu>User Permission Editor</guisubmenu></menuchoice>. Type the user's barcode when prompted.</para> \r
<simplesect>\r
<title>Working Locations</title>\r
- <para>The first simplesect of the User Permission Editor is the the Working Locations \r
- simplesect. You may select more than one working location for a user. This will effect \r
+ <para>You may select more than one working location for a user. This will effect \r
the availability of certain permissions which are dependent on the user having the working location.</para> \r
</simplesect>\r
<simplesect>\r
- <title>User Permission Settings</title>\r
+ <title>User Permission Settings<indexterm><primary>permissions</primary><secondary>user</secondary></indexterm></title>\r
<para>Below the working locations is the long list of all the permissions available on your \r
system. For each permission you can apply it by checking the \r
<emphasis>Applied</emphasis> check box. You can also select a depth to which the \r
</simplesect> \r
</simplesect>\r
<simplesect>\r
- <title>Group Permissions</title>\r
+ <title>Group Permissions <indexterm><primary>permissions</primary><secondary>group</secondary></indexterm></title>\r
<para>Most permissions should be assigned at the group level. Here you can create new \r
groups based on the roles and responsibilities of the users in your system. Staff will be able to \r
assign users to these groups when they register patrons.</para> \r
<tip><para>It is a good idea to create your groups soon after creating your organizational units.\r
- It is also imprtaant to give careful consideration to the hierarchy of your groups to make \r
+ It is also important to give careful consideration to the hierarchy of your groups to make \r
permission assignment as efficient as possible.</para></tip> \r
<para>To enter the <emphasis>Group Permission</emphasis> module from the staff client menu, select \r
<menuchoice><guimenu>Admin</guimenu> <guisubmenu>Server Administration</guisubmenu> \r
their groups</para></step>\r
<step><para>Selecting an <guilabel>Editing Permission</guilabel> will determine the group level the user will have for editing other users.</para></step>\r
<step><para>Select the <guilabel>Parent Group</guilabel> for the group.</para>\r
- <note><para>The group will inherit its parent group's permissions so it is unecessary to assign permissions already inherited from its parent.</para></note></step>\r
+ <note><para>The group will inherit its parent group's permissions so it is unnecessary to assign permissions already inherited from its parent.</para></note></step>\r
<step><para>Click the <guibutton>Save</guibutton> button.</para></step> \r
</procedure>\r
<procedure>\r
</thead>\r
<tbody>\r
<row>\r
- <entry>ABORT_REMOTE_TRANIST</entry>\r
+ <entry>ABORT_REMOTE_TRANSIT</entry>\r
<entry>Allows user to abort a copy transit if the user is not at \r
the transit source or destination</entry>\r
</row>\r
</row>\r
<row>\r
<entry>COPY_BAD_STATUS.override</entry>\r
- <entry>Allows user to check out an item in a non-circulatable \r
+ <entry>Allows user to check out an item in a non-circulating\r
status</entry>\r
</row>\r
<row>\r
</row>\r
<row>\r
<entry>CREATE_COPY_STAT_CAT</entry>\r
- <entry>Allows user to create a statisitcal category for \r
+ <entry>Allows user to create a statistical category for \r
copies</entry>\r
</row>\r
<row>\r
</row>\r
<row>\r
<entry>EVERYTHING</entry>\r
- <entry> Every permssion is granted (for sysadmins and developers \r
+ <entry> Every permission is granted (for sysadmins and developers \r
only!)</entry>\r
</row>\r
<row>\r
</row>\r
<row>\r
<entry>MAX_RENEWALS_REACHED.override</entry>\r
- <entry>Allows user to renew an item past the maximun renewal \r
+ <entry>Allows user to renew an item past the maximum renewal \r
count</entry>\r
</row>\r
<row>\r
<row>\r
<entry>UPDATE_HOLD</entry>\r
<entry>Allows user to edit holds (such as change notification phone \r
- number or pickup library, as well as retarget the hold and capture \r
+ number or pickup library, as well as re-target the hold and capture \r
an item for hold or pickup)</entry>\r
</row>\r
<row>\r
<section>\r
<info>\r
\r
- <title>Staff Accounts</title>\r
+ <title>Staff Accounts <indexterm><primary>staff accounts</primary></indexterm></title>\r
</info>\r
\r
<informalfigure>\r
Group</guilabel> drop-down menu. </para>\r
<para>\r
<mediaobject>\r
- <alt>User permissions screenshot</alt>\r
+ <alt>User permissions screen shot</alt>\r
<imageobject>\r
<imagedata scalefit="0" fileref="../media/profile-2.png"/>\r
</imageobject>\r
\r
\r
<para xml:id="profiles-working">Each new staff account must be assigned a <guilabel>Working\r
- Location</guilabel> which determines its access level in staff client interfaces.\r
+ Location</guilabel><indexterm><primary>staff accounts</primary><secondary>working location</secondary></indexterm> which determines its access level in staff client interfaces.\r
Accounts migrated from legacy systems or created before the upgrade to Evergreen 1.6 already\r
have working locations assigned.</para>\r
\r
</menuchoice></para>\r
<para>\r
<mediaobject>\r
- <alt>User permissions screenshot</alt>\r
+ <alt>User permissions screen shot</alt>\r
<imageobject>\r
<imagedata scalefit="0" fileref="../media/profile-1.png"/>\r
</imageobject>\r
\r
<simplesect xml:id="staff_account_permissions">\r
<info>\r
- <title>Staff Account Permissions</title>\r
+ <title>Staff Account Permissions <indexterm><primary>staff accounts</primary><secondary>permissions</secondary></indexterm> </title>\r
</info>\r
<para>Below is a general outline of staff account permission levels. To view a detailed list\r
of permissions for a particular Evergreen account go to <menuchoice>\r
available to any staff account, including LSAs.</para>\r
<para>\r
<mediaobject>\r
- <alt>User permissions screenshot</alt>\r
+ <alt>User permissions screen shot</alt>\r
<imageobject>\r
<imagedata scalefit="0" fileref="../media/profile-5.png"/>\r
</imageobject>\r
<imageobject>\r
<imagedata scalefit="0" fileref="../media/1.png"/>\r
</imageobject>\r
- </inlinemediaobject> List of permission names. For help correlating permissions to specific Evergreen\r
- functions please contact Sitka support.</para>\r
+ </inlinemediaobject> List of permission names.</para>\r
\r
<para>\r
<inlinemediaobject>\r
<imageobject>\r
<imagedata scalefit="0" fileref="../media/3.png"/>\r
</imageobject>\r
- </inlinemediaobject> <guilabel>Depth</guilabel> limits application to the staff member's library and should be left at the default. Evergreen blocks attempts to set Federation- or Sitka-wide privileges.</para>\r
+ </inlinemediaobject> <guilabel>Depth</guilabel> limits application to the staff member's library and should be left at the default.</para>\r
\r
<para>\r
<inlinemediaobject>\r
<para>To allow processing of offline transactions check the <emphasis>Applied</emphasis> column next to OFFLINE_EXECUTE.</para>\r
<para>\r
<mediaobject>\r
- <alt>User permissions screenshot</alt>\r
+ <alt>User permissions screen shot</alt>\r
<imageobject>\r
<imagedata scalefit="0" fileref="../media/profile-6.png"/>\r
</imageobject>\r
<para>Scroll down and click <guibutton>Save</guibutton> to apply the changes.</para>\r
<para>\r
<mediaobject>\r
- <alt>User permissions screenshot</alt>\r
+ <alt>User permissions screen shot</alt>\r
<imageobject>\r
<imagedata scalefit="0" fileref="../media/profile-7.png"/>\r
</imageobject>\r
<step><para>Click <guibutton>Add</guibutton>.</para></step>\r
<step><para>Locate you new status and check the <emphasis>Holdable</emphasis> check box \r
if you wish to all users to place holds on items in this status. Check \r
- <emphasis>OPAC Visble</emphasis> if you wish for this status to appear in the public \r
+ <emphasis>OPAC Visible</emphasis> if you wish for this status to appear in the public \r
OPAC.</para></step>\r
- <step><para>Click <guibutton>Save Changes</guibutton> at the bottum of the screen to \r
+ <step><para>Click <guibutton>Save Changes</guibutton> at the bottom of the screen to \r
save changes to the new status.</para></step>\r
</procedure>\r
<procedure>\r
</procedure>\r
<procedure>\r
<title>Deleting Billing Types</title>\r
- <step><para>Check the checkbox of the billing type(s) you wish to delete.</para></step>\r
+ <step><para>Check the check box of the billing type(s) you wish to delete.</para></step>\r
<step><para>Click <guibutton>Delete Selected</guibutton>.\r
<caution><para>The selected billing types will be deleted without a \r
verification alert.</para></caution>\r
<step><para>Enter a <emphasis>Code</emphasis>, <emphasis>Name</emphasis> and \r
<emphasis>Description</emphasis>.</para></step>\r
<step><para>Select the <emphasis>SIP 2 Media Type</emphasis>.</para></step>\r
- <step><para>Check the <guibutton>Magnetic Media</guibutton> check box if the item is magnetic media such as a casette \r
+ <step><para>Check the <guibutton>Magnetic Media</guibutton> check box if the item is magnetic media such as a cassette \r
tape.</para></step>\r
<step><para>Click <guibutton>Save</guibutton> to save the new circulation \r
modifier.</para></step>\r
</procedure>\r
<procedure>\r
<title>Editing Circulation Modifiers</title>\r
- <step><para>Double click on the row of the cirlation modifier you wish to \r
+ <step><para>Double click on the row of the circulation modifier you wish to \r
edit.</para></step> \r
<step><para>Make desired changes.</para></step>\r
<step><para>Once you have finished editing, click \r
</section>\r
<section xml:id="catalogingtemplates">\r
<title>Cataloging Templates</title>\r
- <para>Cataloging templates are essential for making the cataloguing process more efficient. Templates are used that that the basic structure of specific types of cataloguing records can loaded when the cataloguer adds a new record</para>\r
+ <para>Cataloging templates are essential for making the cataloging process more efficient. Templates are used that that the basic structure of specific types of cataloging records can loaded when the cataloger adds a new record</para>\r
<procedure>\r
<title>Adding Cataloging Templates</title>\r
<step>\r
\r
</step>\r
<step>\r
- <para>Add the template to the to the <emphasis>marctemplates</emphasis> list in the open-ils.cat simplesect of the evergreen configuration file <filename>opensrf.xml</filename> </para>\r
+ <para>Add the template to the to the <emphasis>marctemplates</emphasis> list in the open-ils.cat section of the evergreen configuration file <filename>opensrf.xml</filename> </para>\r
</step>\r
<step>\r
<para>Restart perl services for changes to take effect.</para>\r
-<?xml version="1.0" encoding="utf-8"?>
-<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
-xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="troubleshooting">
- <title>Troubleshooting System Errors</title>
- <para>If you have Evergreen installed and are encountering systematic errors, here is the steps to find the
- cause and solution to most problems. These instructions assume standard locations and file names for Evergreen
- installations, and may also include commands for specific Linux distributions.</para>
- <procedure>
- <title>Systematic Evergreen Restart to isolate Errors</title>
- <step>
- <para>Stop Apache:</para>
- <screen>/etc/init.d/apache2 stop</screen>
- <para>or</para>
- <screen>apache2ctl stop</screen>
- </step>
- <step>
- <para>Stop OpenSRF:</para>
- <screen>osrf_ctl.sh -l -a stop_all</screen>
- <para>You should get either output resembling this:</para>
- <screen>Stopping OpenSRF C process 12515...</screen>
- <screen>Stopping OpenSRF C process 12520...</screen>
- <screen>Stopping OpenSRF C process 12526...</screen>
- <screen>Stopping OpenSRF Perl process 12471...</screen>
- <screen>Stopping OpenSRF Router process 12466...</screen>
- <para>Or, if services have already been stopped, output maay look like this:</para>
- <screen>OpenSRF C not running</screen>
- <screen>OpenSRF Perl not running</screen>
- <screen>OpenSRF Router not running</screen>
- <para>Occasionally osrf_ctl.sh fails to kill OpenSRF processes, so we should check to make
- sure that none are still running with the command:</para>
- <screen>ps -aef | grep OpenSRF</screen>
- <para>You should manually kill any OpenSRF processes.</para>
- <para>If you were unable to stop OpenSRF with the above methods, you could also try this
- command:</para>
- <screen>rm –R /openils/var/run/*.pid</screen>
- <para>This will remove the temporary OpenSRF process files from the run directory which may
- have been left over from a previous system boot cycle.</para>
- </step>
- <step>
- <para>Restart Ejabberd and Memcached with the following commands:</para>
- <screen>sudo /etc/init.d/ejabberd restart</screen>
- <screen>sudo /etc/init.d/memcached restart</screen>
- </step>
- <step>
- <para>Start the OpenSRF router and check for errors</para>
- <screen>/openils/bin/osrf_ctl.sh -l -a start_router</screen>
- <para>If the router started correctly, output will be:</para>
- <screen>Starting OpenSRF Router</screen>
- <para>If router does not start correcltly, you should check the router error log files
- for error information.</para>
- <para>Evergreen 1.6 uses two routers, a public one and a private one, with two different
- logfiles:</para>
- <para><filename >/openils/var/log/private.router.log</filename></para>
- <para><filename >/openils/var/log/public.router.log</filename></para>
- <para>A quick way to find error information in the logs is with the grep command.</para>
- <screen>grep ERR /openils/var/log/*router.log</screen>
- <para>As a final sanity check, look for router processes using the process status
- command:</para>
- <screen>ps -aef | grep Router</screen>
- </step>
- <step>
- <para>Start the OpenSRF perl services and check for errors</para>
- <screen>/openils/bin/osrf_ctl.sh -l -a start_perl</screen>
- <para>You should see the following output:</para>
- <screen>Starting OpenSRF Perl</screen>
- <screen>* starting all services for norcrossfx.norcross.esi</screen>
- <screen>* starting servivce pid=7484 opensrf.settings</screen>
- <screen>* starting servivce pid=7493 open-ils.cat</screen>
- <screen>* starting servivce pid=7495 open-ils.supercat</screen>
- <screen>* starting servivce pid=7497 open-ils.search</screen>
- <screen>* starting servivce pid=7499 open-ils.circ</screen>
- <screen>* starting servivce pid=7501 open-ils.actor</screen>
- <screen>* starting servivce pid=7502 open-ils.storage</screen>
- <screen>* starting servivce pid=7509 open-ils.penalty</screen>
- <screen>* starting servivce pid=7512 open-ils.collections</screen>
- <screen>* starting servivce pid=7514 open-ils.ingest</screen>
- <screen>* starting servivce pid=7517 open-ils.permacrud</screen>
- <screen>* starting servivce pid=7522 open-ils.fielder</screen>
- <screen>* starting servivce pid=7527 open-ils.vandelay</screen>
- <screen>* starting servivce pid=7516 open-ils.reporter</screen>
- <para>If the perl services do not start correclty or you receive errors, search for errors
- in the following log files:</para>
- <screen>/openils/var/log/router.log</screen>
- <screen>/openils/var/log/osrfsys.log</screen>
- <para>At this point you can use the <command>grep</command> command to find errors in
- any of the Evrgreen log files:</para>
- <screen>grep ERR /openils/var/log/*.log</screen>
- <para>As a final sanity check, look for OpenSRF processes:</para>
- <screen>ps -aef | grep -i opensrf</screen>
- </step>
- <step>
- <para>Start the OpenSRF C services and check for errors:</para>
- <screen>/openils/bin/osrf_ctl.sh -l -a start_c</screen>
- <para>And output should be:</para>
- <para>Starting OpenSRF C (host=localhost)</para>
- <para>If the <emphasis>c</emphasis> service does not start, check for errors by grepping
- the log files for errors:</para>
- <screen>grep ERR /openils/var/log/*.log</screen>
- <para>Check for OpenSRF processes:</para>
- <screen>ps -aef | grep -i opensrf</screen>
- </step>
- <step>
- <para>Smoke test with autogen.sh</para>
- <para>The Autogen tool will take some dynamic information from the database and generate
- static Javascript files for use by the OPAC and staff client. It is also able to refresh
- the proximity map between libraries for the purpose of efficiently routing hold
- requests.</para>
- <para>As user opensrf, you invoke Autogen with the command:</para>
- <screen>/openils/bin/autogen.sh -c /openils/conf/opensrf_core.xml -u</screen>
- <para>If Autogen completes successfully, the output will be:</para>
- <screen>Updating fieldmapper</screen>
- <screen>Updating web_fieldmapper</screen>
- <screen>Updating OrgTree</screen>
- <screen>removing OrgTree from the cache...</screen>
- <screen>Updating OrgTree HTML</screen>
- <screen>Updating locales selection HTML</screen>
- <screen>Updating Search Groups</screen>
- <screen>Refreshing proximity of org units</screen>
- <screen>Successfully updated the organization proximity</screen>
- <screen>Done</screen>
- <para>If Autogen does not complete its task and you recieve errors, use
- <command>grep</command> to find errors in the log files:</para>
- <screen>grep ERR /openils/var/log/*.log</screen>
- </step>
- <step>
- <para>Connect to Evergreen using the srfsh command-line OpenSRF client</para>
- <screen>/openils/bin/srfsh</screen>
- <note>
- <para>In order for you to connect using <command>srfsh</command>, you will need to
- have set up the .srfsh.xml configuration file in your home directory as as
- described in the installation chapter.</para>
- </note>
- <para>You will then see the <emphasis>srfsh</emphasis> prompt:</para>
- <screen>srfsh#</screen>
- <para>At the srfsh prompt, enter this command:</para>
- <screen>login admin open-ils</screen>
- <para>You should the request verification:</para>
- <screen>Received Data: "6f63ff5542da1fead4431c6c280efc75"</screen>
- <screen>------------------------------------</screen>
- <screen>Request Completed Successfully</screen>
- <screen>Request Time in seconds: 0.018414</screen>
- <screen>------------------------------------</screen>
- <screen></screen>
- <screen>Received Data: {</screen>
- <screen>"ilsevent":0,</screen>
- <screen>"textcode":"SUCCESS",</screen>
- <screen>"desc":" ",</screen>
- <screen>"pid":7793,</screen>
- <screen>"stacktrace":"oils_auth.c:312",</screen>
- <screen>"payload":{</screen>
- <screen>"authtoken":"28804ebf99508496e2a4d2593aaa930e",</screen>
- <screen> "authtime":420.000000</screen>
- <screen>}</screen>
- <screen>}</screen>
- <screen></screen>
- <screen>------------------------------------</screen>
- <screen>Request Completed Successfully</screen>
- <screen> Request Time in seconds: 0.552430</screen>
- <screen>------------------------------------</screen>
- <screen> Login Session: 28804. Session timeout: 420.000</screen>
- <screen>srfsh#</screen>
- <para>If you encounter errors or if you are unable to connect, you should consult the
- <filename>srfsh.log</filename> file. The location of this file is configured in your
- <filename>.srfsh.xml</filename> configuration file and is
- <filename>/openils/var/log/srfsh.log</filename> by default.</para>
- <para>Pressing
- <keycombo>
- <keycap>Ctrl</keycap>
- <keycap>D</keycap>
- </keycombo>
- or entering <quote>exit</quote> will terminate srfsh.</para>
- </step>
- <step>
- <para>Start <application>Apache</application> and check for errors:</para>
- <screen>/etc/init.d/apache2 start</screen>
- <para>or</para>
- <screen>apache2ctl start</screen>
- <para>You should see output:</para>
- <screen>* Starting web server apache2</screen>
- <screen>...done.</screen>
- <para>the Apache OpenSRF modules write to the
- <filename>/openils/var/log/gateway.log</filename></para>
- <para>However, you should check all of the log files for errors:</para>
- <screen>grep ERR /openils/var/log/*.log</screen>
- <para>Another place to check for erros is the <application>Apache</application> error logs
- generally located in in the <filename class="directory">/var/log/Apapche2</filename>
- directory</para>
- <para>If you encounter errors with Apache, a common source of potential problems are the
- Evergreen site configuration files <filename>/etc/apache2/eg_vhost.conf</filename> and
- <filename>/etc/apache2/sites-available/eg.conf</filename></para>
- </step>
- <step>
- <para>Try to authenticate with the staff client</para>
- </step>
- <step>
- <para>Try to authenticate with the OPAC</para>
- </step>
- </procedure>
-</chapter>
+<?xml version="1.0" encoding="utf-8"?>\r
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"\r
+xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="troubleshooting">\r
+ <title>Troubleshooting System Errors</title>\r
+ <para>If you have Evergreen installed and are encountering systematic errors, here is the steps to find the \r
+ cause and solution to most problems. These instructions assume standard locations and file names for Evergreen\r
+ installations, and may also include commands for specific Linux distributions.</para>\r
+ <procedure>\r
+ <title>Systematic Evergreen Restart to Isolate Errors</title>\r
+ <step>\r
+ <para>Stop Apache:</para>\r
+ <screen>/etc/init.d/apache2 stop</screen>\r
+ <para>or</para>\r
+ <screen>apache2ctl stop</screen>\r
+ </step>\r
+ <step>\r
+ <para>Stop OpenSRF:</para>\r
+ <screen>osrf_ctl.sh -l -a stop_all</screen>\r
+ <para>You should get either output simlar to this:</para>\r
+ <screen>Stopping OpenSRF C process 12515...</screen>\r
+ <screen>Stopping OpenSRF C process 12520...</screen>\r
+ <screen>Stopping OpenSRF C process 12526...</screen>\r
+ <screen>Stopping OpenSRF Perl process 12471...</screen>\r
+ <screen>Stopping OpenSRF Router process 12466...</screen>\r
+ <para>Or, if services have already been stopped, output may look like this:</para>\r
+ <screen>OpenSRF C not running</screen>\r
+ <screen>OpenSRF Perl not running</screen>\r
+ <screen>OpenSRF Router not running</screen>\r
+ <para>Occasionally osrf_ctl.sh fails to kill OpenSRF processes, so we should check to make \r
+ sure that none are still running with the command:</para>\r
+ <screen>ps -aef | grep OpenSRF</screen>\r
+ <para>You should manually kill any OpenSRF processes.</para>\r
+ <para>If you were unable to stop OpenSRF with the above methods, you could also try this \r
+ command:</para>\r
+ <screen>rm –R /openils/var/run/*.pid</screen>\r
+ <para>This will remove the temporary OpenSRF process files from the run directory which may \r
+ have been left over from a previous system boot cycle.</para>\r
+ </step>\r
+ <step>\r
+ <para>Restart Ejabberd and Memcached with the following commands:</para>\r
+ <screen>sudo /etc/init.d/ejabberd restart</screen>\r
+ <screen>sudo /etc/init.d/memcached restart</screen>\r
+ </step>\r
+ <step> \r
+ <para>Start the OpenSRF router and check for errors</para>\r
+ <screen>/openils/bin/osrf_ctl.sh -l -a start_router</screen>\r
+ <para>If the router started correctly, output will be:</para>\r
+ <screen>Starting OpenSRF Router</screen>\r
+ <para>If router does not start correctly, you should check the router error log files \r
+ for error information.</para>\r
+ <para>Evergreen 1.6 uses two routers, a public one and a private one, with two different \r
+ logfiles:</para>\r
+ <para><filename >/openils/var/log/private.router.log</filename></para>\r
+ <para><filename >/openils/var/log/public.router.log</filename></para>\r
+ <para>A quick way to find error information in the logs is with the grep command.</para>\r
+ <screen>grep ERR /openils/var/log/*router.log</screen>\r
+ <para>As a final sanity check, look for router processes using the process status \r
+ command:</para>\r
+ <screen>ps -aef | grep Router</screen>\r
+ </step>\r
+ <step>\r
+ <para>Start the OpenSRF perl services and check for errors</para>\r
+ <screen>/openils/bin/osrf_ctl.sh -l -a start_perl</screen>\r
+ <para>You should see the output similar to the following:</para>\r
+ <screen>Starting OpenSRF Perl</screen>\r
+ <screen>* starting all services for ...</screen>\r
+ <screen>* starting service pid=7484 opensrf.settings</screen>\r
+ <screen>* starting service pid=7493 open-ils.cat</screen>\r
+ <screen>* starting service pid=7495 open-ils.supercat</screen>\r
+ <screen>* starting service pid=7497 open-ils.search</screen>\r
+ <screen>* starting service pid=7499 open-ils.circ</screen>\r
+ <screen>* starting service pid=7501 open-ils.actor</screen>\r
+ <screen>* starting service pid=7502 open-ils.storage</screen>\r
+ <screen>...</screen>\r
+ \r
+ <para>If the perl services do not start correctly or you receive errors, search for errors \r
+ in the following log files:</para>\r
+ <screen>/openils/var/log/router.log</screen>\r
+ <screen>/openils/var/log/osrfsys.log</screen>\r
+ <para>At this point you can use the <command>grep</command> command to find errors in \r
+ any of the Evergreen log files:</para>\r
+ <screen>grep ERR /openils/var/log/*.log</screen>\r
+ <para>As a final sanity check, look for OpenSRF processes:</para>\r
+ <screen>ps -aef | grep -i opensrf</screen>\r
+ </step>\r
+ <step>\r
+ <para>Start the OpenSRF C services and check for errors:</para>\r
+ <screen>/openils/bin/osrf_ctl.sh -l -a start_c</screen>\r
+ <para>And output should be:</para>\r
+ <para>Starting OpenSRF C (host=localhost)</para>\r
+ <para>If the <emphasis>c</emphasis> service does not start, check for errors by grepping \r
+ the log files for errors:</para>\r
+ <screen>grep ERR /openils/var/log/*.log</screen>\r
+ <para>Check for OpenSRF processes:</para>\r
+ <screen>ps -aef | grep -i opensrf</screen>\r
+ </step>\r
+ <step>\r
+ <para>Smoke test with autogen.sh<indexterm><primary>autogen</primary></indexterm></para>\r
+ <para>The Autogen tool will take some dynamic information from the database and generate \r
+ static JavaScript files for use by the OPAC and staff client. It is also able to refresh \r
+ the proximity map between libraries for the purpose of efficiently routing hold \r
+ requests.</para>\r
+ <para>As user opensrf, you invoke Autogen with the command:</para>\r
+ <screen>/openils/bin/autogen.sh -c /openils/conf/opensrf_core.xml -u</screen>\r
+ <para>If Autogen completes successfully, the output will be:</para>\r
+ <screen>Updating fieldmapper</screen>\r
+ <screen>Updating web_fieldmapper</screen>\r
+ <screen>Updating OrgTree</screen>\r
+ <screen>removing OrgTree from the cache...</screen>\r
+ <screen>Updating OrgTree HTML</screen>\r
+ <screen>Updating locales selection HTML</screen>\r
+ <screen>Updating Search Groups</screen>\r
+ <screen>Refreshing proximity of org units</screen>\r
+ <screen>Successfully updated the organization proximity</screen>\r
+ <screen>Done</screen>\r
+ <para>If Autogen does not complete its task and you receive errors, use \r
+ <command>grep</command> to find errors in the log files:</para> \r
+ <screen>grep ERR /openils/var/log/*.log</screen>\r
+ </step>\r
+ <step>\r
+ <para>Connect to Evergreen using the srfsh command-line OpenSRF client<indexterm><primary>srfsh (command-line OpenSRF client)</primary></indexterm></para>\r
+ <screen>/openils/bin/srfsh</screen>\r
+ <note>\r
+ <para>In order for you to connect using <command>srfsh</command>, you will need to \r
+ have set up the .srfsh.xml configuration file in your home directory as as \r
+ described in the installation chapter.</para>\r
+ </note> \r
+ <para>You will then see the <emphasis>srfsh</emphasis> prompt:</para>\r
+ <screen>srfsh#</screen>\r
+ <para>At the srfsh prompt, enter this command:</para>\r
+ <screen>login admin open-ils</screen>\r
+ <para>You should the request verification:</para>\r
+ <screen>Received Data: "6f63ff5542da1fead4431c6c280efc75"</screen>\r
+ <screen>------------------------------------</screen>\r
+ <screen>Request Completed Successfully</screen>\r
+ <screen>Request Time in seconds: 0.018414</screen>\r
+ <screen>------------------------------------</screen>\r
+ <screen></screen>\r
+ <screen>Received Data: {</screen>\r
+ <screen>"ilsevent":0,</screen>\r
+ <screen>"textcode":"SUCCESS",</screen>\r
+ <screen>"desc":" ",</screen>\r
+ <screen>"pid":7793,</screen>\r
+ <screen>"stacktrace":"oils_auth.c:312",</screen>\r
+ <screen>"payload":{</screen>\r
+ <screen>"authtoken":"28804ebf99508496e2a4d2593aaa930e",</screen>\r
+ <screen> "authtime":420.000000</screen>\r
+ <screen>}</screen>\r
+ <screen>}</screen>\r
+ <screen></screen>\r
+ <screen>------------------------------------</screen>\r
+ <screen>Request Completed Successfully</screen>\r
+ <screen> Request Time in seconds: 0.552430</screen>\r
+ <screen>------------------------------------</screen>\r
+ <screen> Login Session: 28804. Session timeout: 420.000</screen>\r
+ <screen>srfsh#</screen> \r
+ <para>If you encounter errors or if you are unable to connect, you should consult the \r
+ <filename>srfsh.log</filename> file. The location of this file is configured in your \r
+ <filename>.srfsh.xml</filename> configuration file and is \r
+ <filename>/openils/var/log/srfsh.log</filename> by default.</para>\r
+ <para>Pressing \r
+ <keycombo>\r
+ <keycap>Ctrl</keycap>\r
+ <keycap>D</keycap>\r
+ </keycombo>\r
+ or entering <quote>exit</quote> will terminate srfsh.</para>\r
+ </step>\r
+ <step>\r
+ <para>Start <application>Apache</application> and check for errors:</para>\r
+ <screen>/etc/init.d/apache2 start</screen>\r
+ <para>or</para>\r
+ <screen>apache2ctl start</screen>\r
+ <para>You should see output:</para>\r
+ <screen>* Starting web server apache2</screen>\r
+ <screen>...done.</screen>\r
+ <para>the Apache OpenSRF modules write to the \r
+ <filename>/openils/var/log/gateway.log</filename></para>\r
+ <para>However, you should check all of the log files for errors:</para>\r
+ <screen>grep ERR /openils/var/log/*.log</screen>\r
+ <para>Another place to check for errors is the <application>Apache</application> error logs\r
+ generally located in in the <filename class="directory">/var/log/Apache2</filename> \r
+ directory</para>\r
+ <para>If you encounter errors with Apache, a common source of potential problems are the \r
+ Evergreen site configuration files <filename>/etc/apache2/eg_vhost.conf</filename> and \r
+ <filename>/etc/apache2/sites-available/eg.conf</filename></para>\r
+ </step>\r
+ <step>\r
+ <para>Try to login from the <link linkend="staffclient-login">staff client</link></para>\r
+ </step>\r
+ <step>\r
+ <para>Try to access the catalog from the OPAC</para>\r
+ </step> \r
+ </procedure> \r
+</chapter>\r
<?xml version="1.0" encoding="utf-8"?>\r
-<chapter xml:id="start" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="EN"\r
+<chapter xml:id="usingstaffclient" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="EN"\r
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink">\r
<info>\r
\r
projects / Evergreen-DocBook.git / commitdiff