Sailpoint IdentityIQ 7.3 Installation Steps

This post provides the steps to install Sailpoint IdentityIQ 7.3 for a micro footprint installation topology. 

Please check the SailPoint IIQ installation support matrix for version compatibility.

Required Software components

1. MYSQL 5.6 Database
2. Java JDK 1.8 and above
3. Apache Tomcat 9.0
4. Identity IQ 7.3 binaries

Prerequisites

1. Download all the required software components
2. Install the JDK and set JAVA_HOME=C:\Program Files\Java\jdk1.7.0_80 and append JAVA_HOME/bin to your path.
3. Install Apache Tomcat Application server

• Unzip the downloaded binaries to your local C drive
• Start the Tomcat server by navigating C:\apache-tomcat-9.0\bin and double click on startup
• Test URL: http ://localhost:8080 to confirm the application has installed successfully

      4. Install and Configure MYSQL. As a part of MYSQL installation you will be required to install:

• .NET
• VC++
• Work bench

Deploy IIQ War File

Stop the Tomcat Application server by navigating to C:\apache-tomcat-9.0\bin and double click on shutdown.

Create a directory with name identityiq in tomcat webapps directory C:\apache-tomcat-9.0 \webapps\identityiq, which would be the sailpoint installation directory

Unzip the download identityiq-7.3.zip file and locate the identityiq.war file and copy it to the SailPoint installation directory C:\apache-tomcat-9.0\webapps\identityiq

Run the below command from command prompt to extract the war file

               jar -xvf C:\apache-tomcat-9.0\webapps\identityiq\identityiq.war

Configure Extended Attributes (optional) 

There are few default identity attributes provided along with the installation like User Name, First Name, Last Name, Email and Manager. If you want to add extended identity attributes that needs to be searchable ex: userId and empType. We can add them as a named attributes.

Configure the Hibernate XML file to add two named, searchable, indexed, extended attributes.

Edit the file C:\apache-tomcat-9.0\webapps\identityiq\WEB-INF\classes\sailpoint\object\IdentityExtended.hbm.xml using notepad and add the below xml to add the attributes userId and empType. These attributes will be created in database.

Save the changes to the file.

In future you may need to add more identity attributes but we are not sure about the names of these attributes. For these by default 10 placeholders are provided in this file of which 5 are searchable and indexed and another 5 are searchable but not indexed.

Configure the Database

In the command prompt, navigate to C:\apache-tomcat-9.0\webapps\identityiq\WEB-INF\bin directory and enter below command to generate the database schema files

iiq schema

Create the IdentityIQ database by loading the MySQL schema file. In the command prompt navigate to C:\apache-tomcat-9.0\webapps\identityiq\WEB-INF\database directory and run the below commands to log into MySQL

mysql -u root -p
Enter the passoword

Run this command to load the schema into MySQL:

mysql> source create_identityiq_tables.mysql

Check that the database identityiq was created shows in the list of databases

mysql> show databases;

Type quit to exit MySQL.

Configure Database Settings that IdentityIQ will use to connect to database by editing the file C:\apache-tomcat-9.0\webapps\identityiq\WEB-INF\classes\iiq.properties

Load the initial files

Import the default IdentityIQ objects to init and init-lcm to initialize the system

In command prompt navigate to C:\apache-tomcat-9.0\webapps\identityiq\WEB-INF\bin and run the below commands:

iiq console

> import init.xml

> import init-lcm.xml

Start the Tomcat server and verify the installation by login to Identity IQ from browser using URL http://localhost:8080/identityiq/ with default credentials spadmin/admin