From 755ed6b05cf636334224846e86bf8acbf186d801 Mon Sep 17 00:00:00 2001
From: gferg <>
Date: Mon, 31 Jul 2000 13:25:41 +0000
Subject: [PATCH] updated
---
LDP/howto/docbook/DB2-HOWTO.sgml | 209 +++++++++++++++++++++++++++----
1 file changed, 187 insertions(+), 22 deletions(-)
diff --git a/LDP/howto/docbook/DB2-HOWTO.sgml b/LDP/howto/docbook/DB2-HOWTO.sgml
index ef6e591b..cef4be13 100644
--- a/LDP/howto/docbook/DB2-HOWTO.sgml
+++ b/LDP/howto/docbook/DB2-HOWTO.sgml
@@ -9,11 +9,12 @@
dbs
- 0.7
- May 26, 2000
+ 1.1
+ July 28, 2000
dbs
- 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.
+ Documented _SHM_ID_BITS kernel parameter tuning for increasing
+ number of available connections. Added basic indexing.
+
1.0
@@ -23,6 +24,13 @@
grammatical mistakes. Licensed document under GNU GPL. Submitted document to LDP.
+
+ 0.7
+ May 26, 2000
+ dbs
+ 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.
+
@@ -236,6 +244,9 @@ suffering the wrath of his girlfriend.
What are prerequisites?
+installation prerequisites
+prerequisites for installation
+
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.
-Web browser
+
+
+browser prerequisite
+web browser prerequisite
+
+Web browser
DB2 calls the netscape command when you:
@@ -1814,6 +1830,8 @@ while installing DB2, creating an instance, or using a DB2 database.
Problems with DB2 installation
+installationtroubleshooting
+
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:
Problems creating a DB2 instance
+
+instance creationtroubleshooting
+creating DB2 instancestroubleshooting
+
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.
+
+connectiontroubleshooting
+kerneloptimizing parameters
+
@@ -1988,9 +2014,37 @@ when you use a DB2 database.
-The number of connections that DB2 can support depends on two #define
-variables included in the kernel source header files.
+The number of connections that DB2 can support depends on three #define
+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.
+
+_SHM_ID_BITS
+
+
+This variable, defined in /usr/src/linux/include/asm/shmparam.h,
+determines the number of shared memory segment identifiers available to Linux. The
+default value for _SHM_ID_BITS in the kernel source
+is 7, which allows for a total of 2^7, or 128,
+shared memory segment identifiers.
+
+
+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 (FCM) feature
+of DB2. Because each DB2 connection requires one agent per processor,
+on a quad-processor machine the default value of _SHM_ID_BITS
+allows less than 32 simultaneous connections to a DB2 instance.
+
+
+If you recompile the kernel yourself, you should be able to safely
+increase this value to 9.
+
+
+
+
NR_TASKS
@@ -2007,12 +2061,11 @@ The default value for NR_TASKS in the kernel source is NR_TASKS to
-2560, thus allowing 1280 connections for a single DB2 instance.
-However, Caldera OpenLinux 2.4 ships with a kernel in which NR_TASKS
-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 NR_TASKS to 2560 or above.
+However, Caldera OpenLinux eDesktop 2.4 ships with a kernel in which NR_TASKS
+is set to the default value of 512. Caldera users should increase the value
+of this variable and recompile the kernel.
@@ -2033,21 +2086,114 @@ The default value for SEMMNI in the kernel source is
-
-
-
-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.
-
-
-
+
+
+
+kernelparameter defaults
+
+
+Default kernel parameter values, by distribution
+
+
+
+
+
+
+
+
+
+
+ Kernel Parameter
+ Kernel Source
+ Caldera OpenLinux eDesktop 2.4
+ Caldera OpenLinux eServer 2.3
+ Red Hat 6.2
+ SuSE 6.2
+ SuSE 6.3
+ TurboLinux 6.0
+
+
+
+
+ _SHM_ID_BITS
+ 7
+ 7
+ 7
+
+ kernel-2.2.14-5
+ 7
+ kernel-2.2.14-12
+ 9
+ kernel-2.2.16-3
+ 9
+
+ Unknown
+ Unknown
+
+ kernel-2.2.14-5
+ 7
+ kernel-2.2.16-0.4
+ 7
+
+
+
+ NR_TASKS
+ 512
+ 512
+ 512
+
+ kernel-2.2.14-5
+ 2560
+ kernel-2.2.14-12
+ 2560
+ kernel-2.2.16-3
+ 4090
+
+ Unknown
+ Unknown
+
+ kernel-2.2.14-5
+ 2560
+ kernel-2.2.16-0.4
+ 2560
+
+
+
+ SEMMNI
+ 128
+ 128
+ 128
+
+ kernel-2.2.14-5
+ 128
+ kernel-2.2.14-12
+ 512
+ kernel-2.2.16-3
+ 512
+
+ Unknown
+ Unknown
+
+ kernel-2.2.14-5
+ 128
+ kernel-2.2.16-0.4
+ 128
+
+
+
+
+
+
+
+Control Centertroubleshooting
+
When I start the DB2 Control Center, I get a message box with the
@@ -2056,7 +2202,7 @@ error SQL1042C An unexpected system error occurred.
-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.
+
+Control Centertroubleshooting
+
The DB2 Control Center starts normally, but the "Systems" folder is empty.
@@ -2087,6 +2236,9 @@ because no local DB2 Administration Server can be available.
+
+Control Centertroubleshooting
+
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
+
+commandstroubleshooting
+db2 commandstroubleshooting
+
@@ -2140,6 +2296,10 @@ login. For instructions on how to remove or modify this output, see
Installing the IBM Developer Kit for Java
+Javainstalling
+JDKinstalling
+JREinstalling
+
This section gives you quick and dirty instructions on how to install the
IBM Developer Kit for Java, version 1.1.8. You need this version to run
@@ -2303,7 +2463,12 @@ includes online discussion forums and links to other DB2 resources.
+
+
+GPL
+GNU General Public License
+
GNU General Public License