LDSTechForumProjects

WebSphere Getting Started Guide

This document will outline the steps to develop a Stack application using WebSphere 7.

RAD 8 and RAD 7.5

You can develop Websphere applications with RAD 8 or RAD 7.5.

RAD 8:

  • Is Eclipse 3.6/Helios based
  • Allows developers to use M2Eclipse for Maven integration in Eclipse
  • Requires the project to purchase a license from IBM or you can download a 60 day trial.

RAD 7.5:

  • Is Eclipse 3.4 based
  • Developers will need to use the good old "mvn eclipse:eclipse" mechanism of integrating maven and eclipse
  • A license is NOT required for use of RAD 7.5

This document will provide steps for using both RAD 8 and RAD 7.5.

Download and install WebSphere

  1. Download the necessary bundles from http://icslib/apps/Websphere/.
    1. Depending upon if your OS is Windows or Linux download the appropriate was.cd.7000.wasdev.nocharge.XXX.tar.gz and WAS-XXX-Update-7.0.0.X.zip files
  2. Extract and install was.cd.7000.wasdev.nocharge.XXX.
    1. If installing in Ubuntu Linux you will probably need to apply the first of these fixes before installing WAS for managing profiles.
    2. If installing under Windows 7 or Windows Vista if you have UAC enabled then DO NOT install it in the "Program Files" directory. Choose a different directory such as "c:\dev\IBM\Websphere\AppServer".
    3. When asked choose the "Application Server" Environment.
    4. Be sure to uncheck the "Enable Administrative Security" box.
    5. Complete the installation.
    6. In Windows disable the WebSphere "service" by going to Control Panel->System and Security->Administrative Tools->Services.
    7. Double click on IBM Websphere Application Server change "Startup type:" to "Disabled". Select OK.
  3. Extract WAS-XXX-Update-7.0.0.X.zip and install the updates. Instructions for using the WAS update installer can be found on IBM's website for Windows and Linux.
    1. Choose the directory with the *.pak files where it asks for "Maintenance Package Directory Selection".
    2. Complete the update process

WebSphere is now installed and up to date.

RAD 7 Instructions

Install RAD 7

  1. Download RAD-7.5.zip
  2. Unzip RAD-7.5.zip into a new directory and then unzip all of the included zip files into that directory.
    RAD-7.5-Unzipped.PNG
  3. Execute RADAD_SETUP/launchpad
  4. Select "Install IBM Rational Application Developer Assembly and Deployment Features".
  5. DO NOT select "Check for Other Versions and Extensions" at this time.
  6. Complete the installation of the "Installation Manager".
  7. When the Installation Manager starts choose "Update" to install the latest version of the Installation Manager.
  8. Complete the process of updating the Installation Manager.
  9. When the Installation Manager restarts select "Install".
  10. In the "Install Packages" screen press the "Check for Other Versions, Fixes, and Extensions" button.
  11. Check the "IBM Rational Application Developer Assembly and Deployment Feature" and continue the installation process.
  12. Do NOT "Extend an existing Eclipse" it won't work.
  13. Finish the installation process

Install Maven

  1. Download the latest version of Maven 2.2.x.
  2. Unzip Maven to install.
  3. Add M2_HOME and JAVA_HOME as an environment variables and add %M2_HOME%/bin to the path.

Maven-Environment.PNG

Set up WebSphere Server in RAD

  1. Launch RAD
  2. Select the "Servers" view
  3. Right Click->New->Server
  4. Choose WebSphere Application Server v7.0 and press "Next"
  5. Specify where you previously installed WebSphere 7 and press "Next".
  6. Leave the defaults and press "Finish".

Disable automatic EAR creation

  1. Choose Window->Preferences->Java EE->Project
  2. Uncheck "Add project to an EAR" and press "OK".

AddProjectToAnEAR.PNG

Disable deploy error checking

  1. Choose Window->Preferences->Server->Websphere Application Server
  2. Check "Allow applications containing errors to be published on a server" and press "OK".

Install Subclipse Plugin

  1. Help->Software Updates...->Available Software->Add Site...
  2. Add the Subclipse update site http://subclipse.tigris.org/update_1.6.x
  3. Select all of the plugins except the Mylyn Integration
    Install-Subclipse.PNG
  4. Select "Install", complete the installation process, and restart RAD.

Create or check out project (RAD 7.5 Only)

To checkout an existing project:

  1. Window->Open Perspective->Other->SVN Repository Exploring
  2. In SVN Repositories Right click->New->Repository Location...
  3. Enter the URL of your project's SVN Repository and press "Finish".
  4. Enter username and password as needed. Note!!! username must be all lower case.
  5. When you've found the directory you need to check out, right click on the directory->Checkout...
  6. Select "Checkout as a project in the workspace".
  7. Change "Project Name" to match your project's name and press "Finish"


To create a new project:

  1. Launch Stack Starter
  2. Follow the Stack Starter instructions to build a project. Be sure to select "WebSphere" under "Deployment Environment".

Importing the project into Eclipse

  1. Through the command prompt navigate to your project root.
  2. Execute the command "mvn clean install eclipse:eclipse"
  3. Add the Maven Repository location to RAD by going to Window->Preferences->Java->Build Path->Classpath Variables
  4. Select "New..." and Name: M2_REPO Path: {your home directory}/.m2/repository. Select "OK".
  5. Import the web and ear projects by choosing File->Import...->General->Existing Projects into Workspace
  6. Using this mechanism import your project's "web" and "ear" modules into eclipse.

