MSSQL Configuration Guide

MSSQL Configuration
for SOLUM AIMS Server

SOLUM E-Label Platform

REV 1.1

SOLUM

01-14-2022

SUMMARY
This guide describes how to setup and configure Microsoft SQL Server (MSSQL) for use with SOLUM ESL
AIMS Server.

© 2020 SOLUM. All rights reserved

The names of actual companies and products mentioned herein

may be the trademarks of their respective owners.

No part of this document may be reproduced, stored in a retrieval

system, or transmitted in any form or by any means without the
express written consent of Samsung Electro-Mechanics.

This document is subject to change without notice.

REV 2.0 SOLUM Proprietary and Confidential 1/17

 MSSQL Configuration Guide

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT

TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS

MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY

PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH

IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY

THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,

CONTACT YOUR SOLUM REPRESENTATIVE FOR A COPY.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE

SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.SOLUM AND THE ABOVE-NAMED SUPPLIERS

DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A

COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL SOLUM OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL,

CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS

OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF SOLUM OR

ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual

addresses and phone numbers. Any examples, command display output, network topology diagrams, and other

figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone

numbers in illustrative content is unintentional and coincidental.

SOLUM and the SOLUM logo are trademarks or registered trademarks of SOLUM and/or its affiliates in the KOREA.

and other countries Third-party trademarks mentioned are the property of their respective owners. The use of the

word partner does not imply a partnership relationship between SOLUM and any other company.

©
2016-2020 SOLUM Co Ltd, Inc. All rights reserved.

REV 2.0 SOLUM Proprietary and Confidential 2/17

 MSSQL Configuration Guide

TABLE OF CONTENTS

1 PREFACE ................................................................................................................. 5
1.1 ABOUT THIS GUIDE ........................................................................................................................... 5

1.2 AUDIENCE ........................................................................................................................................ 5

1.3 ABBREVIATIONS AND ACRONYMS ....................................................................................................... 5

2 CONFIGURATION .................................................................................................... 6
2.1 MICROSOFT SQL SERVER CONFIGURATION ....................................................................................... 6

2.2 CREATE AND CONFIGURE DATABASES .............................................................................................12

2.3 CREATE AND CONFIGURE SECURITY LOGIN ......................................................................................15

REV 2.0 SOLUM Proprietary and Confidential 3/17

 MSSQL Configuration Guide

DOCUMENT HISTORY

Rev. Date Revision history Page

1.0 Apr 14, 2020 Initial Draft -
1.01 Jun 16, 2020 Minor revision -
1.1 Sep 28, 2020 Updated to include LBS support -
2.0 Jan 14, 2022 Updated for AIMS v4.4.x -

REV 2.0 SOLUM Proprietary and Confidential 4/17

 MSSQL Configuration Guide

1 Preface
1.1 About This Guide
This guide describes how to setup and configure a Microsoft SQL Server (MSSQL) installation for
use with SOLUM ESL AIMS Server. Steps will be shown for Microsoft Windows.

1.2 Audience
This guide is intended for any IT user properly authorized by their company to administrate over
SOLUM ESL System and ESL operation statuses.

1.3 Abbreviations and Acronyms

Terminology/Abbreviation Description
AIMS A* Information Management System
- Advanced / Automated / Absolute
WAS Web Application Server
MSSQL Microsoft SQL Server
ESL Electronic Shelf Label
HTTP Hypertext Transfer Protocol
HTTPS Hypertext Transfer Protocol Secure
UAA User Account and Authentication
OS Operating System
IT Information Technology
UI User Interface
GUI Graphical User Interface
TBD To Be Decided

REV 2.0 SOLUM Proprietary and Confidential 5/17

 MSSQL Configuration Guide

2 Configuration
2.1 Microsoft SQL Server Configuration
Microsoft SQL Server (MSSQL) must be installed and configured, with ESL databases created, prior
to SOLUM AIMS Server installation. This guide assumes that MSSQL is already installed.
To begin configuration, open SQL Server Configuration Manager from the Windows Start Menu.

Figure 2-1. SQL Server Configuration Manager in the Start Menu

In the left panel under SQL Server Configuration Manager, go to SQL Server Network Configuration and
select Protocols for MSSQLSERVER (Instance ID). In the right panel, right-click on TCP/IP and then left-
click Properties.

Figure 2-2. Configuration of TCP/IP Port

REV 2.0 SOLUM Proprietary and Confidential 6/17

 MSSQL Configuration Guide

From the Protocol tab, set Enabled as Yes.

Then under the IP Addresses tab, set TCP Port (under IPAll) as 1433.
Click OK to apply the new settings.

Figure 2-3. Configure Enable and TCP Port on TCP/IP Properties

Restart SQL Server to apply the new settings. If it is not running, the service must be started.

Figure 2-4. Start and configuration of SQL Server in SQL Server Configuration Manager

REV 2.0 SOLUM Proprietary and Confidential 7/17

 MSSQL Configuration Guide

If you want to automatically enable the SQL Server at startup, you can do so by going into the Properties
menu configuring Start Mode as Automatic. This is recommended.

Figure 2-5. Setting of Start Mode in SQL Server Properties

REV 2.0 SOLUM Proprietary and Confidential 8/17

 MSSQL Configuration Guide

SQL Server Management Studio

Open SQL Server Management Studio from the Windows Start Menu. The Connect to Server pop-up
prompt will display as shown in Figure 2-6. Set Authentication to Windows Authentication, and click
Connect.

Figure 2-6. Connecting Microsoft SQL Server Management Studio

Table 2-1. Selecting value for each field on “Connect to Server”

Server Type Database Engine

Server Name Local or the one designated during the installation process

Authentication Windows Authentication

REV 2.0 SOLUM Proprietary and Confidential 9/17

 MSSQL Configuration Guide

Configure Server Properties

Right-click on the SQL Server and left-click on Properties.

Figure 2-7. SQL Server Properties Context Menu Link

REV 2.0 SOLUM Proprietary and Confidential 10/17

 MSSQL Configuration Guide

Under the Select a page panel on the left, go to Security, and make sure the settings inside the red
rectangles match with what is shown below.

Figure 2-8. Server Properties

REV 2.0 SOLUM Proprietary and Confidential 11/17

 MSSQL Configuration Guide

2.2 Create and Configure Databases

Databases can be created by executing the query below. The database names can be configured by the
installer. If DB names are configured, the new values must align during the installation wizard of the SOLUM
ESL Server. For manual database creation, contact SOLUM for assistance.

AIMS Operation DB Required AIMS_CORE_DB

AIMS Operation DB Required AIMS_PORTAL_DB
AIMS Operation DB Required AIMS_OTA_DB
User Account and Authentication (UAA) DB Optional AIMS_UAA_DB
Location Based Service (LBS) DB Optional AIMS_LBS_DB

See next page for query.

REV 2.0 SOLUM Proprietary and Confidential 12/17

 MSSQL Configuration Guide

[SOLUM ESL Database Creation and Configuration Query]

USE [master];
GO

-- DBs required for SOLUM AIMS ESL System

CREATE DATABASE [AIMS_CORE_DB];
GO
CREATE DATABASE [AIMS_PORTAL_DB];
GO
CREATE DATABASE [AIMS_OTA_DB];
GO

-- DB required for optional Security Package

CREATE DATABASE [AIMS_UAA_DB];
GO

-- DB required for optional Location Based Service (LBS) feature

CREATE DATABASE [AIMS_LBS_DB];
GO

-- Activate snapshot isolation and replace the default READ COMMITTED behavior with SNAPSHOT:
ALTER DATABASE [AIMS_CORE_DB]
SET ALLOW_SNAPSHOT_ISOLATION ON
GO

ALTER DATABASE [AIMS_CORE_DB]

SET READ_COMMITTED_SNAPSHOT ON
GO

ALTER DATABASE [AIMS_PORTAL_DB]

SET READ_COMMITTED_SNAPSHOT ON
GO

REV 2.0 SOLUM Proprietary and Confidential 13/17

 MSSQL Configuration Guide

Confirm that the databases and user have been created successfully by checking the Object Explorer.

Figure 2-9. AIMS Databases

If AIMS Server will have the security package installed, then ensure that AIMS_UAA_DB is created.
If AIMS Server will have the Location Based Service (LBS) feature installed, then ensure that
AIMS_LBS_DB is created.

Figure 2-10 AIMS Databases with UAA Database

REV 2.0 SOLUM Proprietary and Confidential 14/17

 MSSQL Configuration Guide

2.3 Create and Configure Security Login

Security Login can be created by executing the query below. The login name can be configured by the
installer. If configured, the updated login must be used during SOLUM ESL Server installation. For manual
login creation, contact SOLUM for assistance.

Default Login Credentials Login: aims Password: aims

[SOLUM ESL Login Creation and Configuration Query]

USE [master];
GO

-- Create Login
CREATE LOGIN [aims] WITH PASSWORD=N'aims', DEFAULT_LANGUAGE=[us_english], CHECK_EXPIRATION=OFF,
CHECK_POLICY=OFF
GO

-- Login Properties
ALTER SERVER ROLE [sysadmin] ADD MEMBER [aims]
GO
ALTER SERVER ROLE [securityadmin] ADD MEMBER [aims]
GO
ALTER SERVER ROLE [serveradmin] ADD MEMBER [aims]
GO
ALTER SERVER ROLE [setupadmin] ADD MEMBER [aims]
GO
ALTER SERVER ROLE [processadmin] ADD MEMBER [aims]
GO
ALTER SERVER ROLE [diskadmin] ADD MEMBER [aims]
GO
ALTER SERVER ROLE [dbcreator] ADD MEMBER [aims]
GO
ALTER SERVER ROLE [bulkadmin] ADD MEMBER [aims]
GO

REV 2.0 SOLUM Proprietary and Confidential 15/17

 MSSQL Configuration Guide

Once the Login is created, right-click on the user

aims under Security → Logins and left-click
Properties.

Figure 2-11 User Properties

REV 2.0 SOLUM Proprietary and Confidential 16/17

 MSSQL Configuration Guide

Check that the user login is mapped to all the databases and proper role memberships assigned.

Figure 2-12. AIMS Databases User Mappings

Once everything is configured, you are now ready to install the SOLUM AIMS Server using Microsoft SQL
Server (MSSQL).

Refer to AIMS_Server_Installation_Guide to install SOLUM ESL AIMS Server.

REV 2.0 SOLUM Proprietary and Confidential 17/17