svn: /phpdoc/en/trunk/reference/oci8/ aliases.xml setup.xml testing.xml
| From: | Christopher Jones | Date: | Thu, 03 Dec 2009 21:35:01 +0000 |
| Subject: | svn: /phpdoc/en/trunk/reference/oci8/ aliases.xml setup.xml testing.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-5606@lists.php.net to get a copy of this message | ||
sixd Thu, 03 Dec 2009 21:35:01 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=291671
Log:
Merge testing notes from the README
Changed paths:
_U phpdoc/en/trunk/reference/oci8/aliases.xml
U phpdoc/en/trunk/reference/oci8/setup.xml
A phpdoc/en/trunk/reference/oci8/testing.xml
Property changes on: phpdoc/en/trunk/reference/oci8/aliases.xml
___________________________________________________________________
Added: svn:eol-style
+ native
Modified: phpdoc/en/trunk/reference/oci8/setup.xml
===================================================================
--- phpdoc/en/trunk/reference/oci8/setup.xml 2009-12-03 21:12:40 UTC (rev 291670)
+++ phpdoc/en/trunk/reference/oci8/setup.xml 2009-12-03 21:35:01 UTC (rev 291671)
@@ -48,17 +48,17 @@
</section>
<!-- }}} -->
+ <!-- {{{ Testing -->
+ <section xml:id="oci8.test">
+ <title xmlns="http://docbook.org/ns/docbook">Testing</title>
+ &reference.oci8.testing;
+ </section>
+ <!-- }}} -->
+
<!-- {{{ Configuration -->
&reference.oci8.ini;
<!-- }}} -->
- <!-- {{{ Resources -->
- <section xml:id="oci8.resources">
- &reftitle.resources;
- &no.resource;
- </section>
- <!-- }}} -->
-
</chapter>
<!-- Keep this comment at the end of the file
Added: phpdoc/en/trunk/reference/oci8/testing.xml
===================================================================
--- phpdoc/en/trunk/reference/oci8/testing.xml (rev 0)
+++ phpdoc/en/trunk/reference/oci8/testing.xml 2009-12-03 21:35:01 UTC (rev 291671)
@@ -0,0 +1,150 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision$ -->
+ <section xml:id="oci8.testing" xmlns="http://docbook.org/ns/docbook">
+ <para>
+ The OCI8 test suite is in <filename>ext/oci8/tests</filename>.
+ After OCI8 tests are run this directory will also contain logs of
+ any failures.
+ </para>
+ </section>
+ <section>
+ <para>
+ Before running PHP's tests, edit <filename>details.inc</filename>
+ and set $user, $password and the $dbase connection string. The
+ OCI8 test suite has been developed using
+ the <literal>SYSTEM</literal> account. Some tests will fail if
+ the test user does not have equivalent permissions.
+ </para>
+ <para>
+ If the database is on the same machine as PHP, set
+ $oracle_on_localhost to <literal>TRUE</literal>.
+ </para>
+ <para>
+ If Oracle 11g Database Resident Connection Pooling is being
+ tested, set $test_drcp to <literal>TRUE</literal> and ensure the
+ connection string uses an appropriate DRCP pooled server.
+ </para>
+ <para>
+ An alternative to editing <filename>details.inc</filename> is the
+ set environment variables, for example:
+ <programlisting>
+<![CDATA[
+ $ export PHP_OCI8_TEST_USER=system
+ $ export PHP_OCI8_TEST_PASS=oracle
+ $ export PHP_OCI8_TEST_DB=localhost/XE
+ $ export PHP_OCI8_TEST_DB_ON_LOCALHOST=TRUE
+ $ export PHP_OCI8_TEST_DRCP=FALSE
+]]>
+ </programlisting>
+ Note in some shells these variables are not propagated correctly
+ to the PHP process and tests will fail to connect if this method
+ is used.
+ </para>
+ <para>
+ Next, set any necessary environment for the Oracle database. With
+ Oracle 10g XE do:
+ <programlisting>
+<![CDATA[
+ $ . /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.sh
+]]>
+ </programlisting>
+ </para>
+ <para>
+ For other versions of the Oracle database do:
+ <programlisting>
+<![CDATA[
+ $ . /usr/local/bin/oraenv
+]]>
+ </programlisting>
+ </para>
+ <para>
+ Some shells require that &php.ini; has <literal>E</literal> in the
+ variables_order parameter, for example:
+ <programlisting>
+<![CDATA[
+ variables_order = "EGPCS"
+]]>
+ </programlisting>
+ </para>
+ <para>
+ Run all the PHP tests with:
+ <programlisting>
+<![CDATA[
+ $ cd your_php_src_directory
+ $ make test
+]]>
+ </programlisting>
+ or run only the OCI8 tests with
+ <programlisting>
+<![CDATA[
+ $ cd your_php_src_directory
+ $ make test TESTS=ext/oci8
+]]>
+ </programlisting>
+ </para>
+ <para>
+ When the tests have completed, review any test failures. On slow
+ systems, some tests may take longer than the default test
+ timeout in <filename>run-tests.php</filename>. To correct this,
+ set the environment variable <literal>TEST_TIMEOUT</literal> to
+ a larger number of seconds.
+ </para>
+ <para>
+ On fast machines with a local database configured for light load
+ (e.g. Oracle 10g XE) some tests might fail with ORA-12516 or
+ ORA-12520 errors. To prevent this, increase the database
+ <literal>PROCESSES</literal> parameter using the following steps:
+ </para>
+ <para>
+ Connect as the oracle software owner:
+ <programlisting>
+<![CDATA[
+ $ su - oracle
+]]>
+ </programlisting>
+ </para>
+ <para>
+ Set the necessary Oracle environment with oracle_env.sh or
+ oraenv, as described above.
+ </para>
+ <para>
+ Start the SQL*Plus command line tool and
+ increase <literal>PROCESSES</literal>
+ <programlisting>
+<![CDATA[
+ $ sqlplus / as sysdba
+ SQL> alter system set processes=100 scope=spfile
+]]>
+ </programlisting>
+ </para>
+ <para>
+ Restart the database:
+ <programlisting>
+<![CDATA[
+ SQL> startup force
+]]>
+ </programlisting>
+ </para>
+ </section>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
Property changes on: phpdoc/en/trunk/reference/oci8/testing.xml
___________________________________________________________________
Added: svn:keywords
+ Revision
Added: svn:eol-style
+ native