Developing JAX-RS 1.1 RESTful Services in Rational Software Architect V8 for deployment to WebSphere Application Server V8

Configure the WebSphere Application Server V8.0 runtime environment

This section outlines the tasks required to configure a new WebSphere Application Server V8.0 to deploy the JAX-RS REST Service.

1. In the Server view right click and select New > Server.
2. In the Define a New Server dialog, select WebSphere Application Server v8.0 as the server type to be created.
3. In the Server runtime environment field, select Create new runtime environment and then click Next (Figure 7).
   
   Figure 7. Create Server: Define a New Server dialog
   
   
   
4. In the Application Server Runtime Environment dialog, click Browse to navigate to the Installation Directory. Select the <installation_directory> for WebSphere Application Server V8.0 and then click Next (Figure 8).
   
   Figure 8. Create Server: Specify Server Runtime Environment
   
   
   
5. In the WebSphere Application Server Settings dialog, if you have an existing profile, you can select it from the Profile name pull down it or you can create a new one.
6. To create a new profile click the Configure profiles link and follow the remaining steps (Figure 9).
   
   Figure 9. Create Server: Specify Server Settings
   
   
   
7. If prompted to Create a runtime environment, click Yes.
8. In the Preferences window, expand Preferences > Server > WebSphere Application Server and click on Run Profile Management Tool (Figure 10).
   
   Figure 10. Create Server: Select Run Profile Management Tool
   
   
   
9. In WebSphere Customization Toolbox window click Create (Figure 11).
   
   Figure 11. Create Server: Create Profile
   
   
   
10. In the Environment Selection dialog choose Application Server and click Next (Figure 12).
    
    Figure 12. Create Server: New Profile Environment Selection
    
    
    
11. In the Profile Creation Options dialog, select Advanced profile creation and click Next (Figure 13).
    
    Figure 13. Create Server: Profile Creation Options Dialog
    
    
    
12. In the Optional Application Deployment dialog, ensure Deploy the admin console is checked, uncheck the Deploy default application and click Next (Figure 14).
    
    Figure 14. Create Server: Profile Application Deployment Dialog
    
    
    
13. In the Profile Name and Location dialog, enter a name for the profile (for example: devWorksProfile)
14. Change the Profile directory to include the name of the application server and click Next (Figure 15)
    
    Figure 15. Create Server: Profile Name and Location
    
    
    
15. In the Node and Host Names dialog, enter appropriate values for Node name, Server name and Host name and then click Next (Figure 16).
    
    Figure 16. Create Server: Profile Node and Host Names dialog
    
    
    
16. In the Administrative Security dialog, check Enable administrative security and enter appropriate values for User name and Password and then click Next (Figure 17). NOTE: Remember this User name to access the Administrative Console and to start or stop the server from the command line.
    
    Figure 17. Create Server: Profile Administrative Security dialog
    
    
    
17. In the Security Certificate (Part 1) dialog, leave all fields as default to create a new default personal certificate and root signing certificate and click Next (Figure 18).
    
    Figure 18. Create Server: Profile Security Certificate I dialog
    
    
    
18. In the Security Certificate (Part 2) dialog leave all fields as default to create a new default personal certificate and root signing certificate and click Next (Figure 19).
    
    Figure 19. Create Server: Profile Security Certificate II dialog
    
    
    
19. In the Port Values Assignments dialog, accept the default generated ports and click Next (Figure 20). Take note of the HTTP transport port as it will be need for the HTTP Client at a later stage in the tutorial.
    
    Figure 20. Create Server: Port Assignments
    
    
    
20. In the Window Service Definition dialog, uncheck Run the application sever process as a Windows service and click Next (Figure 21).
    
    Figure 21. Create Server: Server Windows Service dialog
    
    
    
21. In the Web Server Definition dialog, leave all fields as default and click Next (Figure 22).
    
    Figure 22. Create Server: Web Server Definition dialog
    
    
    
22. Review the Profile Creation Summary information and click Create (Figure 23).
    
    Figure 23. Create Server: Profile Creation Summary
    
    
    
23. In the Profile Creation Complete dialog, uncheck Launch the First steps console and click Finish (Figure 24).
    
    Figure 24. Create Server: Profile Creation Complete dialog
    
    
    
24. The newly created profile should now be visible in the WebSphere Customization Toolbox (Figure 25). Close the window to return to Rational Software Architect.
    
    Figure 25. Create Server: Updated Profile List
    
    
    
25. In the Preferences window, expand Preferences > Server > WebSphere Application Server and click on the WebSphere Application Server V8.0 installed runtime to refresh the list of profiles. The new server should appear in the profile section. Click OK (Figure 26).
    
    Figure 26. Create Server: Updated Servers and Profiles View
    
    
    
26. In the WebSphere Application Server Settings dialog, select the newly created profile in the Profile name drop-down menu. Enter the User ID and Password and click Next (Figure 27).
    
    Figure 27. Create Server: Configure WebSphere Application Server Settings dialog
    
    
    
27. In the Add Remove projects dialog, click Finish.

This completes the steps required to configure the WebSphere Application Server V8.0 runtime environment for deploying the legacy bank application’s JAX-RS 1.1 REST Service. In the Server view you should now see the newly created server in Stopped state.

4 of 12 | Previous | Next

Comments

Back to top

Table of contents

• Before you start
• Introduction
• Import the legacy application code and supporting services (XML and JSON Helpers)
• Configure the WebSphere Application Server V8.0 runtime environment
• Create the JAX-RS 1.1 REST service and Java EE modules
• Implement the JAX-RS 1.1 application configuration and resource classes
• Modify the Web module deployment descriptors
• Deploy the solution to the runtime test environment
• Verify the solution with REST HTTP client
• Download
• Resources
• About the authors

---

4 of 12 | Previous | Next

Next steps from IBM

• Try: Rational Software Architect
• Buy: Rational Software Architect

Dig deeper into WebSphere on developerWorks

IBM SmartCloud trial. No charge.

Unleash the power of hybrid cloud computing today!

---

Public and private solutions in one trial.

Special offers