Web application bridge - Get started

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.

2. Log on to Portal and go to...
   Administration | Portlet Management | Virtual Web Application Manager | Content Provider Profiles | Create Content Provider Profiles

   ...and create the content provider profile.

   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.

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

   ...and create the web dock application.

5. Go to the application created.

6. 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

7. The content author logs in to WebSphere Portal.

8. 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

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

   1. Log on to 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