Leaked source code of windows server 2003
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

  1. <html>
  2. <head>
  3. <title>UDDI Services Post-Installation Notes</title>
  4. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=Windows-1252">
  5. <META HTTP-EQUIV="MSThemeCompatible" CONTENT="Yes">
  6. <META NAME="MS.LOCALE" CONTENT="EN-US">
  7. <LINK REL="STYLESHEET" HREF="webroot/stylesheets/uddi.css" TYPE="text/css">
  8. <SCRIPT>
  9. function BringToFront()
  10. {
  11. window.focus();
  12. }
  13. </SCRIPT>
  14. </head>
  15. <body marginwidth="0" marginheight="0" LEFTMARGIN="0" TOPMARGIN="0" rightmargin="0" background="images/bg.help.gif" ONLOAD="BringToFront()">
  16. <table cellpadding='0' cellspacing='0' width='100%' height='74' border='0' class='headerFrame' ID="Table4">
  17. <tr height='65'>
  18. <td align='left' valign='center'><img src="webroot/images/logo.gif" alt="UDDI&nbsp;Services logo" border="0" width="150" height="64"></td>
  19. </tr>
  20. </table>
  21. <table class="content" width="100%" cellpadding="8" ID="Table1">
  22. <tr>
  23. <td>
  24. <h1><a name="toppage"></a>UDDI&nbsp;Services Post-Installation Notes</h1>
  25. <p align="center"><font color="red">This document contains vital information pertaining
  26. to the proper functionality of a UDDI&nbsp;Services site.<BR>
  27. </font><FONT color="red">It is advised that you review this document in its
  28. entirety before using UDDI&nbsp;Services. </FONT>
  29. </p>
  30. <h2>Web Server component</h2>
  31. <P>
  32. </P>
  33. <ul>
  34. <li>
  35. <a href="#PostInstall">Post-Installation Information</a>
  36. <br>
  37. Important information regarding the installation and configuration of a
  38. UDDI&nbsp;Services Web server component.<BR>
  39. <li>
  40. <a href="#KnownIssues">Known Issues</a>
  41. <br>
  42. Known issues with the Web server component and this release of
  43. UDDI&nbsp;Services<BR>
  44. <li>
  45. <a href="#Troubleshooting">Troubleshooting </a>
  46. <br>
  47. Guide to addressing issues in UDDI&nbsp;Services<BR>
  48. <li>
  49. <a href="#Uninstall">Uninstalling UDDI&nbsp;Services</a>
  50. <br>
  51. Step-by-step instructions for uninstalling UDDI&nbsp;Services<BR>
  52. <li>
  53. <a href="#References">UDDI&nbsp;Services References</a>
  54. <br>
  55. Links to additional information about UDDI&nbsp;Services<BR>
  56. </li>
  57. </ul>
  58. <div>
  59. <hr size="2" width="100%" noshade color="black" align="left">
  60. </div>
  61. <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table9">
  62. <tr>
  63. <td>
  64. <p align="center"><a href="#TopPage">Back to top</a></p>
  65. </td>
  66. </tr>
  67. </table>
  68. <h3><a name=BPostInstall"></a>Post-Installation Information</h3>
  69. After installing a UDDI&nbsp;Services Web server component, you must configure
  70. Internet Information Services (IIS) so that UDDI&nbsp;Services will function
  71. properly.<BR>
  72. <p><a name="ssl"></a> If you use Secure Socket Layer (SSL) encryption with
  73. UDDI&nbsp;Services, then you must obtain and install an authentication
  74. certificate. If you have already obtained and installed an authentication
  75. certificate for the installation of IIS hosting the UDDI&nbsp;Services Web
  76. server component, then you do not need to obtain and install another
  77. certificate. For more information, open IIS MMC help, open the <b>Server
  78. Administration Guide</b>, click <b>Security</b>, click <b>Secure Sockets Layer
  79. (SSL)</b>, and then click <b>Configuring SSL on Your Server</b>.
  80. </p>
  81. <p><b>Note:</b>&nbsp;&nbsp;SSL-encryption provides increased security for
  82. communications between client computers and the UDDI&nbsp;Services Web server
  83. component. If you opted not to use SSL during your UDDI&nbsp;Services
  84. installation, you do not need to obtain or install a server authentication
  85. certificate. However, it is highly recommended that you use SSL with
  86. UDDI&nbsp;Services.</p>
  87. <p>
  88. <a name="asp.net"></a>The ASP.NET Web service extension is automatically
  89. enabled during installation of the UDDI&nbsp;Services Web server component. If
  90. this Web service extension is disabled, the UDDI&nbsp;Services Web server
  91. component will cease to function. For more information, open IIS MMC help, open <b>Getting
  92. Started</b>, click <b>Common Administrative Tasks</b>, and then click <b>How to
  93. Enable Web Service Extensions</b>.</p>
  94. <p>
  95. After you have configured IIS for UDDI&nbsp;Services, you can proceed to use
  96. and interact with it through the following interfaces:</p>
  97. <p>You can interact with a UDDI Services site through one or more of the following
  98. interfaces:
  99. </p>
  100. <UL>
  101. <B>UDDI Services Web User Interface:</B> Provides searching, publishing, and
  102. coordination features that are compatible with Microsoft Internet Explorer 4.0
  103. or later and Netscape Navigator 4.5, or later.
  104. <UL>
  105. <LI>
  106. Integrated Windows Authentication: https://<I>&lt;servername&gt;</I>/uddi/ or
  107. http://<I>&lt;servername&gt;</I>/uddi/
  108. <LI>
  109. Unauthenticated interface with read (inquiry) access only: https://<I>&lt;servername&gt;</I>/uddipublic/
  110. or http://<I>&lt;servername&gt;</I>/uddipublic/
  111. </LI>
  112. </UL>
  113. </UL>
  114. <br>
  115. <UL>
  116. <B>Visual Studio&nbsp;.NET Add Web Reference Interface:</B> Provides Web
  117. service discovery and integration in Visual Studio .NET through UDDI Services.
  118. <UL>
  119. <LI>
  120. Integrated Windows Authentication: https://<I>&lt;servername&gt;</I>/uddi/addwebreference/&nbsp;or
  121. http://<I>&lt;servername&gt;</I>/uddi/addwebreference/
  122. <LI>
  123. Unauthenticated interface: https://<I>&lt;servername&gt;</I>/uddipublic/addwebreference/
  124. or http://<I>&lt;servername&gt;</I>/uddipublic/addwebreference/
  125. </LI>
  126. </UL>
  127. </UL>
  128. <br>
  129. <UL>
  130. <B>UDDI API Interface:</B> Supports the UDDI version 1.0 and 2.0 APIs, enabling
  131. enterprise developers to publish, discover, share, and interact with Web
  132. services directly through their development tools and business applications.
  133. <BR>
  134. <BR>
  135. <b>Publish</b>
  136. <UL>
  137. <LI>
  138. Integrated Windows Authentication for publish API messages: https://<I>&lt;servername&gt;</I>/uddi/publish.asmx
  139. or http://<I>&lt;servername&gt;</I>/uddi/publish.asmx
  140. <LI>
  141. UDDI Specification-based Authentication for publish API messages: https://<I>&lt;servername&gt;</I>/uddipublic/publish.asmx
  142. or http://<I>&lt;servername&gt;</I>/uddipublic/publish.asmx</LI>
  143. </UL>
  144. <b>Inquire</b>
  145. <UL>
  146. <LI>
  147. Integrated Windows Authentication for inquire API messages: https://<I>&lt;servername&gt;</I>/uddi/inquire.asmx
  148. or http://<I>&lt;servername&gt;</I>/uddi/inquire.asmx
  149. <LI>
  150. UDDI Specification-based Authentication for inquire API messages: https://<I>&lt;servername&gt;</I>/uddipublic/inquire.asmx
  151. or http://<I>&lt;servername&gt;</I>/uddipublic/inquire.asmx
  152. </LI>
  153. </UL>
  154. <P CLASS="note"><b>Note</b></P>
  155. <UL>
  156. <LI>
  157. The URL to an SSL-encrypted site begins with "https://", and the URL&nbsp;to
  158. a&nbsp;non-SSL-encrypted site begins with "http://". SSL-encrypted
  159. interfaces&nbsp;are only available on those sites that have been configured to
  160. use SSL-encryption.
  161. </LI>
  162. </UL>
  163. </UL>
  164. <div>
  165. <hr size="2" width="100%" noshade color="black" align="left">
  166. </div>
  167. <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table2">
  168. <tr>
  169. <td>
  170. <p align="center"><a href="#TopPage">Back to top</a></p>
  171. </td>
  172. </tr>
  173. </table>
  174. <h3><a name="KnownIssues"></a>Known Issues</h3>
  175. <p>The following issues are known to exist in this version of the
  176. UDDI&nbsp;Services Web server component:
  177. </p>
  178. <UL type="disc">
  179. <li>
  180. UDDI&nbsp;Services requires Internet Information Services (IIS) to be running
  181. in <i>worker process isolation mode</i>; switching to <i>IIS 5.0 isolation mode</i>
  182. will cause UDDI&nbsp;Services to no longer function. For more information, see <b>IIS
  183. Isolation Modes</b>
  184. in IIS Help.
  185. <LI>
  186. Each computer that is a member of a Web Farm must be configured to use the same <b>machineKey
  187. ValidationKey</b> and <b>machineKey DecryptionKey</b> keys. For more
  188. information, see the <a href="http://go.microsoft.com/fwlink/?linkid=8171&amp;clcid=0x409" target="_blank">
  189. .NET Framework General Reference description of the machineKey element</a>
  190. on the Microsoft Web site.
  191. <LI>
  192. If a computer hosting a UDDI&nbsp;Services Web server component is promoted to
  193. a Domain Controller using DCPROMO, IIS and the UDDI&nbsp;Services Web server
  194. component will cease to function. For more information, see the <a href="http://go.microsoft.com/fwlink/?linkid=5214&amp;clcid=0x409" target="_blank">
  195. Microsoft Knowledge Base article</a>
  196. discussing this issue on the Microsoft Support Web site.
  197. <LI>
  198. When installing UDDI&nbsp;Services from a <b>Terminal Server</b> session, a
  199. dialog box&nbsp;appears, requiring UDDI&nbsp;Services to be installed in <b>Multi
  200. User</b> mode. UDDI&nbsp;Services does not support multi-user installations
  201. and will not function correctly. To prevent Multi User mode errors, you must
  202. change your current user session to <b>Install Mode</b> <i>before you install
  203. UDDI&nbsp;Services</i>.
  204. <h4><b>To change your current user session</b></h4>
  205. <UL>
  206. <OL>
  207. <li>
  208. Before you install UDDI&nbsp;Services, type: <b>change user /Install</b>
  209. at the command prompt.
  210. <li>
  211. When your UDDI&nbsp;Services installation is complete, type: <b>change user
  212. /Execute</b> at the command prompt.</li></OL>
  213. </UL>
  214. </LI>
  215. </UL>
  216. <div>
  217. <hr size="2" width="100%" noshade color="black" align="left">
  218. </div>
  219. <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table5">
  220. <tr>
  221. <td>
  222. <p align="center"><a href="#TopPage">Back to top</a></p>
  223. </td>
  224. </tr>
  225. </table>
  226. <H3><a name="Troubleshooting"></a>Troubleshooting</H3>
  227. <P>
  228. Following an installation, review the UDDI&nbsp;Services setup log found in: <b><i>%windir%</i>\uddisetup.log</b></P>
  229. <p><b>Known problems and solutions:</b></p>
  230. <UL>
  231. <LI>
  232. <b>Problem:</b>&nbsp;&nbsp;During installation a message appears "UDDI Services
  233. is not compatible with IIS 5.0 isolation mode. The UDDI Services Web server
  234. component will not be installed."<br>
  235. <B>Cause:</B>&nbsp;&nbsp;Internet Information Services (IIS) is operating in <i>IIS
  236. 5.0 isolation mode</i> - possibly due to an upgrade installation over a
  237. previous version of Windows.<br>
  238. <B>Solution:</B>&nbsp;&nbsp;Configure ISS to operate in <i>worker process isolation
  239. mode</i> and repeat installation. For more information see <b>IIS Isolation
  240. Modes</b> in IIS Help.<BR>
  241. <LI>
  242. <b>Problem:</b>&nbsp;&nbsp;My Web browser&nbsp;fails to connect to a
  243. UDDI&nbsp;Services site with "Cannot find server or DNS error" message.<br>
  244. <B>Cause:</B>&nbsp;&nbsp;SSL-encryption has been enabled for this site, but an
  245. SSL certificate has not been installed.<br>
  246. <B>Solution:</B>&nbsp;&nbsp;Obtain an SSL certificate or disable SSL for this
  247. site. For more information, see <a href="#ssl">Web Server Component Post
  248. Installation Information</a>.<BR>
  249. <LI>
  250. <b>Problem:</b>&nbsp;&nbsp;My Web browser fails to connect to a
  251. UDDI&nbsp;Services site with "The page cannot be found" or "HTTP 404 - File not
  252. found" message.<br>
  253. <B>Cause:</B>&nbsp;&nbsp;The ASP.NET request handler has been disabled.<br>
  254. <B>Solution:</B>&nbsp;&nbsp;Enable the ASP.NET request handler. For more
  255. information, see <a href="#asp.net">Web Server Component Post Installation
  256. Information</a>.<BR>
  257. <LI>
  258. <b>Problem:</b>&nbsp;&nbsp;My Web browser fails to connect to a
  259. UDDI&nbsp;Services site with "The application cannot be started" message.<br>
  260. <B>Cause:</B>&nbsp;&nbsp;A computer hosting a UDDI&nbsp;Services Web server
  261. component for this site has been promoted to a domain controller.<br>
  262. <B>Solution:</B>&nbsp;&nbsp;Do not host the UDDI&nbsp;Services Web component on
  263. a computer that is also a domain controller or reconfigure IIS and ASP.NET to
  264. function properly on the domain controller computer. For more information, see
  265. the <a href="http://go.microsoft.com/fwlink/?linkid=5214&amp;clcid=0x409">Microsoft
  266. Knowledge Base article</a> discussing this issue on the Microsoft Support
  267. Web site.<br>
  268. </LI>
  269. </UL>
  270. <div>
  271. <hr size="2" width="100%" noshade color="black" align="left">
  272. </div>
  273. <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table6">
  274. <tr>
  275. <td>
  276. <p align="center"><a href="#TopPage">Back to top</a></p>
  277. </td>
  278. </tr>
  279. </table>
  280. <H3><A name="Uninstall"></A>Uninstalling UDDI&nbsp;Services</H3>
  281. <P>You can uninstall UDDI&nbsp;Services using the <B>Add or Remove Programs</B> option
  282. on your computer.
  283. </P>
  284. <H4>To uninstall UDDI&nbsp;Services</H4>
  285. <ol>
  286. <li>
  287. In the Control Panel, open <b>Add or Remove Programs</b>.
  288. <li>
  289. Click <b>Add/Remove Windows Components</b>.
  290. <li>
  291. In the Components list, clear the <b>UDDI&nbsp;Services</b>
  292. check box.&nbsp;
  293. <li>
  294. Click <b>Next.</b><br>
  295. A&nbsp;confirmation message appears when uninstallation is complete.
  296. <li>
  297. Click <b>Finish.</b>
  298. <li>
  299. If you selected to create an MSDE2000 database instance for this installation
  300. of UDDI&nbsp;Services, you can also remove that database from this system;
  301. select <b>Microsoft SQL Server Desktop Engine (UDDI)</b> in the Currently
  302. installed programs list, and then click <b>Remove</b>.
  303. <li>
  304. Click <b>Yes</b> in the Add or Remove Programs dialog box.</li>
  305. </ol>
  306. UDDI&nbsp;Services has now been uninstalled from this system. Repeat this
  307. procedure on any other systems from which you would like to uninstall
  308. UDDI&nbsp;Services.
  309. <div>
  310. <hr size="2" width="100%" noshade color="black" align="left">
  311. </div>
  312. <table border="0" cellspacing="0" cellpadding="0" width="100%" ID="Table8">
  313. <tr>
  314. <td>
  315. <p align="center"><a href="#TopPage">Back to top</a></p>
  316. </td>
  317. </tr>
  318. </table>
  319. <h3><a name="References"></a>UDDI&nbsp;Services References</h3>
  320. <p>Additional information about UDDI and UDDI&nbsp;Services is available at the
  321. following Web sites:
  322. </p>
  323. <ul>
  324. <li>
  325. <a href="http://go.microsoft.com/fwlink/?linkid=5212&amp;clcid=0x409" target="_blank">
  326. Microsoft UDDI Home</a>
  327. <li>
  328. <a href="http://go.microsoft.com/fwlink/?linkid=5202&amp;clcid=0x409" target="_blank">
  329. Additional Resources on the Web</a></li>
  330. </ul>
  331. <div>
  332. <hr size="2" width="100%" noshade color="black" align="left">
  333. </div>
  334. <table border="0" cellspacing="0" cellpadding="0" width="100%">
  335. <tr>
  336. <td>
  337. <p align="center"><a href="#TopPage">Back to top</a></p>
  338. </td>
  339. </tr>
  340. </table>
  341. </td>
  342. </tr>
  343. </table>
  344. <table align="center" ID="Table3">
  345. <tr>
  346. <td align="middle">�2002 Microsoft Corporation
  347. <br>
  348. All rights reserved.</A>
  349. <P></P>
  350. </td>
  351. </tr>
  352. </table>
  353. </body>
  354. </html>