Cloudsnap SAP B1 Connector Installation Guide · Cloudsnap SAP B1 Connector Installation Guide 1....

CloudsnapSAPB1ConnectorInstallationGuide

1. PrerequisitesCloudsnapB1ConnectorrunsonWindowsPlatform;itrunsinsideASP.NETcontainerasaRESTfulWebServiceAPI,andusesSAPDI-APItoconnecttoSAPsystem.BeforeinstallingCloudsnap’sB1Connector,thefollowingcomponentsmustbeinstalledonthemachinethatCloudsnap’sB1Connectorwillberunning.

A. .NETFrameworkNET,FrameworkRuntime4.0(orhigher),youcandownloadandinstallcurrent.NETFrameworkRuntime4.7.2viathelinkbelow:https://www.microsoft.com/net/download/thank-you/net472

B. InstallandenableMicrosoftIIS(InternetInformationServices).YoucanfindhowtoinstallandenableMicrosoftIISonyourWindowsServerviaMicrosoftwebsite:https://msdn.microsoft.com/en-us/library/ms181052(v=vs.80).aspx

C. InstallSAPBusinessOne64-bitDI-API.CloudsnapB1ConnectorrequiresSAPBusinessOne64-bitDI-APIinstalledontheWindowmachine.YoucanfindtheSAPBusinessOne64-bitDI-API’sinstallationcomponentsinyourSAPBusinessOneInstallationpackage.

D. AcquirenecessaryrequiredconfigurationinformationforCloudsnap’sB1ConnectortoconnecttoyourSAPsystem.TherequiredInformationforCloudsnap’sB1Connectorconfigurationfile:

Cloudsnap’sConfig.xml

<Config> <Settings>

<Server>WIN-D66QCI8ELFC</Server><DB>SBODemoUS</DB><DBType>10</DBType><SAPUserName>manager</SAPUserName><SAPPassword>manager</SAPPassword><LicenseServer> WIN-D66QCI8ELFC <LicenseServer><DBTrustedConnection>1</DBTrustedConnection>

</Settings></Config><Server>: SAPServerIPaddressorHostname<DB>: SAPCompanyDatabaseName<DBType>: SAPDatabaseServerType.Oneofthepossiblevalues: 6–MSSQL2008,7–MSSQL2012,8–MSSQL2014,9-HANA,10–MSSQL2016<SAPUserName>: SAPusername <SAPPassword>: SAPpassword<LicenseServer>: SAPLicenseServerIPorHostname<DBTrustedConnection>:WhetherornotDI-APIusetrustedconnection.Oneofpossiblevalues:

0–NotaTrustedConnection,1–TrustedConnectionNote:ItiscriticaltheSAPcredentialhasfullpermissiontoaccessSAPdatabase.

E:WindowsAccountPermissions EventhoughCloudsnap’sB1Connectordoesn’treallyrequireasystem

Administratorprivilege,B1ConnectordoesrequiretheWindowsprivilegetobeabletocreate,readandwriteWindowsEventLog.AlloftheerrorandwarningloginformationwillbewrittenintoWindowsEventLog.

F: ConfigureWindowsFirewalltoallowinternalTCP/IPcommunication B1ConnectorwillcommunicatetoourNuManageAgentinternallyonthesame

Windowsmachineviahttp://localhost:3030,itisrequiredtoconfigureWindowsFirewalltoallowinternalcommunicationsbetweenB1ConnectorandNuManageAgent.

2. DownloadB1ConnectorlatestversionandInstallation

A. B1Connectorcanbedownloadedvia:https://s3.us-east-2.amazonaws.com/cloudsnap.com/builds/B1Connector/latest/RESTServices.zip

B. Installation

• Unzipthedownloadedbinaryinto:‘C:\inetpub’folderonWindowsmachine• Renamethefoldernamefrom‘RESTServices’to‘CloudsnapB1Connector’

C. C:\inetpub\CloudsnapB1Connector\BusLayer\Config.xml• Open‘C:\inetpub\CloudsnapB1Connector\BusLayer\Config.xml’with

notepad.exeoranytexteditor.• FillintherequiredConfigurationsettingsbasedonPrerequisitessection1.D• SavetheConfig.xml

3. ConfigureIIStorunB1ConnectorWebServiceAPIOpen‘MicrosoftInternetInformationServices(IIS)Manager’

A. CreateanApplicationPool

• High-lightthe‘ApplicationPool’andright-click• Clickon‘AddApplicationPool…’• Typein‘B1Connector’asApplicationPoolname,Click‘OK’• A‘B1Connector’ApplicationPoolwillappearinmiddlepanel

B. Configure‘B1Connector’ApplicationPool• High-light‘B1Connector’ApplicationPoolinmiddlepanel• Select‘BasicSettings…’

• Setthevaluesasinthepicturebelow,clickon‘OK’

• High-light‘AdvancedSettings…’,andclick

• SettheIdentitytoaWindowsaccountwithcreate,readandwriteEventLogpermissions,setvaluesasinthepicturebelow,andleavemosttoitsdefaultvalue,clickon‘OK’

C. CreateaWebsite• High-light‘Site’andclickon‘AddWebsite…’

• Setthevaluesassameinthepicturebelow:

• Verify‘B1Connector’ApplicationPoolisin‘Started’state

• Verify‘CloudsnapB1Connector’websiteisin‘Started’state(‘Start’isgreyedout)

4. VerifyB1Connectorisupandrunning

a. Downloadandinstall‘Postman’:https://www.getpostman.com/appsb. PastetheURL:‘http://localhost:3030/api/businesspartner/allcardcode/v2’in

Postman’sURL,select‘GET’method,andclickon‘Send’Buttonc. IfCloudsnapB1Connectorinstalledsuccessfully,youshouldseethereturnof

aboveURLasfollows: