1. System Requirements

To use WebSphere with MyEclipse, you must have a MyEclipse Blue or Bling subscription.

This tutorial was created with MyEclipse, WebSphere 6.1 and the associated Web Service and EJB Feature Packs (as well as 3 update packs) all on Windows.

If you are on Unix/Linux, please see the appropriate WebSphere docs to guide you through the exact programs to launch that are synonymous with the ones outlined in this Windows tutorial. If there are comparable executables on Linux, the instructions, except for the directory paths, will be very similar.

Note: There is no WebSphere installation available for Macintosh.

2. Prerequisites

This document looks fairly sizable because there are many steps  covered in it and you need a handful of different software programs to complete it. Below is a list of what is used in this tutorial and potential alternatives to which you might have access.

• WebSphere Application Server 6.1 Install (We used a ZIP, CD/DVD should work as well)
• Latest WebSphere Update Installer (We used a ZIP, CD/DVD should work as well)
• WebSphere Application Server 6.1.0.x Update PAK (.PAK file)
• WebSphere 6.1 Web Service Feature Pack (We used a ZIP, CD/DVD should work as well)
• WebSphere 6.1 PK53084 Interim Fix PAK (.PAK file)
• WebSphere 6.1 Web Service Feature Pack Fix PAK (.PAK file)
• WebSphere 6.1 EJB 3.0 Feature Pack (We used a ZIP, CD/DVD should work as well)

These are the installers, packs and PAKs used for this tutorial. If you are reading this tutorial at a later date and additional Feature Packs or update PAKs are available, be sure that none of the additional updates interfere with the functions of the Feature Packs outlined in this document. Most likely, there will be no conflicts.

3. Install WebSphere 6.1

1. If you downloaded WebSphere 6.1 in the form of a ZIP file, unzip it. If you have a CD or DVD, insert the disk.
2. If the startup installer app doesn’t launch automatically from the CD/DVD and you need to launch it manually, the name of the executable is launchpad.exe. Double-click the .exe to run it.
   
   Websphere installer executable file
3. After Launchpad starts, click the first option to run the WebSphere Application Server installer.
   
   Websphere Welcome screenNote: If for some reason the link doesn’t work (e.g., for operating system security restrictions), you can close Launchpad and launch the WebSphere Application Server installer by going into the WAS folder, and running install.exe.
   
   After the installer has initialized, the Installation wizard screen appears:
   Websphere installation wizard
4. For the most part, accepting the defaults through the installation is fine. When you reach the Administrative Security portion of the wizard, disable that feature by deselecting the checkbox. Click Next.
   
   Disabling administrative securityThis tutorial is geared towards a development installation of WebSphere Application Server, which is why Administrative Security is not necessary.
5. You are presented with a summary of the installation actions to be performed. Click Next again to begin installation.
6. After the installer is done, click Finish to open the First Steps console.
7. Click the Installation verification link on the First Steps console. Websphere starts up and a console window appears, displaying the startup log.
   
   First steps – installation verification
8. Look for verification success messages at the end of the console log before the installation is verified. This can take a few minutes to display.
   
   Installation verification console message
9. After the installation is verified, close the console window, and click Stop the Server on the First Steps console. Another console log appears. Close the Console window when complete.
10. Close the First Steps console. Your installation of WebSphere Application Server is complete.

Note: If your default browser is at a path that includes embedded spaces, you might have difficulty during installation. If this is the case, modify the firststeps.bat file (in the firststeps folder of the profile) to add double quotes around all instances of %FirstStepsDefaultBrowserPath%.

4. Disable the Windows System Service

By default, when WebSphere Application Server is installed, the installer adds a Windows System Service that runs WebSphere automatically on boot up. This is typically necessary only on a production server, but on a development machine, starting an entire application server on startup not only slows down your startup, but it also conflicts with managing WebSphere from inside MyEclipse. Because of this, you should disable this system service so it doesn’t start on boot up.

1. On Windows XP, click the Start Menu, then Control Panel and then Administrative Tools and Services to find the list of system services. On Vista and 7, open the Start Menu and type Services into the filter box to find the link.
   
   Opening Windows services
2. On the Services window, scroll down to the service named IBM WebSphere Application Server V6.1 and likely the computer node name after that. Right-click the service, and select Properties or double-click the entry to to open its service properties.
3. Select Disabled or Manual from the Startup type drop-down, and click OK.
   
   Changing the service startup type

