InstallationInstall Sana Webstore on Web and Database Server

Install Sana Webstore on Web and Database Server

Sana Commerce 9.2
Your connector

Install Sana Commerce

Install Sana Commerce (Sana webstore and Sana Admin):

Step 1: Run the "Sana Commerce Installer.exe" file from the Sana package.

Step 2: Specify the "Application root path" where the Sana Commerce solution must be installed.

Step 3: Specify the "Frontend application name" which is used for the web site name in Internet Information Services (IIS) Manager.

Step 4: Specify the database connection parameters:

  • Server name: the name of the SQL Server database instance.
  • Database name: the name of the SQL database. Enter the new database name or select the existing one (in this case it will be re-created). Do not use interword spaces in the database name.


Windows Authentication must be used to retrieve the list of database names.


Sana Commerce SQL database can be also hosted on Windows Azure. To restore the Sana SQL database to Windows Azure, you must specify the name of your Windows Azure SQL Database instance in the "Server name" field and use the SQL Server Authentication.

Step 5: In the "Log on to server" section set the administrator credentials of the SQL database.

Step 6: Specify the database user credentials:

  • Database user
  • Database user password

This user is automatically created in the database as a database owner. The database user is connected to the Sana database. Non-existing user name must be specified.

Step 7: Enter SMTP settings: host and port. You can configure a local service that relays to a real SMTP server or an alternative SMTP server can also be used. To establish SSL connection with the SMTP server, select the "SSL enabled" checkbox.

Step 8: Define on which domains the webstore will be running. Several domains can be specified. To separate multiple domains, use line breaks, the ';' or ',' character.

If multiple domains are used, the first domain is used as the default one.


If localhost domain is used for running the webstore, the Default Web Site in Internet Information Services (IIS) Manager must be stopped.

Step 9: Select the deployment type:

To access the webstore and Sana Admin when anonymous authentication is disabled, a user must have read & write permissions to the folder selected for deployment. Use these user's credentials for the NT pop-up.

  • beta: the webstore and Sana Admin are externally accessible, but anonymous authentication in IIS is disabled for both to prevent unauthorized access.
  • live: the webstore is publicly accessible, but anonymous authentication for Sana Admin in IIS is disabled to prevent unauthorized access.
  • test: used for the test purposes. The webstore and Sana Admin are not externally accessible. Thus, the anonymous authentication for Sana Admin and webstore is enabled in IIS.

Step 10: Add the Sana Commerce license. If you install Sana on a beta or live environment, the license file is required. If you install Sana Commerce on a test environment, the webstore will be available via the localhost domain name and in this case the license file is not needed.

Step 11: Add the SSL certificate and enter the password, if it is password-protected.


Applies to: Sana Commerce 9.2.1 and higher

SSL certificate is issued by a certificate authority (CA), which takes steps to verify that your web address actually belongs to your organization. The Web server where you install the Sana Commerce solution must support TLS 1.2.

SSL certificate uses advanced encryption to prevent hackers from reading any data that passes to or from a web site. Thus, the Sana Commerce Installer installs Sana with the SSL certificate right away, so the entire Sana Commerce solution, both Sana webstore and Sana Admin, will run over full HTTPS.


If you don't have the SSL certificate yet, you can install Sana without it, and secure your webstore with SSL once you obtain the security certificate.

For more information, see "HTTPS".

Step 12: Click Run installation.


If  you click "Run installation" and nothing happens, and the following error is shown in the status window: "File run.ps1 cannot be loaded. The file run.ps1 is not digitally signed. You cannot run this script on the current system.", then you need to unblock Windows PowerShell script files in the Sana Commerce Installer package.

In some cases, the Windows PowerShell script files of the Sana Commerce Installer are blocked by the operating system, when they are downloaded from the Internet. Usually, the Sana Commerce Installer is able to bypass this blocking and the scripts can be executed without any problems even if they are blocked by the operating system.

In case you have encountered the above mentioned issue, open the "Files" folder of the Sana Commerce Installer (Sana Commerce [version]\Installer\Files), right-click on the "*.ps1" file, and select "Properties". In the file properties, under the "General" tab, click "Unblock". You must unblock all "*.ps1" files that are stored in the "Files" folder of the Sana Commerce Installer.

When you unblock all "*.ps1" files, run the Sana Commerce Installer again.

When the installation process is finished, Sana Admin will open in the default Web browser. You will be asked to create the first Sana Admin user. This user will have the System administrator role. System administrator has full access to Sana Admin.

In Sana Admin, click View webstore at the top to open the webstore.

When Sana Commerce is installed and the first user with the System administrator role is created, you should make some first steps that allow you or other Sana Admin users proceed to managing the Sana webstore. For more information, see "Getting Started".

InstallationInstall Sana Webstore on Web and Database Server