IBM Tivoli Integrated Portal (TIP) pimD

This page documents the enPortal integration for IBM Tivoli Integrated Portal (TIP).

If you are using portal version 5.4 or above please click here for the integration documentation applicable to it

  • Vendor: IBM
  • Product: Tivoli Integrated Portal (TIP)
  • Supported Version(s): 2.2.0
  • Name of enPortal Integration Package: ibm.tip.common_pimD
  • Required enPortal Version: 4.6.1 and above


The following section documents supported platforms, installation, and configuration of the Tivoli Integrated Portal (TIP) Product Integration Module on enPortal versions 4.6.1 and above.

Page Contents

1. Support Matrix

The following Operating System, Database, and Web Browser platforms are supported:


1.1. Operating System

Please see the list of supported Operating Systems on the System Requirements page.


1.2. Database

A special database is not required to implement this integration module. The AppBoard/enPortal database is used to store all configurations related to this integration module.


1.3. Web Browser

Please see the list of supported Web Browsers on the System Requirements page.


2. Installation

Perform the following steps to install the Tivoli Integrated Portal (TIP) PIM:

  1. Install AppBoard/enPortal as detailed in the Installation documentation
  2. Download the file ibm.tip.common_pimD.jar
  3. Start enPortal and login as a portal administrator
  4. Under the Advanced tab, select PIMImport
  5. Click the Browse... button
  6. Locate the file ibm.tip.common_pimD.jar in the Open dialog
  7. Click the Start button to extract the files from the PIM .jar archive
  8. Under the Advanced tab, select XMLImport
  9. Click the Start button to load the PIM into the system
  10. Confirm that the following message is displayed: "Import completed; loaded the following file(s): load_ibm.tip.common_pimD.txt"
  11. Under the Advanced tab, select Explore System
  12. Navigate to the /Directory/system/proxy/ folder and locate the “Manage Proxy” channel
  13. Right-click on the “Manage Proxy” channel and select Open to launch the channel
  14. In the Manage Proxy tool, click “Reset All”

3. Integration Details

The following sections provide special details for configuring the integration module after installation.


3.1. Channel Types

  • Home - Channel that displays the default Home page for the logged in user, including full navigation controls (no custom configuration required)
  • Proxy - Channel that is used by the system to display Tivoli Integrated Portal (TIP) channels (no custom configuration required)
  • ConfigurationValidation - Channel that displays the TIP Configuration validation page.
  • ManageUsersGroups - Channel that displays the TIP manage users groups page.
  • RuntimeMessages - Channel that displays the TIP runtime messages page.
  • Security-Admin-Troubleshooting - Channel that displays the TIP security admin troubleshooting page.
  • Settings - Channel that displays the TIP settings page.

3.2. Configuration

After installing the Tivoli Integrated Portal (TIP) PIM, perform the following steps to configure access to the host Tivoli Integrated Portal (TIP) server:

  1. Click on the Applications tab
  2. Right-click on the name sample in the row for Tivoli Integrated Portal (TIP) (ibm.tip.common_pimD) and select Modify
  3. Fill in the items in the Modify Application Wizard dialog:
    1. Select the protocol used to access your Tivoli Integrated Portal (TIP) server (http or https)
    2. Change the host name from "changeme" to the hostname or ip address that will resolve to your Tivoli Integrated Portal (TIP) server
    3. Change the port to the port number of your Tivoli Integrated Portal (TIP) server
    4. Click "Save" to keep your changes
  4. Click on the Integrations tab
  5. In the Explorer, under Packages, expand the cuculus.zonoscontrolcenter_pimA tree and click on the sample target. Confirm that the information you entered is displayed for your Tivoli Integrated Portal (TIP) server
  6. Under the sample target, click on the Home channel. A login prompt should be displayed.
  7. Log in using the same credentials you would use for accessing the Tivoli Integrated Portal (TIP) application in a browser. Confirm that the Tivoli Integrated Portal (TIP) Home page is displayed.

This pim comes with two targets, Sample and Admin. This is related to that TIP usually run on at least two ports, 16316 for TIP administration function, 16311 for TIP application.

If you will need to provide TIP administration functionality related channels, you will need to repeated the above steps for Admin target, too.

