Upload
others
View
25
Download
0
Embed Size (px)
Citation preview
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: