Scenario: Remote debug development environment for WebSphere Portal on Windows

This scenario sets up the "WebSphere Portal Server Attach" configuration. WebSphere Studio V5.1.2 and Portal Toolkit V5.0.2.3 will be installed on the development machine. WebSphere Portal will be installed on a separate remote machine.

WebSphere Studio V5.1.2 is as follows:

• WebSphere Studio Site Developer (WSSD) V5.1.2
• WebSphere Studio Enterprise Developer (WSED) V5.1.2
• WebSphere Studio Application Developer Integration Edition (WSAD IE) V5.1.1

1. Creating the WebSphere Studio V5.1.2 Installation image
2. Installing WebSphere Studio
3. Creating the Portal Toolkit V5.0.2.3 Installable image
4. Installing Portal Toolkit V5.0.2.3
5. Set up the portal server on a remote machine
6. Verifying the installation

Creating the WebSphere Studio V5.1.2 Installation image

If you have the WebSphere Studio V5.1.2 CD or the network installation image, you can skip this step.
The following step is only for WSSD V5.1.2. For WSED V5.1.2 and WSAD IE V5.1.1 users, please refer to their installation guides.

Prerequisites:

• Your environment variable TEMP or TMP must point to a valid temporary directory with at least 167 MB free. This is in addition to the space required to install the product.
• You must have approximately 4 GB of disk space to store the full set of downloadable images plus another 4 GB of disk space to unpack the images.

To download and create the installation image:

1. Download the following 2 parts at a minimum. The rest are optional.
   • Part 1 (C57HMML.exe, wsextract.exe) - Contains core installation files.
   • Part 2 (C57HNML.bin, Required.bin) - Contains core installation files.
2. Launch the wsextract.exe file that is located in this temporary directory. This starts the wizard that creates the installation image.
3. Follow the instructions in the wizard to specify where you want to create the image.
4. Select the following feature at a minimum.
   • Core Installation files
5. After the image is created, deselect Start the installation wizard now before you click Finish.

Return to top

Installing WebSphere Studio

Install either of the following:

• WebSphere Studio Site Developer V5.1.2
• WebSphere Studio Enterprise Developer V5.1.2
• WebSphere Studio Application Developer Integration Edition V5.1.1

Installation steps

1. Run launchpad.exe of WebSphere Studio
2. Click "Install IBM WebSphere Studio".
3. Change the default Directory Name. Please note the following:
   • Specify a short directory name such as c:\WSSD.
   • Do not use double-byte characters or special characters such as periods (".") or dollar signs ("$").
   
   
4. Ensure the required features are checked.
5. You can deselect the WebSphere Application Server 5.1 checkbox under Integrated Test Environments.
   
6. Verify that the installation was completed successfully by starting the application.
   1. Select Start > Programs > IBM WebSphere Studio > Site Developer 5.1.2, Enterprise Developer 5.1.2 or Application Developer Integration Edition 5.1.1 to start the application.
   2. Change the default workspace directory name to a shorter one (one with a short path length such as c:\wssdwork).

Return to top

Creating the Portal Toolkit V5.0.2.3 Installable image

Prerequisites:

• Your environment variable TEMP or TMP must point to a valid temporary directory with at least 130 MB free. This is in addition to the space required to install the product.
• You must have approximately 300MB of disk space to store the full set of downloadable images and to unpack the images.

To create the installable image:

1. Download Portal Toolkit V5.0.2.3: ptk5023Win.exe and RequiredWin.bin from the Portal Toolkit web site.
2. Launch the ptk5023Win.exe file. This starts the wizard that creates the installation image.
3. Specify where you want to create the image.
   Important: Do not use special characters.
4. Leave the Core installation files feature checkbox selected.
5. After the image is created, click Finish.

Return to top

Installing Portal Toolkit V5.0.2.3

Carry out the following steps:

1. Make sure WebSphere Studio is installed but not running.
2. Stop the HTTP server if it has been started.
3. Run the installation program by launching ptkimg\PortalToolkit5023\setup.exe, where ptkimg is the directory that you have created the installation image.
4. Click Next on the welcome panel, read and accept the license agreement, and click Next.
5. You do not need to select the WebSphere Portal for Test Environment and click Next.
   

6. Make sure the install location displayed is the installation directory of WebSphere Studio.
7. Click Next. Portal Toolkit will be installed.
8. When the installation is completed, click Finish.
9. Launch WebSphere Studio.
   1. Select Start > Programs > IBM WebSphere Studio > Site Developer 5.1.2, Enterprise Developer 5.1.2 or Application Developer Integration Edition 5.1.1 to start the application.
   2. Change the default workspace directory name to a shorter one (one with a short path length such as c:\wssdwork).
10. You will see the Configuration Changes panel.
    
11. Select the pending configuration change that is displayed.
12. Click Finish.
13. When the update is completed, you will be prompted to restart the workbench. Click Yes to restart.
14. Portal Toolkit installation is completed.

Return to top

Set up the portal server on a remote machine

Refer to the InfoCenter of WebSphere Portal on the WebSphere Portal Product Documentation.

Return to top

Verifying the installation

The installation is completed. To verify the remote debug configuration, carry out the following steps:

1. In the remote server, start WebSphere Portal.
2. In a browser, enter the address "http://hostname.yourco.com/wps/portal" to ensure that the server is running.
3. Launch WebSphere Studio.
   1. Select Start > Programs > IBM WebSphere Studio > Site Developer 5.1.2, Enterprise Developer 5.1.2 or Application Developer Integration Edition 5.1.1 to start the application.
   2. Change the default workspace directory name to a shorter one (one with a short path length such as c:\wssdwork).
4. From the menu, select File > New > Other > Server > Server and Server Configuration. A wizard starts.
   1. Enter the server name.
   2. In the Server type, expand the WebSphere Portal that you will debug portlets on.
   3. Select Server Attach and click Next.
   4. Enter the fully-qualified host name or the IP address of the remote server in the hostname.
   5. Click Finish.
5. In the Servers view, right-click on the server and select Debug.
6. Verify that the server starts successfully.

Return to top