Develop > Presentation layer > WebSphere Commerce integration with WebSphere Portal > WebSphere Commerce Portal development environment
Setup the WebSphere Commerce Portal development environment
You can develop and test WebSphere Commerce Portal configurations using the development environment.
Before you begin
Ensure that you have completed the following tasks:
- The WebSphere Portal and WebSphere Application Server software stack has to be at a specific level in order to enable WebSphere Portal v6.1 to be deployed on WebSphere Application Server v7.0. WebSphere Portal must be at or later than 6.1.0.2, while WebSphere Application Server must be at or later than 7.0.0.5.
- The WebSphere Commerce Toolkit has to be installed and configured properly before starting to set up the WebSphere Commerce Portal development environment.
- The WebSphere Commerce Toolkit must be upgraded with the latest maintenance fixes.
- In addition, there are a few recommended tuning from the WebSphere Portal Information Center on the WebSphere Application Server runtime and Rational Application Developer workbench:
Procedure
- Installation of WebSphere Portal 6.1 test server:
- See Install the WebSphere Portal v6.1 Test Environment in the Rational Application Developer Information Center for detailed tasks on installing WebSphere Portal 6.1 test server.
- After the installation has been completed, upgrade the software level to the latest recommended WebSphere Application Server 7 fix level.
- The WebSphere Portal server requires no special configuration to be used a test environment. See Configure the WebSphere Portal server as a test environment in the Rational Application Developer Information Center to configure an existing WebSphere Portal server to be a test server in Rational Application Developer.
- Configure WebSphere Commerce Portal development environment:
- Start the WebSphere Commerce Toolkit
- Enable the Eclipse Developer, XML, and Web service capabilities in WebSphere Commerce Developer:
- Select Window > Preferences > General > Capabilities.
- Select the required capabilities in the main pane:
- Development (Open Advanced to select all in Development)
- Web Service Developer
- XML Developer
Alternatively, you can simply click Enable All to select all available capabilities in WebSphere Commerce Developer.
- Click OK.
- Verify the JAX-RPC Web service generation settings:
- Select Window > Preferences.
- Select Web Services.
- Select WebSphere.
- Select Select JAX-RPC Code Generation.
- Select the WSDL2Java tab.
- Select Disable data binding and use SOAP element.
- Click OK.
- Select Window > Preferences.
- Select Web Services.
- Select Scenario Defaults.
- Select Java Proxy for Client Type.
- Select Deploy Client in the slider.
- Click OK.
- Select Window > Preferences.
- Select Server Runtime.
- Select WebSphere Application Server v7 as the Server.
- Select IBM WebSphere JAX-RPC as the Web service runtime.
- Click OK.
- Import the MVCPortlet.war file into the Rational Application Developer workbench. Select the Target Runtime to be WebSphere Portal 6.1 on WebSphere Application Server 7. See Import portlets in the Rational Application Developer Information Center for instructions on importing a WAR file.
Ensure the new MVCPortlet project is associated with a new EAR project. Only deploy this new MVCPortlet EAR project to the WebSphere Portal 6.1 on the WAS 7 test server. Do not deploy it to the WebSphere Commerce 7 test server.
- Update the Java build path of the MVCPortlet project by adding the WebSphere Application Server v7 library under the libraries tab. See Java Build Path for more information.
- Create a new test server for WebSphere Portal 6.1. See Define local servers for testing portlets in the Rational Application Developer Information Center for instructions on creating a new test server.
- Optional: Set up the TCP monitor to forward messages from MVCPortlet to the WebSphere Commerce Server.
This step is optional as it is only needed when WebSphere Commerce server is running on a remote machine.
- Open WebSphere Commerce Developer.
- Select Window > Preferences > Run/Debug > TCP/IP Monitor.
- Click the Add button, and add a new monitor using the following properties:
Monitor properties
Property Value Local Monitoring port 80 Hostname host_name Port 8007 If you have configured the WebSphere Commerce services with a different default port number, ensure that you enter the appropriate port number here.
Type HTTP Timeout 0
- Select Start monitor automatically.
- Click OK.
The Realm name used for the VMM setting in the WebSphere Commerce test server environment must be the same as the one used in WebSphere Portal in order for the single sign-on to correctly function.
- Configure WebSphere Portal and WebSphere Commerce single sign-on option for the development environment, from the following options:
The default configuration of WebSphere Portal and WebSphere Commerce single sign-on option is LTPA.
- Configure LTPA single sign-on for WebSphere Commerce
- Configure simulated single sign-on for WebSphere Portal
- Configure basic authentication single sign-on for WebSphere Portal
Basic Authentication has been deprecated in WebSphere Commerce integration with WebSphere Portal. It is strongly recommended to migrate to the suggested LTPA configuration.
See Configure WebSphere Portal with WebSphere Commerce for more information.
- Configure LTPA single sign-on for WebSphere Commerce
The LTPA option requires WebSphere Application Security administrative security to be enabled on both the WebSphere Commerce server and the Portal server. LTPA is the most secure method of performing single sign on.
- Configure simulated single sign-on for WebSphere Portal
Simulated single sign-on is provided for ease of setup in Rational Application Developer where the portlet developer can be up and running without enabling security and without using LDAP. Speed of setup takes precedence over security in a development environment. This option enables the use of a predetermined WebSphere Commerce user ID, where the system automatically uses the credential to perform authentication through a WebSphere Commerce web service, without having the Portal user aware of this operation. Doing this can achieve the single sign on experience inside of the development environment but without the hassle of enabling security and configuring VMM with LDAP.To enable simulated single sign-on configure the WebSphere Portal machine.
- Configure basic authentication for WebSphere Portal
Basic authentication is an authentication method that is designed to allow client programs to provide credentials - in the form of a user name and password - when making a request. Although the scheme is implemented, it relies on the assumption that the connection between the client and server computers is secure and can be trusted.