IBM Software An IBM Proof of Technology

Hands-on Lab: Integrate Web

Application Inside Portal FAST Using
Web Application Bridge
Connecting Microsoft Sharepoint into WebSphere Portal

Lab Exercise
An IBM ICS STEW
Catalog Number

Copyright IBM Corporation, 2012

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
 IBM Software

Contents
INTRODUCTION 4
WEBSPHERE PORTAL OVERVIEW 5
IBM WEB APPLICATION BRIDGE OVERVIEW 6

LAB 1 SETUP ............................................................................................................................................................9

1.1 INITIAL STEPS....................................................................................................................................................................9
1.2 ENABLE VWAT SERVLET................................................................................................................................................10

LAB 2 CONFIGURE VIRTUAL WEB APPLICATION FOR MS SHAREPOINT 2007 IN VIRTUAL WEB APPLICATION
MANAGER PORTLET 13
2.1 CREATE A NEW CATEGORY..........................................................................................................................................13
2.2 CREATE A VIRTUAL WEB APPLICATION (VWA) FOR MS SHAREPOINT 2007.........................................................14

LAB 3 DEPLOY AND CONFIGURE WEB DOCK PORTLET TO DISPLAY CONTENTS FROM VIRTUAL WEB
APPLICATION FOR MS SHAREPOINT 2007 19
3.1 CREATE A PAGE IN WEBSPHERE PORTAL.................................................................................................................19
3.2 CONFIGURE THE PAGE FOR WAB................................................................................................................................21
3.3 CONFIGURE WEB DOCK PORTLET...............................................................................................................................22

CONCLUSION 26
RESOURCES 27

APPENDIX A NOTICES 28

APPENDIX B TRADEMARKS AND COPYRIGHTS 30

Web Experience v8 PoT Page 3

IBM Software

Introduction
Lab Overview

This lab provides an overview of the IBM Web Application Bridge for IBM WebSphere Portal. Lab
attendees will rapidly generate a rich and interactive portal application that integrates view from multiple
back-end web applications especially MS Sharepoint 2007. Lab attendees will create a Virtual Web
Application using the Virtual Web Application Manager portlet and then deploy the Virtual Web
Application on a portal page that delivers the back-end content to users by integrating web resources
from the back-end web application on the glass.

Page 4 Integrating Web Applications with WAB

 IBM Software

WebSphere Portal Overview

What is WebSphere Portal?

Web portals allow partners, employees and customers to choose their user experience, with
personalized applications based on role, context, actions, location, preferences and team collaboration
needs. IBM WebSphere Portal software provides a composite application or business mashup
framework and the advanced tooling needed to build flexible, SOA-based solutions, as well as the
unmatched scalability required by any size organization.

Why Should You Consider Using WebSphere Portal to Deliver Applications to Your Customers?

Many IT solutions provide needed functionality, but require you to learn a new way to work. Portals allow
you to customize your work environment to your own needs, present resources in a consistent fashion,
and can provide a personalized experience based upon your previous preferences or specific role within
an organization.

In addition, the IBM WebSphere Portal provides an integration platform capable of bringing several
services together as a single, unified, consistent user interface (UI). You can create and deploy custom-
branded, market-driven solutions comprised of existing and net-new business assets. Then re-purpose
and reuse as appropriate to help organizations address the challenges inherent with build your own
Web solutions, such as:

Finding it difficult to keep up with the pace of evolution and the demand of user communities

Needing to reduce application development resources and time to market

Wanting to optimize the allocation of scarce IT resources, skills and budgets

Integrating Web Applications with WAB Page 5

IBM Software

IBM Web Application Bridge Overview

What is Web Application Bridge?

The IBM Web Application Bridge for WebSphere Portal is a feature built on top of WebSphere Portal
and WebSphere Application Server that facilitates low-cost, At the glass integration of existing Web
applications.

The Web Application Bridge uses HTML IFrames and reverse proxy technology to provide an integration
solution conforming to the following major requirements.

Little to no content pre/post processing

Direct access to back-end applications is not allowed

Access to applications can be provisioned by URI

Authentication requirements and request handling can vary depending on an end users location

Why and Where Should I Consider Using Web Application Bridge to Integrate existing Web
Applications For My Customers?

The business users operate in complex, dynamic and diverse environments where competitive
pressures are intense due to globalization and reduced barriers to entry. Your customers demand
applications that deliver business growth now and simply will not tolerate lengthy application
development project durations. They have already invested heavily in applications, infrastructure and
platforms from multiple vendors and do not wish to forgo that investment. However, they want to
leverage IBM WebSphere Portal capabilities to provide a unified experience for end-users.

