This commit is contained in:
gferg 2000-07-31 13:25:41 +00:00
parent a1a7869a40
commit 755ed6b05c
1 changed files with 187 additions and 22 deletions

View File

@ -9,11 +9,12 @@
<authorinitials>dbs</authorinitials>
<revhistory>
<revision>
<revnumber>0.7</revnumber>
<date>May 26, 2000</date>
<revnumber>1.1</revnumber>
<date>July 28, 2000</date>
<authorinitials>dbs</authorinitials>
<revremark>Based on DB2 V7.1 beta release, wrote install instructions for
Caldera 2.4, Red Hat 6.2, SuSE 6.2, SuSE 6.3, and TurboLinux 6.0.</revremark>
<revremark>Documented _SHM_ID_BITS kernel parameter tuning for increasing
number of available connections. Added basic indexing.
</revremark>
</revision>
<revision>
<revnumber>1.0</revnumber>
@ -23,6 +24,13 @@
grammatical mistakes. Licensed document under GNU GPL. Submitted document to LDP.
</revremark>
</revision>
<revision>
<revnumber>0.7</revnumber>
<date>May 26, 2000</date>
<authorinitials>dbs</authorinitials>
<revremark>Based on DB2 V7.1 beta release, wrote install instructions for
Caldera 2.4, Red Hat 6.2, SuSE 6.2, SuSE 6.3, and TurboLinux 6.0.</revremark>
</revision>
</revhistory>
<abstract>
@ -236,6 +244,9 @@ suffering the wrath of his girlfriend.
<sect2>
<title>What are prerequisites?</title>
<indexterm><primary>installation prerequisites</primary></indexterm>
<indexterm><primary>prerequisites for installation</primary></indexterm>
<para>
Prerequisites are what you, your machine, and your distribution
require before you will be able to successfully install or use DB2.
@ -397,7 +408,12 @@ and get the IBM Developer Kit for Java.
</varlistentry>
<varlistentry>
<term>Web browser</term>
<term>
<indexterm><primary>browser prerequisite</primary></indexterm>
<indexterm><primary>web browser prerequisite</primary></indexterm>
Web browser</term>
<listitem>
<para>
DB2 calls the <command>netscape</command> command when you:
@ -1814,6 +1830,8 @@ while installing DB2, creating an instance, or using a DB2 database.
<sect2 id="tsinstall">
<title>Problems with DB2 installation</title>
<indexterm><primary>installation</primary><secondary>troubleshooting</secondary></indexterm>
<para>
The following section covers some of the common problems you may encounter
when you install DB2.
@ -1870,6 +1888,10 @@ To update all existing DB2 instances, issue the following command as root:
<sect2>
<title>Problems creating a DB2 instance</title>
<indexterm><primary>instance creation</primary><secondary>troubleshooting</secondary></indexterm>
<indexterm><primary>creating DB2 instances</primary><secondary>troubleshooting</secondary></indexterm>
<para>
The following section covers some of the common problems you may encounter
when you create a DB2 instance.
@ -1980,6 +2002,10 @@ The following section covers some of the common problems you may encounter
when you use a DB2 database.
</para>
<indexterm><primary>connection</primary><secondary>troubleshooting</secondary></indexterm>
<indexterm><primary>kernel</primary><secondary>optimizing parameters</secondary></indexterm>
<qandaset>
<qandaentry>
<question>
@ -1988,9 +2014,37 @@ when you use a DB2 database.
<answer>
<para>
The number of connections that DB2 can support depends on two <literal>#define</literal>
variables included in the kernel source header files.
The number of connections that DB2 can support depends on three <literal>#define</literal>
variables included in the kernel source header files. Following the description of these
variables is a table listing the default values by distribution. The table includes the values
of these variables in the updated kernel packages for each distribution.
<variablelist>
<varlistentry>
<term>_SHM_ID_BITS</term>
<listitem>
<para>
This variable, defined in <filename>/usr/src/linux/include/asm/shmparam.h</filename>,
determines the number of shared memory segment identifiers available to Linux. The
default value for <literal>_SHM_ID_BITS</literal> in the kernel source
is <literal>7</literal>, which allows for a total of 2^7, or 128,
shared memory segment identifiers.
</para>
<para>
On a single-processor machine, DB2 itself uses a set number (~15) of
shared memory segment identifiers. On a machine with multiple processors,
DB2 also requires one shared memory segment identifier per agent to take
advantage of the Fast Communication Manager (<acronym>FCM</acronym>) feature
of DB2. Because each DB2 connection requires one agent per processor,
on a quad-processor machine the default value of <literal>_SHM_ID_BITS</literal>
allows less than 32 simultaneous connections to a DB2 instance.
</para>
<para>
If you recompile the kernel yourself, you should be able to safely
increase this value to <literal>9</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>NR_TASKS</term>
<listitem>
@ -2007,12 +2061,11 @@ The default value for <literal>NR_TASKS</literal> in the kernel source is <liter
allowing a maximum of 256 simultaneous connections to a single DB2 instance.
DB2 itself requires a few connections for overhead processes.
If you recompile the kernel yourself, you should increase this value to something like 2048.
Thankfully, the stock kernels shipped with the Red Hat 6.1, Red Hat 6.2, SuSE 6.2, SuSE 6.3, and
TurboLinux 6.0 distributions set the value of <literal>NR_TASKS</literal> to
<literal>2560</literal>, thus allowing 1280 connections for a single DB2 instance.
However, Caldera OpenLinux 2.4 ships with a kernel in which <literal>NR_TASKS</literal>
is set to the default value of 512. Caldera users may want to consider recompiling the
kernel.
The stock kernels shipped with the Red Hat, SuSE, and TurboLinux distributions
increase the value of <literal>NR_TASKS</literal> to 2560 or above.
However, Caldera OpenLinux eDesktop 2.4 ships with a kernel in which <literal>NR_TASKS</literal>
is set to the default value of 512. Caldera users should increase the value
of this variable and recompile the kernel.
</para>
</listitem>
</varlistentry>
@ -2033,21 +2086,114 @@ The default value for <literal>SEMMNI</literal> in the kernel source is <literal
which, on a quad-processor machine, will only allow 32 simultaneous connections to a DB2 instance.
If you recompile the kernel yourself, increase this value to something like 1024.
</para>
<para>
<note>
<para>
To be added: the value of this variable in the stock kernels shipped with the Caldera OpenLinux 2.4,
Red Hat 6.2, SuSE 6.2, SuSE 6.3, and TurboLinux 6.0 distributions.
</para>
</note>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<indexterm><primary>kernel</primary><secondary>parameter defaults</secondary></indexterm>
<table frame="all">
<title>Default kernel parameter values, by distribution</title>
<tgroup cols="6" align="center" colsep="1" rowsep="1">
<colspec colname="c1">
<colspec colname="c2">
<colspec colname="c3">
<colspec colname="c4">
<colspec colname="c5">
<colspec colname="c6">
<colspec colname="c7">
<thead>
<row>
<entry>Kernel Parameter</entry>
<entry>Kernel Source</entry>
<entry>Caldera OpenLinux eDesktop 2.4</entry>
<entry>Caldera OpenLinux eServer 2.3</entry>
<entry>Red Hat 6.2</entry>
<entry>SuSE 6.2</entry>
<entry>SuSE 6.3</entry>
<entry>TurboLinux 6.0</entry>
</row>
</thead>
<tbody>
<row>
<entry>_SHM_ID_BITS</entry>
<entry><literal>7</literal></entry>
<entry><literal>7</literal></entry>
<entry><literal>7</literal></entry>
<entry><simplelist type="horiz" columns="2">
<member>kernel-2.2.14-5</member>
<member><literal>7</literal></member>
<member>kernel-2.2.14-12</member>
<member><literal>9</literal></member>
<member>kernel-2.2.16-3</member>
<member><literal>9</literal></member>
</simplelist></entry>
<entry>Unknown</entry>
<entry>Unknown</entry>
<entry><simplelist type="horiz" columns="2">
<member>kernel-2.2.14-5</member>
<member><literal>7</literal></member>
<member>kernel-2.2.16-0.4</member>
<member><literal>7</literal></member>
</simplelist></entry>
</row>
<row>
<entry>NR_TASKS</entry>
<entry><literal>512</literal></entry>
<entry><literal>512</literal></entry>
<entry><literal>512</literal></entry>
<entry><simplelist type="horiz" columns="2">
<member>kernel-2.2.14-5</member>
<member><literal>2560</literal></member>
<member>kernel-2.2.14-12</member>
<member><literal>2560</literal></member>
<member>kernel-2.2.16-3</member>
<member><literal>4090</literal></member>
</simplelist></entry>
<entry>Unknown</entry>
<entry>Unknown</entry>
<entry><simplelist type="horiz" columns="2">
<member>kernel-2.2.14-5</member>
<member><literal>2560</literal></member>
<member>kernel-2.2.16-0.4</member>
<member><literal>2560</literal></member>
</simplelist></entry>
</row>
<row>
<entry>SEMMNI</entry>
<entry><literal>128</literal></entry>
<entry><literal>128</literal></entry>
<entry><literal>128</literal></entry>
<entry><simplelist type="horiz" columns="2">
<member>kernel-2.2.14-5</member>
<member><literal>128</literal></member>
<member>kernel-2.2.14-12</member>
<member><literal>512</literal></member>
<member>kernel-2.2.16-3</member>
<member><literal>512</literal></member>
</simplelist></entry>
<entry>Unknown</entry>
<entry>Unknown</entry>
<entry><simplelist type="horiz" columns="2">
<member>kernel-2.2.14-5</member>
<member><literal>128</literal></member>
<member>kernel-2.2.16-0.4</member>
<member><literal>128</literal></member>
</simplelist></entry>
</row>
</tbody>
</tgroup>
</table>
</answer>
</qandaentry>
<indexterm><primary>Control Center</primary><secondary>troubleshooting</secondary></indexterm>
<qandaentry>
<question>
<para><emphasis>When I start the DB2 Control Center, I get a message box with the
@ -2056,7 +2202,7 @@ error <computeroutput>SQL1042C An unexpected system error occurred.</computerout
</question>
<answer>
<para>
This error occurs only the first time you start the Control Center. Note that
On most systems, this error occurs only the first time you start the Control Center. Note that
the message box may be mostly covered up by the pretty DB2 splash screen;
if this is the case, you have to move the error message window down
and press the "Close" button. The Control Center then starts correctly, and you should
@ -2065,6 +2211,9 @@ not get the error message again.
</answer>
</qandaentry>
<indexterm><primary>Control Center</primary><secondary>troubleshooting</secondary></indexterm>
<qandaentry>
<question>
<para><emphasis>The DB2 Control Center starts normally, but the "Systems" folder is empty.</emphasis></para>
@ -2087,6 +2236,9 @@ because no local DB2 Administration Server can be available.
</answer>
</qandaentry>
<indexterm><primary>Control Center</primary><secondary>troubleshooting</secondary></indexterm>
<qandaentry>
<question>
<para><emphasis>When I try to start the DB2 Control Center with
@ -2116,6 +2268,10 @@ For a quick guide to installing the IBM Developer Kit for Java, see
</answer>
</qandaentry>
<indexterm><primary>commands</primary><secondary>troubleshooting</secondary></indexterm>
<indexterm><primary>db2 commands</primary><secondary>troubleshooting</secondary></indexterm>
<qandaentry>
<question>
<para><emphasis>
@ -2140,6 +2296,10 @@ login. For instructions on how to remove or modify this output, see
<sect1 id="jdkinstall">
<title>Installing the IBM Developer Kit for Java</title>
<indexterm><primary>Java</primary><secondary>installing</secondary></indexterm>
<indexterm><primary>JDK</primary><secondary>installing</secondary></indexterm>
<indexterm><primary>JRE</primary><secondary>installing</secondary></indexterm>
<para>
This section gives you quick and dirty instructions on how to install the
IBM Developer Kit for Java, version <literal>1.1.8</literal>. You need this version to run
@ -2303,7 +2463,12 @@ includes online discussion forums and links to other DB2 resources.
</variablelist>
</para>
</appendix>
<appendix id="gpl">
<indexterm><primary>GPL</primary></indexterm>
<indexterm><primary>GNU General Public License</primary></indexterm>
<title>GNU General Public License</title>
<blockquote>
<para>