Installing the ESB Management Portal UDDI Publishing Service

The ESB Management Portal UDDI Publishing Service is a sample service that queries the EndPoints table of the ESBAdmin database to retrieve the Microsoft BizTalk send ports and receive locations to publish to the UDDI server. If the Auto Publish feature is enabled, the service automatically calls the ESB UDDI Web service to publish the endpoint to Universal Description, Discovery, and Integration (UDDI). If the Auto Publish feature is not enabled, the service sends a notification e-mail message to the UDDI administrator; the e-mail message advises the administrator to log on to the ESB Management Portal to publish the endpoint.

Additionally, the UDDI Publishing Service monitors changes made in the Description field of BizTalk receive locations and send ports. For example, when a developer creates or modifies a receive location or a send port, the developer can indicate that the URL configured for it must be registered with UDDI. The developer can enter the moniker uddi:// into the Description property of the receive location or a send port. The UDDI Publishing Service detects the entry, retrieves the necessary endpoint information from the BizTalk receive location or send port, and publishes it according to the UDDI registry settings configured in the ESB Management Portal.

The UDDI Publishing Service has no dependency on BizTalk Server, and it can be installed on a computer that does not have BizTalk Server installed.

To install the ESB Management Portal UDDI Publisher Service

1. If you have not already installed and configured the ESB Management Portal as described in the section Installing the ESB Management Portal, do that now.
2. Open the Visual Studio solution named ESB.UDDI.PublisherService.sln from the \Samples\Management Portal\ESB.UDDI.PublisherService folder. Make sure that the <connectionStrings> section of the App.config file contains the correct connection strings for the ESBAdmin and EsbExceptionDb databases. The following are the default settings.
   Copy

   <connectionStrings>
     <add name="AdminDatabaseServer"
          connectionString="Data Source=.;
                            Integrated Security=True;
                            Initial Catalog=ESBAdmin"
          providerName="System.Data.SqlClient" />
     <add name="EsbExceptionDb" 
          connectionString="Data Source=.;
                            Initial Catalog=EsbExceptionDb;
                            Integrated Security=True"
          providerName="System.Data.SqlClient"/>
   </connectionStrings>
   

3. Make sure that the <applicationSettings> section of the App.config file contains the correct addresses for the UDDIService and BizTalkOperationsService Web services. The following are the default settings.
   Copy

   <applicationSettings>
     <Microsoft.Practices.ESB.UDDI.PublisherService.Properties.Settings>
       <setting name="ESB_UDDI_PublisherService_UDDIService_UDDIService"
                serializeAs="String">
         <value>
             http://localhost/ESB.UDDIService/UDDIService.asmx
         </value>
       </setting> 
       <setting name="Microsoft_Practices_ESB_UDDI_PublisherService_BTQueryService_BizTalkQueryService"
                serializeAs="String">    
         <value>
           http://localhost/ESB.BizTalkOperationsService/BizTalkOperationsService.asmx
         </value>
       </setting>
     </Microsoft.Practices.ESB.UDDI.PublisherService.Properties.Settings>  
   </applicationSettings>
   

   Note:
   The UDDIService is a custom ESB Web service and should not be confused with the actual UDDI server.

4. If you are using a 64-bit computer, open the ESB.UDDI.PublisherService.sln solution in Visual Studio and change the TargetPlatform property for the ESB.UDDI.PublisherService.Install project from x86 to x64.
5. Build the ESB.UDDI.PublisherService.sln solution using the commands on the Build menu.
6. Open Windows Explorer, navigate to the folder \Samples\Management Portal\ESB.UDDI.PublisherService.Install\Release, and then run the Windows Installer file named Setup.exe.
7. Leave all settings at their default values, and then click Next until the installer displays the username and password values to configure the service account for the UDDI Publishing Service. Select an account that is a member of the BizTalk Server Administrators group and that has access to the server hosting the UDDI Publisher Service. Enter the account name in the following form: <DomainName>\<UserName>.
8. Use the Registry Settings page in the portal to configure the following settings in the UDDI Admin table of the ESBAdmin database:
   • UDDIServer. This setting is the URL of the UDDI server; for example, http://servername/uddi.
   • Publishing Service Interval. This settings sets UDDI pubishing service polling interval in milliseconds.
   • Categorization Schema. This setting defines base name of categorization schema used for publishing service endpoints to UDDI.
   • LDAP Root. This setting defines address of LDAP server.
   • Auto Publish. This setting indicates whether the service will automatically publish endpoints to the UDDI server or if administrative approval is required.
   • Anonymous. This setting indicates whether to use anonymous access to connect to the UDDI server or to use the UDDI Publisher Service account.
   • Notification Enabled. This setting indicates whether to send endpoint update notification e-mail messages.
   • SMTP Server. This setting is the address of the SMTP server that will send notification e-mail messages.
   • Notification E-Mail. This setting is the e-mail address to which to send endpoint update notification e-mail messages.
   • E-Mail From Address. This setting is the From address for notification e-mail messages.
   • E-Mail Subject. This setting is the text to display in the subject line of notification e-mail messages.
   • E-Mail Body. This setting is the text for the body of notification e-mail messages.
   • Contact Name. This setting is name of the UDDI administrator to notify of endpoint update requests.
   • Contact E-Mail. This setting is the e-mail address of the UDDI administrator to notify of endpoint update requests.
9. Open Services from Administrative Tools and locate the BizTalk ESB UDDI Publishing Service. Make sure that the startup type is set to Automatic, and then start the service. To open the Services management console, click Start on the taskbar, point to All Programs, point to Administrative Tools, and then click Services (or click Start on the taskbar, and then type services.msc in the search box).

If you run into issues, see Troubleshooting Portal Installation and Configuration.