Configuration Microsoft SQL Server

2022

Installation manual
for system providers

3/17/2023

Product line Neo, version 7.x

Please note that you can always find the most up-to-date technical documentation and product updates in the partner area on our
website at https://www.asctechnologies.com.

Copyright © 2023 ASC Technologies AG. All rights reserved.

Windows is a registered trademark of Microsoft Corporation. VMware® is a registered trademark of VMware, Inc. All other marks
and names mentioned herein may be trademarks of their respective companies.

ASC Technologies AG - Seibelstr. 2-4 - 63768 Hösbach - Germany

 Contents

Contents

1 General information.................................................................................................... 4

2 Introduction................................................................................................................. 5

3 Preconditions.............................................................................................................. 6

4 Configure Microsoft SQL Server 2022 ...................................................................... 8

4.1 Configure SQL Server Configuration Manager............................................................. 8
4.2 Install ASC software ..................................................................................................... 8
4.3 Configure database properties ..................................................................................... 9
4.4 Configure database backup........................................................................................ 12
4.5 Configure backup of the transaction log ..................................................................... 18
4.6 Connection to an AlwaysOn availability group............................................................ 18

5 Quick Guide............................................................................................................... 19

6 FAQ ............................................................................................................................ 20

List of figures ............................................................................................................ 21

List of tables.............................................................................................................. 22

Glossary .................................................................................................................... 23

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 3 / 23

1 General information

1 General information

In the context of this document ASC represents ASC Technologies AG, its subsidiaries, branch
offices, and distributors. An up-to-date overview of the aforementioned entities can be found at
https://www.asctechnologies.com
ASC assumes no guarantee for the actuality, correctness, integrity or quality of the information
provided in the manuals.
ASC regularly checks the content of the released manuals for consistency with the described
hardware and software. Nevertheless, deviations cannot be excluded. Necessary revisions are
included in subsequent editions.
Some aspects of the ASC technology are described in general terms to protect the ownership
and the confidential information or trade secrets of ASC.
The software programs and the manuals of ASC are protected by copyright law. All rights on the
manuals are reserved including the rights of reproduction and multiplication of any kind, be it
photo mechanical, typographical or on digital data media. This also applies to translations.
Copying the manuals, completely or in parts, is only allowed with written authorization of ASC.
Representative, if not defined otherwise, is the technical status at the time of the delivery of the
software, the devices and the manuals of ASC. Technical changes without specified announce-
ments are reserved. Previous manuals lose their validity.
The general conditions of sales and delivery of ASC in their latest version apply.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 4 / 23

2 Introduction

2 Introduction

This document describes the configuration of Microsoft SQL Server 2022 for the EVOIPneo
software.

Only the English-language versions of the respective operating systems are supported. For Mi-
crosoft Windows operating systems, Language Interface Packs (LIP) for the language of your
choice are available. For more information and downloads go to http://www.microsoft.com.

For Microsoft SQL databases, we support the high-availability AlwaysOn Failover Cluster In-
stances and AlwaysOn Availability Groups. The MS SQL functionality Dynamic Ports is not
supported for always-on.
Configure the failover operation according to the manual of the manufacturer.

For Microsoft SQL databases, we support connections to cluster instances (always-on) which
can be reached by means of an IP address. Primary and failover database nodes with different
IP addresses in high-availability configurations are not supported.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 5 / 23

3 Preconditions

3 Preconditions

• Empty asc_rs database

• User must have been created before the installation
• The language of the user has been set to English
• Full-text search has been activated
Check in SQL Server Management Studio (SSMS):
SELECT SERVERPROPERTY('IsFullTextInstalled') AS [Full Text Search
Installed]
=> If the result is 1, then the feature has been installed.
• Microsoft SQL server has been installed according to Microsoft manual

Minimum rights for user

Owned Schema: asc_rs

Membership: db_owner

Full-text search cannot be configured before Microsoft SQL has been installed.

Adjust one of the following settings in the setup:

Windows authentication mode

1. In the window Database Engine Configuration, select the option Windows authentication
mode.

Mixed mode (SQL Server authentication and Windows authentication)

1. In the window Database Engine Configuration, select the option Mixed Mode.
2. Click on the button Add Current User to add the current user as SQL Server administrator.
3. Create a password for the SQL Server administrator.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 6 / 23

3 Preconditions

Fig. 1: Select authentication mode (example)

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 7 / 23

4 Configure Microsoft SQL Server 2022

4 Configure Microsoft SQL Server 2022

The external database has to be installed before installing the Neo software. If you would like
to use an external database, you have to open the port which allows the Neo software to ac-
cess the database.

