Chapter 4: Building Portlets

Requirements

To use Web services with Enterprise Portal:

You must use the version of global.properties.xml installed with Enterprise Portal version 6.0 and later that includes the WebServiceRoot property in the UWP property group.
Enterprise Portal comes preconfigured to use Web services. To verify or change Web services configuration settings:
1. Beneath your Enterprise Portal installation directory, go to the onepage Web application configuration directory
  - %SYBASE%\EAServer\Repository\WebApplication\onepage\config on Windows
  - $SYBASE/EAServer/Repository/WebApplication/onepage/config on UNIX
  Open webservices.properties.xml in Microsoft WordPad or the text editor of your choice on other platforms.
2. The ArraySize1, WSCache, and DefaultExpireLength properties are set on installation, but you can change them if necessary.
```
<Properties name="Properties">
<Property name="ArraySize1" value="2"
description=”default array size"/>

<Property name="WSCache" value="true"
description="(true/false)' true to turn on caching for processed complexTypes and definitions of wsdl"/>

<Property name="DefaultExpireLength" value="259200000" description="default expire length for cached WS element, e.g., 3 days"/>
```
3. If you change any of the configuration properties, restart the application server to put your changes into effect.
If you get a Secure Sockets Layer (SSL) certificate error while trying to publish a Web service to a registry using HTTPS, use one of these options to resolve this:
- Install a new version of Java (for example, JDK 1.4.1) and run Enterprise Portal with that version. The root certificate on the registry site should already be installed in your default keystore file—cacerts.
- Use your browser to download a root certificate (issued from Verisign), then use keytool to import this certificate to your default keystore (cacerts) or a newly created keystore. If you import the certificate to a new keystore, you must also point the client keystore property to the new keystore:
```
[System.setProperty("javax.net.ssl.keyStore", "...")]
```
Register accounts with the UDDI public registries, then publish your Web service.

The TrySybase registry does not provide a site to register an account; use guest (user name) and guest (password) as the account login to publish to the Sybase registry.

View this book as PDF