Note: If the service is still running, click Stop.

5. Install the WebSphere Update Installer

WebSphere Application Server updates are installed using the WebSphere Update Installer to install PAK files representing updates for the server.

1. To install the WebSphere Update Installer, either unzip the ZIP file you received or insert the CD or DVD into your computer. If the installer does not autostart for you, you might need to drill down to find it.Drill down into the UpdateInstaller folder to find installer.exe, and then double-click to run it.
   
   Drilling down to the WebSphere Update Installer fileThe Welcome screen of the WebSphere Update Installer appears.
   
   Update Installer installation wizard
2. Click Next on each installer page, selecting the defaults. On the last page of the wizard, the installer asks if you want to launch the WebSphere Update Installer, but you have not yet downloaded the PAK files to install, so deselect the checkbox for now, and click Finish.
   
   Final installer page

In this tutorial, you run the Update Installer twice, first to apply the WebSphere Application Server 6.1.0.0 -> 6.1.0.x patch, and then again to apply two separate patches (Interim patch and Web Service Feature Pack patch).

6. Apply WebSphere Update 6.1.0.x

This is the first update you will apply to WebSphere Application Server; it updates the server from version 6.1.0.0 to 6.1.0.x.

1. To apply this PAK file, download it, and place it in the maintenance folder of the WebSphere Update Installer, as this is the default location in which the Update Installer looks. In this case, because you installed the Updater Installer into the C:Program FilesIBMWebSphereUpdateInstaller folder, the folder in which to place PAK files is as shown below.
   
   Location of the maintenance folder for PAK files
2. Run the Update Installer by double-clicking the update.exe file in the same folder, or by running it from the Start menu.
   
   Running Update Installer from the Start menuImportant Note: If you installed WebSphere Application Server to the C:Program Files folder, due to revised permission control on Windows 7 and Vista, we recommend you right-click the Update Installer windows shortcut, and select Run as Administrator from the menu to ensure the update doesn’t fail due to permission problems.
   
   Running Update Installer as administrator
3. After launching the Update Installer and clicking Next, you are prompted for the installation folder of WebSphere Application Server. By default the Update Installer should find and display it, but confirm that it is correct.
4. Click Next to install or uninstall a maintenence package; in this case accept the default, which is Install. Click Next to enter the folder containing the maintenance package files (PAK files). You placed them in the maintenance folder below the Update Installer’s installation folder, which is displayed by default.
   
   Entering the maintenance package folder
5. After changing the directory or confirming the default and clicking Next, the Update Installer displays the update packs it found and prompts you to confirm/select the ones you want to install. In this case, you should only have one update pack listed.
   
   List of available maintenance packages
6. Click Next, and the installer verifies the action you are about to perform and prompts you to confirm it. Click Next again and the update process begins.
   
   Update progressNote: Given the size of the update package being applied, on a fast machine this can take 2-5 mins; on a slower machine it could take up to 10 mins or more to run.
7. After the update is finished, the Update Installer confirms the process is complete.
   
   Installation confirmation

Important Note: If the update process fails at any point, you can try to re-run the Update Installer. It attempts to recover the failed update. If recovery fails, it is possible that a server resource is locked due to a hung server process or running server. Be sure the server is stopped and we recommend rebooting your computer before trying to recover the update process to make sure all open file handles are closed.

7. Install the Web Service Feature Pack

Now that WebSphere is updated to the latest version, you are ready to install the Web Services Feature Pack, which adds support for the Java EE Web Service Specification: JAX-WS.

1. The Web Service Feature Pack is installed by way of a stand alone installer contained in the ZIP or on CD/DVD. Either unzip the ZIP file or insert the CD/DVD into your computer. If you are installing from CD/DVD, the installer should run automatically. Otherwise, and locate and run the installer.exe file in the WEBSV subfolder.
   
   Location of the Web Service Feature Pack installerImportant Note: If you installed WebSphere Application Server to the C:Program Files folder, due to revised permission control on Windows 7 and Vista, we recommend you right-click the Update Installer windows shortcut, and select Run as Administrator from the menu to ensure the update doesn’t fail due to permission problems.
2. In the installation wizard, click Next on each page, agreeing to the license, confirming your WebSphere Application Server installation path, and then installation begins.
   
   Installation progress
