Portal Toolkit

 

+
Search Tips   |   Advanced Search

 

Overview

This topic describes how to install Portal Toolkit V5.0 for use with WebSphere Studio Site Developer V5.0.1. The Portal Toolkit can be downloaded from...

http://www.ibm.com/websphere/portal/toolkit

If you have a version of Portal Toolkit prior to V5.0, remove it before installing Portal Toolkit V5.0. Also, make sure WebSphere Studio is installed but not running before installing Portal Toolkit.

  1. Launch the Portal Toolkit installation from the install.bat file in the download package.

  2. During the installation, you are prompted to select components to install. The Portal Toolkit component is already selected. For the local debug configuration, select WebSphere Portal for Test Environment.

  3. When prompted, select which components you want installed.

     

    Portal Toolkit V5.0

    WebSphere Portal V5.0 for Test Environment

    WebSphere Portal V4.2 for Test Environment

     

  4. For the local debug configuration, you are prompted for the location of the WebSphere Portal installer. For example, the following values are used if the CD is inserted into the E:\> drive.

     

     

     

  5. When the installation is complete, reboot the machine.

  6. Open WebSphere Studio.

  7. When you are prompted to open Update Manager, click Yes. The pending configuration changes are displayed by a date and time stamp.

  8. Select the date and time for the Portal Toolkit installation. If you expand the selection, you will see a list of all of the pending configuration changes. Click Finish.

When the update is complete, you are prompted to restart WebSphere Studio. After you restart WebSphere Studio, you are ready to start work in the portlet development environment.

 

Troubleshooting Portal Toolkit installation

If the Portal Toolkit installation ends with a general failure message that doesn't point directly to an obvious failure reason, check the log files TkWpsInst.log and TkWpsConfig.log for an entry like: 


   Running WebSphere Portal 5.0.0.0 configuration task.
   The input line is too long.

This error is caused by an environment variable which exceeds the 256 character limitation of Windows operating systems. The install procedure appends various files and directories to existing environment variables which might produce an environment variable which is too long. Often it is the PATH environment variable that is affected. Check the affected variables, especially PATH, and delete duplicate or not required entries to shorten the variable within the 256 character limit.

See also