SailPoint Identity IQ (IIQ) 8.4 Installation Guide

Introduction

This tutorial provides a step-by-step guide on installing SailPoint Identity IQ (IIQ) version 8.4. It covers all necessary software requirements, installation procedures, and configuration steps to help you set up Identity IQ effectively.

Step 1: Download Required Software

Before beginning the installation, ensure you have the following software downloaded:

• Identity IQ 8.4: Download from the SailPoint Compass portal.
• JDK 11: Available at Oracle.
• Apache Tomcat 9.0: Download from Apache Tomcat.
• MySQL 8.0: Download from MySQL.
• IdentityIQ WAR file: Obtain it from SailPoint Community.

Optional software for easier manipulation:

• Notepad++: Download here
• DBeaver: Download here
• 7zip: Download here

Step 2: Prepare the Installation Environment

1. Extract the Identity IQ zip file to a convenient directory on your system.
2. Open the directory to locate the identityiq.war file.

Step 3: Install Identity IQ on Apache Tomcat

1. Check if Apache Tomcat is running:
   • If it is running, shut it down using the command:

     shutdown.bat
     

2. Copy the WAR file:
   • Place the identityiq.war file in the webapps folder of your Apache Tomcat installation.
3. Extract the WAR file:
   • You can use the command line or 7zip:

     jar -xvf identityiq.war
     

   • This will create a folder with the same name as the WAR file.

Step 4: Set Up MySQL Database

1. Create the Database:
   • Open MySQL and run the following command to create the required databases:

     CREATE DATABASE identityiq;
     CREATE DATABASE identityiq_plugin;
     CREATE DATABASE identityiq_h;
     

2. Initialize the Database:
   • Locate the init.xml file in the config folder of the Identity IQ installation.
   • Use the MySQL command to import the database schema:

     SOURCE /path/to/init.xml;
     

Step 5: Configure Database Connection

1. Locate the properties file:
   • Navigate to the WEB-INF/classes folder in the Identity IQ directory and open the identityiq.properties file.
2. Update Database Connection Details:
   • Modify the database connection URLs to include your MySQL port (default is 3306, change to 3307 if needed):

     jdbc:mysql://localhost:3307/identityiq
     

   • Ensure all three databases have the correct URLs configured.

Step 6: Initialize SailPoint Objects

1. Run the Identity IQ Console:
   • Open a command prompt in the Identity IQ bin folder and run:

     iiq console
     

2. Import the initial configuration:
   • Execute the following command in the console:

     import init.xml
     

   • For LCM, run:

     import init-lcm.xml
     

Step 7: Start Apache Tomcat

1. Start Tomcat:
   • Navigate to the bin folder of Apache Tomcat and run:

     startup.bat
     

2. Access Identity IQ:
   • Open a web browser and navigate to the default URL for Identity IQ.
   • Log in using the credentials:
     • Username: spadmin
     • Password: admin

Conclusion

You have now successfully installed SailPoint Identity IQ 8.4. You should verify the installation by checking the version and confirming the default identities in the system. For further customization or advanced configurations, refer to the official documentation or community forums for additional guidance.