Overcome Challenges and Deliver Business Value to Your Customers Using Web Application
Bridge and WebSphere Portal

Together Web Application Bridge and WebSphere Portal help overcome the challenges described in the
previous section and provide the ultimate exceptional web experience platform for rapidly delivering rich,
interactive and social applications that enable business growth by attracting, engaging, retaining and
delighting customers. Web Application Bridge provides the fastest way to integrate existing deployed
applications with a web interface into WebSphere Portal and provides the following key benefits:

Faster solution delivery by completely negating the application delivery cycle time

Increased customer satisfaction by preserving ROI

Empowers self-service application integration and provides adaptive role-based applications as

intended by the integrated application

Extensively tested for and certified for integrating MS Sharepoint 2007. Can be used to integrate
all kinds of other web applications as well

Page 6 Integrating Web Applications with WAB

 IBM Software

How Does Web Application Bridge Work?

The Web Application Bridge henceforth mentioned as WAB uses reverse proxy and iframe technology to
provide an integration mechanism for back-end web applications. The term back-end web applications
implies that the application users will be interacting with the IBM WebSphere Portal which will provide an
interface to these applications in its own context.

Each back-end web application to be integrated through WAB needs to be registered through the Virtual
Web Application Manager Portlet. You need to provide a corresponding Virtual Web Application
configuration with runtime parameters used to make an HTTP connection to the application, satisfy its
security requirements and fetch its web content and resources.

The content from the Virtual Web Application is displayed inside a Web Dock Portlet which is a
specialized iframe portlet. It invokes the VWAT Servlet for each request either generated by any user
action or even browser generated activity. The VWAT Servlet proxies the interaction with the back-end
web application and provides its functionality and content to the Web Dock portlet.

Integrating Web Applications with WAB Page 7

IBM Software

Web Application Bridge Lab

Lab User Credentials (Use the credentials below when completing this lab)

Account Type Description User ID / Password

MS Windows 7
IBM WebSphere Portal
MS Sharepoint 2007
Account used to access the lab VM ibm_admin/password
image.
Account used to access WebSphere wpsadmin / wpsadmin
Portal.
Account used to access Sharepoint. ibm_admin/password

Lab Exercise Goals

This is an introductory demonstration of integrating MS Sharepoint 2007 inside IBM WebSphere Portal
v8.0 using WAB. The specific activities covered under this exercise are:

Enable VWAT Servlet

Configure Virtual Web Application for MS Sharepoint 2007 in Virtual Web Application Manager
Portlet

Deploy and Configure Web Dock Portlet to display contents from Virtual Web Application for MS
Sharepoint 2007

Page 8 Integrating Web Applications with WAB

 IBM Software

Lab 1 Setup

1.1 Initial Steps

__1. Navigate to Start Menu All Programs IBM WebSphere IBM WebSphere Portal Server
V8.

__2. Launch First Steps.

__3. Click Work with IBM WebSphere Portal and then Start WebSphere Portal.

Integrating Web Applications with WAB Page 9

IBM Software

1.2 Enable VWAT Servlet

The VWAT Servlet as available Out of the Box, is deployed on a dummy context root of /wps/vwat. We
need to change it to the context root of /. This is required so that all requests on contexts not registered
with the WebSphere Application Server should be handled by the VWAT Servlet which is the reverse
proxy component of WAB.

__1. Login into WAS console.

https://demo.portal.ibm.com:10032/ibm/consoleNavigate

__2. Navigate to the wp.vwat.servlet.ear.

Applications Application Types WebSphere enterprise applications wp.vwat.servlet.ear

You can use a filter, such as wp.vwat.* as above, to find the application quickly.

Page 10 Integrating Web Applications with WAB

 IBM Software

__3. Click on wp.vwat.servlet.ear.

__4. Click on Context Root For Web Modules.

__5. Modify the value of Context Root from /wps/vwat to /.

Integrating Web Applications with WAB Page 11

IBM Software

__6. Click on the Ok button.

__7. Click on Save directly to the master configuration.

Page 12 Integrating Web Applications with WAB

 IBM Software

Lab 2 Configure Virtual Web Application for MS Sharepoint 2007

in Virtual Web Application Manager Portlet

2.1 Create a New Category

__1. Login into WebSphere Portal.

http://demo.portal.ibm.com:10039/wps/portal

