InstallationPrepare SAP EnvironmentInstall Sana Web Service

Prepare SAP Environment

  Open 'Prepare SAP Environment' wizard and choose your SAP version to see more information.

Install Sana Web Service

A Sana web store connects to SAP Business One through the Web service implemented by Sana. The Sana Web service for SAP Business One is hosted in the Internet Information Services (IIS) Manager and must be installed on the same machine where the DI Server components are installed. The Sana Web service uses the DI Server to communicate with SAP Business One.

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

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.
  • .NET Framework 4.5 or higher
  • Windows Authentication role service must be installed on the SAP Business One server.
  • Create local or domain user account which will be used to authorize the Sana Web service.

Install Sana Web Service for SAP Business One

Step 1: Run "Sana.Commerce.eBusiness.SapB1.Installer" on the SAP Business One server. You can find it in the "Connector" folder in the Sana add-on package for SAP Business One.

Step 2: In the field "Site Name", enter the web site name which will be used in the IIS Manager for the Sana Web service. The name of the application pool is automatically predefined with the web site name.

 NOTE

In the "Site Name" field you can see all web sites that are available in the IIS Manager on the server. If the Sana Web service for SAP Business One is already installed and you need to upgrade it to the latest version, you can also use the installer. You can select the existing web site which hosts the Sana Web service for SAP Business One and upgrade it. If you need to upgrade the Sana Web service, at first create the backup of your existing Web service.

Step 3: In the dropdown list, on the right of the "Application Pool" field, select the deployment type. For example, if you set up the Sana Web service for SAP Business One on the live environment, you can select "Live". This does not change any logic, but only adds the selected deployment type to the end of the web site name in IIS Manager.

Step 4: In the field "Physical Path", enter the location on the SAP Business One server where the Sana Web service must be installed. This is the path where the Sana Web service content will be stored.

Step 5: In the field "Port", enter the port on which the Sana Web service for SAP Business One must run. The requests to the Sana Web service are made through this port.

Step 6: Enter the host name, if you want to access the Sana Web service for SAP Business One by the domain name. The host name is not required. If you leave this field empty, you will be able to access the Sana Web service by the server IP address.

Step 7: Select Windows Authentication to gain access to the Sana Web service for SAP Business One. It is required to use Windows Authentication for security reasons.

Step 8: Click Create.

The Sana Installer will create the web site and application pool for the Web service in the IIS Manager, extract the Web service files to the installation folder, and set up Web service authentication.

When the Sana Web service for SAP Business One 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 9: Open Internet Information Services (IIS) Manager. Right-click on the web site of the Sana Web service and select "Edit Permissions".

Step 10: 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 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. 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".


 NOTE

If the Sana Web service is hosted on the IIS version below 7.5, you must comment out the following line of code in the "Web.config" file of the Sana Web service:

<extendedProtectionPolicy policyEnforcement="Always">
InstallationPrepare SAP EnvironmentInstall Sana Web Service