How to Set Up SailPoint IdentityIQ (IIQ)

Setting up SailPoint IdentityIQ involves installing and configuring a few key components. Below is a step-by-step guide to get your environment ready.
1️⃣ Required Software
To set up SailPoint IIQ, you need the following software:
Java JDK (e.g., JDK 11)
MySQL Server (e.g., MySQL 8.0)
Apache Tomcat (e.g., Tomcat 9)
SailPoint IIQ JAR/WAR files (e.g., SailPoint IIQ 8.4)
💡 You may also use Oracle, PostgreSQL, or SQL Server instead of MySQL, but MySQL is commonly used and well-supported. Similarly, SailPoint supports other servers like Oracle WebLogic, IBM WebSphere, or JBoss EAP — however, Apache Tomcat is lightweight, efficient, and widely adopted, so we'll use it for this setup.
2️⃣ Java Configuration
Download a JDK version compatible with your IIQ version.
Extract it and configure the following environment variables:
JAVA_HOME
: Set to your JDK installation folderAdd
%JAVA_HOME%\bin
to your systemPATH
variable
Verify installation by running
java -version
in the terminal.
3️⃣ MySQL Server Setup
Download and install MySQL Server.
Configure the environment variables:
- Add the MySQL
bin
directory to your systemPATH
.
- Add the MySQL
4️⃣ Apache Tomcat Server Setup
Download and extract the Apache Tomcat version of your choice.
Configure environment variables:
CATALINA_HOME
: Set to the Tomcat root directory.
5️⃣ Deploy SailPoint IIQ
Download the SailPoint IIQ installation ZIP from the official site.
Extract it to a folder inside the Tomcat directory (e.g.,
IIQ_Installation
).Copy
identityiq.war
into Tomcat’swebapps
folder.Start Tomcat — it will automatically extract the WAR and create an
identityiq
directory.Stop Tomcat and delete the
identityiq.war
to avoid re-extraction.
6️⃣ Generate Database Scripts
Start both Tomcat and MySQL servers.
Open the command prompt and navigate to:
bashCopyEdit<TOMCAT_HOME>/webapps/identityiq/WEB-INF/bin
Run the following command:
graphqlCopyEditiiq schema
This will generate SQL scripts inside
WEB-INF/database
.
7️⃣ Create SailPoint IIQ Database
Navigate to the
WEB-INF/database
folder.Open MySQL CLI:
>mysql -u root -p
Run:
>source create_identityiq_tables.mysql;
Verify the database creation:
>show databases;
8️⃣ Import SailPoint Modules
Open the IIQ console:
>cd <TOMCAT_HOME>/webapps/identityiq/WEB-INF/bin iiq console
Import the initialization files:
>import init.xml
You can also import other modules:
init-lcm.xml
→ Life Cycle Managerinit-pam.xml
,init-ai.xml
,init-cam.xml
,init-rapidsetup.xml
✅ Final Tip
Make sure you restart the Tomcat server after completing the setup and importing modules. You're now ready to log in to the SailPoint IdentityIQ application!
Subscribe to my newsletter
Read articles from Kranthi directly inside your inbox. Subscribe to the newsletter, and don't miss out.
Written by

Kranthi
Kranthi
I specialize in Java, IAM, and SailPoint, solving identity security challenges and always open to discussions on java, access governance and authentication.