Integrating WebSphere Portal 7.0 with Qucikr 8.5 using Web Application Integrator
Customer who will use Quickr 8.5 as a document repository, would like to achieve a seamless look and feel between Portal and Quickr. One option available is to leverage Web Application Integrator. This document is designed to help customer's use WAI with Quickr and Portal.
In this article, we are assuming that Portal and Quickr have been installed and configured to use the same LDAP repository.
Configure Single Sign-on between Quickr and Portal:
1 – Access the WebSphere admin console for the PortalServer. Example: http://servername:port/ibm/console
2 – Navigate to Security – Global Security – LTPA
3 – Enter in password for key and location where key will be exported.
4 – Select export. Copy the exported token to the Quickr Server.
5 – Open admin console on the Quickr server and navigate to Security – Secure Administration,Applications and Infrastructure – Authentication mechanism and expiration.
6 – Enter the same password used above when exporting and the location and filename to where the key was copied.
7 – Select import.
Once completed, you will need to perform the same steps to export the Quickr key and import on the Portal Server.
8 – Both the Portal and Quickr server will need to be restarted once keys have been imported.
9 – Perform the following sanity check to ensure SSO is working.
Login to Quickr 8.5 then change the browser URL to the secure portal server url (example: http://servername:port/wps/myportal
You should already be logged in if SSO is working properly.
Web Application Integration Installation:
Download Web Application Integrator using the following url:
Once download, perform the following steps to install WAI in Portal v7 environment.
1. Unzip webappintegrator.zip to a temporary directory on your portal server.
2. Since this a v7 Portal installation, we will be using the files from directory 7.0.x.
3. Copy deployWebAppIntegrator.xml from the extracted files to \ConfigEngine\config\includes.
5. Make sure WebSphere Portal Server is running.
6. Run the following command from wp_profile/ConfigEngine directory
7. ConfigEngine.bat deploy-webAppIntegrator -DWasPassword= -DPortalAdminPwd= -DWebAppIntegratorLocation=\wai_install
8. Move the Web Application Integrator theme files
a. Locate the legacy "Portal" theme shipped with Portal 7.0:
b. Copy the folders named "Portal", "psw", and "webAppIntegrator" from the
wp_theme.war to: /installedApps//wps.ear/wps.war/themes/html/
c. Rename the "Portal" folder to "WAI"
d. Go to the Themes and Skins portlet:
Administration > WebSphere Portal > Portal User Intergface > Themes and Skins
e. Select "Add new theme"
Assign a title to the theme, use "WAI" as the theme directory name, and assign the "IBM" skin as the default
f. Restart the portal server.
(Note: currently the page builder theme is not supported with WAI, for more information on WAI, please see the documentation provided in the download)
Creating Page to use WAI:
1. Login to the Portal Server with Administrative user and create a standard Portal URL page.
– Go to Administration page - Manage Pages portlet
– Identify or create a parent page in the Portal page hierarchy (example: I created a page called Quickr under context root)
– Assign the "WAI Theme" to this parent page. This is required so a theme that resides in the wps.war is assigned.
– Navigate to the children of this parent page.
– Click "New URL" button.
– On the "New URL" page:
– Add a title for page. (example used MyQuickr)
– Ensure that the radio button "A link to a Web page with the following URL" is selected.
– Click the "HTML" checkbox and enter the URL to the external web application.
– Click the "OK" button.
2. Use the new Web Application Integration portlet to generate an HTML
5. Navigate to the following directory:
- Edit Default.jsp
– Add the WAI script directly after the tag.dir="rtl"
– Should look like the following:
Note: It is important to insert the WAI script tags directly after the tag so the portal markup will be rendered at the top of each page.
You should now be able to login to Quickr and see the Portal markup and or go to the page in Portal and it directs to the Quickr Site.
Login to Quickr direct, it will now look like the following :
If you login to Portal and navigate to the page created (in this example: Quickr), it will direct me to the Quickr Site as seen above.
This document is designed to help users integrate Portal and Quickr so it appears seamless to the end user when accessing either environment.