# IIQ Console is not starting for 8.4 upgrade system

**URL:** <https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905>\
**Category:** IIQ Discussion and Questions\
**Tags:** identityiq\
**Created:** [May 10, 2025, 9:05am UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905 "2025-05-10T09:05:23Z")\
**Posts on this page:** 17\
**Page:** 1

<div class="post-metadata">

**Author:** ![deva\_sp](https://avatars.discourse-cdn.com/v4/letter/d/b487fb/32.png) [@deva\_sp](https://developer.sailpoint.com/discuss/u/deva_sp)\
**Post date:** [May 10, 2025, 9:05am UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/1 "2025-05-10T09:05:23Z")

</div>

## Which IIQ version are you inquiring about?

8.4

## Please share any other relevant files that may be required (for example, logs).

2025-05-10T04:55:23,189 WARN main springframework.context.support.ClassPathXmlApplicationContext:559 - Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.BeanCreationException: Error creating bean with name ‘versionChecker’ defined in class path resource [configBeans.xml]: Invocation of init method failed; nested exception is java.lang.RuntimeException: Unable to check AccessHistory database version: Unable to connect to: null  
org.springframework.beans.factory.BeanCreationException: Error creating bean with name ‘versionChecker’ defined in class path resource [configBeans.xml]: Invocation of init method failed; nested exception is java.lang.RuntimeException: Unable to check AccessHistory database version: Unable to connect to: null

## Share all details about your problem, including any error messages you may have received.

We are upgrading from Sailpoint IIQ 8.3 to 8.4, and excluded the access history module. When open the IIQ console getting the below error. Can anyone suggest on the issue.

**org.springframework.beans.factory.BeanCreationException: Error creating bean with name ‘versionChecker’ defined in class path resource [configBeans.xml]: Invocation of init method failed; nested exception is java.lang.RuntimeException: Unable to check AccessHistory database version: Unable to connect to: null**

---

<div class="post-metadata">

**Author:** ![angelborrego](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/angelborrego/32/21987_2.png) [@angelborrego](https://developer.sailpoint.com/discuss/u/angelborrego)\
**Post date:** [May 10, 2025, 9:31am UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/2 "2025-05-10T09:31:06Z")

</div>

Hi @deva_sp ,

During startup, Spring attempts to initialize the `versionChecker` bean, which verifies the schema version of several IIQ subsystems — one of which is AccessHistory.

Since you’re upgrading from 8.3 to 8.4 and have excluded the AccessHistory module, IIQ is still attempting to validate its schema, but fails to connect, likely because:

- There’s **no JDBC connection URL defined** for AccessHistory (hence `Unable to connect to: null`)
- Or, the AccessHistory module is **partially configured** , causing `versionChecker` to try validating it

* * *

## 🛠 How to Fix

You need to **explicitly disable AccessHistory** in your IdentityIQ configuration to prevent Spring from trying to load it.

### ✔ Option 1: Comment Out AccessHistory Bean in `configBeans.xml`

Locate the following in `$IIQ_HOME/WEB-INF/configBeans.xml`:

```auto
<bean id="accessHistory" class="sailpoint.api.AccessHistory">
    ...
</bean>

```

Either:

- Comment it out completely, or
- Remove it if you have no intention of using AccessHistory in 8.4

And ensure there’s **no reference** to this bean in other config files like `init.xml`.

* * *

### ✔ Option 2: Set the AccessHistory to `disabled` in `iiq.properties`

If you have any configuration pointing to AccessHistory (such as `audit.accessHistory.enabled=true`), make sure it’s explicitly **disabled** in your `iiq.properties` or in any override file:

```auto
audit.accessHistory.enabled=false

```

This prevents components from referencing it during startup.

* * *

### ✔ Option 3: Remove `accessHistory` DB references

If you previously had AccessHistory in `iiqDataSources.xml`, and have since removed the schema or DB, ensure the related `<DataSource>` element is removed.

* * *

Hope this helps! 🚀 Let me know if you have any questions.

---

<div class="post-metadata">

**Author:** ![deva\_sp](https://avatars.discourse-cdn.com/v4/letter/d/b487fb/32.png) [@deva\_sp](https://developer.sailpoint.com/discuss/u/deva_sp)\
**Post date:** [May 10, 2025, 12:06pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/3 "2025-05-10T12:06:17Z")

</div>

Hi @angelborrego ,

Thanks for the information, I could not find the file path **$IIQ\_HOME/WEB-INF/configBeans.xml** to comment the access history related bean id. And also couldn’t find file like `iiqDataSources.xml`

I have commented all the access related entries in `iiq.properties` file and tried to launch the console but still not working.

And also I tried below SQL query and gives result not table exist.

`select * from identityiqah.spt_hist_database_version;`

Please suggest if you find any root cause for this.

---

<div class="post-metadata">

**Author:** ![angelborrego](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/angelborrego/32/21987_2.png) [@angelborrego](https://developer.sailpoint.com/discuss/u/angelborrego)\
**Post date:** [May 10, 2025, 8:52pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/4 "2025-05-10T20:52:48Z")

</div>

> [@deva\_sp](#):
>
> **configBeans.xml**

Hi, I just found more info about your problem in the Compass post:  
[I am facing BeanCreation Exception - Page 2 - Compass](https://community.sailpoint.com/t5/New-to-SailPoint/I-am-facing-BeanCreation-Exception/td-p/229423/page/2)

There they fixed it by adding “allowPublicKeyRetrieval=true” in iiq.properties, in the dataSource.url

An example: dataSource.url=jdbc:mysql://localhost/identityiq?useServerPrepStmts=true&allowPublicKeyRetrieval=true&tinyInt1isBit=true&useSSL=false&characterEncoding=UTF-8&serverTimezone=UTC

Try with that. Let me know if it works!

---

<div class="post-metadata">

**Author:** ![pravin\_ranjan](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/pravin_ranjan/32/6771_2.png) [@pravin\_ranjan](https://developer.sailpoint.com/discuss/u/pravin_ranjan)\
**Post date:** [May 11, 2025, 2:50am UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/5 "2025-05-11T02:50:40Z")

</div>

@deva_sp when you do upgrade from 8.3 to 8.4. Access History is disabled bydefault.

I would suggest creating the access history db and let it be there and keep upgrade.

As per doc **The identityiqah database must be created as part of the installation, even if you do not intend to use the Access History feature.**

It’s also about product support by sailpoint. There is no harm to just create one extra db instance and you never know if you would like access history. In that case, you have to do lots of patch work to enable access history.

Cheers,  
Pravin

---

<div class="post-metadata">

**Author:** ![deva\_sp](https://avatars.discourse-cdn.com/v4/letter/d/b487fb/32.png) [@deva\_sp](https://developer.sailpoint.com/discuss/u/deva_sp)\
**Post date:** [May 13, 2025, 9:54am UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/6 "2025-05-13T09:54:52Z")

</div>

Hi @angelborrego

Thanks for the inputs, I tried with this option getting same error. Looks like no issue with identityiq schema, problem with identityiqah schema.

---

<div class="post-metadata">

**Author:** ![deva\_sp](https://avatars.discourse-cdn.com/v4/letter/d/b487fb/32.png) [@deva\_sp](https://developer.sailpoint.com/discuss/u/deva_sp)\
**Post date:** [May 13, 2025, 10:01am UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/7 "2025-05-13T10:01:24Z")

</div>

Hi @pravin_ranjan

Thanks for the inputs, my initial plan is go with default access history option, I tried that but giving below error.

```auto
2025-05-13T05:47:51,952 WARN main springframework.context.support.ClassPathXmlApplicationContext:559 - Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'versionChecker' defined in class path resource [configBeans.xml]: Invocation of init method failed; nested exception is java.lang.RuntimeException: Unable to check IdentityIQ database version: Unable to connect to: jdbc:mysql://xxxxx-1.rds.amazonaws.com/identityiqah?useServerPrepStmts=true&allowPublicKeyRetrieval=true&tinyInt1isBit=true&useSSL=true&characterEncoding=UTF-8&serverTimezone=UTC
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'versionChecker' defined in class path resource [configBeans.xml]: Invocation of init method failed; nested exception is java.lang.RuntimeException: Unable to check IdentityIQ database version: Unable to connect to: jdbc:mysql://xxxx-1.rds.amazonaws.com/identityiqah?useServerPrepStmts=true&allowPublicKeyRetrieval=true&tinyInt1isBit=true&useSSL=true&characterEncoding=UTF-8&serverTimezone=UTC

```

My suspect is we are using keystores for passwords, unfortunately not having the identityiqah schema encryption password . I configured as below but not working.

```auto

dataSourceAccessHistory.username=identityiqah
dataSourceAccessHistory.password=identityiqah

```

Please let me know if there anyway we can encrypt this with old keystore values and suggest on this issue.

Thanks.

---

<div class="post-metadata">

**Author:** ![pravin\_ranjan](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/pravin_ranjan/32/6771_2.png) [@pravin\_ranjan](https://developer.sailpoint.com/discuss/u/pravin_ranjan)\
**Post date:** [May 13, 2025, 1:50pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/8 "2025-05-13T13:50:16Z")

</div>

Can u check current version ?

```auto
Identityiqah.spt_hist_database_version

also for Identityiq.spt_database_version

if possible then pls paste iiq.properties here.

```

---

<div class="post-metadata">

**Author:** ![deva\_sp](https://avatars.discourse-cdn.com/v4/letter/d/b487fb/32.png) [@deva\_sp](https://developer.sailpoint.com/discuss/u/deva_sp)\
**Post date:** [May 13, 2025, 5:05pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/9 "2025-05-13T17:05:13Z")

</div>

Hi @pravin_ranjan

Please find the DB versions, and also attached the iiq.properties file.

 ![image](https://global.discourse-cdn.com/sailpoint/original/3X/b/a/ba3b9015ea93d4a08e7699b8db40c400c5f5e76b.png)

 ![image](https://global.discourse-cdn.com/sailpoint/original/3X/f/2/f2a4df86bf2c10880319523e1d73c89a4097162c.png)  
[iiq.properties](https://developer.sailpoint.com/discuss/uploads/short-url/AqinnfBvzKUVrpIym7MnwJLtXHw.properties) (17.3 KB)

---

<div class="post-metadata">

**Author:** ![pravin\_ranjan](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/pravin_ranjan/32/6771_2.png) [@pravin\_ranjan](https://developer.sailpoint.com/discuss/u/pravin_ranjan)\
**Post date:** [May 13, 2025, 6:53pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/10 "2025-05-13T18:53:01Z")

</div>

did you executed the command ?

```auto
iiq upgrade

```

Also check password for iiq and iiq history user at the time of creation is same as in iiq.properties file.

---

<div class="post-metadata">

**Author:** ![deva\_sp](https://avatars.discourse-cdn.com/v4/letter/d/b487fb/32.png) [@deva\_sp](https://developer.sailpoint.com/discuss/u/deva_sp)\
**Post date:** [May 14, 2025, 9:22am UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/11 "2025-05-14T09:22:50Z")

</div>

I still didn’t run the upgrade command. I am planning to run after successfully launched the IIQ console.

---

<div class="post-metadata">

**Author:** ![pravin\_ranjan](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/pravin_ranjan/32/6771_2.png) [@pravin\_ranjan](https://developer.sailpoint.com/discuss/u/pravin_ranjan)\
**Post date:** [May 14, 2025, 12:46pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/12 "2025-05-14T12:46:09Z")

</div>

@deva_sp you cannot launch iiq console without executing iiq upgrde command. You need to first upgrade then you can run iiq console. the reason you already upgraded the db and now u need to upgrdae iiq so there is mismatch that’s why it’s throwing error. i replicated same in my lab and it also give same error.

Please execute upgrade first.

the error is very clear now.

---

<div class="post-metadata">

**Author:** ![deva\_sp](https://avatars.discourse-cdn.com/v4/letter/d/b487fb/32.png) [@deva\_sp](https://developer.sailpoint.com/discuss/u/deva_sp)\
**Post date:** [May 14, 2025, 4:07pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/13 "2025-05-14T16:07:36Z")

</div>

Hi @pravin_ranjan

Thanks for the clarification, when I run upgrade command I am getting below, we are using MySql Arora database, and I think default drivers can be provided by Sailpoint, any idea what is missing here

```auto
2025-05-14T07:05:37,149 ERROR main sailpoint.server.upgrade.Upgrader:1523 - Cannot create JDBC driver of class '' for connect URL 'null'
sailpoint.tools.GeneralException: Cannot create JDBC driver of class '' for connect URL 'null'
        at sailpoint.server.upgrade.Upgrader$JdbcContext.createConnection(Upgrader.java:261) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader$JdbcContext.getConnection(Upgrader.java:243) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.getDatabaseSchemaVersion(Upgrader.java:1614) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.validateSchemaVersion(Upgrader.java:1495) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.validateSchemaVersions(Upgrader.java:1166) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.execute(Upgrader.java:1092) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.main(Upgrader.java:643) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[?:?]
        at jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[?:?]
        at jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[?:?]
        at java.lang.reflect.Method.invoke(Method.java:566) ~[?:?]
        at sailpoint.launch.Launcher.main(Launcher.java:250) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
Caused by: java.sql.SQLException: Cannot create JDBC driver of class '' for connect URL 'null'
        at org.apache.commons.dbcp2.DriverFactory.createDriver(DriverFactory.java:75) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.createConnectionFactory(BasicDataSource.java:459) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.createDataSource(BasicDataSource.java:525) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.getConnection(BasicDataSource.java:731) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at sailpoint.server.upgrade.Upgrader$JdbcContext.createConnection(Upgrader.java:258) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        ... 11 more
Caused by: java.sql.SQLException: No suitable driver
        at java.sql.DriverManager.getDriver(DriverManager.java:298) ~[java.sql:?]
        at org.apache.commons.dbcp2.DriverFactory.createDriver(DriverFactory.java:60) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.createConnectionFactory(BasicDataSource.java:459) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.createDataSource(BasicDataSource.java:525) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.getConnection(BasicDataSource.java:731) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at sailpoint.server.upgrade.Upgrader$JdbcContext.createConnection(Upgrader.java:258) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        ... 11 more
2025-05-14T07:05:37,149 ERROR main sailpoint.server.upgrade.Upgrader:1523 - Cannot create JDBC driver of class '' for connect URL 'null'
sailpoint.tools.GeneralException: Cannot create JDBC driver of class '' for connect URL 'null'
        at sailpoint.server.upgrade.Upgrader$JdbcContext.createConnection(Upgrader.java:261) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader$JdbcContext.getConnection(Upgrader.java:243) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.getDatabaseSchemaVersion(Upgrader.java:1614) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.validateSchemaVersion(Upgrader.java:1495) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.validateSchemaVersions(Upgrader.java:1166) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.execute(Upgrader.java:1092) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at sailpoint.server.upgrade.Upgrader.main(Upgrader.java:643) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        at jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[?:?]
        at jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[?:?]
        at jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[?:?]
        at java.lang.reflect.Method.invoke(Method.java:566) ~[?:?]
        at sailpoint.launch.Launcher.main(Launcher.java:250) [identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
Caused by: java.sql.SQLException: Cannot create JDBC driver of class '' for connect URL 'null'
        at org.apache.commons.dbcp2.DriverFactory.createDriver(DriverFactory.java:75) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.createConnectionFactory(BasicDataSource.java:459) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.createDataSource(BasicDataSource.java:525) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.getConnection(BasicDataSource.java:731) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at sailpoint.server.upgrade.Upgrader$JdbcContext.createConnection(Upgrader.java:258) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        ... 11 more
Caused by: java.sql.SQLException: No suitable driver
        at java.sql.DriverManager.getDriver(DriverManager.java:298) ~[java.sql:?]
        at org.apache.commons.dbcp2.DriverFactory.createDriver(DriverFactory.java:60) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.createConnectionFactory(BasicDataSource.java:459) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.createDataSource(BasicDataSource.java:525) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at org.apache.commons.dbcp2.BasicDataSource.getConnection(BasicDataSource.java:731) ~[commons-dbcp2-2.9.0.jar:2.9.0]
        at sailpoint.server.upgrade.Upgrader$JdbcContext.createConnection(Upgrader.java:258) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]
        ... 11 more

```

---

<div class="post-metadata">

**Author:** ![pattabhi](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/pattabhi/32/25700_2.png) [@pattabhi](https://developer.sailpoint.com/discuss/u/pattabhi)\
**Post date:** [May 14, 2025, 6:14pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/14 "2025-05-14T18:14:24Z")

</div>

Hi @deva_sp

The application server is failing to connect to the database please cross check following points to make sure the proper connection between IIQ server and Database. MySQL Aurora is a managed service by AWS?  
{the IIQ upgrade process is trying to establish a database connection but lacks the necessary information.}

**Network Connectivity:**  
Ensure there is network connectivity between your IIQ server(s) and the Aurora MySQL cluster endpoint. You might want to use tools like `ping` or `telnet` from the IIQ server to the Aurora endpoint and port to verify basic network reachability.

**Authentication:**  
Double-check the database username and password configured is correct.

**JDBC Driver JAR File:**  
You still need the MySQL Connector/J JAR file in the IIQ classpath. Ensure you have downloaded the appropriate version (compatible with your MySQL Aurora version and the driver class you specified) and placed it in the correct lib directory of your IIQ installation.

**Security Group Configuration:**  
This is crucial for Aurora. Verify that the security group associated with your IIQ server allows inbound TCP traffic on the port your Aurora MySQL cluster is listening on (default 3306) from the IP address(es) of your IIQ servers. If the security group rules are not correctly configured, IIQ will not be able to establish a network connection to the database, even if the driver and URL are correct.

**JDBC Connection URL:**  
The connection.url needs to be correctly formatted for your Aurora MySQL cluster.

`jdbc:mysql://<your_cluster_endpoint>:<port>/<your_database_name></property>`  
Replace `<port>` with the port your MySQL database is listening on (the default is usually `3306`).

JDBC Driver Class Name:  
Ensure the connection.driver\_class in your IIQ database configuration file is set to the correct MySQL driver class.

for newer version, it might be:  
`com.mysql.cj.jdbc.Driver`

For older versions, it might be:  
`com.mysql.jdbc.Driver`

---

<div class="post-metadata">

**Author:** ![pravin\_ranjan](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/pravin_ranjan/32/6771_2.png) [@pravin\_ranjan](https://developer.sailpoint.com/discuss/u/pravin_ranjan)\
**Post date:** [May 14, 2025, 9:18pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/15 "2025-05-14T21:18:49Z")

</div>

> [@deva\_sp](#):
>
> default drivers can be provided by Sailpoint

Sailpoint stopped providing default drivers. you need to drop in IIQ before upgrade.

check here : [JDBC Drivers and IdentityIQ - Compass](https://community.sailpoint.com/t5/Other-Documents/JDBC-Drivers-and-IdentityIQ/ta-p/78962)

---

<div class="post-metadata">

**Author:** ![deva\_sp](https://avatars.discourse-cdn.com/v4/letter/d/b487fb/32.png) [@deva\_sp](https://developer.sailpoint.com/discuss/u/deva_sp)\
**Post date:** [May 15, 2025, 1:39pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/16 "2025-05-15T13:39:14Z")

</div>

Hi Kumar,

I have identified the issue, data source key has given wrong for Access History connections, after corrected I am able to launch the IIQ console and able to run the IIQ Upgrade command. There are no third party drivers required for JDBC for my DB.

However when I ran the upgrade script there many DB related error shown but application able launch successfully.

Below are few error:

```auto
Caused by: com.mysql.cj.exceptions.CJCommunicationsException: Communications link failure

Caused by: javax.net.ssl.SSLException: Received fatal alert: record_overflow

2025-05-15T02:54:28,094 ERROR main sailpoint.server.upgrade.Upgrader:647 - org.hibernate.exception.JDBCConnectionException: could not execute statement
sailpoint.tools.GeneralException: org.hibernate.exception.JDBCConnectionException: could not execute statement
	at sailpoint.persistence.HibernatePersistenceManager.commitTransaction(HibernatePersistenceManager.java:586) ~[identityiq.jar:8.4 Build bdd0ed4de58-20230919-192552]

```

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/sailpoint/original/2X/f/f2136700ed5e3703e0b85e02f6be799dacca7735.png) [@system](https://developer.sailpoint.com/discuss/u/system)\
**Post date:** [July 14, 2025, 1:39pm UTC](https://developer.sailpoint.com/discuss/t/iiq-console-is-not-starting-for-8-4-upgrade-system/126905/17 "2025-07-14T13:39:45Z")

</div>

This topic was automatically closed 60 days after the last reply. New replies are no longer allowed.
