IBM Support

"Cannot load JDBC driver class 'com.microsoft.sqlserver.jdbc.SQLServerDriver'" when trying to start FAP service

Troubleshooting


Problem

User tries to start FAP service. This fails. In addition, user launches FAP Client. User tries to create a new 'source'. User cannot successfully save this new source.

Symptom

FAPFatalerror log:

com.ibm.cognos.fap.common.exception.ConnectionException: Could not
connect to: jdbc:sqlserver://cognosdb;Database=CONTROLLER_FAP

at
com.ibm.cognos.fap.common.persistence.dao.DbContext.getConnection(DbCont
ext.java:72)
at
com.ibm.cognos.fap.common.persistence.dao.LogDao.trace(LogDao.java:82)
at
com.ibm.cognos.fap.common.persistence.dao.LogDao.error(LogDao.java:133)
at
com.ibm.cognos.fap.common.persistence.dao.LogDao$$FastClassByCGLIB$$6012
7973.invoke(<generated>)
at net.sf.cglib.proxy.MethodProxy.invoke(MethodProxy.java:149)
at
com.ibm.cognos.fap.common.persistence.retry.RetryInterceptor.intercept(R
etryInterceptor.java:54)
at
com.ibm.cognos.fap.common.persistence.dao.LogDaoMSSqlServer$$EnhancerByC
GLIB$$ada747e2.error(<generated>)
at
com.ibm.cognos.fap.service.schedule.Scheduler.run(Scheduler.java:286)
at
com.ibm.cognos.fap.service.schedule.Scheduler$1.run(Scheduler.java:135)
at java.lang.Thread.run(Thread.java:736)
Caused by: org.apache.commons.dbcp.SQLNestedException: Cannot load JDBC
driver class 'com.microsoft.sqlserver.jdbc.SQLServerDriver'

at
org.apache.commons.dbcp.BasicDataSource.createDataSource(BasicDataSource
.java:1136)
at
org.apache.commons.dbcp.BasicDataSource.getConnection(BasicDataSource.ja
va:880)
at
com.ibm.cognos.fap.common.persistence.dao.DbContext.getConnection(DbCont
ext.java:70)
... 9 more
Caused by: java.lang.ClassNotFoundException:
com.microsoft.sqlserver.jdbc.SQLServerDriver
at java.lang.Class.forName(Class.java:136)

at
org.apache.commons.dbcp.BasicDataSource.createDataSource(BasicDataSource
.java:1130)
... 11 more

Inside FAP client:

After creating new 'source' and clicking "Save" button, user receives the following error message:


    Only alphanumeric characters and underscore are valid in source
    name(first character must be alpha), please adjust the name.

[{"Product":{"code":"SS9S6B","label":"IBM Cognos Controller"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"Controller","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.1","Edition":"","Line of Business":{"code":"LOB76","label":"Data Platform"}},{"Product":{"code":"SSMRTZ","label":"IBM Cognos Controller on Cloud"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB76","label":"Data Platform"}}]

Log InLog in to view more of this document

This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.

Document Information

Modified date:
08 May 2025

UID

swg21650550