3.3. Create Channels

After installing the Tivoli Integrated Portal (TIP) PIM and configuring access to the host Tivoli Integrated Portal (TIP) server, perform the following steps to create channels to display Tivoli Integrated Portal (TIP) content:

  1. Click on the Applications tab
  2. Right-click on the name "sample" in the row for ibm.tip.common_pimD and select a channel type
  3. In the "Channel Name" box, enter the name you want to give to the new channel
  4. For "Channel Type", select "3rd Party Pims"
  5. Select Pim, Class, and Target for your channel
  6. Click Next
  7. Click Finish
  8. Click on the Integrations tab
  9. In the Explorer, under Packages, expand the ibm.tip.common_pimD tree and click on the sample target. Confirm that the new channel is listed along with the other sample channels

Repeat the above steps to create additional channels. Select a different Channel Type in step 2 to create a different type of channel.


3.4. Known Issues

The following known issues are associated with this PIM:

  • For additional information Tivoli Integrated Portal. Please see the online documentation v2.2.
  • This pim is the general pim for TIP and it provides SSO to TIP application. The other Tivoli applications such as WebGUI, TBSM, TCR have their own respective pims. The pims that built for those specific applications depend on this tip.common pim to perform SSO. Therefore, the specific Tivoli application requires two pims to be installed in enPortal.

3.5. License Usage

In order for the AppBoard/enPortal administrator to configure the ibm.tip.common_pimD PIM, the AppBoard/enPortal license.properties file must include licensing for at least one ibm.tip.common_pimD server. The administrator can create one additional host ("target") in AppBoard/enPortal for each server license included in the license file.

Each AppBoard/enPortal user maintains one user session with the Tivoli Integrated Portal (TIP) server. The Tivoli Integrated Portal (TIP) application must be licensed to support the number of users that will be accessing the application through AppBoard/enPortal.


3.6. Version Support

The following matrix details the supported Tivoli Integrated Portal (TIP) and compatible AppBoard/enPortal versions:

Version Support
Package Name enPortal Version Tivoli Integrated Portal (TIP) Supported Versions
ibm.tip.common_pimD 4.6.1+ 2.2.0
To see the current enPortal version, run the portal version command from the [AppBoard_Home]/server/bin directory.

4. Upgrades

4.1. Upgrading from an older version

Older versions of Tivoli Integrated Portal (TIP) are not supported by this PIM, so this upgrade path is not supported. It is recommended that you validate the PIM in your Tivoli Integrated Portal (TIP) environment to confirm that it supports the required functionalities.


4.2. Upgrading to a newer version

Perform the following steps when the Tivoli Integrated Portal (TIP) server is upgraded to a newer version of Tivoli Integrated Portal (TIP):

  1. Check the AppBoard/enPortal PIM online documentation to see if the new Tivoli Integrated Portal (TIP) version is supported by the existing ibm.tip.common_pimD PIM.
  2. Test if the new Tivoli Integrated Portal (TIP) version is supported by the existing PIM that you have installed, perform the following steps:
    1. Click on the Applications tab
    2. Right-click on the row for the old Tivoli Integrated Portal (TIP) server and select "Modify"
    3. Update the protocol, host, and port to reference the server where the new version of Tivoli Integrated Portal (TIP) is running
  3. If the new Tivoli Integrated Portal (TIP) version is not supported by the existing PIM that you have installed, perform the following steps to upgrade the PIM:
    1. Download the new PIM version from the PIM download site
    2. Follow the steps in the Installation section above to install and configure the new PIM version
    3. Re-create all Tivoli Integrated Portal (TIP) channels to reference the new PIM
    4. [Optional] Perform the steps outlined in the Uninstall section below to remove the old PIM from the system


5. Uninstall

Perform the following steps to uninstall the ibm.tip.common_pimD PIM:


Uninstalling the ibm.tip.common_pimD PIM will break all of the channels in your AppBoard/enPortal system that reference this integration.
  1. Click on the Integrations tab
  2. In the Explorer, under Packages, locate the ibm.tip.common_pimD integration
  3. Right click on the integration name, and select "Delete"
  4. Click "Ok" to confirm that you want to delete the integration package