Configure WebSphere

This Step configures your local WebSphere instance for the application using the WAS Deploy Plugins

  1. In the "Servers" View right click on the WebSphere Server, setup before, and select "Start"
  2. Through the command prompt navigate to your project's "deploy" module
  3. Execute the command "mvn clean install stack-was-deploy:config". You may need to specify the -DwasHome property to the location of your WebSphere/AppServer directory.
  4. This command will connect to your local WebSphere instance and configure it according to the "dev" environment properties your project's deploy module. It is recommended that all websphere configuration be done through deploy properties. For more information view the WAS Deploy Plugin Reference documentation. Anytime you need to reconfigure WebSphere simply run this Maven command.
  5. It is recommended that your restart your WebSphere Server after every time it has been reconfigured. To do this select Servers->right click on Server->Restart.

Deploy application

Once your WebSphere instance is configured we can deploy our application.

  1. Drag your "-ear" project onto your websphere server.
  2. This will deploy your application to WebSphere. Open a browser and hit your application at http://localhost:9080/{projectName}

RAD 8 Instructions

Install RAD 8

  1. Download and begin the RAD 8 installation process.
  2. When asked if you want to extend an existing Eclipse, don't opt for it as it doesn't work.
  3. When asked for "Features" to install choose what you want but you must at least select everything under "WebSphere Application Server, version 7.0 development tools".
  4. It is recommended that you select only the WAS 7 plugin
  5. Press Next and Complete the Install

You don't need to install Maven if using RAD 8.

Set up WebSphere Server in RAD

  1. Launch RAD
  2. Select the "Servers" view
  3. Right Click->New->Server
  4. Choose WebSphere Application Server v7.0 and press "Next"
  5. Specify where you previously installed WebSphere 7 and press "Next".
  6. Leave the defaults and press "Finish".

Disable automatic EAR creation

  1. Choose Window->Preferences->Java EE->Project
  2. Uncheck "Add project to an EAR" and press "OK".

AddProjectToAnEAR.PNG

Disable deploy error checking

  1. Choose Window->Preferences->Server->Websphere Application Server
  2. Check "Allow applications containing errors to be published on a server" and press "OK".

Install LDSTech IDE plugins

  1. Help->Install New Software...->Available Software Sites->Import...
  2. Input http://code.lds.org/downloads/lds-tech-ide/update/e36/bookmarks.xml and press "Open".
  3. Select "OK" taking you back to the "Install" window.
  4. Select the "LDS Tech Update Site" Choose the Packages you wish to install.
    1. "LDS Tech Core" is the only required module
    2. QA, SVN, and WTP are recommended packages
    3. Spring IDE and STS currently have known issues with RAD though parts of them may work.
  5. After choosing the packages you want select "Next" and finish the installation process.

Create or check out project

To check out an existing project:

  1. Window->Open Perspective->Other->SVN Repository Exploring
  2. In SVN Repositories Right click->New->Repository Location...
  3. Enter the URL of your project's SVN Repository and press "Finish".
  4. Enter username and password as needed. Note!!! username must be all lower case.
  5. When you've found the directory you need to check out, right click on the directory->Check out as Maven Project... and press "Finish"
  6. Once the project has been checked out and imported by maven proceed to Run Maven Config Goal

To create a new project:

  1. Launch Stack Starter from http://code.lds.org/maven-sites/stack/3.1
  2. Follow the Stack Starter instructions to build a project. Be sure to select "WebSphere" under "Deployment Environment".
  3. Next we need to import this project into Eclipse.
  4. Switch back to the "Java EE" perspective.
  5. On the Enterprise Explorer View Right click->Import->Import...->Maven->Existing Maven Projects press "Next".
  6. In "Root Directory" select the directory of your newly created Stack Starter Project and press "Finish".
  7. Once the project has successfully been imported into RAD proceed to Run Maven Config Goal

Configure WebSphere

This Step configures your local WebSphere instance for the application using the WAS Deploy Plugins

  1. In order to configure your server you must do a one-time initial "Maven Install" of your project. To do this, right click on your root project->Run As->Maven Clean Install (skip tests).
  2. In the "Servers" View right click on the WebSphere Server set up before and select "Start"
  3. Once the server has started Right click on your project's "-deploy" module->Run As->Maven Build...
  4. Provide a Name for this Maven command
  5. In "Goals" section specify "clean install stack-was-deploy:config" and press "Run"
  6. If you get an error such as "The system cannot find the path specified" you may need to specify the "wasHome" parameter in the Maven command.
    WasConfig.PNG
  7. This command will connect to your local WebSphere instance and configure it according to the "dev" environment properties your project's deploy module. It is recommended that all websphere configuration be done through deploy properties. For more information view the WAS Deploy Plugin Reference documentation. Anytime you need to reconfigure WebSphere simply run this Maven command.
  8. It is recommended that your restart your WebSphere Server after every time it has been reconfigured. To do this select Servers->right click on Server->Restart.

Deploy application

Once your WebSphere instance is configured we can deploy our application.

  1. Find your "-web" module. Right click->Run As->Run On Server. Choose the Server and press "Finish".
  2. This will deploy your application to WebSphere and open a browser window in RAD to your running application.
This page was last modified on 12 July 2013, at 19:25.

Note: Content found in this wiki may not always reflect official Church information. See Terms of Use.