Developer Workstation Installation

Open 'Developer Workstation Installation' wizard, choose your scenario to see more provider-related information of the installation manual.

Setup the SQL Database

Sana Commerce uses a SQL database to store content, product enrichments, multi-site and multi-language information. Besides that, it contains membership tables in which user and password information of the backoffice users are stored. 
 
To be able to work with SQL Database Engine, your login should be a member of the sysadmin fixed server role. Members of this role can perform any activity in the Database Engine. By default, all members of the Windows BUILTIN\Administrators group (the local administrators group) are members of the sysadmin fixed server role. 
 
To setup this database, undertake the following steps: 

Step 1: Open SQL Management Studio and connect to the SQL server instance where you want to install the database.

Step 2: Expand the SQL server instance in the object explorer, click right on the 'Databases' node and select 'Restore database':

 
Beginning the Restoration of the Database
 
Step 3: Enter a database name in the 'Restore Database' window and select the Sana Commerce SQL backup file in the 'Source for restore > From device' section from the temporary folder where the release of the Sana Commerce solution is stored. Go to the 'Database' directory to locate the 'SanaStore.bak' SQL backup file.

Step 4: Check the 'Restore' check box:

 
Selecting the Sana Commerce Database for Restore Operation 

Step 5: Go to the 'Options' page and set the destination of the new database and the .log file by clicking the button next to the 'Restore As' column (we recommend to choose the SQL Server 'database' directory: 'Microsoft SQL Server\MSSQL.1\MSSQL\Data'):

 
Specifying Files for the Restored Database 

Step 6: Give the appropriate names to the database and .log files (their extensions should be '.mdf' and '.ldf' respectively):

 
Saving the Database and .log Files  

Step 7: Check the 'Overwrite the existing database' check box in the 'Restore options' section.

Step 8: Click 'OK' to create the database:

 
Successful Restoration of the Database 

  
Since the Sana Commerce database has a limited size, we advise to set the Recovery model to 'Full' ('Database Properties > 'Options' page > Recovery model' dropdown) to guarantee the integrity of your data. 

There are two ways to make sure the database is accessible from the Sana Commerce webshop and backoffice:

Use SQL Authentication
If you are going to use this type of authentication please check if it is enabled in SQL Server. Click right on the SQL server instance and select 'Properties > Security'. Make sure that the 'SQL Server and Windows Authentication mode' is selected in the 'Server authentication' section: 

  
Enabling the SQL Server and Windows Authentication Mode 
 
Step 1: Open the SQL server instance > Security, click right on the 'Logins' folder and select 'New login'.

Step 2: Enter a new username and check the 'SQL Server authentication' option.
 
Step 3: Enter a password and confirm it in the second textbox:
 

SQL Server password complexity policies are designed to deter brute force attacks by increasing the number of possible passwords.

  • When the check box 'Enforce password policy' is checked new passwords must meet the following requirements:
    • The password does not contain all or a 'part' of the user's account name. Part of an account name is defined as three or more consecutive alpha-numeric characters delimited on both ends by 'white space' (space, tab, return) or any of the following characters: , . - _ #
    • The password is at least six characters long
    • The password contains characters from three of the following four categories:
    • English uppercase letters (A - Z)
    • English lowercase letters (a - z)
    • Base 10 digits (0 - 9)
    • Non-alphanumeric symbols (For example: !, $, #, or %)
  • Password expiration policies are used to manage the lifespan of a password. When the check box 'Enforce password policy' is checked, users are reminded to change old passwords and accounts with expired passwords are disabled.
  • When the checkbox 'User must change password at next login' is checked, the SQL Server will prompt the user for a new password the first time the new login is used.
Please note that password policies for SQL logins require Windows Server 2003 or later versions. If Sana Commerce project is installed on a workstation with Windows XP, you need to uncheck the 'Enforce password policy' check box.
 
Step 4: Select the newly created Sana Commerce database as the Default database:
 
 
Selecting the 'SQL Server' Option 

Step 5: Go to the 'User Mapping' page, check the 'Map' check box in the Sana Commerce database and check the 'db_owner' role in the membership role list:

 
Specifying the Database and Roles for New Login 

Step 6: Click the 'OK' button to finish the setup.

Use Windows authentication

Step 1: Open the SQL server instance > Security, click right on the 'Logins' folder and select 'New login' (if the windows user already has rights to the SQL server instance, please select the properties of this user instead of creating a new one).

Step 2: Enter the windows username in the 'Login name' textbox. You can  use the search option to lookup users (e.g. in Active Directory).

Step 3: Select the newly created Sana Commerce database as the Default database:

 
Selecting the 'Windows Authentication' Option 

Step 4: Go to the user mappings option, check the Map check box on the Sana Commerce database and check the db_owner role in the membership role list:

 
Specifying the Database and Roles for New Login 

Step 5: Click the 'OK' button to finish the setup.