3. After installation is complete, the wizard displays a summary of everything installed:
   
   Installation confirmation
4. Click Finish, which opens the Profile Management tool. You don’t need the tool at the moment, so you can close it.

8. Apply Updates PK53084 Interim Fix and Web Service Feature Pack

Now that you have updated WebSphere and added the Web Service Feature Pack, you need to apply two updates for the Web Service Feature Pack:

• 6.1.0.9-WS-WASWebSvc-IFPK53084.pak
• 6.1.0-WS-WASWebSvc-WinX32-FP0000013.pak

1. Copy or move both of these PAK files into the maintenance folder used in Section 6.
   
   Two new PAK files placed in the maintenance folder
2. And as you did with the WebSphere update, run the Update Installer again by launching it from the Start menu.
   
   Important Note: If you installed WebSphere Application Server to the C:Program Files folder, due to revised permission control on Windows 7 and Vista, we recommend you right-click the Update Installer windows shortcut, and select Run as Administrator from the menu to ensure the update doesn’t fail due to permission problems.
3. Click Next on each page of the wizard, confirming the WebSphere installation to upgrade, and so on. When you reach the page displaying the list of updates to apply, two are listed.
   
   Available maintenance packages
4. At this point, only the 6.1.0.9-WS-WASWebSvc-IFPK53084.pak is available to select. Select and apply it first.
   
   Installation confirmation
5. Click Relaunch (or click Finish, and manually restart the Update Installer) and step through the wizard to the point where the only remaining update is listed, and select it. Click Next.
   
   Final maintenance packageThe updater applies the last update to WebSphere.
   
   Installation confirmation
6. Click Finish to finalize the Web Service Pack Feature update.

9. Install the EJB 3.0 Feature Pack

The last step in this tutorial is installing the EJB 3.0 Feature Pack for WebSphere Application Server 6.1. Installation of this pack is identical to the Web Service Feature Pack installation.

1. Either unzip the ZIP file, and run the install.exe or insert the CD/DVD into your computer and do the same (if the installer doesn’t automatically start up). The installer file is found in the EJB 3.0 folder.
   
   Location of the EJB 3.0 installerWhen you run the installer, you see the Welcome page as with the other installers.
2. Click Next on each page of the wizard, confirming the WebSphere installation location and eventually agreeing on the Summary page, which begins the installation.
   
   Installation progressAfter installation is complete, the wizard displays a summary of the installation.
   
   Installation confirmation
3. Click Finish, which opens the Profile Management tool. We cover Profile augmentation in the next section. Leave the Profile Management tool open and continue to the next section, or close it and reopen it at a later date to continue.

10. Manage Your Profile

Now that you have installed all updates and feature packs for WebSphere 6.1, you have two choices to begin working with the new technologies:

• Create a new profile based on the feature packs
• Augment an existing profile to add support for one of the feature packs

Note: At the time of this writing it does not seem possible to expose an EJB 3.0 bean as a JAX-WS web service as defined in the Java EE 5 specification for profiles with both the EJB 3.0 and JAX-WS feature packs installed. IBM should likely fix this in a future update.

10.1 Augmenting a Profile

1. Launch the Profile Management Tool from the Start menu.
   
   Opening the Profile Management Tool from the Start menu
2. Click Augment.
   
   Profile Management Tool options
3. Select the profile you want to augment, and click Next.
   
   Profile Selection window
4. Select the augmentation you want to apply to the profile, and click Next.
   
   Augment Selection window

Note: At the time of this writing there seems to be a bug with WebSphere 6.1 such that existing profiles can only be augmented with the EJB 3.0 feature pack and not the JAX-WS feature pack. The only way to get JAX-WS support is to create a new profile based on that feature pack.

WebSphere makes the necessary changes (it may take a few minutes).

10.2 Creating a New Profile

1. Launch the Profile Management Tool from the Start menu.
   
   Opening Profile Management Tool from the Start menu
2. Click Create, and click Next.
   
   Profile Management Tool options
3. Select the features on which you want to base the new profile, and click Next.
   
   Environment Selection window

Note: At the time of this writing, you cannot augment an EJB 3.0 profile with JAX-WS. To create a profile that uses both feature packs, you must create a JAX-WS profile first, and then augment it with the EJB 3.0 feature pack.

This process generates a new profile for WebSphere based on the platform technology you selected. You can use the profile or augment it further with additional features.