Prepare SAP Environment

A Sana web store connects to SAP Business One Cloud through the Web service implemented by Sana. The Sana Web service for SAP Business One Cloud is hosted in the Internet Information Services (IIS) Manager. It uses SAP Business One Service Layer to establish connection between Sana and SAP Business One Cloud.

The Sana Web service for SAP Business One Cloud can be installed on any server as long as it can be used as a connection between Sana and SAP Business One Cloud using the Service Layer.

Sana delivers the installer to install and configure the Sana Web service for SAP Business One Cloud.

 NOTE

Only registered Sana partners can download the Sana Web Service installer for SAP Business One Cloud from the Sana Community website. If you are a customer, please contact your Sana partner or Sana project manager.

Prerequisites

• The Sana Web service for SAP Business One. Only registered Sana partners can download it from the Sana Community web site. If you are a customer, please contact your Sana partner or Sana project manager.
• Internet Information Services (IIS) Manager 7.5 or higher.
• .NET Framework 4.5 or higher.
• Windows Authentication role service must be installed on the server.
• HTTP Activation component must be installed on the server.
  Open the Server Manager and "Add Roles and Features Wizard". Go through the wizard until you reach the "Features" screen. Expand the item ".NET Framework 4.5 Features" and the subitem "WCF Services". If the option "HTTP Activation" is not listed as installed, select it and then install.
• Create local or domain user account which will be used to authorize the Sana Web service.
• It is required to secure data transfer between the Sana web store and SAP Business One Cloud. Thus, you must obtain the SSL certificate for the Web service domain. SSL certificate is issued by a certificate authority (CA), which takes steps to verify that your web address actually belongs to your organization. The server where you install the Sana Web service for SAP Business One must support TLS 1.2. TLS 1.2 is available on Windows Server 2008 R2 and higher. The Sana Web service for SAP Business One Cloud must run over HTTPS.

Step 1: Run "Web Service Installer.exe". You can find the Sana Web Service Installer in the "Connector" folder of the Sana add-on package for SAP Business One Cloud.

Step 2: Go to the "Installation/Upgrade" step. Fill in the fields and set up the necessary settings.

Step 3: Click "Install".

The Sana Web Service Installer will create the web site and application pool for the Sana Web Service in the IIS Manager, extract the ERP Web Service files to the installation folder, and set up the Web Service authentication. If you have added the SSL certificate, it will also set up the Sana Web Service for SAP Business One Cloud to use SSL.

Step 4: When the Sana Web Service is installed, click "Next". On the "Configuration" step, fill in the fields and set up the necessary settings to configure the Sana Web Service for SAP Business One Cloud.

Step 5: Click "Save and Test Connection". If the Sana Web Service has been successfully configured and connected to the Service Layer, click "Finish".

When the Sana Web Service for SAP Business One Cloud is installed, it will automatically open in the default Web browser. If you can see the Web Service information page, then the Sana Web Service has been installed successfully.

Step 6: Open Internet Information Services (IIS) Manager. Right-click on the web site of the Sana Web Service and select "Edit Permissions".

Step 7: On the "Security" tab, add the user which must be used to authorize the Sana Web Service. See prerequisites at the top of the page. This user must have "Read & execute" permissions.

 NOTE

When the Sana Web Service for SAP Business One Cloud is installed, you will need to enter the URL of the Web service and user credentials on the "ERP connection" page in Sana Admin to establish connection between Sana and SAP Business One Cloud. If you don't have access to Sana Admin, send the Sana Web service URL and user credentials to the person who is responsible for the Sana web store maintenance. For more information, see "ERP Connection".

When the Sana add-on is installed inside the SAP Business One Cloud, you can reconfigure the Sana Web Service at any time, if there is a necessity. For more information, see "Configure Sana Web Service for SAP Business One Cloud".