Why use this deployment scenario?
Description of the scenario
- This scenario is a good choice for developers who are comfortable with the RAD 6 IDE.
- Using the Embedded Test Server (Portal UTE) allows for faster server startup.
- The Embedded Test Server can be used to run models stand alone and as portlets.
- This scenario allows the developer to take advantage of the Unit Test Environment features while working with the WebSphere Portlet Factory.
- A single deployment configuration is used.
- The WPF new project wizard creates both a standard WPF project and a coresponding EAR project.
- This example use the the WebSphere Portal v5.1 Test Environment in Rational Application Developer v6.0
NOTE: These steps are specific to WPF 6.0.1 and WPF 6.0.2
1. Create a new WebSphere Portlet Factory project.
2. On the Project Name page of the wizard, enter a name for your project. Click Next.
3. On the Add Feature Sets page of the wizard, check off the "Tutorials and Samples" feature set category. Click Next.
4. On the Java Settings page of the wizard, accept the defaults. Click Next.
5. On the Deployment Configuration screen, click the Add button for the Portal Server Deployment Configuration.
6. Enter a name for the new server configuration.
7. Enter a description. (optional)
8. Select "RAD Portal Unit Test Environment" for the server type.
9. Select a portlet API setting.
10. If you selected WebSphere Native (deprecated) you will have to enter the location to the pbportlet.jar file.
11. Enter 9081 for the server port. (This example uses the WebSphere Portal v5.1 Test Environment)
12. Click OK.
13. Click finish. The project will be created and ask if you want to deploy now. Click no.
14. Two projects will be created. A standard project with the name you specified and a second project, with the name you specified followed by "EAR", will be created.
15. Right click on the standard project, click Run > Run on Server...
16. Select WebSphere Portal v5.1 Test Environment @ localhost (if this option is not available, you will have to define a server of this type) Click Next.
17. Verify that your project is added to the list of applications for the server to run. Click Finish.
18. The server tab will indicate that the server is starting.
19. Once the server has started, a browser window will open inside of the IDE and will display the tutorial portlets.
If you should have trouble getting the server to display the portlets, the first thing to try is to stop the server and restart it.
Models can also be run stand alone from the IDE.
1. Open a model for editing.
2. Right click on the project and select Run > Run...
3. When the Run dialog appears, select your WPF run configuration. If you don't have a WPF run configuration, create a new one. The default will work for this scenario. Once you have selected your WPF run configuration, click the Run button.
4. A browser will open and display the model.