__2. Click on Administration.

__3. Click on Virtual Web Application Manager.

Every VWA is required to be under an Administrator-defined Category. It is used for classification of

VWA's.

__4. Click on New Application Category.

Integrating Web Applications with WAB Page 13

IBM Software

__5. Enter the details as per the screenshot below.

__6. Click on the Save button.

2.2 Create a Virtual Web Application (VWA) for MS Sharepoint 2007.

This contains the configuration required for a VWA and is a placeholder for the back-end web
application.

__1. Click on New Application Component.

__2. Enter the details as per the screenshot below.

Page 14 Integrating Web Applications with WAB

 IBM Software

Basic Tab

URI Scheme: HTTP

Host: demo.sharepoint.com

Context Root: /WebResource.axd, /Pages, /_layouts, /PublishingImages, /Wiki%20Site, /Document

%20Workspace, /Team%20Site, /[a-zA-Z0-9]*

Display Name: Sharepoint 2007

Description: For MS Sharepoint 2007.

Category: Sharepoint

Note: You can find the above information in the desktop file Virtual Web Application.rtf , so that you
can cut and paste the information.

Integrating Web Applications with WAB Page 15

IBM Software

Also, please make sure that you add the wpsadmins group in the permissions section :

Connection Tab

Allowed HTTP Methods: GET, POST

User Agent: Forward User Agent

Page 16 Integrating Web Applications with WAB

 IBM Software

Authentication Tab

Type: HTTP

Scheme: Basic

Add Header

Name: User-Agent

Type: Header

Direction: Both

Action: Propagate

Integrating Web Applications with WAB Page 17

IBM Software

Localization Tab

The display name specified here appears as the Web Dock Portlet title. If not specified, then the
display name specified on the Basic tab appears instead. (You do not have to add anything, this
is just informational)

__3. Click Save.

Page 18 Integrating Web Applications with WAB

 IBM Software

Lab 3 Deploy and Configure Web Dock Portlet to display

contents from Virtual Web Application for MS Sharepoint
2007

3.1 Create a page in WebSphere Portal

The page on which the back-end content needs to be displayed.

__1. Click on Home

__2. Go to Edit Mode . Look to the Top Right Hand side. If it says Edit Mode, then click that link.
If it reads View Mode then you are already in Edit Mode and you don't have to do anything.

__3. Click the More button and create a new Sibling Page

Integrating Web Applications with WAB Page 19

IBM Software

__4. Create a Page called WAB Demo . The Friendly URL name will auto-populate:

__5. A new page will be created , with a 2-column Layout.

__6. You will be fitting entire Sharepoint page into this screen so you may want to only have one
column. Choose the 1-column layout by clicking the Layout tab and selecting the appropriate
layout.

__7. Click Save

Page 20 Integrating Web Applications with WAB

 IBM Software

3.2 Configure the page for WAB

The Web Dock portlet which is the iframe component of WAB requires the portal theme to provide
certain capabilities through the page.

__1. Select the Overview Tab, and Edit the Page Properties

__2. Navigate to the Advanced tab on the Page Properties dialog.

__3. Select Profile Full.

Integrating Web Applications with WAB Page 21

IBM Software

__4. Click on the Save button at the bottom.

__5. Navigate to the Content tab.

__6. Search for Web Dock

__7. Place the portlet onto the page by doing drag & drop of the Web Dock Portlet onto the
content hot spot.

__8. Click on Save.

3.3 Configure Web Dock Portlet

__1. Click on Portlet Menu Click on Edit Shared Settings.

Page 22 Integrating Web Applications with WAB

 IBM Software

__2. Enter the details as per the screenshot below.

Edit Shared Settings

__a. URL: /Pages/Default.aspx

__b. Scheme: HTTP

__c. Host: demo.sharepoint.com

__d. Height: 800

__e. Width: 1000

Integrating Web Applications with WAB Page 23

IBM Software

__3. Click on the Save Button.

The page will ask you to enter the credentials because MS Sharepoint 2007 as configured requires
Basic Authentication.

You may see the following error :

__4. Click on Portlet Menu Personalize.

__5. Enter the credentials.

__6. Click on the Save button.

Page 24 Integrating Web Applications with WAB

 IBM Software

__7. The MS Sharepoint page displays as per the screenshot.

You can experiment with the layout and iframe settings to get an optimum display.

Navigate to various Sharepoint pages and execute functionality.

Integrating Web Applications with WAB Page 25

IBM Software

