9. Troubleshooting

The following section covers some of the common problems you may encounter while installing DB2, creating an instance, or using a DB2 database.

9.1. Problems with DB2 installation

The following section covers some of the common problems you may encounter when you install DB2.

9.1.1. When I try to run db2setup, I get the following error: DBI1503E An error was encountered when opening or writing to file, "/tmp/.dbinst.swp".
9.1.2. When I try to run db2setup, I get the following error: ./db2inst: error while loading shared libraries: libncurses.so.4: cannot open shared object file: No such file or directory
9.1.3. Creating a DB2 instance on SuSE Linux: Default user name already exists
9.1.4. Creating a DB2 instance on SuSE Linux: Default group name already exists
9.1.5. Creating a DB2 instance on SuSE Linux: Default home directory points to /usr/lib/db2/
9.1.6. After creating a DB2 instance, I installed the Application Development Client, but I can't use that instance to create DB2 applications.
9.1.7. I installed DB2, but none of the permissions in /usr/IBMdb2/V7.1/bin are executable!

9.1.1. When I try to run db2setup, I get the following error: DBI1503E An error was encountered when opening or writing to file, "/tmp/.dbinst.swp".

DB2 issues this error when it can't find the pdksh or ksh shells. This has probably occurred because you did not install the pdksh package for your distribution. See Section 3 for more details on installing the pdksh package for your Linux distribution.

9.1.2. When I try to run db2setup, I get the following error: ./db2inst: error while loading shared libraries: libncurses.so.4: cannot open shared object file: No such file or directory

DB2 issues this error when it can't find the libncurses.so.4 library. Red Hat 7 does not include this level of the library in their standard ncurses-5.1-2 package, requiring that you install the ncurses4-5.0-2 library for backwards compatibility.

9.1.3. Creating a DB2 instance on SuSE Linux: Default user name already exists

If you did not remove the default DB2 user IDs created by SuSE Linux before installing DB2 (see Section 3.4), the DB2 Create Instance panel places the corresponding user ID in the "User ID" field. This can cause a problem when you change the value of the User Name field to reflect the name of the new instance, because the value of the "User ID" still reflects the original user name.

Ensure that you select the "Use default UID" check box to automatically associate the new user name with its corresponding user ID.

9.1.4. Creating a DB2 instance on SuSE Linux: Default group name already exists

If you did not remove the default DB2 user IDs created by SuSE Linux before installing DB2 (see Section 3.4), the DB2 Create Instance panel places the corresponding group ID in the Group ID field. This can cause a problem when you change the value of the Group Name field to reflect the name of the new instance, because the value of the Group ID still reflects the original group name.

Ensure that you select the "Use default GID" check box to automatically associate the new group name with its corresponding group ID.

9.1.5. Creating a DB2 instance on SuSE Linux: Default home directory points to /usr/lib/db2/

If you did not remove the default DB2 user IDs created by SuSE Linux before installing DB2 (see Section 3.4), the default user name already exists and was created in the /usr/lib/db2/ directory. To change the home directory of your new DB2 instance, you must manually specify the location of the new instance. The default home directory is /home/.

9.1.6. After creating a DB2 instance, I installed the Application Development Client, but I can't use that instance to create DB2 applications.

When you add the Application Development Client after you initially install DB2 and create a DB2 instance, your existing DB2 instance won't recognize the db2 prep command. Instead, DB2 returns the following error: DB21051E The command is not supported for this environment.

The problem is that when you install a new DB2 component, DB2 does not automatically update existing DB2 instances to include links to the new libraries and executables. To update an existing DB2 instance, use the db2iupdt command as root:
bash# /usr/IBMdb2/V7.1/instance/db2iupdt instance-name
To update all existing DB2 instances, issue the following command as root:
bash# /usr/IBMdb2/V7.1/instance/db2iupdt -e

9.1.7. I installed DB2, but none of the permissions in /usr/IBMdb2/V7.1/bin are executable!

When you create an instance, as described in Section 6, DB2 copies selected files from /usr/IBMdb2/V7.1/bin into the $HOME/sqllib/bin directory of the instance. DB2 sets the appropriate permissions on the copies of the files in the instance directory.

9.2. Problems creating a DB2 instance

The following section covers some of the common problems you may encounter when you create a DB2 instance.

