|
|
<html> <head> <title>UDDI Services Post-Installation Notes</title> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=Windows-1252"> <META HTTP-EQUIV="MSThemeCompatible" CONTENT="Yes"> <META NAME="MS.LOCALE" CONTENT="EN-US"> <LINK REL="STYLESHEET" HREF="webroot/stylesheets/uddi.css" TYPE="text/css"> <SCRIPT> function BringToFront() { window.focus(); } </SCRIPT> </head> <body marginwidth="0" marginheight="0" LEFTMARGIN="0" TOPMARGIN="0" rightmargin="0" background="images/bg.help.gif" ONLOAD="BringToFront()"> <table cellpadding='0' cellspacing='0' width='100%' height='74' border='0' class='headerFrame' ID="Table4"> <tr height='65'> <td align='left' valign='center'><img src="webroot/images/logo.gif" alt="UDDI Services logo" border="0" width="150" height="64"></td> </tr> </table> <table class="content" width="100%" cellpadding="8" ID="Table1"> <tr> <td> <h1><a name="toppage"></a>UDDI Services Post-Installation Notes</h1> <p align="center"><font color="red">This document contains vital information pertaining to the proper functionality of a UDDI Services site.<BR> </font><FONT color="red">It is advised that you review this document in its entirety before using UDDI Services. </FONT> </p> <h2>Web Server component</h2> <P> </P> <ul> <li> <a href="#PostInstall">Post-Installation Information</a> <br> Important information regarding the installation and configuration of a UDDI Services Web server component.<BR> <li> <a href="#KnownIssues">Known Issues</a> <br> Known issues with the Web server component and this release of UDDI Services<BR> <li> <a href="#Troubleshooting">Troubleshooting </a> <br> Guide to addressing issues in UDDI Services<BR> <li> <a href="#Uninstall">Uninstalling UDDI Services</a> <br> Step-by-step instructions for uninstalling UDDI Services<BR> <li> <a href="#References">UDDI Services References</a> <br> Links to additional information about UDDI Services<BR> </li> </ul> <div> <hr size="2" width="100%" noshade color="black" align="left"> </div> <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table9"> <tr> <td> <p align="center"><a href="#TopPage">Back to top</a></p> </td> </tr> </table> <h3><a name=BPostInstall"></a>Post-Installation Information</h3> After installing a UDDI Services Web server component, you must configure Internet Information Services (IIS) so that UDDI Services will function properly.<BR> <p><a name="ssl"></a> If you use Secure Socket Layer (SSL) encryption with UDDI Services, then you must obtain and install an authentication certificate. If you have already obtained and installed an authentication certificate for the installation of IIS hosting the UDDI Services Web server component, then you do not need to obtain and install another certificate. For more information, open IIS MMC help, open the <b>Server Administration Guide</b>, click <b>Security</b>, click <b>Secure Sockets Layer (SSL)</b>, and then click <b>Configuring SSL on Your Server</b>. </p> <p><b>Note:</b> SSL-encryption provides increased security for communications between client computers and the UDDI Services Web server component. If you opted not to use SSL during your UDDI Services installation, you do not need to obtain or install a server authentication certificate. However, it is highly recommended that you use SSL with UDDI Services.</p> <p> <a name="asp.net"></a>The ASP.NET Web service extension is automatically enabled during installation of the UDDI Services Web server component. If this Web service extension is disabled, the UDDI Services Web server component will cease to function. For more information, open IIS MMC help, open <b>Getting Started</b>, click <b>Common Administrative Tasks</b>, and then click <b>How to Enable Web Service Extensions</b>.</p> <p> After you have configured IIS for UDDI Services, you can proceed to use and interact with it through the following interfaces:</p> <p>You can interact with a UDDI Services site through one or more of the following interfaces: </p> <UL> <B>UDDI Services Web User Interface:</B> Provides searching, publishing, and coordination features that are compatible with Microsoft Internet Explorer 4.0 or later and Netscape Navigator 4.5, or later. <UL> <LI> Integrated Windows Authentication: https://<I><servername></I>/uddi/ or http://<I><servername></I>/uddi/ <LI> Unauthenticated interface with read (inquiry) access only: https://<I><servername></I>/uddipublic/ or http://<I><servername></I>/uddipublic/ </LI> </UL> </UL> <br> <UL> <B>Visual Studio .NET Add Web Reference Interface:</B> Provides Web service discovery and integration in Visual Studio .NET through UDDI Services. <UL> <LI> Integrated Windows Authentication: https://<I><servername></I>/uddi/addwebreference/ or http://<I><servername></I>/uddi/addwebreference/ <LI> Unauthenticated interface: https://<I><servername></I>/uddipublic/addwebreference/ or http://<I><servername></I>/uddipublic/addwebreference/ </LI> </UL> </UL> <br> <UL> <B>UDDI API Interface:</B> Supports the UDDI version 1.0 and 2.0 APIs, enabling enterprise developers to publish, discover, share, and interact with Web services directly through their development tools and business applications. <BR> <BR> <b>Publish</b> <UL> <LI> Integrated Windows Authentication for publish API messages: https://<I><servername></I>/uddi/publish.asmx or http://<I><servername></I>/uddi/publish.asmx <LI> UDDI Specification-based Authentication for publish API messages: https://<I><servername></I>/uddipublic/publish.asmx or http://<I><servername></I>/uddipublic/publish.asmx</LI> </UL> <b>Inquire</b> <UL> <LI> Integrated Windows Authentication for inquire API messages: https://<I><servername></I>/uddi/inquire.asmx or http://<I><servername></I>/uddi/inquire.asmx <LI> UDDI Specification-based Authentication for inquire API messages: https://<I><servername></I>/uddipublic/inquire.asmx or http://<I><servername></I>/uddipublic/inquire.asmx </LI> </UL> <P CLASS="note"><b>Note</b></P> <UL> <LI> The URL to an SSL-encrypted site begins with "https://", and the URL to a non-SSL-encrypted site begins with "http://". SSL-encrypted interfaces are only available on those sites that have been configured to use SSL-encryption. </LI> </UL> </UL> <div> <hr size="2" width="100%" noshade color="black" align="left"> </div> <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table2"> <tr> <td> <p align="center"><a href="#TopPage">Back to top</a></p> </td> </tr> </table> <h3><a name="KnownIssues"></a>Known Issues</h3> <p>The following issues are known to exist in this version of the UDDI Services Web server component: </p> <UL type="disc"> <li> UDDI Services requires Internet Information Services (IIS) to be running in <i>worker process isolation mode</i>; switching to <i>IIS 5.0 isolation mode</i> will cause UDDI Services to no longer function. For more information, see <b>IIS Isolation Modes</b> in IIS Help. <LI> Each computer that is a member of a Web Farm must be configured to use the same <b>machineKey ValidationKey</b> and <b>machineKey DecryptionKey</b> keys. For more information, see the <a href="http://go.microsoft.com/fwlink/?linkid=8171&clcid=0x409" target="_blank"> .NET Framework General Reference description of the machineKey element</a> on the Microsoft Web site. <LI> If a computer hosting a UDDI Services Web server component is promoted to a Domain Controller using DCPROMO, IIS and the UDDI Services Web server component will cease to function. For more information, see the <a href="http://go.microsoft.com/fwlink/?linkid=5214&clcid=0x409" target="_blank"> Microsoft Knowledge Base article</a> discussing this issue on the Microsoft Support Web site. <LI> When installing UDDI Services from a <b>Terminal Server</b> session, a dialog box appears, requiring UDDI Services to be installed in <b>Multi User</b> mode. UDDI Services does not support multi-user installations and will not function correctly. To prevent Multi User mode errors, you must change your current user session to <b>Install Mode</b> <i>before you install UDDI Services</i>. <h4><b>To change your current user session</b></h4> <UL> <OL> <li> Before you install UDDI Services, type: <b>change user /Install</b> at the command prompt. <li> When your UDDI Services installation is complete, type: <b>change user /Execute</b> at the command prompt.</li></OL> </UL> </LI> </UL> <div> <hr size="2" width="100%" noshade color="black" align="left"> </div> <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table5"> <tr> <td> <p align="center"><a href="#TopPage">Back to top</a></p> </td> </tr> </table> <H3><a name="Troubleshooting"></a>Troubleshooting</H3> <P> Following an installation, review the UDDI Services setup log found in: <b><i>%windir%</i>\uddisetup.log</b></P> <p><b>Known problems and solutions:</b></p> <UL> <LI> <b>Problem:</b> During installation a message appears "UDDI Services is not compatible with IIS 5.0 isolation mode. The UDDI Services Web server component will not be installed."<br> <B>Cause:</B> Internet Information Services (IIS) is operating in <i>IIS 5.0 isolation mode</i> - possibly due to an upgrade installation over a previous version of Windows.<br> <B>Solution:</B> Configure ISS to operate in <i>worker process isolation mode</i> and repeat installation. For more information see <b>IIS Isolation Modes</b> in IIS Help.<BR> <LI> <b>Problem:</b> My Web browser fails to connect to a UDDI Services site with "Cannot find server or DNS error" message.<br> <B>Cause:</B> SSL-encryption has been enabled for this site, but an SSL certificate has not been installed.<br> <B>Solution:</B> Obtain an SSL certificate or disable SSL for this site. For more information, see <a href="#ssl">Web Server Component Post Installation Information</a>.<BR> <LI> <b>Problem:</b> My Web browser fails to connect to a UDDI Services site with "The page cannot be found" or "HTTP 404 - File not found" message.<br> <B>Cause:</B> The ASP.NET request handler has been disabled.<br> <B>Solution:</B> Enable the ASP.NET request handler. For more information, see <a href="#asp.net">Web Server Component Post Installation Information</a>.<BR> <LI> <b>Problem:</b> My Web browser fails to connect to a UDDI Services site with "The application cannot be started" message.<br> <B>Cause:</B> A computer hosting a UDDI Services Web server component for this site has been promoted to a domain controller.<br> <B>Solution:</B> Do not host the UDDI Services Web component on a computer that is also a domain controller or reconfigure IIS and ASP.NET to function properly on the domain controller computer. For more information, see the <a href="http://go.microsoft.com/fwlink/?linkid=5214&clcid=0x409">Microsoft Knowledge Base article</a> discussing this issue on the Microsoft Support Web site.<br> </LI> </UL> <div> <hr size="2" width="100%" noshade color="black" align="left"> </div> <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table6"> <tr> <td> <p align="center"><a href="#TopPage">Back to top</a></p> </td> </tr> </table> <H3><A name="Uninstall"></A>Uninstalling UDDI Services</H3> <P>You can uninstall UDDI Services using the <B>Add or Remove Programs</B> option on your computer. </P> <H4>To uninstall UDDI Services</H4> <ol> <li> In the Control Panel, open <b>Add or Remove Programs</b>. <li> Click <b>Add/Remove Windows Components</b>. <li> In the Components list, clear the <b>UDDI Services</b> check box. <li> Click <b>Next.</b><br> A confirmation message appears when uninstallation is complete. <li> Click <b>Finish.</b> <li> If you selected to create an MSDE2000 database instance for this installation of UDDI Services, you can also remove that database from this system; select <b>Microsoft SQL Server Desktop Engine (UDDI)</b> in the Currently installed programs list, and then click <b>Remove</b>. <li> Click <b>Yes</b> in the Add or Remove Programs dialog box.</li> </ol> UDDI Services has now been uninstalled from this system. Repeat this procedure on any other systems from which you would like to uninstall UDDI Services. <div> <hr size="2" width="100%" noshade color="black" align="left"> </div> <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table8"> <tr> <td> <p align="center"><a href="#TopPage">Back to top</a></p> </td> </tr> </table> <h3><a name="References"></a>UDDI Services References</h3> <p>Additional information about UDDI and UDDI Services is available at the following Web sites: </p> <ul> <li> <a href="http://go.microsoft.com/fwlink/?linkid=5212&clcid=0x409" target="_blank"> Microsoft UDDI Home</a> <li> <a href="http://go.microsoft.com/fwlink/?linkid=5202&clcid=0x409" target="_blank"> Additional Resources on the Web</a></li> </ul> <div> <hr size="2" width="100%" noshade color="black" align="left"> </div> <table border="0" cellspacing="0" cellpadding="0" width="100%"> <tr> <td> <p align="center"><a href="#TopPage">Back to top</a></p> </td> </tr> </table> </td> </tr> </table> <table align="center" ID="Table3"> <tr> <td align="middle">�2002 Microsoft Corporation <br> All rights reserved.</A> <P></P> </td> </tr> </table> </body> </html>
|