ADRA MATCH

RECEIVABLES 5.1
INSTALLATION GUIDE
FOR VERSION 5.1

PAGE 1 (7)
CONTENTS
Adra Match Receivables 5.1 Installation Guide ...................................................................... 1
About this document ........................................................................................................... 3
Install and Update application Standard .......................................................................... 4
Create or Update database ................................................................................................ 5
Database User and Connection String ............................................................................... 6
Database User ................................................................................................................ 6
Connection string and Config file .................................................................................... 6
Install and Update application Custom............................................................................. 7

PAGE 2 (7)
ABOUT THIS DOCUMENT
This is an installation and update guide for Adra Match Receivables 5.1.

PAGE 3 (7)
INSTALL AND UPDATE APPLICATION STANDARD
This will install Adra Match Receivables 5.1 and needed prerequisites.

1. Download Setup.exe (12MB)

http://www.adramatch.com/AdraMatchReceivables/51X/Setup.exe

2. Execute Setup.exe

3. If you do not have MS .NET Framework 4 installed from before you will be asked to install
this prerequisite. The install will continue after the MS .NET Framework 4 installation.

4. Click Next on the welcome page

5. Select Installation Folder

a. If this is you first install Adra Match Receivables 5 or Adra Match Receivables 4,
we recommend you to install in the pre-defined folder. Click Next

b. If you have previous install of Adra Match Receivables 5 the installer will suggest
that folder. If not, locate folder manually. Click Next

c. If you have previous install of Adra Match Receivables 4 and the installations folder
is the same as suggested by the installer, change the installations folder to e.g.
C:\Program Files (x86)\Adra Match AS\Adra Match Receivables 5\. Click Next

6. Ready to Install Click Install

7. The install is now complete. Click Finish

PAGE 4 (7)
CREATE OR UPDATE DATABASE
Adra Match provides one database script that can create a new database or update an existing
PreMatch 4, Adra Match Receivables 4 or Adra Match Receivables 5 database.

1. Download the SQL Script

http://www.adramatch.com/AdraMatchReceivables/51X/CreateAndUpdateDatabaseV13.zip

2. Open SQL Server Management Studio and connect to the server where you want to
create your new database, or where the existing database resides

3. Open the SQL Script you downloaded in SQL Server Management Studio

4. Edit and Run the SQL Script

a. If no previous database exists, running the script will create a new database
named AMR. If you want a different database name you need to edit he script
before running it. See images below for details on how to edit the database name

b. If you have existing database, edit the database name in the script to the name of
the existing database before running the script. See images below for details on
how to edit the database name

In the top of the SQL Script you need to change the database name in three places to be
able to update an existing database or create a new with a custom name. See image below.

5. After running the script, be sure to check for error. The database is now created or
updated

PAGE 5 (7)
DATABASE USER AND CONNECTION STRING
Adra Match Receivables 5.1 uses a connection string and .NET Framework Data Provider for
SQL Server to connect to the SQL Server database.
Before you edit the connection string in the AMRDesk.exe.config you need to create a database
user or group.

Database User
The minimum rights to the database for a user or group is:

> Database Role Membership

db_datareader

db_datawriter

> Database Permission

Connect=Grant

Execute=Grant

To be able to use the Database Management options in the application the user or group needs
to be a db owner or a system administrator.

Connection string and Config file

The config file, AMRDesk.exe.config, that resides in the root directory of the AMR installation,
normally c:\Program Files\Adra Match AS\Adra Match Receivables. Open the file in a text editor
like Notepad and find the row that start with <add key="dns" value="data source= and edit the
values.

Connection with username and password

add key="dns" value="data source=SERVERNAME\INTANCE;initial catalog=AMR;user
id=myUsername;password=myPassword" />

Connection with integrated security

<add key="dns" value="data source=SERVERNAME\INTANCE;
initial catalog=AMR;Integrated security = SSPI" />

For more information on connection strings: http://www.connectionstrings.com/

PAGE 6 (7)
INSTALL AND UPDATE APPLICATION CUSTOM
The setup consists of a single MSI and will not run any custom actions, like checking for
prerequisites. This should be used when running silent installs or when using a MSI package
distribution application.
This package can also be used to update Adra Match Receivables v. 5 or later.

MSI setup:
http://www.adramatch.com/AdraMatchReceivables/51X/Setup.msi

MS .Net Framework 4 Setup: (If not installed from before)

This setup needs internet connection while installing.
http://www.adramatch.com/AdraMatchReceivables/50X/dotNetFx40_Full_setup.exe

PAGE 7 (7)