From fc28b91452d3a0cf021fc4d8368bada846e0402c Mon Sep 17 00:00:00 2001 From: rsoulliere Date: Tue, 22 Mar 2011 15:43:27 -0400 Subject: [PATCH] Add field documentation from James Fournie. Update Upgrade and install instructions for 2.0 -- opensrf 1.6.3 and Evergreen 2.0.4. --- 1.6/admin/admin-lsa.xml | 52 +- 2.0/admin/Upgrading-Evergreen-2.0.xml | 765 ++++++++++++----------- 2.0/admin/serversideinstallation_2.0.xml | 52 +- 3 files changed, 466 insertions(+), 403 deletions(-) diff --git a/1.6/admin/admin-lsa.xml b/1.6/admin/admin-lsa.xml index c9a3c1a1e5..30f33d69a5 100644 --- a/1.6/admin/admin-lsa.xml +++ b/1.6/admin/admin-lsa.xml @@ -1306,7 +1306,57 @@ - +
+ Field Documentation + Field Documentation is custom field-level documentation that explains individual fields for + library staff. As of 2.0, the field documentation only is used in the Patron Registration screen. + + Administering Field Documentation + field documentationadministering field documentation + If their permission settings allow, staff members can create local field documentation. This + requires the ADMIN_FIELD_DOC permission. The 'depth' at which that permission is applied, is the maximum + level of the org tree at which the staff member will be able to create field documentation. + + + In the staff client, select + Admin + Local Administration + Field Documentation + + + + Click the New button. + + + Using the fm_class selector, select the database table for which you wish to create Field Documentation. This will show all of the + existing Field Documentation for that table. + As of Evergreen 2.0, only the ILS User table is used anywhere in the Evergreen UI + + + Using the owner selector, select the topmost org unit at which you would like the field documentation to be available. + + + Using the field selector, select the field you wish to document. + + + Enter your actual documentation in the string text box. + + + Click Save to save your Field Documentation entry + + + + To view field documentation for different tables, use the Class selector to filter the Field Documentation list + + + + Patron Field Documentation + field documentationpatron field documentation + On the patron registration screen there are small boxes along the left hand side. If a magnifying glass appears, you may click that magnifying + glass to retrieve the Field Documentation for that patron field. + +
+
Cash Reports diff --git a/2.0/admin/Upgrading-Evergreen-2.0.xml b/2.0/admin/Upgrading-Evergreen-2.0.xml index 1afdb64115..78b6604a95 100644 --- a/2.0/admin/Upgrading-Evergreen-2.0.xml +++ b/2.0/admin/Upgrading-Evergreen-2.0.xml @@ -1,378 +1,387 @@ - - - - Upgrading Evergreen to 2.0 - - This Chapter will explain the step-by-step process of upgrading Evergreen - to 2.0, including steps to upgrade OpenSRF. Before - upgrading, it is important to carefully plan an upgrade strategy to minimize system downtime and - service interruptions. All of the steps in this chapter are to be completed from the command line. - - - - Evergreen 2.0 has several software requirements: - - PostgreSQL: Version 8.4 is the minimum supported version of PostgreSQL. - Linux: Evergreen 2.0 has been tested on Debian Squeeze (6.0) and Ubuntu Lucid Lynx (10.04). If you are runnung an older version of these distributions, - you may want to upgrade befor installing Evergreen 2.0. For instructions on upgrading these distributions, visit the - Debian or Ubuntu websites. - - In the following instructions, you are asked to perform certain steps as either the root or - opensrf user. - - Debian: To become the root user, issue the su command and enter the password of the - root user. - Ubuntu: To become the root user, issue the sudo su command and enter the password of your current user. - - To switch from the root user to a different user, issue the su - [user] command; for example, - su - opensrf. Once you have become a non-root user, to become the root user again simply issue the exit command. - In the following instructions, /path/to/OpenSRF/ represents the path to the OpenSRF source directory. -
- Backing Up Data - - - As root, stop the Apache - web serverweb serverApache. - - - As the opensrf user, stop all - Evergreen - and OpenSRF services: - osrf_ctl.sh -l -a stop_all - - - Back up of the /openils - directory. - - - Back up the evergreen - database. - - -
-
- Upgrading OpenSRF to 1.6.2OpenSRF - - - As the opensrf user, download and extract the source files for OpenSRF - 1.6.2: - -wget http://open-ils.org/downloads/OpenSRF-1.6.2.tar.gz -tar xzf OpenSRF-1.6.2.tar.gz - - A new directory OpenSRF-1.6.2 is created. - For the latest edition of OpenSRF, check the Evergreen download page at - . - - - - As the root user, install the software prerequisites using the automatic - prerequisite installer. - -aptitude install make -cd /home/opensrf/OpenSRF-1.6.2 - - Replace below with the following value - for your distribution: - - - for Debian Squeeze (6.0) - LinuxDebian - - - for Ubuntu Lucid Lynx - (10.04)LinuxUbuntu - - - for CentOS 5 - LinuxCentOS - - - for Red Hat Enterprise Linux 5 - LinuxRed Hat - - - -cd /path/to/OpenSRF -make -f src/extras/Makefile.install [distribution] - - This will install a number of packages required by OpenSRF on your system, - including some Perl modules from CPANPerlCPAN - . You can type 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 - type yes. - - - As the opensrf user, configure and compile OpenSRF: - You can include the and configure options if - you want to include support for PythonPython and Java - Java, respectively. - -cd /home/opensrf/OpenSRF-1.6.2 -./configure --prefix=/openils --sysconfdir=/openils/conf -make - - - - As the root user, return to your OpenSRF build directory and install - OpenSRF: - -cd /home/opensrf/OpenSRF-1.6.2 -make install - - - - As the root user, change the ownership of the installed files to the - opensrf user: - chown -R opensrf:opensrf /openils - - - Restart and Test OpenSRF - -osrf_ctl.sh -l -a start_all -/openils/bin/srfsh -srfsh# request opensrf.math add 2 2 - - You should see output such as: - -Received Data: 4 - ------------------------------------- -Request Completed Successfully -Request Time in seconds: 0.007519 ------------------------------------- - -srfsh# - - If test completed successfully move onto the next section. - Otherwise, refer to the troubleshooting chapter - of this documentation. - - -
-
- Upgrade <application>Evergreen</application> from 1.6.1 to 2.0 - - PostgreSQL 8.4 is the minimum supported version of PostgreSQL. - Evergreen 2.0 has been tested on Debian Squeeze (6.0) and Ubuntu Lucid (10.04). If you are runnung an older version of - these distributions, you may want to upgrade befor installing Evergreen 2.0. For instructions on upgrading these distribuitions, visit the - Debian or Ubuntu websites. - - - - As the opensrf user, download and extract Evergreen 2.0 - - -wget http://www.open-ils.org/downloads/Evergreen-ILS-2.0.1.tar.gz -tar xzf Evergreen-ILS-2.0.1.tar.gz - - For the latest edition of Evergreen 2.0, check the Evergreen download page at - and adjust upgrading instructions accordingly. - - - As the root user, install the prerequisites: - cd /home/opensrf/Evergreen-ILS-2.0.1 - On the next command, replace with one of - these values for your distribution of Debian or Ubuntu: - - - - for Debian Squeeze (6.0) - - - - for Ubuntu Lucid Lynx - (10.04) - - - make -f Open-ILS/src/extras/Makefile.install - - - As the opensrf user, configure and compile - Evergreen: - cd /home/opensrf/Evergreen-ILS-2.0.1 - ./configure --prefix=/openils --sysconfdir=/openils/conf - make - - - As the root user, install - Evergreen: - make STAFF_CLIENT_BUILD_ID=rel_2_0_1 install - - - Change to the Evergreen installation - directory: - cd /home/opensrf/Evergreen-ILS-2.0.1 - - - As the root user, change all files to be owned by the - opensrf user and group: - chown -R opensrf:opensrf /openils - - - As the opensrf user, update server symlink in /openils/var/web/xul/: - -cd /openils/var/web/xul/ -rm server -ln -s rel_2_0_1/server - - - - Update the evergreen database: - It is recommended that you back up your Evergreen database in order to restore your data if anything goes wrong. - - -psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1-2.0-upgrade-db.sql evergreen -psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.0-2.0.1-upgrade-db.sql evergreen - - - The 1.6.1-2.0-upgrade-db.sql upgrade script may take a long time (hours) to process - on larger systems. - - - Run the reingest-1.6-2.0.pl script to generate an sql script. Then use the sql file to reingest bib records into your - evergreen database. This is required to make the new facet sidebar in OPAC search results work and to upgrade the keyword indexes to use - the revised NACO normalization routine. - If you are running a large Evergreen installation, it is recommend that you examine the script first. Reingesting a large number of bibliographic records - may take several hours. -perl Open-ILS/src/sql/Pg/reingest-1.6-2.0.pl -psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/reingest-1.6-2.0.sql evergreen - - - As the opensrf user, - copy /openils/conf/oils_web.xml.example to /openils/conf/oils_web.xml - . (If upgrading from 1.6.1.x, oils_web.xml should already exist.) - configuration filesoils_web.xml - cp /openils/conf/oils_web.xml.example /openils/conf/oils_web.xml - - - Update opensrf_core.xml and opensrf.xml by copying the new example files - (/openils/conf/opensrf_core.xml.example and /openils/conf/opensrf.xml). - configuration filesopensrf.xml - cp /openils/conf/opensrf_core.xml.example /openils/conf/opensrf_core.xml - configuration filesopensrf_core.xml - cp /openils/conf/opensrf.xml.example /openils/conf/opensrf.xml - Copying these configuration files will remove any customizations you have made to them. Remember to redo your customizations after copying - them. - - - Update opensrf.xml with the database connection info: - -perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config --service all --create-offline --user evergreen \ ---password evergreen --hostname localhost --port 5432 --database evergreen - - - - Update /etc/apache2/startup.pl by copying the example from - Open-ILS/examples/apache/startup.pl.configuration filesstartup.pl - - - Update /etc/apache2/eg_vhost.conf by copying the example from - Open-ILS/examples/apache/eg_vhost.conf.configuration fileseg_vhost.conf - - - Update /etc/apache2/sites-available/eg.conf by copying the example from Open-ILS/ - examples/apache/eg.conf.configuration fileseg.conf - - - Copying these Apache configuration files will remove any customizations you have made to them. Remember to redo your customizations after copying - them. For example, if you purchased an SSL certificate, you - will need to edit eg.conf to point to the appropriate SSL certificate files. - SSLcertificates - - -
-
- Restart Evergreen and Test - - - As the opensrf user, start all - Evergreen and OpenSRF - services: - osrf_ctl.sh -l -a start_all - - - As the opensrf user, run autogen to refresh the static - organizational data files:autogen - -cd /openils/bin -./autogen.sh -c /openils/conf/opensrf_core.xml -u - - - - - Start srfsh and try logging in using your Evergreen - username and password: - -/openils/bin/srfsh -srfsh% login - - - - Start the Apache web server. - - - - If you encounter errors, refer to the troubleshooting - section of this documentation for tips - on finding solutions and seeking further assistance from the Evergreen community. - -
-
- Upgrading PostgreSQL from 8.2 to 8.4 (if required) - Evergreen 1.6.1 supports PostgreSQL version 8.4 and it is recommended that you upgrade PostgreSQL when you upgrade Evergreen to 1.6. - The order of the following steps is very important.databasesPostgreSQL - - - As opensrf, stop the evergreen and opensrf services: - osrf_ctl.sh -l -a stop_all - - - Backup the Evergreen database data - - - Upgrade to Postgresql 8.4 by removing old version and installing Postgresql 8.4 - - - Create an empty Evergreen database in postgresql 8.4 by issuing the following commands as the postgres user: - - -createdb -E UNICODE evergreen -createlang plperl evergreen -createlang plperlu evergreen -createlang plpgsql evergreen -psql -f /usr/share/postgresql/8.4/contrib/tablefunc.sql evergreen -psql -f /usr/share/postgresql/8.4/contrib/tsearch2.sql evergreen -psql -f /usr/share/postgresql/8.4/contrib/pgxml.sql evergreen - - - - - As the postgres user on the PostgreSQL server, create a PostgreSQL user named evergreen for the database cluster: - createuser -P -s evergreen - Enter the password for the new PostgreSQL superuser (evergreen) - - - Restore data from backup created in step 1. - - - To point tsearch2 to proper function names in 8.4, run the SQL script - /home/opensrf/Evergreen-ILS*/Open-ILS/src/sql/Pg/000.english.pg84.fts-config.sql using the psql command. - cd /home/opensrf/Evergreen-ILS* - psql -f /Open-ILS/src/sql/Pg/000.english.pg84.fts-config.sql evergreen - - - Restart Evergreen and OpenSRF services - - - For additional information regarding upgrading PostgreSQL, see the following documentation in PostgreSQL: - - - - - - -
- + + + + Upgrading Evergreen to 2.0 + + This Chapter will explain the step-by-step process of upgrading Evergreen + to 2.0, including steps to upgrade OpenSRF. Before + upgrading, it is important to carefully plan an upgrade strategy to minimize system downtime and + service interruptions. All of the steps in this chapter are to be completed from the command line. + + + + Evergreen 2.0 has several software requirements: + + PostgreSQL: Version 8.4 is the minimum supported version of PostgreSQL. + Linux: Evergreen 2.0 has been tested on Debian Squeeze (6.0) and Ubuntu Lucid Lynx (10.04). If you are runnung an older version of these distributions, + you may want to upgrade befor installing Evergreen 2.0. For instructions on upgrading these distributions, visit the + Debian or Ubuntu websites. + + In the following instructions, you are asked to perform certain steps as either the root or + opensrf user. + + Debian: To become the root user, issue the su command and enter the password of the + root user. + Ubuntu: To become the root user, issue the sudo su command and enter the password of your current user. + + To switch from the root user to a different user, issue the su - [user] command; for example, + su - opensrf. Once you have become a non-root user, to become the root user again simply issue the exit command. + In the following instructions, /path/to/OpenSRF/ represents the path to the OpenSRF source directory. +
+ Backing Up Data + + + As root, stop the Apache + web serverweb serverApache. + + + As the opensrf user, stop all + Evergreen + and OpenSRF services: + osrf_ctl.sh -l -a stop_all + + + Back up of the /openils + directory. + + + Back up the evergreen + database. + + +
+
+ Upgrading OpenSRF to 1.6.3OpenSRF + + + As the opensrf user, download and extract the source files for OpenSRF + 1.6.3: + +wget http://open-ils.org/downloads/OpenSRF-1.6.3.tar.gz +tar xzf OpenSRF-1.6.3.tar.gz + + A new directory OpenSRF-1.6.3 is created. + For the latest edition of OpenSRF, check the Evergreen download page at + . + + + + As the root user, install the software prerequisites using the automatic + prerequisite installer. + +aptitude install make +cd /home/opensrf/OpenSRF-1.6.3 + + Replace below with the following value + for your distribution: + + + for Debian Squeeze (6.0) + LinuxDebian + + + for Fedora 13 + LinuxFedora + + + for Ubuntu Lucid Lynx + (10.04)LinuxUbuntu + + + for CentOS 5 + LinuxCentOS + + + for Red Hat Enterprise Linux 5 + LinuxRed Hat + + + +cd /path/to/OpenSRF +make -f src/extras/Makefile.install [distribution] + + This will install a number of packages required by OpenSRF on your system, + including some Perl modules from CPANPerlCPAN + . You can type 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 - type yes. + + + As the opensrf user, configure and compile OpenSRF: + You can include the and configure options if + you want to include support for PythonPython and Java + Java, respectively. + +cd /home/opensrf/OpenSRF-1.6.3 +./configure --prefix=/openils --sysconfdir=/openils/conf +make + + + + As the root user, return to your OpenSRF build directory and install + OpenSRF: + +cd /home/opensrf/OpenSRF-1.6.3 +make install + + + + As the root user, change the ownership of the installed files to the + opensrf user: + chown -R opensrf:opensrf /openils + + + Restart and Test OpenSRF + +osrf_ctl.sh -l -a start_all +/openils/bin/srfsh +srfsh# request opensrf.math add 2 2 + + You should see output such as: + +Received Data: 4 + +------------------------------------ +Request Completed Successfully +Request Time in seconds: 0.007519 +------------------------------------ + +srfsh# + + If test completed successfully move onto the next section. + Otherwise, refer to the troubleshooting chapter + of this documentation. + + +
+
+ Upgrade <application>Evergreen</application> from 1.6.1 to 2.0 + + PostgreSQL 8.4 is the minimum supported version of PostgreSQL. + Evergreen 2.0 has been tested on Debian Squeeze (6.0) and Ubuntu Lucid (10.04). If you are runnung an older version of + these distributions, you may want to upgrade befor installing Evergreen 2.0. For instructions on upgrading these distribuitions, visit the + Debian or Ubuntu websites. + + + + As the opensrf user, download and extract Evergreen 2.0 + + +wget http://www.open-ils.org/downloads/Evergreen-ILS-2.0.4.tar.gz +tar xzf Evergreen-ILS-2.0.4.tar.gz + + For the latest edition of Evergreen 2.0, check the Evergreen download page at + and adjust upgrading instructions accordingly. + + + As the root user, install the prerequisites: + cd /home/opensrf/Evergreen-ILS-2.0.4 + On the next command, replace with one of + these values for your distribution of Debian or Ubuntu: + + + + for Debian Squeeze (6.0) + + + + for Ubuntu Lucid Lynx + (10.04) + + + make -f Open-ILS/src/extras/Makefile.install + + + As the opensrf user, configure and compile + Evergreen: + cd /home/opensrf/Evergreen-ILS-2.0.4 + ./configure --prefix=/openils --sysconfdir=/openils/conf + make + + + As the root user, install + Evergreen: + make STAFF_CLIENT_BUILD_ID=rel_2_0_4 install + + + Change to the Evergreen installation + directory: + cd /home/opensrf/Evergreen-ILS-2.0.4 + + + As the root user, change all files to be owned by the + opensrf user and group: + chown -R opensrf:opensrf /openils + + + As the opensrf user, update server symlink in /openils/var/web/xul/: + +cd /openils/var/web/xul/ +rm server +ln -s rel_2_0_4/server + + + + Update the evergreen database: + It is recommended that you back up your Evergreen database in order to restore your data if anything goes wrong. + The 1.6.1-2.0-upgrade-db.sql upgrade script may take a long time (hours) to process + on larger systems. + + +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1-2.0-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.0-2.0.1-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.1-2.0.2-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.1-2.0.2-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.2-2.0.3-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.3-2.0.4-upgrade-db.sql evergreen + + + + + + Run the reingest-1.6-2.0.pl script to generate an sql script. Then use the sql file to reingest bib records into your + evergreen database. This is required to make the new facet sidebar in OPAC search results work and to upgrade the keyword indexes to use + the revised NACO normalization routine. + If you are running a large Evergreen installation, it is recommend that you examine the script first. Reingesting a large number of bibliographic records + may take several hours. +perl Open-ILS/src/sql/Pg/reingest-1.6-2.0.pl +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/reingest-1.6-2.0.sql evergreen + + + As the opensrf user, + copy /openils/conf/oils_web.xml.example to /openils/conf/oils_web.xml + . (If upgrading from 1.6.1.x, oils_web.xml should already exist.) + configuration filesoils_web.xml + cp /openils/conf/oils_web.xml.example /openils/conf/oils_web.xml + + + Update opensrf_core.xml and opensrf.xml by copying the new example files + (/openils/conf/opensrf_core.xml.example and /openils/conf/opensrf.xml). + configuration filesopensrf.xml + cp /openils/conf/opensrf_core.xml.example /openils/conf/opensrf_core.xml + configuration filesopensrf_core.xml + cp /openils/conf/opensrf.xml.example /openils/conf/opensrf.xml + Copying these configuration files will remove any customizations you have made to them. Remember to redo your customizations after copying + them. + + + Update opensrf.xml with the database connection info: + +perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config --service all --create-offline --user evergreen \ +--password evergreen --hostname localhost --port 5432 --database evergreen + + + + Update /etc/apache2/startup.pl by copying the example from + Open-ILS/examples/apache/startup.pl.configuration filesstartup.pl + + + Update /etc/apache2/eg_vhost.conf by copying the example from + Open-ILS/examples/apache/eg_vhost.conf.configuration fileseg_vhost.conf + + + Update /etc/apache2/sites-available/eg.conf by copying the example from Open-ILS/ + examples/apache/eg.conf.configuration fileseg.conf + + + Copying these Apache configuration files will remove any customizations you have made to them. Remember to redo your customizations after copying + them. For example, if you purchased an SSL certificate, you + will need to edit eg.conf to point to the appropriate SSL certificate files. + SSLcertificates + + +
+
+ Restart Evergreen and Test + + + As the opensrf user, start all + Evergreen and OpenSRF + services: + osrf_ctl.sh -l -a start_all + + + As the opensrf user, run autogen to refresh the static + organizational data files:autogen + +cd /openils/bin +./autogen.sh -c /openils/conf/opensrf_core.xml -u + + + + + Start srfsh and try logging in using your Evergreen + username and password: + +/openils/bin/srfsh +srfsh% login + + + + Start the Apache web server. + + + + If you encounter errors, refer to the troubleshooting + section of this documentation for tips + on finding solutions and seeking further assistance from the Evergreen community. + +
+
+ Upgrading PostgreSQL from 8.2 to 8.4 (if required) + Evergreen 2.0 requires PostgreSQL version 8.4 or later. + The order of the following steps is very important.databasesPostgreSQL + + + As opensrf, stop the evergreen and opensrf services: + osrf_ctl.sh -l -a stop_all + + + Backup the Evergreen database data + + + Upgrade to Postgresql 8.4 by removing old version and installing Postgresql 8.4 + + + Create an empty Evergreen database in postgresql 8.4 by issuing the following commands as the postgres user: + + +createdb -E UNICODE evergreen +createlang plperl evergreen +createlang plperlu evergreen +createlang plpgsql evergreen +psql -f /usr/share/postgresql/8.4/contrib/tablefunc.sql evergreen +psql -f /usr/share/postgresql/8.4/contrib/tsearch2.sql evergreen +psql -f /usr/share/postgresql/8.4/contrib/pgxml.sql evergreen + + + + + As the postgres user on the PostgreSQL server, create a PostgreSQL user named evergreen for the database cluster: + createuser -P -s evergreen + Enter the password for the new PostgreSQL superuser (evergreen) + + + Restore data from backup created in step 1. + + + To point tsearch2 to proper function names in 8.4, run the SQL script + /home/opensrf/Evergreen-ILS*/Open-ILS/src/sql/Pg/000.english.pg84.fts-config.sql using the psql command. + cd /home/opensrf/Evergreen-ILS* + psql -f /Open-ILS/src/sql/Pg/000.english.pg84.fts-config.sql evergreen + + + Restart Evergreen and OpenSRF services + + + For additional information regarding upgrading PostgreSQL, see the following documentation in PostgreSQL: + + + + + + +
+ diff --git a/2.0/admin/serversideinstallation_2.0.xml b/2.0/admin/serversideinstallation_2.0.xml index a2f3759daf..001ed09bc3 100644 --- a/2.0/admin/serversideinstallation_2.0.xml +++ b/2.0/admin/serversideinstallation_2.0.xml @@ -48,7 +48,7 @@ 2.0 - 1.6.2 + 1.6.3 8.4 @@ -70,7 +70,7 @@ OpenSRF installation - Installing OpenSRF 1.6.2 On <systemitem class="osname">Ubuntu</systemitem> or + <title>Installing OpenSRF 1.6.3 On <systemitem class="osname">Ubuntu</systemitem> or <systemitem class="osname">Debian</systemitem> Linux @@ -91,7 +91,7 @@ until you have verified that OpenSRF has been successfully installed and tested. The following steps have been tested on the x86 (32-bit) and x86-64 (64-bit) - platforms. OpenSRF 1.6.2 has been tested on Debian Lenny (5.0), Debian Squeeze (6.0) + platforms. OpenSRF 1.6.3 has been tested on Debian Lenny (5.0), Debian Squeeze (6.0) and Ubuntu Lucid Lynx (10.04), Debian Lenny (5.0), CentOS 5, Red Hat Enterprise Linux 5. In the following instructions, you are asked to perform certain steps as @@ -142,17 +142,17 @@ download The latest version of OpenSRF can be found here: - . + . As the opensrf user, change to the directory /home/opensrf then download and extract OpenSRF. The new subdirectory - /home/opensrf/OpenSRF-1.6.2 will be created: + /home/opensrf/OpenSRF-1.6.3 will be created: # as the opensrf user: cd /home/opensrf - wget http://evergreen-ils.org/downloads/OpenSRF-1.6.2.tar.gz - tar zxf OpenSRF-1.6.2.tar.gz + wget http://evergreen-ils.org/downloads/OpenSRF-1.6.3.tar.gz + tar zxf OpenSRF-1.6.3.tar.gz @@ -170,7 +170,7 @@ # as the root user: - cd /home/opensrf/OpenSRF-1.6.2 + cd /home/opensrf/OpenSRF-1.6.3 make -f src/extras/Makefile.install [DISTRIBUTION] @@ -178,6 +178,10 @@ for Debian Squeeze (6.0) LinuxDebian + + for Fedora 13 + LinuxFedora + for Ubuntu Lucid Lynx (10.04) @@ -216,7 +220,7 @@ # as the opensrf user: - cd /home/opensrf/OpenSRF-1.6.2 + cd /home/opensrf/OpenSRF-1.6.3 ./configure --prefix=/openils --sysconfdir=/openils/conf make @@ -231,7 +235,7 @@ # as the root user: - cd /home/opensrf/OpenSRF-1.6.2 + cd /home/opensrf/OpenSRF-1.6.3 make install This step will take several minutes to complete. @@ -774,17 +778,17 @@ Download and Unpack Latest Evergreen Version The latest version of Evergreen can be found here: - . + . As the opensrf user, change to the directory /home/opensrf then download and extract Evergreen. The new subdirectory - /home/opensrf/Evergreen-ILS-2.0.1 will be created: + /home/opensrf/Evergreen-ILS-2.0.4 will be created: # as the opensrf user: cd /home/opensrf - wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.1.tar.gz - tar zxf Evergreen-ILS-2.0.1.tar.gz + wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.4.tar.gz + tar zxf Evergreen-ILS-2.0.4.tar.gz @@ -805,7 +809,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.1 + cd /home/opensrf/Evergreen-ILS-2.0.4 make -f Open-ILS/src/extras/Makefile.install [DISTRIBUTION] @@ -917,7 +921,7 @@ # as the opensrf user: - cd /home/opensrf/Evergreen-ILS-2.0.1 + cd /home/opensrf/Evergreen-ILS-2.0.4 ./configure --prefix=/openils --sysconfdir=/openils/conf make @@ -931,14 +935,14 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.1 - make STAFF_CLIENT_BUILD_ID=rel_2_0_1 install + cd /home/opensrf/Evergreen-ILS-2.0.4 + make STAFF_CLIENT_BUILD_ID=rel_2_0_4 install The Staff Client will also be automatically built, but you must remember to set the variable STAFF_CLIENT_BUILD_ID to match the version of the Staff Client you will use to connect to the Evergreen server. The above commands will create a new subdirectory - /openils/var/web/xul/rel_2_0_1 + /openils/var/web/xul/rel_2_0_4 containing the Staff Client. To complete the Staff Client installation, as the root user execute the following commands to @@ -950,7 +954,7 @@ # as the root user: cd /openils/var/web/xul - ln -sf rel_2_0_1/server server + ln -sf rel_2_0_4/server server @@ -1046,7 +1050,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.1 + cd /home/opensrf/Evergreen-ILS-2.0.4 perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config \ --service all --create-schema --create-offline \ --hostname HOSTNAME --port PORT \ @@ -1112,7 +1116,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.1 + cd /home/opensrf/Evergreen-ILS-2.0.4 cp Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/ cp Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/ cp Open-ILS/examples/apache/startup.pl /etc/apache2/ @@ -1543,7 +1547,7 @@ # as the opensrf user: cd /home/opensrf - ./Evergreen-ILS-2.0.1/Open-ILS/src/support-scripts/settings-tester.pl + ./Evergreen-ILS-2.0.4/Open-ILS/src/support-scripts/settings-tester.pl If the output of settings-tester.pl does not help you find the problem, please do not make any significant changes to your @@ -1575,7 +1579,7 @@ # as the root user: - xulrunner /home/opensrf/Evergreen-ILS-2.0.1/Open-ILS/xul/staff_client/build/application.ini + xulrunner /home/opensrf/Evergreen-ILS-v/Open-ILS/xul/staff_client/build/application.ini A login screen for the Staff Client similar to this should appear: -- 2.43.2