The service SQL Server Agent is required to execute jobs in the Neo database.
The service SQL Server Agent has been deactivated by default when the SQL Server 2 starts
the service automatically.

The ASC software uses the default port 1433 for MSSQL.
Observe the following order during configuration:
1. Configure SQL Server Configuration Manager, see chapter "Configure SQL Server Configu-
ration Manager", p. 8
2. Install EVOIPneo software, see chapter "Install ASC software", p. 8
3. Configure database properties, see chapter "Configure database properties", p. 9
4. Configure database backup, see chapter "Configure database backup", p. 12
5. Configure backup of the transaction log, see chapter "Configure backup of the transaction
log", p. 18
6. Start SQL Server Agent

4.1 Configure SQL Server Configuration Manager

1. After the installation of the SQL server, start the SQL Server Configuration Manager.
2. Change to the protocol MSSQLSERVER in the menu item SQL Server Network Configura-
tion.
3. Activate the protocol TCP/IP.

Fig. 2: Configure SQL Server Configuration Manager

If you do not want to use the default instance, a separate port must be defined for this in-
stance:
SQL Server Configuration Manager > SQL Server Network Configuration > Protocols for... >
TCP/IP > IP Addresses
Enter this port for every IP address.
After that, restart the instance via the SQL Server Services. Open the port in the firewall. Use
this port during the setup, too.

4.2 Install ASC software

Install the EVOIPneo software. See installation manual Installation EVOLUTIONneo, Installation
EVOLUTIONneo eco or Installation EVOLUTIONneo XXL.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 8 / 23

4 Configure Microsoft SQL Server 2022

4.3 Configure database properties

The database properties must not be changed by administrators without the necessary experi-
ence. Enabling autogrowth by default will cause performance issues as the database will not
be available for the application during autogrowth.
After a certain time in productive operation check the autogrowth value. If required, adjust the
value when the size of the database has changed.

Configure asc_rs database:

1. Start SQL Server 2022 Management Studio by clicking on Windows key > All Programs >
Microsoft SQL Server 2022.
2. Select the database in the SQL Server 2022 Management Studio.

Fig. 3: Select database

3. Right-click on the folder of the ASC database and open the context menu.
4. Select the menu item Properties.

Fig. 4: Select properties of the asc_rs database

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 9 / 23

4 Configure Microsoft SQL Server 2022

5. Click on Select a page > Files.

6. Go to the table with the database files and scroll to the right.
7. In the line asc_rs in the column Autogrowth / Maxsize, click on the button with the three
dots.
8. In the following window, set the parameter File Growth to 100 megabytes.
9. Select the option Unlimited for the maximum file size.
10. Click on the button OK.

Fig. 5: Change autogrowth for dat file (example)

11. In the line asc_rs_log, click on the button with the 3 dots.
12. In the following window, set the parameter File Growth to 100 megabytes.
13. Select the option Unlimited for the maximum file size.
14. Click on the button OK.

Fig. 6: Change autogrowth for log file (example)

15. Click on Select a page > Options.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 10 / 23

4 Configure Microsoft SQL Server 2022

16. On the right, select the option Full for the Recovery model.
17. For Automatic > Auto Shrink, select the value False.
18. Click on the button OK.

Fig. 7: Adjust recovery type

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 11 / 23

4 Configure Microsoft SQL Server 2022

ATTENTION!
When expecting more than 5 million recordings for a database, the following
settings are urgently recommended.
Preconditions:
- Full-text search (FULLTEXTSEARCH) must have been installed in Microsoft SQL.
- Neo version 6.4 or higher.
Proceeding:
- Stop the service ASC-ServiceMan and the Enterprise Core on all Enterprise Core servers.
- Start Microsoft SQL Server Management Studio and execute the following queries. Make
sure that you have all administrative rights to the Microsoft SQL database.
Query 1:
CREATE FULLTEXT CATALOG fullTextSearch AS DEFAULT;
Query 2:
ALTER TABLE asc_rs.recordmetadatarc ADD id UNIQUEIDENTIFIER NOT NULL DEFAULT
NEWID();
Query 3:
ALTER TABLE asc_rs.recordmetadatarc ADD CONSTRAINT pk_recordmetadatarc PRIMARY
KEY NONCLUSTERED ( id ASC )WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE
= OFF, SORT_IN_TEMPDB = OFF, IGNORE_DUP_KEY = OFF, ONLINE = OFF,
ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = OFF, FILLFACTOR = 80)
Query 4:
CREATE FULLTEXT INDEX ON asc_rs.recordmetadatarc (recordingids Language 1031)
KEY INDEX pk_recordmetadatarc WITH STOPLIST = SYSTEM;
- Add the following entry in the setup.xml on all Enterprise Cores:
<useMssqlFullTextIndexForInserter>true</useMssqlFullTextIndexForInserter>
- Reboot the service ASC-ServiceMan and the Enterprise Core on all Enterprise Core servers.

