Troubleshooting a database connectionAdded by IBM on February 11, 2013 | Version 1 (Original)
|A faulty JDBC driver or data source can prevent you from accessing an IBM® Connections application. To troubleshoot and correct these problems, test the database connections.
Before you begin
If you encounter an HTTP 500 - Internal Server Error when attempting to access an IBM
Connections application for the first time, ensure that you are using the correct web address. If the web address is correct and you still experience problems, continue with this task.
(Oracle only) Ensure that the Statement cache size for the data sources on WebSphere Application Server is no larger than 50. A higher value could lead to Out Of Memory errors on the application server instance.
About this task
To test a database connection, complete the following steps:
- Log in to the WebSphere® Application Server Integrated Solutions Console of the Deployment Manager.
- Select Resources -> JDBC -> Data sources.
- Click a data source and check the values of the database name, server name, and port number. If you discover an error, change the incorrect value. Click OK and Save, and then retest the database connection.
- Select the check box beside the application whose data source you want to test. The data sources are named as follows:
Click Test connection.
If the connection fails, make sure the JAAS Auth alias information is correct.
- Activities: activities
- Blogs: blogs
- Communities: communities
- Bookmarks: dogear
- Files: files
- Forums: forums
- Home page: homepage
- Metrics: metrics
- Mobile: mobile
- News: news
- OAuth: oauth provider
- Profiles: profiles
- Search: search
- Wikis: wikis
- Click a data source to review its settings.
- Click JAAS - J2C authentication data and then click the JAAS entry for the application. The JAAS entries are named as follows:
Make sure that the ID in the user ID field is the same User ID that you provided during installation when you were asked to specify a user ID for the database connector.
- Activities: activitiesJAASAuth
- Blogs: blogsJAASAuth
- Communities: communitiesJAASAuth
- Bookmarks: dogearJAASAuth
- Files: filesJAASAuth
- Forums: forumJAASAuth
- Home page: homepageJAASAuth
- Metrics: metricsJAASAuth
- Mobile: mobileJAASAuth
- News: newsJAASAuth
- Profiles: profilesJAASAuth
- Search: searchJAASAuth
- Wikis: wikisJAASAuth
After applying any changes, click OK. Return to the data source properties page, and then click Test connection.
The user ID should be one of the following default IDs:
Table 1. Default user ID for IBM Connections databases
|Application||DB2® database||DB2 User ID||Oracle database||Oracle User ID||SQL Server database||SQL Server User ID|
|Blogs||BLOGS ||lcuser||ORCL||BLOGS||BLOGS ||BLOGSUSER|
|Communities||SNCOMM ||lcuser||ORCL||SNCOMMUSER||SNCOMM ||SNCOMMUSER|
|Dogear||DOGEAR ||lcuser||ORCL||DOGEARUSER||DOGEAR ||DOGEARUSER|
|Files||FILES ||lcuser||ORCL||FILESUSER||FILES ||FILESUSER|
|Mobile||MOBILE||lcuser||ORCL||MOBILEUSER ||MOBILE||MOBILEUSER |
|Profiles||PEOPLEDB ||lcuser||ORCL||PROFUSER||PEOPLEDB ||PROFUSER|
|Wikis||WIKIS ||lcuser||ORCL||WIKISUSER||WIKIS ||WIKISUSER|
Consider reentering the password to make sure that the value that you specified at installation is correct.
If the connection fails again, make sure the JDBC driver library location information is being detected by WebSphere Application Server.
- From the Integrated Solution Console navigation bar, expand Environment, and then click WebSphere Variables.
- Scroll down the list to find the database location variable. The variables are named as follows:
Ensure that the corresponding file path in the Value column is the same file path that you specified in the JDBC driver library field when you ran the installation wizard. For example:
- Activities: ACTIVITIES_JDBC_DRIVER_HOME
- Blogs: BLOGS_JDBC_DRIVER_HOME
- Communities: COMMUNITIES_JDBC_DRIVER_HOME
- Dogear: DOGEAR_JDBC_DRIVER_HOME
- Files: FILES_JDBC_DRIVER_HOME
- Forums: FORUMS_JDBC_DRIVER_HOME
- Home page: HOMEPAGE_JDBC_DRIVER_HOME
- Metrics: MOBILE_JDBC_DRIVER_HOME
- Mobile: NEWS_JDBC_DRIVER_HOME
- News: NEWS_JDBC_DRIVER_HOME
- Profiles: PROFILES_JDBC_DRIVER_HOME
- Search: SEARCH_JDBC_DRIVER_HOME
- Wikis: WIKIS_JDBC_DRIVER_HOME
Select JDBC -> Data sources to return to the data source. Select the check box next to the data source, and then click Test connection.
If the file path is incorrect, click the variable name and edit the file path in the Value
Parent topic: Troubleshooting tips
Search error messages