UDDI Services Post-Installation Notes
This document contains vital information pertaining
to the proper functionality of a UDDI Services site.
It is advised that you review this document in its
entirety before using UDDI Services.
Web Server component
Post-Installation Information
After installing a UDDI Services Web server component, you must configure
Internet Information Services (IIS) so that UDDI Services will function
properly.
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 Server
Administration Guide, click Security, click Secure Sockets Layer
(SSL), and then click Configuring SSL on Your Server.
Note: 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.
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 Getting
Started, click Common Administrative Tasks, and then click How to
Enable Web Service Extensions.
After you have configured IIS for UDDI Services, you can proceed to use
and interact with it through the following interfaces:
You can interact with a UDDI Services site through one or more of the following
interfaces:
UDDI Services Web User Interface: Provides searching, publishing, and
coordination features that are compatible with Microsoft Internet Explorer 4.0
or later and Netscape Navigator 4.5, or later.
-
Integrated Windows Authentication: https://<servername>/uddi/ or
http://<servername>/uddi/
-
Unauthenticated interface with read (inquiry) access only: https://<servername>/uddipublic/
or http://<servername>/uddipublic/
Visual Studio .NET Add Web Reference Interface: Provides Web
service discovery and integration in Visual Studio .NET through UDDI Services.
-
Integrated Windows Authentication: https://<servername>/uddi/addwebreference/ or
http://<servername>/uddi/addwebreference/
-
Unauthenticated interface: https://<servername>/uddipublic/addwebreference/
or http://<servername>/uddipublic/addwebreference/
UDDI API Interface: 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.
Publish
-
Integrated Windows Authentication for publish API messages: https://<servername>/uddi/publish.asmx
or http://<servername>/uddi/publish.asmx
-
UDDI Specification-based Authentication for publish API messages: https://<servername>/uddipublic/publish.asmx
or http://<servername>/uddipublic/publish.asmx
Inquire
-
Integrated Windows Authentication for inquire API messages: https://<servername>/uddi/inquire.asmx
or http://<servername>/uddi/inquire.asmx
-
UDDI Specification-based Authentication for inquire API messages: https://<servername>/uddipublic/inquire.asmx
or http://<servername>/uddipublic/inquire.asmx
Note
-
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.
Known Issues
The following issues are known to exist in this version of the
UDDI Services Web server component:
-
UDDI Services requires Internet Information Services (IIS) to be running
in worker process isolation mode; switching to IIS 5.0 isolation mode
will cause UDDI Services to no longer function. For more information, see IIS
Isolation Modes
in IIS Help.
-
Each computer that is a member of a Web Farm must be configured to use the same machineKey
ValidationKey and machineKey DecryptionKey keys. For more
information, see the
.NET Framework General Reference description of the machineKey element
on the Microsoft Web site.
-
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
Microsoft Knowledge Base article
discussing this issue on the Microsoft Support Web site.
-
When installing UDDI Services from a Terminal Server session, a
dialog box appears, requiring UDDI Services to be installed in Multi
User 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 Install Mode before you install
UDDI Services.
To change your current user session
-
Before you install UDDI Services, type: change user /Install
at the command prompt.
-
When your UDDI Services installation is complete, type: change user
/Execute at the command prompt.
Troubleshooting
Following an installation, review the UDDI Services setup log found in: %windir%\uddisetup.log
Known problems and solutions:
-
Problem: 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."
Cause: Internet Information Services (IIS) is operating in IIS
5.0 isolation mode - possibly due to an upgrade installation over a
previous version of Windows.
Solution: Configure ISS to operate in worker process isolation
mode and repeat installation. For more information see IIS Isolation
Modes in IIS Help.
-
Problem: My Web browser fails to connect to a
UDDI Services site with "Cannot find server or DNS error" message.
Cause: SSL-encryption has been enabled for this site, but an
SSL certificate has not been installed.
Solution: Obtain an SSL certificate or disable SSL for this
site. For more information, see Web Server Component Post
Installation Information.
-
Problem: My Web browser fails to connect to a
UDDI Services site with "The page cannot be found" or "HTTP 404 - File not
found" message.
Cause: The ASP.NET request handler has been disabled.
Solution: Enable the ASP.NET request handler. For more
information, see Web Server Component Post Installation
Information.
-
Problem: My Web browser fails to connect to a
UDDI Services site with "The application cannot be started" message.
Cause: A computer hosting a UDDI Services Web server
component for this site has been promoted to a domain controller.
Solution: 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 Microsoft
Knowledge Base article discussing this issue on the Microsoft Support
Web site.
Uninstalling UDDI Services
You can uninstall UDDI Services using the Add or Remove Programs option
on your computer.
To uninstall UDDI Services
-
In the Control Panel, open Add or Remove Programs.
-
Click Add/Remove Windows Components.
-
In the Components list, clear the UDDI Services
check box.
-
Click Next.
A confirmation message appears when uninstallation is complete.
-
Click Finish.
-
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 Microsoft SQL Server Desktop Engine (UDDI) in the Currently
installed programs list, and then click Remove.
-
Click Yes in the Add or Remove Programs dialog box.
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.
UDDI Services References
Additional information about UDDI and UDDI Services is available at the
following Web sites:
|