4.4 Configure database backup

The backup interval has to be calculated individually for every customer.

It is recommended to defragment the indices cyclically. For more information see https://solu-
tioncenter.apexsql.com/how-to-automate-and-schedule-sql-server-index-defragmentation/.

If many database transactions take place, a daily database backup and a backup of the transac-
tion log every 2 hours is recommended.
If few transactions are effected, a weekly database backup and a daily backup of the transac-
tion log is recommended.
1. Start the Microsoft SQL Server 2022 Management Studio.
2. Right-click on the folder of the ASC database and open the context menu.
3. Select the menu item Tasks > Back Up....

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 12 / 23

4 Configure Microsoft SQL Server 2022

Fig. 8: Select Tasks > Back Up

4. In the following window, under Source > Backup type, select the option Full.

Fig. 9: Select backup type

5. Under Destination, click on the button Add to add an existing destination folder or create a
new one. Here, you define the name of the backup file, too.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 13 / 23

4 Configure Microsoft SQL Server 2022

Fig. 10: Define name and target directory of the backup file

6. Click on Select a page > Media Options.

7. To attach the backup to a backup set which already exists on the backup computer, go to
Overwrite media > Back up to the existing media set and activate the option Append to the
existing backup set.
To overwrite all backup sets which already exist on the backup computer, go to Overwrite
media > Back up to the existing media set and activate the option Overwrite all existing
backup sets.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 14 / 23

4 Configure Microsoft SQL Server 2022

Fig. 11: Overwrite media

8. Click on Select a page > Backup Options.

9. In the field under Backup set > Name, enter a name for the backup set. In the field Descrip-
tion, you can optionally enter a description of the backup set.

Fig. 12: Define name and description of the backup set

10. Click on Select a page > General.

11. Expand the menu Script by clicking on the arrow next to it.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 15 / 23

4 Configure Microsoft SQL Server 2022

12. Select the menu item Script Action to Job.

Fig. 13: Select Script Action to Job

13. Enter a job name in the following window in the field Name.

Fig. 14: Define job name

14. Click on Select a page > Schedules.

15. Click on the button New to create a new date.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 16 / 23

4 Configure Microsoft SQL Server 2022

Fig. 15: Create new date

In the following window, you can configure when the backup procedure is supposed to be re-
peated.
16. Under Name, enter a name for the schedule.
17. Confirm all windows by clicking on the button OK.

Fig. 16: Enter name of schedule

It is possible to create several schedules for one single process. That way the process can be
carried out on every first Monday of the month as well as on very 10th day of the month.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 17 / 23

4 Configure Microsoft SQL Server 2022

If the process does not start according to the schedule, read Start SQL Server Agent in this in-
stallation manual.

4.5 Configure backup of the transaction log

Repeat all steps described in Configure database backup. The only difference is in the selection
of the backup type. Under Source > Backup type, select the option Transaction log, see Define
name and description of the backup set.

4.6 Connection to an AlwaysOn availability group

If a Microsoft SQL Cluster is supposed to be distributed across several locations, the following
manual configuration is required:
1. Stop the service ASC Application Server on the Neo application server.
2. On the Neo application server, open the configuration file domain.xml in an editor.
Example before:
<jdbc-connection-pool max-pool-size="60" fail-all-connections="true" vali-
date-atmost-once-period-in-seconds="60" datasource-classname="com.micro-
soft.sqlserver.jdbc.SQLServerConnectionPoolDataSource" name="ASCSuitePool-
Standby" validation-table-name="asc_rs.db_connection_control" is-connection-
validation-required="true" transaction-isolation-level="read-uncommitted"
res-type="javax.sql.ConnectionPoolDataSource">
<property name="user" value="sa"></property>
<property name="url" value="jdbc:sqlserver://#DNS-availability-group-lis-
tener#:1433;databasename=asc_rs">
</property>
<property name="password" value="${ALIAS=db_password_alias}">
</property>
<property name="selectMethod" value="cursor"></property>
</jdbc-connection-pool>

