User manual MICROSOFT DYNAMICS NAV 5.0

[. . . ] Microsoft Dynamics NAV 5. 00 TM Installation & System Management: Commerce Gateway for Microsoft DynamicsTM NAV®5. 00 INSTALLATION & SYSTEM MANAGEMENT: COMMERCE GATEWAY FOR MICROSOFT DYNAMICSTM NAV 5. 00 Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted in examples herein are fictitious. No association with any real company, organization, product, domain name, e-mail address, logo, person, place, or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. [. . . ] When the Custom Adapter or Commerce Gateway Request Server is finished sending data, it will tell the broker to mark the NAV Application Server as available. When you are running Dynamics NAV Commerce Gateway Broker, you define the IP address and port number for Dynamics NAV Commerce Gateway Broker in the BizTalk Management Setup window in Dynamics NAV. Define the port numbers for NAV Application Servers in the Start-Up Parameter Value field. For example, CG Port= 7528 where 7528 represents the number of the receiving port (TCP/IP). . Refer to the manual Installation & System Management: Application Server for Microsoft Dynamics NAV for information about how to install more than one NAV Application Server. Refer to the section Running More Than One NAV Application Server in this manual for information about how to fill in the setup windows when you are running more than one NAV Application Server. Running the Setup Wizard To run the Commerce Gateway Broker setup wizard: 1 Double click the setup. exe file for the Commerce Gateway Broker that is located on the Microsoft Dynamics NAV product DVD. The installation wizard will guide you through the installation process. 25 Chapter 1. Commerce Gateway 5. 00 for BizTalk Server 2006 2 In the Customer Information window, enter your user name, for example, Broker_user, and company name. You can also leave these fields blank. 3 In the Setup Type window, select Complete: 4 In the Ready to Install the Program window, click Install to start the installation of Commerce Gateway Broker. Modifying the Config. Xml files Before you start using Commerce Gateway Broker, you must make some modifications to the CGBroker_Config. Xml and the TCPCom_Config. Xml files. Modifying the CGBroker_Config. Xml File All the available NAV Application Servers must be known to the broker, and therefore you must specify some parameters in the CGBroker_Config. Xml file. 26 1. 6 Installing Microsoft Dynamics NAV Commerce Gateway Broker The file is located in the C:\Program Files\Microsoft Dynamics NAV\Commerce Gateway Broker folder. Open the file, for example with Notepad, and make the following changes: <Settings> <ApplicationServers> <ApplicationServer> <Name>NAS</Name> <IP>127. 0. 0. 1</IP> <PortNumber>7518</PortNumber> </ApplicationServer> </ApplicationServers> <RecoveryPoll>5</RecoveryPoll> </Settings> 1 Enter a name for the NAV Application Server in Settings/ApplicationServers/ApplicationServer/Name to make the first NAV Application Server known to the broker. It can be any name you choose but it must be unique. 2 Enter the IP address of the NAV Application Server in Settings/ApplicationServers/ApplicationServer/IP. 3 In Settings/ApplicationServers/ApplicationServer/PortNumber, enter the port number that the NAV Application Server is listening to. Make sure that the number is identical to the port number in the Start-Up Parameter Value field the NAV Application Server Manager. 4 The RecoveryPoll field specifies the interval in seconds you want the broker to listen for an available NAS after the NAS has returned a "Not available" message. To enter information for additional NAV Application Servers, you must copy the lines for the first NAV Application Server and paste them into the document. Change the values in the fields to match the values valid for the NAV Application Servers. 27 Chapter 1. Commerce Gateway 5. 00 for BizTalk Server 2006 Make sure to give the application servers unique names. <Settings> <ApplicationServers> <ApplicationServer> <Name>NAS1</Name> <IP>10. 251. 71. 46</IP> <PortNumber>7518</PortNumber> </ApplicationServer> <ApplicationServer> <Name>NAS2</Name> <IP>10. 251. 71. 46</IP> <PortNumber>7519</PortNumber> </ApplicationServer> <ApplicationServer> <Name>NAS3</Name> <IP>10. 251. 71. 46</IP> <PortNumber>7520</PortNumber> </ApplicationServer> </ApplicationServers> <RecoveryPoll>5</RecoveryPoll> </Settings> Modifying the TCPCom_Config. Xml File In the TCPCom_Config. Xml file you specify some security options, the port number of the broker, set a maximum size for the documents you transfer and specify a dump path for request and response documents. The file is located in the C:\Program Files\Microsoft Dynamics NAV\Commerce Gateway Broker folder. Open the file, and make the following changes: <Settings> <PortNumber>7517</PortNumber> <MaxDatasize>20000000</MaxDatasize> <Security> <AllowAll Values="Yes/No">Yes</AllowAll> <LogIntruders Values="Yes/No">No</LogIntruders> <Cryptography Values="Yes/No">Yes</Cryptography> <AllowedIPs> <IP>127. 0. 0. 1</IP> </AllowedIPs> </Security> <Debug> <RequestDocuments> <DumpDocuments Values="Yes/No">No</DumpD <DumpPath>C:\TCPDocLog\Request</DumpPat </RequestDocuments> <ResponseDocuments> <DumpDocuments Values="Yes/No">No</DumpD <DumpPath>C:\TCPDocLog\Response</DumpP </ResponseDocuments> </Debug> </Settings> 28 1. 6 Installing Microsoft Dynamics NAV Commerce Gateway Broker 1 In Settings/PortNumber, enter the number of the port that Commerce Gateway Broker should listen to. Make sure that the port number is identical to the number in the Appln. Srv. /Broker Port No. 2 A maximum size for the documents you are transferring is defined in Settings/MaxDatasize. The default value is 20 MB, but you can change this value to anything lower than the max. If you set it to Yes, the broker will handle the request regardless of the IP address that the request was sent from. [. . . ] The Custom Adapter wraps the received document with information from BizTalk Server, such as document specification, partner ID and document name. The Custom Adapter asks the broker for an available application server. The Custom Adapter then forwards the document to the assigned NAV Application Server using TCPCom. Once the application server has handled the document, the Custom Adapter provides the broker with information about the transaction and the application server is marked as available. [. . . ]