Fix a bit the Oracle section:

- Add missing application, username, envar, filename etc. tags
- Fix the ports for the linux_base etc. and be more general about
  various available ports.
- Add link to RPM port
- Some little rewordings.

(I do not own Oracle and/or a 9.X version, so I cannot check/update some
parts :( )
This commit is contained in:
Marc Fonvieille 2003-08-29 08:06:00 +00:00
parent 3ad81c207c
commit d54f21bffa
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=18023

View file

@ -865,44 +865,43 @@ exit 0</programlisting>
<sect2>
<title>Preface</title>
<para>This document describes the process of installing Oracle 8.0.5 and
Oracle 8.0.5.1 Enterprise Edition for Linux onto a FreeBSD
<para>This document describes the process of installing <application>Oracle 8.0.5</application> and
<application>Oracle 8.0.5.1 Enterprise Edition</application> for Linux onto a FreeBSD
machine.</para>
</sect2>
<sect2>
<title>Installing the Linux Environment</title>
<para>Make sure you have both <filename>linux_base</filename> and
<filename>linux_devtools</filename> from the ports collection
installed. If you run into difficulties with
<filename>linux_base-6.1</filename> or
<filename>linux_devtools-6.1</filename> you may have to use version
5.2 of these packages.</para>
<para>Make sure you have both <filename role='package'>emulators/linux_base</filename> and
<filename role='package'>devel/linux_devtools</filename> from the ports collection
installed. If you run into difficulties with these ports,
you may have to use
the packages or older versions available in the ports collection.</para>
<para>If you want to run the intelligent agent, you will
also need to install the Red Hat Tcl package:
also need to install the Red Hat <application>Tcl</application> package:
<filename>tcl-8.0.3-20.i386.rpm</filename>. The general command
for installing packages with the official RPM port is:</para>
for installing packages with the official <application>RPM</application> port (<filename role='package'>archivers/rpm</filename>) is:</para>
<screen>&prompt.root; <userinput>rpm -i --ignoreos --root /compat/linux --dbpath /var/lib/rpm <replaceable>package</replaceable></userinput></screen>
<para>Installation of the package should not generate any errors.</para>
<para>Installation of the <replaceable>package</replaceable> should not generate any errors.</para>
</sect2>
<sect2>
<title>Creating the Oracle Environment</title>
<para>Before you can install Oracle, you need to set up a proper
<para>Before you can install <application>Oracle</application>, you need to set up a proper
environment. This document only describes what to do
<emphasis>specially</emphasis> to run Oracle for Linux on FreeBSD, not
what has been described in the Oracle installation guide.</para>
<emphasis>specially</emphasis> to run <application>Oracle</application> for Linux on FreeBSD, not
what has been described in the <application>Oracle</application> installation guide.</para>
<sect3 id="linuxemu-kernel-tuning">
<title>Kernel Tuning</title>
<indexterm><primary>kernel tuning</primary></indexterm>
<para>As described in the Oracle installation guide, you need to set
<para>As described in the <application>Oracle</application> installation guide, you need to set
the maximum size of shared memory. Do not use
<literal>SHMMAX</literal> under FreeBSD. <literal>SHMMAX</literal>
is merely calculated out of <literal>SHMMAXPGS</literal> and
@ -917,10 +916,10 @@ options SEMMNS=200
options SEMMNI=70
options SEMMSL=61</programlisting>
<para>Set these options to suit your intended use of Oracle.</para>
<para>Set these options to suit your intended use of <application>Oracle</application>.</para>
<para>Also, make sure you have the following options in your kernel
config-file:</para>
configuration file:</para>
<programlisting>options SYSVSHM #SysV shared memory
options SYSVSEM #SysV semaphores
@ -931,17 +930,17 @@ options SYSVMSG #SysV interprocess communication</programlisting>
<title>Oracle Account</title>
<para>Create an Oracle account just as you would create any other
account. The Oracle account is special only that you need to give
<para>Create an <username>oracle</username> account just as you would create any other
account. The <username>oracle</username> account is special only that you need to give
it a Linux shell. Add <literal>/compat/linux/bin/bash</literal> to
<filename>/etc/shells</filename> and set the shell for the Oracle
<filename>/etc/shells</filename> and set the shell for the <username>oracle</username>
account to <filename>/compat/linux/bin/bash</filename>.</para>
</sect3>
<sect3 id="linuxemu-environment">
<title>Environment</title>
<para>Besides the normal Oracle variables, such as
<para>Besides the normal <application>Oracle</application> variables, such as
<envar>ORACLE_HOME</envar> and <envar>ORACLE_SID</envar> you must
set the following environment variables:</para>
@ -1011,10 +1010,10 @@ export PATH</programlisting>
<para>Due to a slight inconsistency in the Linux emulator, you need to
create a directory named <filename>.oracle</filename> in
<filename>/var/tmp</filename> before you start the installer. Either
make it world writable or let it be owner by the oracle user. You
should be able to install Oracle without any problems. If you have
problems, check your Oracle distribution and/or configuration first!
After you have installed Oracle, apply the patches described in the
make it world writable or let it be owned by the <username>oracle</username> user. You
should be able to install <application>Oracle</application> without any problems. If you have
problems, check your <application>Oracle</application> distribution and/or configuration first!
After you have installed <application>Oracle</application>, apply the patches described in the
next two subsections.</para>
<para>A frequent problem is that the TCP protocol adapter is not
@ -1033,11 +1032,11 @@ export PATH</programlisting>
<sect3 id="linuxemu-patch-root">
<title>Patching root.sh</title>
<para>When installing Oracle, some actions, which need to be performed
<para>When installing <application>Oracle</application>, some actions, which need to be performed
as <username>root</username>, are recorded in a shell script called
<filename>root.sh</filename>. <filename>root.sh</filename> is
<filename>root.sh</filename>. This script is
written in the <filename>orainst</filename> directory. Apply the
following patch to root.sh, to have it use to proper location of
following patch to <filename>root.sh</filename>, to have it use to proper location of
<command>chown</command> or alternatively run the script under a
Linux native shell.</para>
@ -1059,7 +1058,7 @@ export PATH</programlisting>
#
# Define variables to be used in this script</programlisting>
<para>When you do not install Oracle from CD, you can patch the source
<para>When you do not install <application>Oracle</application> from CD, you can patch the source
for <filename>root.sh</filename>. It is called
<filename>rthd.sh</filename> and is located in the
<filename>orainst</filename> directory in the source tree.</para>
@ -1071,7 +1070,7 @@ export PATH</programlisting>
<para>The script <command>genclntsh</command> is used to create
a single shared client
library. It is used when building the demos. Apply the following
patch to comment out the definition of PATH:</para>
patch to comment out the definition of <envar>PATH</envar>:</para>
<programlisting>*** bin/genclntsh.orig Wed Sep 30 07:37:19 1998
--- bin/genclntsh Tue Dec 22 15:36:49 1998