Installing IBM WebSphere Portal Integration for Enterprise Marketing Management

You can download and install the IBM® WebSphere® Portal Integration for Enterprise Marketing Management add-on from the IBM Collaboration Solutions catalog. The add-on is delivered as a Portal Application Archive (PAA) file.

About this task

After you install this package, you can see a new Marketing section in the Content section of the site toolbar in WebSphere Portal. This Marketing section contains the IBM Marketing Center Spot and IBM Interact Spot portlets.

Before you add these portlets to the page, the WebSphere Portal administrator and the Marketing Center or Interact administrator must complete the configuration and other steps.

Procedure

  1. Download the emm-integration.zip file from the IBM Collaboration Solutions catalog and extract it to a location on your portal server.
  2. Change to the wp_profile_root/ConfigEngine directory.
  3. Install the emm-integration.paa file.
    Note: If you are installing to a cluster environment, repeat this step for every node in the cluster.
    • AIX® HP-UX Linux Solaris:- ./ConfigEngine.sh install-paa -DWasPassword=password -DPortalAdminPwd=password -DPAALocation=file_path_emm-integration.paa
    • IBM i:- ConfigEngine.sh install-paa -DWasPassword=password -DPortalAdminPwd=password -DPAALocation=file_path_emm-integration.paa
    • Windows:- ConfigEngine.bat install-paa -DWasPassword=password -DPortalAdminPwd=password -DPAALocation=file_path_emm-integration.paa
  4. Deploy the emm-integration.paa file.
    Note: If you are installing to a cluster environment, repeat this step for every node in the cluster.
    • AIX HP-UX Linux Solaris:- ./ConfigEngine.sh deploy-paa -DPortalAdminIdShort=Short_name_for_WebSphere_Portal_administrator -DPortalAdminPwd=password DWasPassword=password-DappName=emm-integration
    • IBM i:- ConfigEngine.sh deploy-paa -DPortalAdminIdShort=Short_name_for_WebSphere_Portal_administrator -DPortalAdminPwd=password DWasPassword=password-DappName=emm-integration
    • Windows:- ConfigEngine.bat deploy-paa -DPortalAdminIdShort=Short_name_for_WebSphere_Portal_administrator -DPortalAdminPwd=password DWasPassword=password-DappName=emm-integration
  5. If your portal's URLs are prefixed by a customized context root, complete the following manual updates after you install the PAA.
    1. Log in to Portal as an admin and go to Applications > Content > Web Content Authoring.
    2. If the Marketing library does not appear in the list of WCM libraries, click Preferences > Edit Shared Settings > Library Selection. Add the Marketing library and click OK.
    3. Click Marketing > Components > Interact. A list of components appears, including JSP components, which must be edited.
    4. Select the check box next to Interact Edit Mode Finalizer and then click Edit.
    5. Update the Path field by replacing wps with your portal's context root. For example, if your portal's context root is my_new_context_root, replace wps with my_new_context in the Path field. If your Portal has no context root, remove the /wps from the beginning of the path.
    6. Click Save and Close to return to the list of Interact components.
    7. Repeat steps d to f for each of the following components
      • Interact list Item Processor
      • Interact List Item Renderer
      • Interact View Mode Finalizer
    8. Click Components in the breadcrumb trail and then Marketing Center.
    9. Repeat steps d to f for each of the following components
      • Marketing Center Edit Mode Renderer
      • Marketing Center View Mode Renderer
    10. In the breadcrumb trail, click Marketing, then Presentation Templates > Interact > IBM Interact Spot, then click Edit.
    11. Search for the single occurrence of /wps/PA_wp.emm/images/blank.png and then replace wps in the path with your portal's context root. If your Portal has no context root, remove the /wps from the beginning of the path.
    12. Click Save and Close.
    13. Click Presentation Templates in the breadcrumb trail, then Marketing Center > IBM Marketing Center Spot, then click Edit.
    14. Search for three occurrences of /wps/PA_wp.emm/images/blank.png and then replace wps in the path with your portal's context root. If your Portal has no context root, remove the /wps from the beginning of the path.
    15. Click Save and Close.