Setup the collaboration between Portal Server and BTT Application Server

Procedure

  1. Access Your Portal Instance
    1. Please login Portal at http://jonder.cn.ibm.com:10039/wps/portal using your username and password that inputted during the setup process.
  2. Register BTT Application Server URL in your local Portal Instance
    1. Select Administration>Portlet Management>Virtual Web Application Manager
    2. Select “New>Application category” to create a new category. This category is a placeholder to hold your multiple applications. It is suggested that keep your same kind of applications such as BTT in one category.
    1. Then select New>Application component, to create a new application under the previous category. Enter the following information on the Basic tab of your application components:
      1. Select HTTP or HTTPS, and define the URI scheme.
      2. Select the appropriate Host from the list of available Web servers. The host name should be the fully qualified host name of your backend server. Notes here: localhost or computer name are not accepted here.
      3. Enter a display name for your application.
      4. Enter a description for your application.
      5. Select the appropriate category for your application.
  3. Propagate the necessary token
    1. Select the Authentication tab and define how users authenticate with the Web application, following three headers shall be correctly propagated:
      • User-Agent
      • requesttype
      • X-Requested-With
  4. Configure Your Portal Page: After creating the application, you must add a Web Dock portlet onto a page so that users can access the Web application:
    1. Navigate to Administration>Manage Pages, and click Content Root.
    2. Click New Page and create a page for your Web application.
    3. After selecting or creating a page, click the Edit Page Properties icon and select Advanced options.
    4. Click “I want to set parameters,” enter the following information, and then click Add:
      • New parameter:resourceaggregation.profile
      • New value:Enter the profile override for the page, for example profiles/profile_full.json
    5. Click OK to save the new parameter.
    6. Click OK to save the changes to the page properties.
  5. Configure the Web Dock portlet
    1. Select Administration>Manage Pages>Content Root>BTT, Click “Edit Page Layout”.
    2. Switch to Edit Mode
    3. Click "Add portlets"
    4. Search “web dock” -> check “Web Dock Portlets” -> Click “OK”.
  6. Configure BTT application in front page.
    1. We can find a “BTT” link exists in navigate bar, Click it, and switch into Edit Mode.
    2. Click “Edit Shared Setting”, fill the form according to your environment. After saving it, switch into View Mode.

Results

Congratulations, now we can visit BTT application in Portal!