How to Set Up SailPoint IdentityIQ (IIQ)

KranthiKranthi
2 min read

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 folder

    • Add %JAVA_HOME%\bin to your system PATH 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 system PATH.

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

  1. Download the SailPoint IIQ installation ZIP from the official site.

  2. Extract it to a folder inside the Tomcat directory (e.g., IIQ_Installation).

  3. Copy identityiq.war into Tomcat’s webapps folder.

  4. Start Tomcat — it will automatically extract the WAR and create an identityiq directory.

  5. Stop Tomcat and delete the identityiq.war to avoid re-extraction.


6️⃣ Generate Database Scripts

  1. Start both Tomcat and MySQL servers.

  2. Open the command prompt and navigate to:

     bashCopyEdit<TOMCAT_HOME>/webapps/identityiq/WEB-INF/bin
    
  3. Run the following command:

     graphqlCopyEditiiq schema
    

    This will generate SQL scripts inside WEB-INF/database.


7️⃣ Create SailPoint IIQ Database

  1. Navigate to the WEB-INF/database folder.

  2. Open MySQL CLI:

     >mysql -u root -p
    
  3. Run:

     >source create_identityiq_tables.mysql;
    
  4. Verify the database creation:

     >show databases;
    

8️⃣ Import SailPoint Modules

  1. Open the IIQ console:

     >cd <TOMCAT_HOME>/webapps/identityiq/WEB-INF/bin
     iiq console
    
  2. Import the initialization files:

     >import init.xml
    

    You can also import other modules:

    • init-lcm.xml → Life Cycle Manager

    • init-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!

0
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

👋 Hi, I’m Kranthi Kumar Puttapaka, a Certified SailPoint IAM Engineer with over 5 years of experience in building secure and scalable identity solutions. I help organizations streamline their Identity & Access Management (IAM) processes and strengthen their security posture. I specialize in designing and implementing enterprise-grade IAM systems using technologies like SailPoint IdentityIQ, Identity Security Cloud (ISC), Okta, Azure AD (Entra ID), and CyberArk. My focus areas include identity governance, access lifecycle automation, role-based access control, and Zero Trust security architectures. Over the years, I’ve led multiple SailPoint IIQ to ISC migration projects with zero downtime, developed custom connectors for seamless integrations, and implemented compliance frameworks like SOX, GDPR, HIPAA, and NIST. I also have hands-on experience with cloud platforms such as AWS and Azure, enabling organizations to adopt cloud-native identity governance. On the technical side, I work with Java, JavaScript, Python, and BeanShell for customization and automation. My toolkit includes Spring Boot, Spring Security, Docker, Terraform, and databases like MySQL, Oracle, MongoDB, and LDAP. Here on Hashnode, I write about IAM architecture patterns, SailPoint implementation deep dives, cloud identity strategies, Zero Trust security models, and real-world challenges I’ve solved in Identity Governance. Always excited to connect with fellow IAM professionals and share knowledge about building secure, scalable identity solutions. Let’s make the digital world more secure, one identity at a time!