betz Mon Jun 23 13:33:28 2003 EDT
Modified files:
/phpdoc/en/chapters install.iplanet.xml
Log:
examples to xml, restructering
Index: phpdoc/en/chapters/install.iplanet.xml
diff -u phpdoc/en/chapters/install.iplanet.xml:1.1
phpdoc/en/chapters/install.iplanet.xml:1.2
--- phpdoc/en/chapters/install.iplanet.xml:1.1 Tue Jan 15 06:22:19 2002
+++ phpdoc/en/chapters/install.iplanet.xml Mon Jun 23 13:33:28 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<sect1 id="install.netscape-enterprise">
<title>Servers-Netscape and iPlanet</title>
<para>
@@ -8,153 +8,211 @@
and <link linkend="install.netscape.windows">Windows</link> versions.
</para>
<para>
- You can find more information about setting up PHP for
- the Netscape Enterprise Server here:
+ You can find more information about setting up PHP for the Netscape
+ Enterprise Server (NES) here:
<ulink url="&url.netscape.nsapi;">&url.netscape.nsapi;</ulink>
</para>
<sect2 id="install.netscape.sun">
<title>Installing PHP with Netscape on Sun Solaris</title>
<para>
- To build PHP with NES or iPlanet web servers, enter the proper
- install directory for the
- <link linkend="install.configure.with-nsapi">--with-nsapi</link>
- = <replaceable>DIR</replaceable> option. The default
- directory is usually <filename
class="directory">/opt/netscape/suitespot/</filename>.
+ To build PHP with NES or iPlanet web servers, enter the proper install
+ directory for the
+ <link linkend="install.configure.with-nsapi">--with-nsapi=[DIR]</link>
+ option. The default directory is usually
+ <filename class="directory">/opt/netscape/suitespot/</filename>.
Please also read
<filename>/php-xxx-version/sapi/nsapi/nsapi-readme.txt</filename>.
</para>
+ <note>
+ <simpara>
+ These instructions are written for Sun Solaris 2.6 with Netscape
+ Enterprise Server 3.6, conributed by bhager at invacare dot com.
+ </simpara>
+ </note>
<para>
- <example id="install.netscape-enterprise.solaris">
- <title>Installation Example for Netscape Enterprise on Solaris</title>
- <screen>
+ <orderedlist>
+ <listitem>
+ <para>
+ Install the following packages from <ulink url="&url.sun.freeware;">
+ &url.sun.freeware;</ulink> or another download site:
+ <simplelist>
+ <member><filename>autoconf-2.13</filename></member>
+ <member><filename>automake-1.4</filename></member>
+ <member><filename>bison-1_25-sol26-sparc-local</filename></member>
+ <member><filename>flex-2_5_4a-sol26-sparc-local</filename></member>
+ <member><filename>gcc-2_95_2-sol26-sparc-local</filename></member>
+ <member><filename>gzip-1.2.4-sol26-sparc-local</filename></member>
+ <member><filename>m4-1_4-sol26-sparc-local</filename></member>
+ <member><filename>make-3_76_1-sol26-sparc-local</filename></member>
+ <member>
+ <filename>mysql-3.23.24-beta</filename> (if you want mysql support)
+ </member>
+ <member><filename>perl-5_005_03-sol26-sparc-local</filename></member>
+ <member><filename>tar-1.13</filename> (GNU tar)</member>
+ </simplelist>
+ </para>
+ </listitem>
+ <listitem>
+ <simpara>
+ Make sure your path includes the proper directories
+ <literal>PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin</literal>
+ and make it available to your system <userinput>export PATH</userinput>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <userinput>gunzip php-x.x.x.tar.gz</userinput> (if you have a .gz dist,
+ otherwise go to 4).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <userinput>tar xvf php-x.x.x.tar</userinput>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Change to your extracted PHP directory:
+ <userinput>cd ../php-x.x.x </userinput>
+ </simpara>
+ </listitem>
+ <listitem>
+ <para>
+ For the following step, make sure
+ <filename class="directory">/opt/netscape/suitespot/</filename> is
+ where your netscape server is installed. Otherwise, change to the
+ correct path and run:
+ <programlisting role="shell">
<![CDATA[
-Instructions for Sun Solaris 2.6 with Netscape Enterprise Server 3.6
-From: [EMAIL PROTECTED]
-
-1. Install the following packages from www.sunfreeware.com or another
-download site:
-
- flex-2_5_4a-sol26-sparc-local
- gcc-2_95_2-sol26-sparc-local
- gzip-1.2.4-sol26-sparc-local
- perl-5_005_03-sol26-sparc-local
- bison-1_25-sol26-sparc-local
- make-3_76_1-sol26-sparc-local
- m4-1_4-sol26-sparc-local
- autoconf-2.13
- automake-1.4
- mysql-3.23.24-beta (if you want mysql support)
- tar-1.13 (GNU tar)
-
-2. Make sure your path includes the proper directories
- PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin
- export PATH
-
-3. gunzip php-x.x.x.tar.gz (if you have a .gz dist, otherwise go to 4)
-4. tar xvf php-x.x.x.tar
-5. cd ../php-x.x.x
-
-6. For the following step, make sure /opt/netscape/suitespot/ is where
- your netscape server is installed. Otherwise, change to correct path:
- /configure --with-mysql=/usr/local/mysql --with-nsapi=/opt/netscape/suitespot/
--enable-track-vars --enable-libgcc
-7. make
-8. make install
-]]>
- </screen>
- </example>
- After performing the base install and reading the appropriate
- readme file, you may need to performs some additional
- configuration steps.
- </para>
- <para>
- Firstly you may need to add some paths to the LD_LIBRARY_PATH
- environment for Netscape to find all the shared libs. This can
- best done in the start script for your Netscape server.
- Windows users can probably skip this step. The start
- script is often located in:
- <filename
- class="directory">/path/to/server/https-servername/start</filename>
+./configure --with-mysql=/usr/local/mysql \
+--with-nsapi=/opt/netscape/suitespot/ \
+--enable-libgcc
+]]>
+ </programlisting>
+ </para>
+ </listitem>
+ <listitem>
+ <simpara>
+ Run <command>make</command> followed by <command>make install</command>.
+ </simpara>
+ </listitem>
+ </orderedlist>
</para>
<para>
- You may also need to edit the configuration files that are
- located in:<filename
- class="directory">/path/to/server/https-servername/config/</filename>.
+ After performing the base install and reading the appropriate readme file,
+ you may need to perform some additional configuration steps.
</para>
-
- <example id="install.netscape-enterprise.configure">
- <title>
- Configuration Example for Netscape Enterprise
- </title>
- <screen>
+ <formalpara>
+ <title>Configuration Instructions for NES</title>
+ <para>
+ Firstly you may need to add some paths to the LD_LIBRARY_PATH environment
+ for Netscape to find all the shared libs. This can best done in the start
+ script for your Netscape server. Windows users can probably skip this
+ step. The start script is often located in: <filename
+ class="directory">/path/to/server/https-servername/start</filename>.
+ You may also need to edit the configuration files that are
+ located in: <filename
+ class="directory">/path/to/server/https-servername/config/</filename>.
+ <orderedlist>
+ <listitem>
+ <para>
+ Add the following line to <filename>mime.types</filename>:
+ <screen>
<![CDATA[
-Configuration Instructions for Netscape Enterprise Server
-From: [EMAIL PROTECTED]
-
-1. Add the following line to mime.types:
- type=magnus-internal/x-httpd-php exts=php
-
-2. Add the following to obj.conf, shlib will vary depending on
- your OS, for unix it will be something like
- /opt/netscape/suitespot/bin/libphp4.so.
-
- You should place the following lines after mime types init.
- Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans"
shlib="/php4/nsapiPHP4.dll"
- Init fn=php4_init errorString="Failed to initialize PHP!"
-
- <object name="default">
- .
- .
- .
- .#NOTE this next line should happen after all 'ObjectType' and before all
'AddLog' lines
- Service fn="php4_execute" type="magnus-internal/x-httpd-php"
- .
- .
- </Object>
-
-
- <Object name="x-httpd-php">
- ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
- Service fn=php4_execute
- </Object>
-
-
- Authentication configuration
-
- PHP authentication cannot be used with any other authentication. ALL
AUTHENTICATION IS
- PASSED TO YOUR PHP SCRIPT. To configure PHP Authentication for the entire server,
add
- the following line:
-
- <Object name="default">
- AuthTrans fn=php4_auth_trans
- .
- .
+type=magnus-internal/x-httpd-php exts=php
+]]>
+ </screen>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Edit <filename>obj.conf</filename> and add the following, shlib will
+ vary depending on your OS, for Unix it will be something like
+ <filename>/opt/netscape/suitespot/bin/libphp4.so</filename>. You should
+ place the following lines after <literal>mime types init</literal>.
+ <programlisting>
+<![CDATA[
+Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans"
shlib="/php4/nsapiPHP4.dll"
+Init fn=php4_init errorString="Failed to initialize PHP!"
+]]>
+ </programlisting>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Configure the default object:
+ <programlisting>
+<![CDATA[
+<object name="default">
+.
+.
+.
+.#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog'
lines
+Service fn="php4_execute" type="magnus-internal/x-httpd-php"
.
.
- </Object>
-
- To use PHP Authentication on a single directory, add the following:
-
- <Object ppath="d:\path\to\authenticated\dir\*">
- AuthTrans fn=php4_auth_trans
</Object>
]]>
- </screen>
- </example>
+ </programlisting>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Create a new object for the usage of PHP:
+ <programlisting>
+<![CDATA[
+<Object name="x-httpd-php">
+ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
+Service fn=php4_execute
+</Object>
+]]>
+ </programlisting>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Setup of authentication: PHP authentication cannot be used with any
+ other authentication. ALL AUTHENTICATION IS PASSED TO YOUR PHP SCRIPT.
+ To configure PHP Authentication for the entire server, add the
+ following line to your default object:
+ <programlisting>
+<![CDATA[
+<Object name="default">
+AuthTrans fn=php4_auth_trans
+.
+.
+.
+</Object>
+]]>
+ </programlisting>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ To use PHP Authentication on a single directory, add the following:
+ <programlisting>
+<![CDATA[
+<Object ppath="d:\path\to\authenticated\dir\*">
+AuthTrans fn=php4_auth_trans
+</Object>
+]]>
+ </programlisting>
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </formalpara>
<para>
- If you are running Netscape Enterprise 4.x, then you should use the following:
- </para>
- <example>
- <title>Configuration Example for Netscape Enterprise 4.x</title>
+ If you are running Netscape Enterprise 4.x, then you should use the
+ following: Place these lines after the <literal>mime types init</literal>,
+ and everything else is similar to the example configuration above.
+ (Contributed by Graeme Hoose, GraemeHoose at BrightStation dot com).
<programlisting>
<![CDATA[
-Place these lines after the mime types init, and everything else is similar
-to the example configuration above.
-From: Graeme Hoose ([EMAIL PROTECTED])
-
Init fn="load-modules" shlib="/path/to/server4/bin/libphp4.so"
funcs="php4_init,php4_close,php4_execute,php4_auth_trans"
Init fn="php4_init" LateInit="yes"
]]>
</programlisting>
- </example>
+ </para>
</sect2>
<sect2 id="install.netscape.windows">
<title>Installing PHP with Netscape on Windows</title>
@@ -166,14 +224,14 @@
<listitem>
<simpara>
Copy <filename>php4ts.dll</filename> to your systemroot
- (the directory where you installed windows)
+ (the directory where you installed Windows)
</simpara>
</listitem>
<listitem>
<para>
Make a file association from the command line.
Type the following two lines:
- <programlisting>
+ <programlisting role="shell">
<