Example after:
<jdbc-connection-pool max-pool-size="60" fail-all-connections="true" vali-
date-atmost-once-period-in-seconds="60" datasource-classname="com.micro-
soft.sqlserver.jdbc.SQLServerConnectionPoolDataSource" name="ASCSuitePool-
Standby" validation-table-name="asc_rs.db_connection_control" is-connection-
validation-required="true" transaction-isolation-level="read-uncommitted"
res-type="javax.sql.ConnectionPoolDataSource">
<property name="user" value="sa"></property>
<property name="url" value="jdbc:sqlserver://#DNS-availability-group-lis-
tener#:1433;databasename=asc_rs;multiSubnetFailover=true">
</property>
<property name="password" value="${ALIAS=db_password_alias}">
</property>
<property name="selectMethod" value="cursor"></property>
</jdbc-connection-pool>

3. Start the service ASC Application Server on the Neo application server.
ð You can access both nodes in different networks.
ð In case of an error, you can switch actively.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 18 / 23

5 Quick Guide

5 Quick Guide

• Adjust the default settings during the installation of the SQL Server 2022: SQL Server 2022
Setup > Database Engine Configuration > Authentication Mode > Windows or >
Mixed Mode: activate and enter password.
• Start SQL Server Configuration Manager: SQL Server Network Configuration > Proto-
cols for MSSQLSERVER > TCP/IP: activate.
• Start SQL Server 2022 Management Studio: Windows key > All programs > Microsoft
SQL Server 2022 > SQL Server Management Studio: asc_rs-database > right-click >
Properties > Select a page: Files > asc_rs: [...] for Autogrowth/Maximum size and
asc_rs_log: [...] for Autogrowth/Maximum size
– File growth: 1/8 of the size of the database in Megabytes
– Maximum File Size: Unlimited
• Select database properties: Windows key > All programs > Microsoft SQL Server 2022
> SQL Server Management Studio: asc_rs-database > right-click > Properties > Op-
tions: Select a page > Recovery model Full and > Automatic > Auto shrink: False.
• Database backup cannot be configured before the EVOIPneo software has been installed.
• Configure database backup: Windows key > All programs > Microsoft SQL Server 2022
> SQL Server Management Studio > Databases > asc_rs > Tasks > Back up > Backup
type: Full > Destination: Add (a target directory) > File name: Name of the backup
set > Backup set: Name of the backup set > Media Options: Select a page
– Append backup to already existing backup sets on backup computer: Append backup
to already existing backup set: Activate
– Overwrite all existing backup sets on the backup computer: Overwrite all already exist-
ing backup sets: Activate
• Script settings: General: Select a page > Script > Script Action to Job: enter name >
Schedules > New: enter date.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 19 / 23

6 FAQ

6 FAQ

Which MS SQL databases are supported?

Information about released versions and those supported by the recording system can be found
in the Release Announcement and in the installation manual Installation requirements.

Which database size is recommended?

To calculate the database size, use the data volume calculator Postgres_Callpool_Sizing. Add
an additional 20 % of data volume.

The file Postgres_Callpool_Sizing can be found on the Manual Package in folder 1_Sizing cal-
culator.

Which authentication mode is used?

For Neo systems, Windows authentication or SQL Server Authentication (Mixed Mode) is re-
quired.

Which server collations are supported?

The collation Latin1_General_CI_AS is required.

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 20 / 23

 List of figures

List of figures

Fig. 1 Select authentication mode (example) .................................................................... 7

Fig. 2 Configure SQL Server Configuration Manager ....................................................... 8
Fig. 3 Select database ...................................................................................................... 9
Fig. 4 Select properties of the asc_rs database ................................................................ 9
Fig. 5 Change autogrowth for dat file (example)................................................................ 10
Fig. 6 Change autogrowth for log file (example)................................................................ 10
Fig. 7 Adjust recovery type ................................................................................................ 11
Fig. 8 Select Tasks > Back Up ......................................................................................... 13
Fig. 9 Select backup type .................................................................................................. 13
Fig. 10 Define name and target directory of the backup file ................................................ 14
Fig. 11 Overwrite media....................................................................................................... 15
Fig. 12 Define name and description of the backup set ...................................................... 15
Fig. 13 Select Script Action to Job....................................................................................... 16
Fig. 14 Define job name....................................................................................................... 16
Fig. 15 Create new date ...................................................................................................... 17
Fig. 16 Enter name of schedule .......................................................................................... 17

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 21 / 23

 List of tables

List of tables

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 22 / 23

 Glossary

Glossary

LIP
Language Interface Pack

Configuration Microsoft SQL Server 2022 - Neo 7.x Rev. 2 23 / 23