9.2.1. Creating a DB2 instance or a DB2 Administration Server fails.
9.2.2. db2setup indicated that it successfully created an instance, but I checked /tmp/db2install.log and it contains the message DBI1766W Cannot change the secondary group list of "" (Caldera OpenLinux 2.4).

9.2.1. Creating a DB2 instance or a DB2 Administration Server fails.

DB2 often fails to create an instance because you became root by issuing the command bash$ su root rather than bash$ su -l root, which uses the environment settings for the root account. Check the contents of the DB2 install log in /tmp/db2setup.log. If the installer has issued the following error message:
  DBI1517E An attempt to execute a command in a subprocess failed.

  Explanation: An error was detected when attempting to execute a command in a subprocess. One of the
  following problems occurred: 

      o The command does not exist. 
      o Incomplete command search path. 
      o Incorrect access permissions on the command. 
      o System resource problem. 
then most likely your root account did not have the /usr/sbin directory in the PATH environment variable for root.

PATH is normally set correctly for you if you log in as root, or issue the command bash$ su -l root to become root. You can add /usr/sbin to the PATH environment variable by issuing the following command at the terminal prompt, or including it in /root/.bashrc:
  export PATH=$PATH:/usr/sbin

9.2.2. db2setup indicated that it successfully created an instance, but I checked /tmp/db2install.log and it contains the message DBI1766W Cannot change the secondary group list of "" (Caldera OpenLinux 2.4).

This is one area where DB2 and Caldera OpenLinux don't work well together. Fix this by manually adding each instance user ID to the group you defined during instance creation. Here's the full help from the IBM DB2 Message Reference:
      DBI1766W Cannot change the secondary group list of 
                "".  

      Explanation:  A code, "", is returned when attempting to 
      change the secondary group list of the given user ID. One of the 
      following situations has occurred: 

      o  NIS is running.  

      o  One or more processes are currently being executed under the  
          given user ID.  

      User Response:  You must add the group ID, "", to the 
      secondary group list of the user ID, "", so that the 
      Adminstration Server can function properly.  

      o  If there happens to be any process run under the given user   
          ID, terminate all of these processes and follow the   
          instructions above to setup the secondary group list of this  
          user ID.  

      o  If you are running this command on an NIS client, try the    
          above instructions to setup the secondary group list of this  
          user ID on your NIS server.
For instructions on how to add user IDs to groups, see Section 3.1.3.1.

9.3. Problems using DB2

The following section covers some of the common problems you may encounter when you use a DB2 database.

9.3.1. DB2 is running out of available connections.
9.3.2. I installed DB2 Version 6.1 and db2start just hangs.
9.3.3. I'm using DB2 PE 7.1 on linux (RH 6.0), and I'm having problems when trying to connect with my username and password. I can connect successfully to the database with the default user ID:
bash$ db2 connect to sample

Database Connection Information

Database server        = DB2/LINUX 7.1.0
SQL authorization ID   = userID
Local database alias   = SAMPLE
But when I try to connect to the database using the explicit user ID, it fails:
bash$ db2 CONNECT TO sample USER userID
Enter current password for userID:
SQL1403N  The username and/or password supplied is incorrect.
SQLSTATE=08004
Why can't I connect with an explicit user ID?
9.3.4. When I start the DB2 Control Center, I get a message box with the error SQL1042C An unexpected system error occurred.
9.3.5. The DB2 Control Center starts normally, but the "Systems" folder is empty.
9.3.6. When I try to start the DB2 Control Center, I get the following message at the console: Xlib: connection to "localhost:0.0" refused by server
9.3.7. When I start the DB2 Control Center, I get a message box with the error SQL1042C An unexpected system error occurred.
9.3.8. When I try to start the DB2 Control Center with the db2cc command, the splash screen comes up, then disappears.
9.3.9. When I run any db2 commands, part of the output is Welcome to your OpenLinux system!. How do I change this? (Caldera OpenLinux 2.4)

9.3.1. DB2 is running out of available connections.

You probably need to adjust some kernel parameters. For more information, see Section 10.

9.3.2. I installed DB2 Version 6.1 and db2start just hangs.

