This section instructs a user on the settings needed to be made to the SIRVA sHub and related components available from MoversSuite on to an application server.

 

Prior to configuring the Microsoft BizTalk Server (BizTalk), all folders and queues referenced in the instructions below must exist and have the proper permissions assigned.  All folders that will be used by BizTalk must have the BizTalk user assigned to the folder’s security.

 

The procedure consists of configuring ports and locations needed by the Microsoft BizTalk Server application to communicate with the SIRVA sHub.

 

Configure send ports and receive locations

 

Notes: 

•      Default all Send pipelines to PassThruTransmit, unless otherwise specified

•      Transport Types may differ depending on the customer

•      Select the same Host from the dropdown menu for all steps

•      The anticipated folder structure for both Atlas and SIRVA sHub is listed below:

 

Figure 15: Atlas and SIRVA sHub default folders structure.

 

Process to setup Send and Receive Ports and Locations for SIRVA sHub

1.   Run the Start > All Programs > Microsoft BizTalk Server 2006 > BizTalk Server Administration program,

2.   Expand the Biztalk Server 2006 Administration > BizTalk Group > Applications > sHub folder,

Figure 16: Configure option within the BizTalk Server application.

3.   Right-mouse click the sHub application and choose Configure and the Configure Application interface will appear,

Figure 17: Orchestrations configurations from the main menu.

Within the Orchestrations section:

Update the LocalListenerErrors settings:

4.   Click on LocalListnerErrrors menu option,

5.   Select a Host, such as “BizTalkServerApplication”,

6.   Create an Inbound Logical Ports Receive Ports (click in the row under the Receive Ports header and select <New receive port…>) with the following properties:

Property	Value
Name	LocalListenerError

 

a.   Set the following within the Receive Locations option:

Property	Value
Name	POP3 LocalListenerError Location
Type	POP3

 

b.   Configure the POP3 type with the following properties (available through the Configure…button).  Note: Most of these properties will depend on how the mail server is configured:

Property	Value
MIME Decoding	True
Body Part Index	1
Authentication Scheme	Basic
Error Threshold	10
Polling Interval	1
Polling Interval Unit	Minutes

 

7.   Create an Outbound Logical Ports Send Ports/Send Port Groups (click in the row under the Send Ports/Send Port Groups header and select <New send port…>) with the following properties:

Property	Value
Name	Echo.LocalListenerError
Type	FILE
Destination Folder	Locallistener-error.echo

 

Update the SQL Error Log Ports:

8.   Open the LogSqlError settings from the list of Orchestrations,

9.   Select the appropriate Host from the available list (example: BizTalkServerApplication),

10.  Create an Outbound Logical Ports Send Ports/Send Port Groups (click in the row under the Send Ports/Send Port Groups header and select <New send port…>) with the following properties:

Property	Value
Name	SqlLogErrorPort
Type	SQL
Connection String	(Found through the Configure… button and pressing the ellipses button within the Connection String field) Set the Data Link Properties of Select or enter server name and Select the database on the server.  These two settings are pointers to the server and the database that sHub will be using.

 

Update the Registration Request Ports:

11.  Open the RegistrationRequest settings from the list of Orchestrations,

12.  Select the appropriate Host from the available list (example: BizTalkServerApplication),

13.  Create an Inbound Logical Ports Receive Ports (click in the row under the Receive Ports header and select <New receive port…>) with the following properties:

Property	Value
Name	MssRequestPort

 

a.   Set the Receive Locations for this port as follows (define new locations by opening the Receive Locations screen and pressing the New… button):

Property	Value
Name	MssRequestLocation
Type	FILE
Receive Folder	Set to appropriate directory

b.   Create a second Receive Location with the following properties:

Property	Value
Name	Mss Request Queue
Type	MSMQ
Password	As needed
User name	As needed
Batch Size	As needed
On Failure	As needed
Ordered Processing	As needed
Queue	As needed
Transactional	If the sHub queue is transactional, then verify that this option is set to True otherwise set it to False.

 

14.  Create an Outbound Logical Ports Send Ports/Send Port Groups (click in the row under the Send Ports/Send Port Groups header and select <New send port…>) with the following properties:

a.   Define the first Send Port with the following properties:

Property	Value
Name	EchoRequest
Type	FILE Set the Destination Folder within the Configure… options.

b.   Define a second Send Port with the following properties:

 

Property	Value
Name	LLDataPort
Type	FILE Set the Destination Folder within the Configure… options.
Send pipeline	XMLTransmit

 

Update the Registration Response Ports:

15.  Open the RegistrationResponse settings from the list of Orchestrations,

16.  Select the appropriate Host from the available list (example: BizTalkServerApplication),

17.  Create an Inbound Logical Ports Receive Ports (click in the row under the Receive Ports header and select <New receive port…>) with the following properties:

Property	Value
Name	sHub.LL.In.Port
In the Receive Location section:
Name	sHub.LL.In.FolderLocation
Type	FILE Configure the file properties as needed (Configure… button) and confirm that the correct URI propagates.

 

18.  Create an Outbound Logical Ports Send Ports/Send Port Groups (click in the row under the Send Ports/Send Port Groups header and select <New send port…>) with the following properties:

Property	Value
Name	EchoResponsePort
Type	FILE Configure the file properties as needed (Configure… button) and confirm that the correct URI propagates.

 

a.   Define a second Send Port with the following properties:

Property	Value
Name	Mss.Mirror.InternalImportPort
Type	FILE Configure the file properties as needed (Configure… button) and confirm that the correct URI propagates. Set the File name within the Configuration for the type to “%SourceFileName%.xml”
Send pipeline	XMLTransmit

 

b.   Define a third Send Port with the following properties:

Property	Value
Name	FinalOutputPort
Type	FILE Configure the file properties as needed (Configure… button) and confirm that the correct URI propagates.
Send pipeline	XMLTransmit

 

c.   Define a fourth Send Port with the following properties:

Property	Value
Name	Mss.Error.DownloadException
Type	FILE Configure the file properties as needed (Configure… button) and confirm that the correct URI propagates.

Update the Registration Request Ports:

19.  Open the SqlImportOrder settings from the list of Orchestrations,

20.  Select the appropriate Host from the available list (example: BizTalkServerApplication),

21.  Create an Outbound Logical Ports Send Ports/Send Port Groups (click in the row under the Send Ports/Send Port Groups header and select <New send port…>) with the following properties:

Property	Value
Name	SqlXmlImportPort
Type	SQL Configure the file properties as needed (Configure… button) and confirm that the correct URI propagates. Set the Data Link Properties of Select or enter server name and Select the database on the server.  These two settings are pointers to the server and the database that sHub will be using.
Receive Pipeline	XMLReceive

Create a Static One-Way Send Port:

22.  Open the sHub > Send Ports folder,

23.  Right-mouse click in the Send Ports pane,

24.  Create a new port by <Static one-way send port…> with the following attributes:

Property	Value
Name	SqlTempOutput
Type	FILE Configure the file properties as needed (Configure… button) and confirm that the correct URI propagates.

Start and verify sHub:

25.  Start the sHub application through the right-mouse click options of sHub > Start > Start and verify that it operates as expected.