Troubleshooting a database connection
A faulty JDBC driver or data source can prevent you from accessing an HCL Connections™ application. To troubleshoot and correct these problems, test the database connections.
If you encounter an HTTP 500 - Internal Server Error when attempting to access an HCL 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.
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 for the application whose data source you want to test. The data sources are named as follows:
- 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 Test connection.
If the connection fails, make sure the JAAS Auth alias information is correct.
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:
- 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
- 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.
The user ID should be one of the following default IDs:
Application DB2® database DB2 User ID Oracle database Oracle User ID SQL Server database SQL Server User ID Activities OPNACT lcuser ORCL ACTIVITIES OPNACT OAUSER 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 Forums FORUM lcuser ORCL DFUSER FORUM DFUSER Home page HOMEPAGE lcuser ORCL HOMEPAGE HOMEPAGE HOMEPAGEUSER Metrics METRICS lcuser ORCL METRICSUSER METRICS METRICSUSER Mobile MOBILE lcuser ORCL MOBILEUSER MOBILE MOBILEUSER News HOMEPAGE lcuser ORCL HOMEPAGE HOMEPAGE HOMEPAGEUSER Profiles PEOPLEDB lcuser ORCL PROFUSER PEOPLEDB PROFUSER Search HOMEPAGE lcuser ORCL HOMEPAGE HOMEPAGE HOMEPAGEUSER Wikis WIKIS lcuser ORCL WIKISUSER WIKIS WIKISUSER
Consider reentering the password to make sure that the value that you specified at installation is correct.
After applying any changes, click OK. Return to the data source properties page, and then click Test connection.
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:
- 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
- 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:
If the file path is incorrect, click the variable name and edit the file path in the Value field.
Select JDBC > Data sources to return to the data source. Select the check box next to the data source, and then click Test connection.
Parent topic:Troubleshooting tips