Conclusion
You have been able to setup the Web Application Bridge for IBM WebSphere Portal and successful in
using it to integrate MS Sharepoint 2007. The Web Application Bridge (WAB) can be used to integrate
other public internet sites as well as other business and social applications. The Web Application Bridge
provides an extended list of features & capabilities like Inter Portlet Communication, SPNEGO
authentication using Kerberos etc.

Page 26 Integrating Web Applications with WAB

 IBM Software

Resources
Web Application Bridge for IBM WebSphere Portal

Catalog download link

(This will be the most updated version available)

https://greenhouse.lotus.com/plugins/plugincatalog.nsf/assetDetails.xsp?
action=editDocument&documentId=9FAAD6D44DC64231852577EB006F4D9D

Wiki link

http://www-10.lotus.com/ldd/portalwiki.nsf/dx/Integrating_with_the_web_application_bridge_wp8

Integrating Web Applications with WAB Page 27

IBM Software

Appendix A Notices
This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries.
Consult your local IBM representative for information on the products and services currently available in
your area. Any reference to an IBM product, program, or service is not intended to state or imply that
only that IBM product, program, or service may be used. Any functionally equivalent product, program,
or service that does not infringe any IBM intellectual property right may be used instead. However, it is
the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or
service.

IBM may have patents or pending patent applications covering subject matter described in this
document. The furnishing of this document does not grant you any license to these patents. You can
send license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation

Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any other country where such
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION
PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-
INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states
do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement
may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically
made to the information herein; these changes will be incorporated in new editions of the publication.
IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part
of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.

Page 28 Integration Between WebSphere Portal and Forms Experience Builder

 IBM Software

Any performance data contained herein was determined in a controlled environment. Therefore, the
results obtained in other operating environments may vary significantly. Some measurements may have
been made on development-level systems and there is no guarantee that these measurements will be
the same on generally available systems. Furthermore, some measurements may have been estimated
through extrapolation. Actual results may vary. Users of this document should verify the applicable data
for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their
published announcements or other publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of
those products.

All statements regarding IBM's future direction and intent are subject to change or withdrawal without
notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples include the names of individuals, companies, brands, and
products. All of these names are fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental. All references to fictitious companies or individuals are
used for illustration purposes only.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs
in any form without payment to IBM, for the purposes of developing, using, marketing or distributing
application programs conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly tested under all
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these
programs.

Appendix Page 29
IBM Software

Appendix B Trademarks and copyrights

The following terms are trademarks of International Business Machines Corporation in the United States,
other countries, or both:
IBM AIX CICS ClearCase ClearQuest Cloudscape
Cube Views DB2 developerWorks DRDA IMS IMS/ESA
Informix Lotus Lotus Workflow MQSeries OmniFind
Rational Redbooks Red Brick RequisitePro System i
System z Tivoli WebSphere Workplace System p

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or
trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications

Agency which is now part of the Office of Government Commerce.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel
SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its
subsidiaries in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the
United States, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of The Minister for the Cabinet
Office, and is registered in the U.S. Patent and Trademark Office.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle
and/or its affiliates.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other
countries, or both and is used under license therefrom.

Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are trademarks of HP, IBM Corp.
and Quantum in the U.S. and other countries.

Page 30 Integration Between WebSphere Portal and Forms Experience Builder

NOTES
NOTES

Copyright IBM Corporation 2012

The information contained in these materials is provided for

informational purposes only, and is provided AS IS without warranty
of any kind, express or implied. IBM shall not be responsible for any
damages arising out of the use of, or otherwise related to, these
materials. Nothing contained in these materials is intended to, nor
shall have the effect of, creating any warranties or representations
from IBM or its suppliers or licensors, or altering the terms and
conditions of the applicable license agreement governing the use of
IBM software. References in these materials to IBM products,
programs, or services do not imply that they will be available in all
countries in which IBM operates. This information is based on
current IBM product plans and strategy, which are subject to change
by IBM without notice. Product release dates and/or capabilities
referenced in these materials may change at any time at IBMs sole
discretion based on market opportunities or other factors, and are not
intended to be a commitment to future product or feature availability
in any way.

IBM, the IBM logo, and ibm.com are trademarks of International

Business Machines Corp., registered in many jurisdictions
worldwide. Other product and service names might be trademarks of
IBM or other companies. A current list of IBM trademarks is
available on the Web at Copyright and trademark information at
www.ibm.com/legal/copytrade.shtml.