Web application bridge - Get started

See also

• Getting started with the Web Application Bridge | HCL WebSphere Portal
• Integrate existing web applications with the IBM Web Application Bridge

Follow steps below if the portal context root (site URL) has not been removed from /wps/portal. If it has been modified, see instead Getting started with the Web Application Bridge | HCL WebSphere Portal

1. Set the context root for wp.vwat.servlet.ear:

   1. Log on to the WAS console and go to...
      Applications | Application Types | WebSphere enterprise applications | wp.vwat.servlet.ear | Web Module Properties | Context Root For Web Modules

   2. Change the context root to /.

      To avoid name conflicts, add a rewrite rule using the Apache module mod_rewrite, and provide short vanity URLs.

   3. Click OK.

   4. Click Save to save the changes to the master configuration.

   5. Restart wp.vwat.servlet.ear.

   Log on to Portal and go to...

   Administration | Portlet Management | Virtual Web Application Manager | Content Provider Profiles | Create Content Provider Profiles

   Do not enter < or > into any of the text boxes. There is a known security issue. A user can write a JavaScript to hijack the Virtual Web Application Manager and Web Dock portlets.

2. Create the content provider profile.

3. Go to the new profile and click...
   Add policy

   Create at least one policy for the content provider profile.

4. Click...
   Web Dock Applications | Create Web Dock Applications

5. Create the web dock applications.

6. Go to the application created.

7. Selects one of the following tabs, and then click Edit to configure the web dock settings:
   • Web Dock Display Settings
   • Client Side IPC for Web Dock
   • Server Side IPC for Web Dock
   • Plugins

8. The content author logs in to HCL WebSphere Portal.

9. The content author accesses the site toolbar, and takes one of the following actions:
   • Creates a page and adds the web dock application portlet to the page.
   • Edits an existing page and adds the web dock application portlet to the page.

   To get the web dock application to render on a page, the page must either have the Web Dock profile or a profile that includes the wp_webdock module. Edit the page properties and change the profile or add the wp_webdock module to the profile applied to the page:

   1. Connect to the theme repository with the fs-type1 connection.

   2. Go to the theme.

   3. Open the profile file in the /profiles directory.

   4. Make a copy of the profile file and give it a unique name.

   5. Edit the .json file and add the wp_webdock module ID.

   6. Copy the profile created to the /profiles directory.

   7. Invalidate the resource aggregator cache to integrate the changes.
      Administration | Theme Analyzer | Utilities | Control Center | Invalidate cache

10. If a content author experiences issues with viewing the web dock applications, update the user role:

    1. Log on to HCL WebSphere Portal as the administrator and click...
       Administration | Access | Resource Permissions

    2. Search for the page containing the web dock application.

    3. Give the content author the correct permissions to the page.

    4. If the content provider policy is set to use basic or form-based authentication...
       • Go to the web dock application and give the content user the correct permissions.
       • Go to the credential vault used for the authentication. Give the content user the correct permissions to the credential vault.

Parent Web application bridge