Hey! I said I wasn't going to include any DB2 Version 6.1 information! Oh well, this is one of the most frequently asked questions about 6.1, so here's a short answer: you need to install a recent DB2 FixPack. The initial release of DB2 Version 6.1 ran into incompatibilities with distributions built on glibc 2.1. For a full description of the problem, and the correct install procedure, refer to IBM Support document 1000814: db2start hangs on Linux distributions built with glibc 2.1.

9.3.3. I'm using DB2 PE 7.1 on linux (RH 6.0), and I'm having problems when trying to connect with my username and password. I can connect successfully to the database with the default user ID:
bash$ db2 connect to sample

Database Connection Information

Database server        = DB2/LINUX 7.1.0
SQL authorization ID   = userID
Local database alias   = SAMPLE
But when I try to connect to the database using the explicit user ID, it fails:
bash$ db2 CONNECT TO sample USER userID
Enter current password for userID:
SQL1403N  The username and/or password supplied is incorrect.
SQLSTATE=08004
Why can't I connect with an explicit user ID?

Check the ownership and permissions on the db2ckpw program. They should look like this:
bash$ ls -al ~/sqllib/security/db2ckpw 
-rwsr-s--x    1 root     build       15989 Oct 17 07:22 sqllib/security/db2ckpw*
If this program is not owned by root, then do the following as root:
bash# chown root db2ckpw
bash# chmod ug+s db2ckpw

9.3.4. When I start the DB2 Control Center, I get a message box with the error SQL1042C An unexpected system error occurred.

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 not get the error message again.

9.3.5. The DB2 Control Center starts normally, but the "Systems" folder is empty.

If the Control Center displays an empty "Systems" folder, you might need to catalog the DB2 Administration Server manually for the local instance from which you are trying to run the Control Center. This assumes that you have created the DB2 Administration Server instance before starting the Control Center.

To catalog the DB2 Administration Server, issue the following command:
bash$ db2 catalog admin local node machine-name instance Administration-Server-name system machine-name ostype linux
Now restart the Control Center. Your local system is now displayed under the "Systems" folder. Do not try this from a client-only install of DB2, because no local DB2 Administration Server can be available.

9.3.6. When I try to start the DB2 Control Center, I get the following message at the console: Xlib: connection to "localhost:0.0" refused by server

This normally indicates an X permissions problem that occurs when you log on as one user, then su to the DB2 instance owner so that you can start the DB2 Control Center. By default, most X servers do not recognize 'localhost' as a client that is allowed to initiate an X app on your display; it will only recognize your real hostname. If xauth is set up, then it will complain if a user ID other than the one that started X tries to invoke an X application.There are a few things you can try:

  • Before su'ing to the DB2 instance owner, issue the command bash$ xhost +localhost: this tells your X server that 'localhost' is allowed to start X apps on your display. Then su to the DB2 instance owner and start the Control Center.

  • Log out completely, then log on directly as the DB2 instance owner and start the Control Center. You may still have to issue the command bash$ xhost +localhost before the Control Center will start--recent distributions have added this extra level of security.

  • Look into the xauth command and add your primary user ID's ~/.Xauthority file to your DB2 instance owner's xauth authority database. I believe it's the xauth merge command that you want.

9.3.7. When I start the DB2 Control Center, I get a message box with the error SQL1042C An unexpected system error occurred.

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 not get the error message again.

9.3.8. When I try to start the DB2 Control Center with the db2cc command, the splash screen comes up, then disappears.

On Caldera, the Control Center didn't work for me until I added the instance user IDs to the appropriate groups. For more information, see Section 3.1.3.1.

Ensure that you have installed the IBM Developer Kit for Java, and that the directory containing the jre or java executable is in your path. If you issue the command
bash$ java -fullversion
, you should get a response like this: java full version "JDK 1.1.8 IBM build l118-20000325 (JIT enabled: jitc)" or, for the IBM JDK 1.3: java full version "J2RE 1.3.0 IBM build cx130-20000623" Java virtual machines from other sources may not work. For a quick guide to installing the IBM Developer Kit for Java, see Section 11.

9.3.9. When I run any db2 commands, part of the output is Welcome to your OpenLinux system!. How do I change this? (Caldera OpenLinux 2.4)

Caldera OpenLinux includes this annoying message as part of their default login. For instructions on how to remove or modify this output, see Section 3.1.3.3.