Search This Blog

Friday, June 19, 2020

Sailpoint - New installation of Accelerator Pack 8.1 on Fresh IIQ 8.1

Approach-1(Installing IIQ and Accelerator Pack Together)

Steps-
  • Download “identityiq-8.1.zip” and unzip the file in local machine
  • Create a directory identityiq inside the apache folder “C:\Sailpoint\home\apache-tomcat-9.0.36\webapps”
  • Copy the identityiq.war file unzipped in step 1 to “C:\Sailpoint\home\apache-tomcat-9.0.36\webapps\identityiq”
  • Run the below command to unwar the war file. - As i am doing it on windows environment- Convert war in zip and then unzip it. If it linux enviroment user - un -xvf identityiq.war
  • Download the Accelerator Pack 8.1 zip file from Sailpoint Compass.
  • Extract the Accelerator Pack zip file to a temp folder like C:\Sailpoint\Software\Accelerator_Pack. Please do not extract directly in Sailpoint installation directory.
  • Update the Hibernate configuration files in your IdentityIQ installation directory
    Note - If you are doing it on fresh installation where extended attributes are not setup then copy and overwrite all the files else merge the files.
  • As this is new installation, you can copy all the *.hbm.xml files from the unzipped Accelerator Pack location’s C:\Sailpoint\Software\Accelerator_Pck\web\WEB-INF\classes\sailpoint\object\ folder to the [IdentityIQ_HOME]\WEB-INF\classes\sailpoint\object\ folder, and overwrite the existing ones.
  • If you wish to add custom attributes like department, costCenter or location, add the custom attributes in hbm.xml file.
  • As this is new installation, you can copy C:\Sailpoint\Software\Accelerator_Pck\WEB-INF\lib\AcceleratorPack.jar to [IdentityIQ_HOME]\WEB-INF\lib
  • As this is new installation, you can copy all files and subfolders under C:\Sailpoint\Software\Accelerator_Pck\web\WEB-INF\config\ to [IdentityIQ_HOME]\WEB-INF\config\
  • As this is new installation, you can copy all files under C:\Sailpoint\Software\Accelerator_Pck\images\icons\ to [IdentityIQ_HOME]\images\icons\
  • Copy C:\Sailpoint\Software\Accelerator_Pck\web\define\applications\IdentityIQLoopback.xhtml to [IdentityIQ_HOME]\define\applications\
  • Open the Accelerator Pack custom properties file: C:\Sailpoint\Software\Accelerator_Pck\web\WEBINF\classes\sailpoint\web\messages\iiqCustom.properties, copy the whole content and append it to the file to IdentityIQ custom properties file: [IdentityIQ_HOME]\WEBINF\classes\sailpoint\web\messages\iiqCustom.properties.
  • Create the database schema follow below 3 steps
  • Open cmd and navigate to C:\Sailpoint\home\apache-tomcat-9.0.36\webapps\identityiq\WEB-INF\bin
  • Execute "iiq schema" to create the schema


  • Create the database table using the above schema
  • Go to the C:\Sailpoint\home\apache-tomcat-9.0.36\webapps\identityiq\WEB-INF\database and run appropiate file by using database client (used MYSQL Workbench) - C:\Sailpoint\home\apache-tomcat-9.0.36\webapps\identityiq\WEB-INF\database\create_identityiq_tables.mysql
  • Update Database Settings that IdentityIQ will use to connect to its repository  - C:\Sailpoint\home\apache-tomcat-9.0.36\webapps\identityiq\WEB-INF\classes\iiq.properties
  • By default identityiq will be used as usename and password for identityiq schema.
  • Note - Change the default dataSource.password and encrypt it by using IIQ encrypt utility.
  • Launch the IdentityIQ console by running the iiq console command from the identityiq_home\WEB-INF\bin directory.   iiq console and then run the below command to import init.xml and init-lcm.xml.
  • import init.xml
  • init-lcm.xml 
  • import init-acceleratorpack.xml
  • quit
  • Note - Import the default IdentityIQ objects to init and init-lcm in the system can be done via UI as well.
    • import init.xml
    • init-lcm.xml 
    • import init-acceleratorpack.xml
           


  • Use Spadmin credential to login. Dont forgot to change the password for spadmin
  • For verification whether its installed or not  - Go to Administrative Tasks > Installed Accelerator Pack  and check the quick links. Also you can go to Debug pages in Configuration Objects -> System Configuration and verifying that this line is there:
    <entry key="acceleratorPackVersion" value="8.1"/>

           

           

Approach-2 (Installing IIQ and Accelerator Pack Separatly)

Prerequisite -
  • Shutdown iiq servers
  • Full backup of database.
  • Back up all the Hibernate configuration files in the [IdentityIQ_Home]\WEB-INF\classes\sailpoint\object\
Steps -
  • Download the Accelerator Pack 8.1 zip file from Sailpoint Compass.
  • Extract the Accelerator Pack zip file to a temp folder like C:\Sailpoint\Software\Accelerator_Pack. Please do not extract directly in Sailpoint installation directory.
  • If the servers are running then stop the application server.
  • Update the Hibernate configuration files in your IdentityIQ installation directory
    Note - If you are doing it on fresh installation where extended attributes are not setup then copy and overwrite all the files else merge the files.
  • As this is new installation, you can copy all the *.hbm.xml files from the unzipped Accelerator Pack location’s C:\Sailpoint\Software\Accelerator_Pck\web\WEB-INF\classes\sailpoint\object\ folder to the [IdentityIQ_HOME]\WEB-INF\classes\sailpoint\object\ folder, and overwrite the existing ones.
  • As this is new installation, you can copy C:\Sailpoint\Software\Accelerator_Pck\WEB-INF\lib\AcceleratorPack.jar to [IdentityIQ_HOME]\WEB-INF\lib
  • As this is new installation, you can copy all files and subfolders under C:\Sailpoint\Software\Accelerator_Pck\web\WEB-INF\config\ to [IdentityIQ_HOME]\WEB-INF\config\
  • As this is new installation, you can copy all files under C:\Sailpoint\Software\Accelerator_Pck\images\icons\ to [IdentityIQ_HOME]\images\icons\
  • Copy C:\Sailpoint\Software\Accelerator_Pck\web\define\applications\IdentityIQLoopback.xhtml to [IdentityIQ_HOME]\define\applications\
  • Open the Accelerator Pack custom properties file: C:\Sailpoint\Software\Accelerator_Pck\web\WEBINF\classes\sailpoint\web\messages\iiqCustom.properties, copy the whole content and append it to the file to IdentityIQ custom properties file: [IdentityIQ_HOME]\WEBINF\classes\sailpoint\web\messages\iiqCustom.properties.
  • Extend your database schema using the IdentityIQ console: Open cmd and go to C:\Sailpoint\home\apache-tomcat-9.0.36\webapps\identityiq\WEB-INF\ and run  iiq extendedSchema
  • Update script and comment out all alter table identityiq and create index statements from all extended attributes as those will already be created by IIQ fresh installation.
  • Open your database client MYSQL workbench and run the script add_identityiq_extensions.mysql
  • Note- If you see "Error Code: 1060. Duplicate column name 'extended1'" type issue then you may need to modify the script remove all alter table identityiq and create index statements from all extended attributes
  • Open the iiq console and run the command
    --> import init-acceleratorpack.xml
  • For verification whether its installed or not  - Go to Administrative Tasks > Installed Accelerator Pack  and check the quick links. Also you can go to Debug pages in Configuration Objects -> System Configuration and verifying that this line is there:
  • <entry key="acceleratorPackVersion" value="8.1"/>


     

No comments:

Post a Comment