Complete the following steps to configure AmigoPOS to use MS SQL Server as the database engine. Do not complete this section until MS SQL Server has been installed (and configured successfully) and the database is created.



Database Configuration Utility

Database Configuration Utility



1. Open the database configuration utility from the Windows Start Menu and select Microsoft SQL Server from the drop-down list. Select the version of SQL Server database driver to use, as shown in box #2 above. If you are unsure, open Control Panel - Administrative Tools - Data Sources and refer to the following image. SQL Native Client 11.0 is used by MS SQL Server 2012, SQL Server Native Client 10.0 is used by MS SQL Server 2008 R2. Note that AmigoPOS installs SQL Server Native Client 11.0 by default on Windows 7/8/8.1/10 computers.



Control Panel | Administrative Tools | ODBC Data Sources

Control Panel | Administrative Tools | ODBC Data Sources




2. Enter the Database Server name and Instance, separated by a back slash as shown above in box #4. The server name is the name of the PC as shown in the Windows Control Panel System applet. In this case the PC is named POS1. The instance name is set during SQL Server installation and can be determined by opening the Services applet in Windows Control Panel | Administrative Tools, as shown below. In this case, there are 3 instances installed. The instance used by AmigoPOS is SQLEXPRESS. The server name is POS1\SQLEXPRESS, as shown above in the "Server" field.


Windows Services Applet

Windows Services Applet


3. Enter the database name as described in the previous topic. In the case, the database is named AmigoPOS as shown above in the "Server" field.


4. Select the mode of security. If multiple POS Stations (and/or back office computers) exist on a simple Windows network, use SQL Server Authentication, as it is the easiest to configure. If SQL Server resides on the same PC that is being configured or a domain is used, Windows Authentication can be used with little or no additional configuration.


5. Enter the Login Name. The default Login created during setup is sa but may be disabled. For extra security leave this account disabled and create a new Login. The sa account can be enabled or additional Logins can be added by using SQL Server Management Studio Express, as shown below. Use SQL Server Authentication when creating a new login


Adding a new SQL Server Login in SQL Server Management Studio

Adding a new SQL Server Login in SQL Server Management Studio



Enable the sa account in SQL Server Management Studio

6. Enter the Password that was created during installation or when adding new users in the previous step.


7.Select the Timeout value. This is the time in seconds that AmigoPOS will attempt to connect to the database server before raising an error. A low value may cause excessive errors on slow networks; a high value will result in excessive wait time before the error is raised; AmigoPOS will be unresponsive to mouse clicks during this timeout period. In most cases, a value between 5-15 seconds is adequate.


8. Click Test to confirm that the connection parameters are correct. If the connection is not established within the Timeout interval specified in the previous step, an error message will appear below the Test button. The error message is also saved to the error log and can help the technical support personnel resolve the issue.


Note that any changes in the SQL Server connection settings are saved automatically when the Test button is pressed.