Whitespace and structure changes to bring this chapter closer to FDP

conformance.  No content changes, translaters may ignore this.
This commit is contained in:
Tom Rhodes 2002-05-15 17:30:46 +00:00
parent da6ea0ec5f
commit 3867e5a95a
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=13095

View file

@ -54,15 +54,15 @@
<para>In a nutshell, the compatibility allows FreeBSD users to run
about 90% of all Linux applications without modification. This
includes applications such as <application>Star Office</application>,
the Linux version of <application>Netscape</application>,
<application>Adobe Acrobat</application>,
includes applications such as <application>Star Office</application>,
the Linux version of <application>Netscape</application>,
<application>Adobe Acrobat</application>,
<application>RealPlayer</application>
5 and 7, <application>VMWare</application>,
5 and 7, <application>VMWare</application>,
<application>Oracle</application>,
<application>WordPerfect</application>, <application>Doom</application>,
<application>WordPerfect</application>, <application>Doom</application>,
<application>Quake</application>, and more. It is also reported
that in some situations, Linux binaries perform better on FreeBSD
that in some situations, Linux binaries perform better on FreeBSD
than they do under Linux.</para>
<indexterm>
<primary>Linux</primary>
@ -78,21 +78,31 @@
<para>After reading this chapter, you will know:</para>
<itemizedlist>
<listitem><para>How to enable Linux binary compatibility on your
system.</para></listitem>
<listitem><para>How to install additional Linux shared
libraries.</para></listitem>
<listitem><para>How to install Linux applications on your
FreeBSD system.</para></listitem>
<listitem><para>The implementation details of Linux
compatibility in FreeBSD.</para></listitem>
<listitem>
<para>How to enable Linux binary compatibility on your system.</para>
</listitem>
<listitem>
<para>How to install additional Linux shared
libraries.</para>
</listitem>
<listitem>
<para>How to install Linux applications on your FreeBSD system.</para>
</listitem>
<listitem>
<para>The implementation details of Linux compatibility in FreeBSD.</para>
</listitem>
</itemizedlist>
<para>Before reading this chapter, you should:</para>
<itemizedlist>
<listitem><para>Know how to install additional third-party
software (<xref linkend="ports">).</para></listitem>
<listitem>
<para>Know how to install additional third-party
software (<xref linkend="ports">).</para>
</listitem>
</itemizedlist>
</sect1>
@ -142,18 +152,18 @@ Id Refs Address Size Name
by adding <literal>options LINUX</literal> to your kernel
configuration file. Then install your new kernel as described in
<xref linkend="kernelconfig">.</para>
<sect2>
<title>Installing Linux Runtime Libraries</title>
<indexterm>
<primary>Linux</primary>
<primary>Linux</primary>
<secondary>installing Linux libraries</secondary>
</indexterm>
<para>This can be done one of two ways, either by using the
<link linkend="linuxemu-libs-port">linux_base</link> port, or
by installing them <link
linkend="linuxemu-libs-manually">manually</link>.</para>
<link linkend="linuxemu-libs-port">linux_base</link> port, or
by installing them <link
linkend="linuxemu-libs-manually">manually</link>.</para>
<sect3 id="linuxemu-libs-port">
<title>Installing Using the linux_base Port</title>
@ -214,7 +224,7 @@ Id Refs Address Size Name
<para>If you have access to a Linux system, see what shared
libraries the application needs, and copy them to your FreeBSD
system. Look at the following example:</para>
<informalexample>
<para>Let us assume you used FTP to get the Linux binary of
Doom, and put it on a Linux system you have access to. You
@ -289,7 +299,7 @@ libc.so.4 (DLL Jump 4.5pl26) =&gt; /lib/libc.so.4.6.29</screen>
<sect2>
<title>Installing Linux ELF Binaries</title>
<indexterm>
<primary>Linux</primary>
<primary>Linux</primary>
<secondary>ELF binaries</secondary>
</indexterm>
@ -327,7 +337,7 @@ Abort</screen>
<programlisting>order hosts, bind
multi on</programlisting>
<para>The order here specifies that <filename>/etc/hosts</filename>
is searched first and DNS is searched second. When
<filename>/compat/linux/etc/host.conf</filename> is not
@ -381,7 +391,7 @@ multi on</programlisting>
<title>Branding the Linux Binaries</title>
<para>The Linux binaries are located in the <filename>Unix</filename>
directory of the <application>Mathematica</application> CDROM
directory of the <application>Mathematica</application> CDROM
distributed by Wolfram. You
need to copy this directory tree to your local hard drive so that
you can brand the Linux binaries with &man.brandelf.1; before
@ -398,12 +408,12 @@ multi on</programlisting>
&prompt.root; <userinput>cd /localdir/Installers/Linux/</userinput>
&prompt.root; <userinput>./MathInstaller</userinput></screen>
<para>Alternatively, you can simply set the default ELF brand
to Linux for all unbranded binaries with the command:</para>
<screen>&prompt.root; <userinput>sysctl -w kern.fallback_elf_brand=3</userinput></screen>
<para>This will make FreeBSD assume that unbranded ELF binaries
use the Linux ABI and so you should be able to run the
installer straight from the CDROM.</para>
<para>Alternatively, you can simply set the default ELF brand
to Linux for all unbranded binaries with the command:</para>
<screen>&prompt.root; <userinput>sysctl -w kern.fallback_elf_brand=3</userinput></screen>
<para>This will make FreeBSD assume that unbranded ELF binaries
use the Linux ABI and so you should be able to run the
installer straight from the CDROM.</para>
</sect2>
<sect2>
@ -414,8 +424,8 @@ multi on</programlisting>
password from Wolfram that corresponds to your <quote>machine
ID</quote>.</para>
<indexterm>
<primary>Ethernet</primary>
<secondary>MAC address</secondary>
<primary>Ethernet</primary>
<secondary>MAC address</secondary>
</indexterm>
<para>Once you have installed the Linux compatibility runtime
@ -435,19 +445,19 @@ disco.example.com 7115-70839-20412</screen>
respond with a corresponding password consisting of groups of
numbers. You can then enter this information when you attempt to
run <application>Mathematica</application> for the first time
exactly as you would for any other
exactly as you would for any other
<application>Mathematica</application> platform.</para>
</sect2>
<sect2>
<title>Running the Mathematica Frontend over a Network</title>
<para><application>Mathematica</application> uses some special
<para><application>Mathematica</application> uses some special
fonts to display characters not
present in any of the standard font sets (integrals, sums, Greek
letters, etc.). The X protocol requires these fonts to be install
<emphasis>locally</emphasis>. This means you will have to copy
these fonts from the CDROM or from a host with
these fonts from the CDROM or from a host with
<application>Mathematica</application>
installed to your local machine. These fonts are normally stored
in <filename>/cdrom/Unix/Files/SystemFiles/Fonts</filename> on the
@ -646,7 +656,7 @@ FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \
PLATFORMS=i86_r ISSUER="Waterloo Maple Inc." \
ISSUED=11-may-2000 NOTICE=" Technische Universitat Wien" \
SN=XXXXXXXXX</programlisting>
<note><para>Serial number and key 'X''ed out. "chillig" is a
hostname.</para></note>
@ -681,10 +691,10 @@ FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \
Oracle 8.0.5.1 Enterprise Edition 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. These ports are added to the collection after the release
@ -699,7 +709,7 @@ FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \
also need to install the Red Hat Tcl package:
<filename>tcl-8.0.3-20.i386.rpm</filename>. The general command
for installing packages with the official RPM port 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>
@ -707,7 +717,7 @@ FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \
<sect2>
<title>Creating the Oracle Environment</title>
<para>Before you can install Oracle, 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
@ -716,7 +726,7 @@ FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \
<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
the maximum size of shared memory. Do not use
<literal>SHMMAX</literal> under FreeBSD. <literal>SHMMAX</literal>
@ -731,8 +741,8 @@ options SHMSEG=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 Oracle.</para>
<para>Also, make sure you have the following options in your kernel
config-file:</para>
@ -743,7 +753,7 @@ options SYSVMSG #SysV interprocess communication</programlisting>
</sect3>
<sect3 id="linuxemu-oracle-account">
<title>Oracle Account</title>
<para>Create an Oracle account just as you would create any other
@ -819,8 +829,8 @@ export PATH</programlisting>
</sect2>
<sect2>
<title>Installing Oracle</title>
<title>Installing Oracle</title>
<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
@ -845,13 +855,13 @@ export PATH</programlisting>
<sect3 id="linuxemu-patch-root">
<title>Patching root.sh</title>
<para>When installing Oracle, 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
written in the <filename>orainst</filename> directory. Apply the
following patch to root.sh, to have it use to proper location of
<command>chown</command> or alternatively run the script under a
<command>chown</command> or alternatively run the script under a
Linux native shell.</para>
<programlisting>*** orainst/root.sh.orig Tue Oct 6 21:57:33 1998
@ -880,8 +890,8 @@ export PATH</programlisting>
<sect3 id="linuxemu-patch-tcl">
<title>Patching genclntsh</title>
<para>The script <command>genclntsh</command> is used to create
<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>
@ -908,13 +918,13 @@ export PATH</programlisting>
<sect2>
<title>Running Oracle</title>
<para>When you have followed the instructions, you should be able to run
<application>Oracle</application> as if it was run on Linux
<application>Oracle</application> as if it was run on Linux
itself.</para>
</sect2>
</sect1>
<sect1 id="sapr3">
<sect1info>
<authorgroup>
@ -948,7 +958,7 @@ export PATH</programlisting>
<sect2 id="preface">
<title>Preface</title>
<para>This document describes a possible way of installing a
<para>This document describes a possible way of installing a
<application>SAP R/3-System</application>
with <application>Oracle Database</application>
for Linux onto a FreeBSD machine, including the installation
@ -969,14 +979,14 @@ export PATH</programlisting>
<para>Even though this document tries to describe all important
steps in a greater detail, it is not intended as a replacement
for the <application>Oracle</application> and
for the <application>Oracle</application> and
<application>SAP R/3</application> installation guides.</para>
<para>Please see the documentation that comes with the
<para>Please see the documentation that comes with the
<application>SAP R/3</application>
Linux edition for <application>SAP-</application> and
Linux edition for <application>SAP-</application> and
<application>Oracle</application>-specific questions, as well
as resources from <application>Oracle</application> and
as resources from <application>Oracle</application> and
<application>SAP OSS</application>.</para>
</sect2>
@ -989,98 +999,112 @@ export PATH</programlisting>
<title>SAP R/3 4.6B, Oracle 8.0.5</title>
<informaltable>
<tgroup cols=3>
<thead>
<row>
<entry>Name</entry> <entry>Number</entry> <entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>KERNEL</entry> <entry>51009113</entry> <entry>SAP Kernel Oracle /
Installation / AIX, Linux, Solaris</entry>
</row>
<row>
<entry>RDBMS</entry> <entry>51007558</entry> <entry>Oracle / RDBMS 8.0.5.X /
Linux</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51010208</entry> <entry>IDES / DB-Export /
Disc 1 of 6</entry>
</row>
<row>
<entry>EXPORT2</entry> <entry>51010209</entry> <entry>IDES / DB-Export /
Disc 2 of 6</entry>
</row>
<row>
<entry>EXPORT3</entry> <entry>51010210</entry> <entry>IDES / DB-Export /
Disc 3 of 6</entry>
</row>
<row>
<entry>EXPORT4</entry> <entry>51010211</entry> <entry>IDES / DB-Export /
Disc 4 of 6</entry>
</row>
<row>
<entry>EXPORT5</entry> <entry>51010212</entry> <entry>IDES / DB-Export /
Disc 5 of 6</entry>
</row>
<row>
<entry>EXPORT6</entry> <entry>51010213</entry> <entry>IDES / DB-Export /
Disc 6 of 6</entry>
</row>
</tbody>
</tgroup>
<tgroup cols=3>
<thead>
<row>
<entry>Name</entry> <entry>Number</entry> <entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>KERNEL</entry> <entry>51009113</entry> <entry>SAP Kernel Oracle /
Installation / AIX, Linux, Solaris</entry>
</row>
<row>
<entry>RDBMS</entry> <entry>51007558</entry> <entry>Oracle / RDBMS 8.0.5.X /
Linux</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51010208</entry> <entry>IDES / DB-Export /
Disc 1 of 6</entry>
</row>
<row>
<entry>EXPORT2</entry> <entry>51010209</entry> <entry>IDES / DB-Export /
Disc 2 of 6</entry>
</row>
<row>
<entry>EXPORT3</entry> <entry>51010210</entry> <entry>IDES / DB-Export /
Disc 3 of 6</entry>
</row>
<row>
<entry>EXPORT4</entry> <entry>51010211</entry> <entry>IDES / DB-Export /
Disc 4 of 6</entry>
</row>
<row>
<entry>EXPORT5</entry> <entry>51010212</entry> <entry>IDES / DB-Export /
Disc 5 of 6</entry>
</row>
<row>
<entry>EXPORT6</entry> <entry>51010213</entry> <entry>IDES / DB-Export /
Disc 6 of 6</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>Additionally, I used the <application>Oracle 8
Server</application> (Pre-production version 8.0.5 for Linux,
Kernel Version 2.0.33) CD which is not really necessary, and
Server</application> (Pre-production version 8.0.5 for Linux,
Kernel Version 2.0.33) CD which is not really necessary, and
of course FreeBSD 4.3-STABLE (it was only a few days past 4.3
RELEASE).</para>
RELEASE).</para>
</sect3>
<sect3 id="software-46c">
<title>SAP R/3 4.6C SR2, Oracle 8.1.7</title>
<title>SAP R/3 4.6C SR2, Oracle 8.1.7</title>
<informaltable>
<tgroup cols=3>
<thead>
<row>
<entry>Name</entry> <entry>Number</entry> <entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>KERNEL</entry> <entry>51014004</entry> <entry>SAP Kernel Oracle /
SAP Kernel Version 4.6D / DEC, Linux</entry>
</row>
<row>
<entry>RDBMS</entry> <entry>51012930</entry> <entry>Oracle 8.1.7/ RDBMS /
Linux</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51013953</entry> <entry>Release 4.6C SR2 / Export
/ Disc 1 of 4</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51013953</entry> <entry>Release 4.6C SR2 / Export
/ Disc 2 of 4</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51013953</entry> <entry>Release 4.6C SR2 / Export
/ Disc 3 of 4</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51013953</entry> <entry>Release 4.6C SR2 / Export
/ Disc 4 of 4</entry>
</row>
<row>
<entry>LANG1</entry> <entry>51013954</entry> <entry>Release 4.6C SR2 /
Language / DE, EN, FR / Disc 1 of 3</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<informaltable>
<tgroup cols=3>
<thead>
<row>
<entry>Name</entry> <entry>Number</entry> <entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>KERNEL</entry> <entry>51014004</entry> <entry>SAP Kernel Oracle /
SAP Kernel Version 4.6D / DEC, Linux</entry>
</row>
<row>
<entry>RDBMS</entry> <entry>51012930</entry> <entry>Oracle 8.1.7/ RDBMS /
Linux</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51013953</entry> <entry>Release 4.6C SR2 / Export
/ Disc 1 of 4</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51013953</entry> <entry>Release 4.6C SR2 / Export
/ Disc 2 of 4</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51013953</entry> <entry>Release 4.6C SR2 / Export
/ Disc 3 of 4</entry>
</row>
<row>
<entry>EXPORT1</entry> <entry>51013953</entry> <entry>Release 4.6C SR2 / Export
/ Disc 4 of 4</entry>
</row>
<row>
<entry>LANG1</entry> <entry>51013954</entry> <entry>Release 4.6C SR2 /
Language / DE, EN, FR / Disc 1 of 3</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>Depending on the languages you would like to install, additional
language CDs might be necessary. Here we're just using DE and EN, so
@ -1096,51 +1120,58 @@ export PATH</programlisting>
<title>SAP-Notes</title>
<para>The following notes should be read before installing
<application>SAP R/3</application> or proved to be useful
during installation:</para>
<application>SAP R/3</application> or proved to be useful
during installation:</para>
<sect3 id="sap-notes-46b">
<title>SAP R/3 4.6B, Oracle 8.0.5</title>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Number</entry>
<entry>Title</entry>
</row>
</thead>
<tbody>
<row>
<entry>0171356</entry> <entry>SAP Software on Linux: Essential
Comments</entry>
</row>
<row>
<entry>0201147</entry> <entry>INST: 4.6C R/3 Inst. on UNIX -
Oracle</entry>
</row>
<row>
<entry>0373203</entry> <entry>Update / Migration Oracle 8.0.5 -->
8.0.6/8.1.6 LINUX</entry>
</row>
<row>
<entry>0072984</entry> <entry>Release of Digital UNIX 4.0B for
Oracle</entry>
</row>
<row>
<entry>0130581</entry> <entry>R3SETUP step DIPGNTAB terminates</entry>
</row>
<row>
<entry>0144978</entry> <entry>Your system has not been installed
correctly</entry>
</row>
<row>
<entry>0162266</entry> <entry>Questions and tips for R3SETUP on Windows
NT / W2K</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Number</entry>
<entry>Title</entry>
</row>
</thead>
<tbody>
<row>
<entry>0171356</entry> <entry>SAP Software on Linux: Essential
Comments</entry>
</row>
<row>
<entry>0201147</entry> <entry>INST: 4.6C R/3 Inst. on UNIX -
Oracle</entry>
</row>
<row>
<entry>0373203</entry> <entry>Update / Migration Oracle 8.0.5 -->
8.0.6/8.1.6 LINUX</entry>
</row>
<row>
<entry>0072984</entry> <entry>Release of Digital UNIX 4.0B for
Oracle</entry>
</row>
<row>
<entry>0130581</entry> <entry>R3SETUP step DIPGNTAB terminates</entry>
</row>
<row>
<entry>0144978</entry> <entry>Your system has not been installed
correctly</entry>
</row>
<row>
<entry>0162266</entry> <entry>Questions and tips for R3SETUP on Windows
NT / W2K</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect3>
<sect3 id="sap-notes-46c">