While the IIQDA Plugin is a great tool to help your developers accelerate their development efforts, installation isn’t always straightforward. We’ve worked through challenges with many customers who’ve faced issues when installing and using the IIQDA4.0.2 plugin. One of the biggest challenges is that installation tips/guides seem to be either incomplete or scattered across multiple locations. To simplify the process, we’ve compiled all the steps you need to take advantage of the full feature set of IIQDA into a single location.
Links to Download Required Software:
Latest Plugin – click here.
· Once the eclipse zip is downloaded make sure that it is “unblocked.” For this select the zip –> right click and go to properties and in the lower portion of the window make sure you have checked the box for “unblock.”
· Unzip the eclipse zip (eclipse-jee-neon-3-win32-x86_64.zip) into a folder onto your local machine
· Once extracted, move into the folder “eclipse” and double click on “eclipse.exe”
· This will launch the eclipse
· Next, unzip the IIQDA plugin
· Unzip in a local folder e.g <YOUR LOCAL PATH>/iiqda-4.0.beta. The directory content will look like this:
· Now open the eclipse and go to About –> Install New Software–> A New Window Opens and Click on Add… Button
· You will see the plugin came into the box below, select the checkbox corresponding to SailPoint and Click Next
· On the Eclipse Progress screen, you may see Security Warning like below, Click OK
· It will ask you to Restart the eclipse, Please restart to complete the installation
Download the WorkFlow-Import.xml
Following is the URL to download, if you are using chrome then it will directly show the content of the XML file and does not give the option to download the file directly. You can right-click and Save As XML, click here.
Once downloaded, please import the downloaded file into the target IIQ environment.
Setup a Project
· Provide Project Name and Check SSB Option
· Now go to project properties (Select the Project in the Project Explorer, right-click and Select Properties –> Find out IdentityIQ Project Properties and change the Connection Timeout value to 50000
· Here you are set up with IIQDA Plugin in the eclipse. Now you can click on your project config folder and are ready to do import/export to your SailPoint Environment. You should have <env>.target.properties file present and populated with correct IQ URL, something similar to below:
Remote Logger Configuration
Remote logger allows you to view IIQ logs at your eclipse environment locally, while your actual SailPoint Environment is remote. You should have connectivity and firewall port open 8000 between the machine where eclipse is installed and the machine where IIQ is installed. Follow these configuration steps:
· Find out the Jar ssappender*.jarfrom your local eclipse installation/unzipped folder :
The jar file is located here:
<ECLIPSE_HOME>configurationorg.eclipse.osgi968 .cplib ssappender-0.0.1-SNAPSHOT.jar
Note: jar is available for Neon Release.
· Copy this jar to your IIQ remote environment$TOMCAT_HOME/webapps/identityiq/WEB-INF/lib
· Edit your log4j.properties located under$TOMCAT_HOME/webapps/identityiq/WEB-INF/classes/ folder with following lines in the appender section:
· Edit rootLogger to add net appender (created above) so your rootLogger entry should look like this :
· Now go to your local machine and open the eclipse configured for the IdentityIQ project.
· In the Eclipse go and Select Windows –> Show View –> Other–> SailPoint -> IdentityIQ Log View
You should now be able to view the remote SailPoint logs.