You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
354 lines
16 KiB
354 lines
16 KiB
<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>
|