From: Robert Soulliere <rsoulliere@libdog.mohawkcollege.ca> Date: Fri, 10 Sep 2010 19:53:26 +0000 (-0400) Subject: Add upgrading postgresql to 8.3. X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=52cfea629b7625aaa85eca0c1187d5a7e17fd501;p=Evergreen-DocBook.git Add upgrading postgresql to 8.3. Add a few chapters top root Edit docbook conversion script to point to github working directory. --- diff --git a/1.6/admin/Upgrading-Evergreen_1.6.xml b/1.6/admin/Upgrading-Evergreen_1.6.xml index aa7807e..f24bfcb 100644 --- a/1.6/admin/Upgrading-Evergreen_1.6.xml +++ b/1.6/admin/Upgrading-Evergreen_1.6.xml @@ -259,8 +259,8 @@ </step> </procedure> </simplesect> - <simplesect> - <para>Restart Evergreen and Test</para> + <simplesect xml:id="upgraderestart"> + <title>Restart Evergreen and Test</title> <procedure> <step> <para>As the <emphasis>opensrf</emphasis> user, start all @@ -291,4 +291,50 @@ section</link> of this documentation for tips on finding solutions and seeking further assistance from the Evergreen community.</para> </note> +<simplesect> + <title>Upgrading PostgreSQL from 8.2 to 8.3</title> + <para>Evergreen 1.6 supports PostgreSQL version 8.3 and it is recommended that you upgrade PostgreSQL when you upgrade Evergreen to 1.6.</para> + <note><para>The Order of the following steps is very important.</para></note> + <procedure> + <step> + <para>As opensrf, stop the evergreen and opensrf services:</para> + <screen>osrf_ctl.sh -l -a stop_all</screen> + </step> + <step> + <para><link linkend="backupevergreendatabase">Backup the Evergreen database data</link></para> + </step> + <step> + <para>Create an empty Evergreen database in postgresql 8.3 by issuing the following commands as the postgres user:</para> + <screen>createdb -E UNICODE evergreen</screen> + <screen>createlang plperl evergreen</screen> + <screen>createlang plperlu evergreen</screen> + <screen>createlang plpgsql evergreen</screen> + <screen>psql -f /usr/share/postgresql/8.3/contrib/tablefunc.sql evergreen</screen> + <screen>psql -f /usr/share/postgresql/8.3/contrib/tsearch2.sql evergreen</screen> + <screen>psql -f /usr/share/postgresql/8.3/contrib/pgxml.sql evergreen</screen> + </step> + <step> + <para>As the postgres user on the PostgreSQL server, create a PostgreSQL user named evergreen for the database cluster:</para> + <screen>createuser -P -s evergreen</screen> + <para>Enter the password for the new PostgreSQL superuser (<quote>evergreen</quote>)</para> + </step> + <step> + <para>Restore data from backup created in step 1.</para> + </step> + <step> + <para>To point tsearch2 to proper function names in 8.3, run the SQL script + <filename>/home/opensrf/Evergreen-ILS*/Open-ILS/src/sql/Pg/000.english.pg83.fts-config.sql</filename> using the <command>psql</command> command.</para> + </step> + <step> + <para><link linkend="upgraderestart">Restart Evergreen and OpenSRF services</link></para> + </step> + <step> + <para>For additional information regarding upgrading PostgreSQL, see the following documentation in PostgreSQL:</para> + <para><ulink url="http://www.postgresql.org/docs/8.3/static/install-upgrading.html" /></para> + <para><ulink url="http://www.postgresql.org/docs/8.3/interactive/textsearch-migration.html" /> + </para> + <para><ulink url="http://www.postgresql.org/docs/current/static/tsearch2.html#AEN102824" /></para> + </step> + </procedure> + </simplesect> </chapter> diff --git a/1.6/appendices/temp.xml b/1.6/appendices/temp.xml deleted file mode 100644 index e69de29..0000000 diff --git a/1.6/root.xml b/1.6/root.xml index 638207e..59cee76 100755 --- a/1.6/root.xml +++ b/1.6/root.xml @@ -68,9 +68,12 @@ </info> <xi:include href="admin/admin-intro.xml"/> <xi:include href="admin/requirements-configuration.xml"/> + <xi:include href="admin/ServersideInstallation.xml"/> <xi:include href="admin/serveradministration.xml"/> <xi:include href="admin/AdminMisc.xml"/> <xi:include href="admin/admin-lsa.xml"/> + <xi:include href="admin/admin-survey.xml"/> + <xi:include href="admin/admin-receipt.xml"/> <xi:include href="admin/Upgrading-Evergreen_1.6.xml"/> <xi:include href="admin/troubleshooting.xml"/> <xi:include href="admin/z3950.xml"/> diff --git a/tools/docbookConvert.sh b/tools/docbookConvert.sh index 51b5f91..0553ff0 100755 --- a/tools/docbookConvert.sh +++ b/tools/docbookConvert.sh @@ -1,14 +1,14 @@ #/bin/bash #generate draft html - xsltproc --xinclude --stringparam base.dir /openils/var/web/evergreen_documentation/draft/html/ /home/rsoulliere/doctools/EvergreenDocumentation/evergreen_docbook_files/evergreen_xhtml.xsl /home/rsoulliere/doctools/EvergreenDocumentation/root.xml + xsltproc --xinclude --stringparam base.dir /openils/var/web/evergreen_documentation/draft/html/ ~/Evergreen-DocBook/stylesheets/evergreen_docbook_files/evergreen_xhtml.xsl ~/Evergreen-DocBook/1.6/root.xml #Generate PDF via FO -xsltproc --xinclude --output /home/rsoulliere/doctools/EvergreenDocumentation/pdf/temp.fo /home/rsoulliere/doctools/EvergreenDocumentation/evergreen_docbook_files/evergreen_fo.xsl /home/rsoulliere/doctools/EvergreenDocumentation/root.xml + xsltproc --xinclude --output ~/Evergreen-DocBook/1.6/pdf/temp.fo ~/Evergreen-DocBook/stylesheets/evergreen_docbook_files/evergreen_fo.xsl ~/Evergreen-DocBook/1.6/root.xml # must run fop from same directory as root.xml -cd /home/rsoulliere/doctools/EvergreenDocumentation/ +cd ~/Evergreen-DocBook/1.6/ ~/doctools/fop/fop -fo pdf/temp.fo -pdf /openils/var/web/evergreen_documentation/draft/pdf/Evergreen_Documentation.pdf