Checklist for upgrading to 8.4

[lsaipriya26 (saipriya lingala)]

HI all,

I am going to upgrade sailpoint iiq to version 8.4 and it is first time i am doing any upgrade process, can anyone suggest what are the basics like we need to verify after upgradation like in downtime the check list i needed to confirm that upgrade went well.

Thank you!

[naveenkumar3 (Naveen Kumar)]

1. Pre-Upgrade

Backup (MANDATORY)

• Database backup (full)
• <IIQ_HOME> directory backup
• Customizations: take the backup of all the xmls

Look for deprecated APIs between your version → 8.4

---

2. During Upgrade

Stop Services

• Stop app server cleanly
• Ensure no DB sessions are active

Deploy New WAR

• Replace old identityiq.war
• Clear:
  • work/
  • temp/
  • logs/ (optional but helpful)

DB Upgrade

• Run upgrade scripts provided by SailPoint

---

3. Post-Upgrade Validation

This is what you asked for — what confirms upgrade is successful

---

check critical app , do a test connection, or if all the operations are working fine

Look for below errors in the loggers:

• Hibernate errors
• ClassNotFoundException
• Connector failures

---

Basic Functional Testing

JML workflows, see if they are working fine

• Refresh identity
• Create request
• Approve workflow
• Provisioning executes

---

D. Aggregation

• Run at least 1 aggregation
• Verify:
  • No connector errors
  • Accounts visible

---

E. Tasks & Scheduler

• Run:
  • Identity Refresh
  • Perform Identity Request Maintenance (important in your case)
• Ensure:
  • Tasks complete successfully
  • No LazyInitialization errors

---

G. UI & Plugins

• Check:
  • Custom UI pages
  • Plugins
  • Quicklinks

---

---

Watch out for:

• Missing JAR conflicts (especially Axis / connectors)
• Deprecated API in custom rules
• Hibernate / LazyInitialization errors
• connectivity breaking due to TLS.

[utkirjonkamiljanov]

@lsaipriya26 Please refer to the article below:

SailPoint IdentityIQ Upgrade

Hi All, In this document, I will try to explain the upgrade procedure on a high level so that whenever you are doing it in the future, you can keep in mind all these steps. These steps are given by SailPoint recommendations only. Upgrade SailPoint IdentityIQ: You must stop all processes and shutdown IdentityIQ before performing the upgrade. It is recommended that you schedule the upgrade for a time when the application is not being used heavily. Note: If IQService is installed, the IQServic…

[lsaipriya26 (saipriya lingala)]

Thanks for the replies will consider the suggestions provided

[neel193 (Neelmadhav Panda)]

@lsaipriya26 Also make sure platform is compatible with the new version. Check for java version, OS, DB versions, etc. You can refer to doc: https://community.sailpoint.com/t5/IdentityIQ-Articles/IdentityIQ-Supported-Platforms-Matrix/ta-p/75551

When we did the upgrade from 8.1 to 8.4, we had to change OS as CentOS was getting deprecated and Java version upgrade. Please check your environment, and make sure they are well supported.

For IIQ upgrade, fellow Sailors already shared the document which you can follow. If you have any specific query, feel free to ask.

Note: Found a fix?Help the community by marking the comment as solution. Feel free to react(,, etc.)with an emoji to show your appreciation or message me directly if your problem requires a deeper dive.

[kannan_sb85 (Kannan Sriniyappan Balakrishnan)]

@lsaipriya26 - Refer my Quick deployment and patch upgrade procedure using SSD Link → Quick deployment and patch upgrade procedure using SSD - Compass