Scenario: Remote debug development environment for WebSphere Portal on Linux

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 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 (C57I0ML.bin, wsextract.bin) - Contains core installation files.
   • Part 2 (C57I1ML.bin, Required.bin) - Contains core installation files.
2. Launch the wsextract.bin 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 Application Developer Integration Edition V5.1.1

Installation steps

1. Log in as root user.
2. Run launchpad.bin of WebSphere Studio
3. Click "Install IBM WebSphere Studio".
4. Change the default Directory Name. Please note the following:
   • Do not use double-byte characters or special characters such as periods (".") or dollar signs ("$").
   
5. Ensure the required features are checked.
6. You can deselect the WebSphere Application Server 5.1 checkbox under Integrated Test Environments.
   
7. Verify that the installation was completed successfully by starting the application.
   1. If you want to use the double-byte character set on Red Hat 8.0, you will need to upgrade GTK 2.0 to GTK 2.2.2 or later. However, support for Korean, Simplified Chinese, Japanese, and Traditional Chinese languages is not fully functional. To avoid these limitations, use the product in English. To upgrade GTK, refer to "(Optional) Upgrading to GTK 2.2.2 or later" in the Installation Guide of WebSphere Studio Version 5.1.2.
   2. Log out and log in as a user that is used for the development.
   3. In a command prompt, type the following command:

      /usr/bin/wssitedev51 or /usr/bin/wsappdevie51

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. Log in as root user.
2. Download Portal Toolkit V5.0.2.3: ptk5023Linux.bin and RequiredLinux.bin from the Portal Toolkit web site.
3. Launch the ptk5023Linux.bin file. This starts the wizard that creates the installation image.
4. Specify where you want to create the image.
   Important: Do not use special characters.
5. Leave the Core installation files feature checkbox selected.
6. 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 not running.
2. Log in as root user.
3. Stop the HTTP server if it has been started.
4. Run the installation program by launching ptkimg/PortalToolkit5023/setup.bin, where ptkimg is the directory that you have created the installation image.
5. Click Next on the welcome panel, read and accept the license agreement, and click Next.
6. You do not need to select the WebSphere Portal for Test Environment and click Next.
   
7. Make sure the install location displayed is the installation directory of WebSphere Studio.
8. Click Next. Portal Toolkit will be installed.
9. When the installation is completed, click Finish.
10. Launch WebSphere Studio.
    1. If you want to use the double-byte character set on Red Hat 8.0, you will need to upgrade GTK 2.0 to GTK 2.2.2 or later. However, support for Korean, Simplified Chinese, Japanese, and Traditional Chinese languages is not fully functional. To avoid these limitations, use the product in English. To upgrade GTK, refer to "(Optional) Upgrading to GTK 2.2.2 or later" in the Installation Guide of WebSphere Studio Version 5.1.2.
    2. Log out and log in as a user that is used for the development.
    3. In a command prompt, type the following command:

       /usr/bin/wssitedev51 or /usr/bin/wsappdevie51

11. You will see the Configuration Changes panel.
    
12. Select the pending configuration change that is displayed.
13. Click Finish.
14. When the update is completed, you will be prompted to restart the workbench. Click Yes to restart.
15. 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 the Studio.
   1. If you want to use the double-byte character set on Red Hat 8.0, you will need to upgrade GTK 2.0 to GTK 2.2.2 or later. However, support for Korean, Simplified Chinese, Japanese, and Traditional Chinese languages is not fully functional. To avoid these limitations, use the product in English. To upgrade GTK, refer to "(Optional) Upgrading to GTK 2.2.2 or later" in the Installation Guide of WebSphere Studio Version 5.1.2.
   2. Log out and log in as a user that is used for the development.
   3. In a command prompt, type the following command:

      /usr/bin/wssitedev51 or /usr/bin/wsappdevie51

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