Installatie Handleiding

Installatie van SQLio op Windows Server met IIS

Versie 2.0 — September 2026

Vereisten

WebSocket Protocol controleren

SQLio gebruikt WebSockets voor real-time communicatie. Controleer of dit is ingeschakeld:

1. Open Server Manager → Add Roles and Features
2. Ga naar Server Roles → Web Server (IIS) → Application Development
3. Controleer of WebSocket Protocol is aangevinkt

Voorbereidende stap: SQL Login

SQLio verbindt met SQL Server via een eigen login: een SQL-login of een Windows-account (het account van de application pool). Het script in stap 2 maakt die login aan als hij nog niet bestaat. Maakt de DBA de login liever zelf aan, zie dan de handleiding "SQL Login Aanmaken".

Stap 1: .NET 9.0 Runtime Installeren

Download en installeer de ASP.NET Core 9.0 Hosting Bundle:

1. Ga naar https://dotnet.microsoft.com/download/dotnet/9.0
2. Download de ASP.NET Core Runtime - Hosting Bundle
3. Voer de installer uit op de webserver
4. Herstart IIS na installatie:

iisreset

Stap 2: SQLio Database Aanmaken

SQLio bewaart zijn configuratie in een eigen database: SQLioDB. De installatie bestaat uit vier scripts, die u in SQL Server Management Studio uitvoert als sysadmin (of met de rechten om databases en logins aan te maken).

Voer de scripts uit in deze volgorde: 01, dan 02a óf 02b, dan 03. Alle scripts staan in de map SQL\Installatie van het installatiepakket; 01, 02a en 02b staan hieronder ook, om te kopiëren.

01_SQLioDB_Database.sql

Maakt de database en de rol SQLioRole aan. Het script mag vaker worden uitgevoerd: wat al bestaat wordt overgeslagen.

-- ============================================================================
-- 01_SQLioDB_Database.sql
-- SQLio v2 - nieuwe installatie, stap 1: configuratiedatabase en rol
--
-- Draaien op: master (SSMS), als sysadmin of met CREATE DATABASE-recht.
--
-- Maakt aan:
--   1. De database SQLioDB (de configuratie van SQLio).
--   2. De rol SQLioRole met lees-, schrijf- en EXECUTE-rechten op schema dbo.
--
-- Andere databasenaam? Vervang dan SQLioDB in de scripts 01, 02a/02b en 03.
--
-- Mag vaker gedraaid worden: wat al bestaat wordt overgeslagen.
-- Volgende stap: 02a (SQL-login) of 02b (Windows-account).
-- ============================================================================

USE [master]
GO

SET NOCOUNT ON
GO

PRINT 'SQLio v2 - stap 1: database en rol'
PRINT ''

IF DB_ID(N'SQLioDB') IS NULL
BEGIN
    CREATE DATABASE [SQLioDB]
    PRINT '   [OK] Database SQLioDB aangemaakt'
END
ELSE
    PRINT '   [--] Database SQLioDB bestaat al'
GO

USE [SQLioDB]
GO

IF DATABASE_PRINCIPAL_ID(N'SQLioRole') IS NULL
BEGIN
    CREATE ROLE [SQLioRole]
    PRINT '   [OK] Rol SQLioRole aangemaakt'
END
ELSE
    PRINT '   [--] Rol SQLioRole bestaat al'

GRANT SELECT, INSERT, UPDATE, DELETE ON SCHEMA::dbo TO [SQLioRole]
GRANT EXECUTE ON SCHEMA::dbo TO [SQLioRole]
GRANT VIEW DEFINITION ON SCHEMA::dbo TO [SQLioRole]
PRINT '   [OK] Rechten op schema dbo voor SQLioRole'

PRINT ''
PRINT 'Klaar. Volgende stap: 02a_SQLioDB_Login_SQL.sql of 02b_SQLioDB_Login_Windows.sql'
GO

02a_SQLioDB_Login_SQL.sql (SQL Authentication)

Vul bovenin de loginnaam en een eigen, sterk wachtwoord in. Het script stopt als u dat vergeet. Bestaat de login al, dan wordt alleen de gebruiker in SQLioDB aangemaakt; het wachtwoord blijft dan ongewijzigd.

-- ============================================================================
-- 02a_SQLioDB_Login_SQL.sql
-- SQLio v2 - nieuwe installatie, stap 2 (SQL-authenticatie)
--
-- Draaien op: master (SSMS), als sysadmin of met ALTER ANY LOGIN-recht.
-- Gebruik dit script als SQLio met een SQL-login verbindt. Verbindt SQLio met
-- een Windows-account (bijvoorbeeld de identiteit van de app pool), gebruik dan
-- 02b_SQLioDB_Login_Windows.sql.
--
-- Maakt aan:
--   1. De SQL-login (als die nog niet bestaat).
--   2. De gebruiker in SQLioDB, lid van SQLioRole.
--
-- Vul hieronder de loginnaam en een eigen, sterk wachtwoord in.
-- Mag vaker gedraaid worden: wat al bestaat wordt overgeslagen.
-- ============================================================================

SET NOCOUNT ON;

DECLARE @LoginName  sysname       = N'svc_SQLio';
DECLARE @Wachtwoord nvarchar(128) = N'<<wachtwoord>>';

-- ----------------------------------------------------------------------------
IF @Wachtwoord LIKE N'<<%'
    THROW 50001, 'Vul bovenin eerst @Wachtwoord in.', 1;
IF DB_ID(N'SQLioDB') IS NULL
    THROW 50002, 'Database SQLioDB bestaat niet. Draai eerst 01_SQLioDB_Database.sql.', 1;

PRINT 'SQLio v2 - stap 2: SQL-login ' + @LoginName;
PRINT '';

DECLARE @Sql nvarchar(max);

IF SUSER_ID(@LoginName) IS NULL
BEGIN
    SET @Sql = N'CREATE LOGIN ' + QUOTENAME(@LoginName)
             + N' WITH PASSWORD = ' + QUOTENAME(@Wachtwoord, '''')
             + N', DEFAULT_DATABASE = [SQLioDB], CHECK_POLICY = ON, CHECK_EXPIRATION = OFF;';
    EXEC sys.sp_executesql @Sql;
    PRINT '   [OK] Login ' + @LoginName + ' aangemaakt';
END
ELSE
    PRINT '   [--] Login ' + @LoginName + ' bestaat al (wachtwoord niet gewijzigd)';

-- Gebruiker en rol in SQLioDB
SET @Sql = N'
IF DATABASE_PRINCIPAL_ID(@LoginName) IS NULL
BEGIN
    EXEC (N''CREATE USER '' + @Quoted + N'' FOR LOGIN '' + @Quoted + N'';'');
    PRINT ''   [OK] Gebruiker '' + @LoginName + '' aangemaakt in SQLioDB'';
END
ELSE
    PRINT ''   [--] Gebruiker '' + @LoginName + '' bestaat al in SQLioDB'';

IF ISNULL(IS_ROLEMEMBER(N''SQLioRole'', @LoginName), 0) = 0
BEGIN
    EXEC (N''ALTER ROLE [SQLioRole] ADD MEMBER '' + @Quoted + N'';'');
    PRINT ''   [OK] '' + @LoginName + '' is lid van SQLioRole'';
END
ELSE
    PRINT ''   [--] '' + @LoginName + '' is al lid van SQLioRole'';';

DECLARE @Quoted nvarchar(300) = QUOTENAME(@LoginName);
EXEC [SQLioDB].sys.sp_executesql @Sql, N'@LoginName sysname, @Quoted nvarchar(300)', @LoginName, @Quoted;

PRINT '';
PRINT 'Klaar. ConfigConnection voor appsettings.json:';
PRINT '   Server=<server>;Database=SQLioDB;User Id=' + @LoginName + ';Password=<wachtwoord>;TrustServerCertificate=True;Application Name=SQLio';
PRINT 'Volgende stap: 03_SQLioDB_Schema.sql';

02b_SQLioDB_Login_Windows.sql (Windows Authentication)

Vul bovenin het Windows-account in waaronder de application pool van SQLio draait, bijvoorbeeld DOMEIN\svc_sqlio.

-- ============================================================================
-- 02b_SQLioDB_Login_Windows.sql
-- SQLio v2 - nieuwe installatie, stap 2 (Windows-authenticatie)
--
-- Draaien op: master (SSMS), als sysadmin of met ALTER ANY LOGIN-recht.
-- Gebruik dit script als SQLio verbindt met een Windows-account. Verbindt SQLio
-- met een SQL-login, gebruik dan 02a_SQLioDB_Login_SQL.sql.
--
-- Welk account? Het account waaronder de app pool van SQLio in IIS draait:
--   - domeinserviceaccount (aanbevolen):       DOMEIN\svc_SQLio
--   - app pool-identiteit (SQL Server lokaal): IIS APPPOOL\SQLio
--   - computeraccount van de webserver:        DOMEIN\WEBSERVER$
--
-- Maakt aan:
--   1. De Windows-login (als die nog niet bestaat).
--   2. De gebruiker in SQLioDB, lid van SQLioRole.
--
-- Mag vaker gedraaid worden: wat al bestaat wordt overgeslagen.
-- ============================================================================

SET NOCOUNT ON;

DECLARE @AccountName sysname = N'<<DOMEIN\account>>';

-- ----------------------------------------------------------------------------
IF @AccountName LIKE N'<<%'
    THROW 50001, 'Vul bovenin eerst @AccountName in: het Windows-account van de app pool.', 1;
IF DB_ID(N'SQLioDB') IS NULL
    THROW 50002, 'Database SQLioDB bestaat niet. Draai eerst 01_SQLioDB_Database.sql.', 1;

PRINT 'SQLio v2 - stap 2: Windows-login ' + @AccountName;
PRINT '';

DECLARE @Sql nvarchar(max);

IF SUSER_ID(@AccountName) IS NULL
BEGIN
    SET @Sql = N'CREATE LOGIN ' + QUOTENAME(@AccountName) + N' FROM WINDOWS WITH DEFAULT_DATABASE = [SQLioDB];';
    EXEC sys.sp_executesql @Sql;   -- faalt als SQL Server het account niet kent
    PRINT '   [OK] Login ' + @AccountName + ' aangemaakt';
END
ELSE
    PRINT '   [--] Login ' + @AccountName + ' bestaat al';

-- Gebruiker en rol in SQLioDB
SET @Sql = N'
IF DATABASE_PRINCIPAL_ID(@AccountName) IS NULL
BEGIN
    EXEC (N''CREATE USER '' + @Quoted + N'' FOR LOGIN '' + @Quoted + N'';'');
    PRINT ''   [OK] Gebruiker '' + @AccountName + '' aangemaakt in SQLioDB'';
END
ELSE
    PRINT ''   [--] Gebruiker '' + @AccountName + '' bestaat al in SQLioDB'';

IF ISNULL(IS_ROLEMEMBER(N''SQLioRole'', @AccountName), 0) = 0
BEGIN
    EXEC (N''ALTER ROLE [SQLioRole] ADD MEMBER '' + @Quoted + N'';'');
    PRINT ''   [OK] '' + @AccountName + '' is lid van SQLioRole'';
END
ELSE
    PRINT ''   [--] '' + @AccountName + '' is al lid van SQLioRole'';';

DECLARE @Quoted nvarchar(300) = QUOTENAME(@AccountName);
EXEC [SQLioDB].sys.sp_executesql @Sql, N'@AccountName sysname, @Quoted nvarchar(300)', @AccountName, @Quoted;

PRINT '';
PRINT 'Klaar. ConfigConnection voor appsettings.json:';
PRINT '   Server=<server>;Database=SQLioDB;Integrated Security=True;TrustServerCertificate=True;Application Name=SQLio';
PRINT 'Stel in IIS de identiteit van de app pool in op ' + @AccountName + '.';
PRINT 'Volgende stap: 03_SQLioDB_Schema.sql';

03_SQLioDB_Schema.sql

Maakt alle tabellen, relaties en procedures aan. Het script staat in het installatiepakket. Voer het uit op SQLioDB.

Stap 3: SQLio Applicatie Installeren

Bestanden plaatsen

1. Maak de map C:\inetpub\wwwroot\sqlio aan
2. Pak het SQLio installatie bestand uit naar deze map

Application Pool aanmaken

1. Open IIS Manager
2. Rechtsklik op Application Pools → Add Application Pool
3. Configureer:

Application Pool Identity instellen

Bij gebruik van Windows Authentication:

1. Rechtsklik op de SQLio Application Pool → Advanced Settings
2. Onder Process Model, klik op Identity
3. Kies Custom account
4. Vul in: DOMEIN\svc_sqlio met bijbehorend wachtwoord

Application Pool altijd actief houden

SQLio verwerkt webhooks via een achtergrondservice die continu binnen de applicatie draait. Standaard legt IIS een Application Pool stil zodra er een tijd geen webverkeer is. Daardoor stopt ook de achtergrondservice en worden webhooks pas weer opgepakt zodra de applicatie opnieuw wordt aangeroepen. Om dit te voorkomen moet de Application Pool altijd actief blijven.

Configureer via IIS Manager → Application Pools → SQLio → Advanced Settings de volgende waarden:

Preload Enabled stelt u in op de website zelf: IIS Manager → Sites → SQLio → Advanced Settings → Preload Enabled = True.

Website aanmaken

Er zijn drie opties voor de website binding, afhankelijk van uw situatie:

Optie A: HTTPS met certificaat (directe toegang)

Gebruik deze optie als SQLio direct (zonder DMZ/reverse proxy) bereikbaar moet zijn.

1. Rechtsklik op Sites → Add Website
2. Configureer:

Optie B: HTTP intern (bij DMZ met reverse proxy)

Gebruik deze optie als u een DMZ met reverse proxy gebruikt. Het SSL-certificaat zit dan op de reverse proxy, niet op SQLio zelf.

Optie C: HTTP op alternatieve poort (alleen voor test)

Stap 4: Configuratie

Connection String instellen

Open C:\inetpub\wwwroot\sqlio\appsettings.json en vul bij ConfigConnection de connection string in. Scripts 02a en 02b tonen aan het eind de juiste string.

Windows Authentication:

{
  "ConnectionStrings": {
    "ConfigConnection": "Server=SERVERNAAM;Database=SQLioDB;Trusted_Connection=True;TrustServerCertificate=True;Application Name=SQLio;"
  }
}

SQL Authentication:

{
  "ConnectionStrings": {
    "ConfigConnection": "Server=SERVERNAAM;Database=SQLioDB;User Id=svc_sqlio;Password=UW_WACHTWOORD;TrustServerCertificate=True;Application Name=SQLio;"
  }
}

Bestandsrechten instellen

Het service account heeft lees- én schrijfrechten nodig op de applicatiemap: SQLio schrijft zijn instellingen in appsettingsBHS.json.

Bij Custom Account (Windows Authentication):

1. Rechtsklik op de map C:\inetpub\wwwroot\sqlio → Properties → Security
2. Klik Edit → Add
3. Voer in: DOMEIN\svc_sqlio
4. Geef Modify rechten

Bij ApplicationPoolIdentity (SQL Authentication):

1. Rechtsklik op de map C:\inetpub\wwwroot\sqlio → Properties → Security
2. Klik Edit → Add
3. Type handmatig: IIS AppPool\SQLio
4. Geef Modify rechten

Stap 5: Eerste start

1. Start de SQLio website in IIS Manager
2. Open een browser
3. Ga naar de juiste URL:
   • Optie A (HTTPS): https://sqlio.uwbedrijf.nl
   • Optie B (DMZ): http://servernaam:5000 (intern)
   • Optie C (Test): http://localhost:poort
4. Log in. Bij de eerste installatie doet BHS Solutions dit met het beheeraccount.

Encryptiesleutel

SQLio versleutelt connection strings en wachtwoorden van externe systemen met een eigen sleutel. Stel die in vóór u omgevingen aanmaakt:

1. Ga naar Instellingen
2. Klik bij Encryptie Sleutel op Genereer nieuwe sleutel en sla op

Licentie

Vraag de licentie aan via info@bhssolutions.nl en vul de licentiesleutel in bij Instellingen.

Gebruikers

Maak bij Gebruikersbeheer de gebruikers aan die SQLio gaan beheren.

Controleer:

• De SQLio interface laadt correct
• U kunt inloggen
• Geen database foutmeldingen

Probleemoplossing

HTTP Error 500.19

Oorzaak: ASP.NET Core Module niet geïnstalleerd

Oplossing: Herinstalleer de .NET 9.0 Hosting Bundle

HTTP Error 502.5

Oorzaak: Applicatie kan niet starten

Oplossing:

• Controleer .NET 9.0 Runtime versie
• Bekijk Windows Event Viewer voor details

Database Connection Failed

Oorzaken:

• Connection string in appsettings.json is onjuist
• Service account heeft geen SQL Server toegang
• Bij Windows Auth: Application Pool identity niet correct ingesteld

Login failed for user 'IIS APPPOOL\SQLio'

Oorzaak: Application Pool identity is niet correct ingesteld

Oplossing:

• Bij Windows Auth: stel Custom account in met domein service account
• Bij SQL Auth: controleer credentials in connection string

Webhooks worden niet (op tijd) verwerkt

Oorzaak: De Application Pool valt in idle-stand, waardoor de webhook-achtergrondservice tussentijds wordt stilgelegd

Oplossing:

• Zet Start Mode op AlwaysRunning
• Zet Idle Time-out op 00:00:00 (0 minuten)
• Zet Preload Enabled op de website op True
• Zie de sectie "Application Pool altijd actief houden" in Stap 3

Styling/CSS werkt niet correct

Oorzaak: WebSocket Protocol niet ingeschakeld

Oplossing: Server Manager → Web Server (IIS) → Application Development → WebSocket Protocol

Certificaat foutmelding (alleen Optie A)

Oorzaak: Certificaat niet vertrouwd of hostname komt niet overeen

Oplossing:

• Controleer of het certificaat geldig is
• Controleer of de hostname in het certificaat overeenkomt met de binding
• Installeer eventueel het root certificaat op client machines

Volgende Stappen

Na succesvolle installatie:

1. ERP-databases klaarmaken — Zie handleiding "Target Database Setup"
2. Omgevingen inrichten — Zie handleiding "Omgevingen"
3. E-mail notificaties — Zie handleiding "Azure AD App Registration Setup"
4. API toegang vanuit internet — Kies één van de volgende opties:
   • API Publicatie — Direct in IIS met URL Rewrite (eenvoudiger, geschikt voor MKB)
   • Publicatie via DMZ — Met reverse proxy (veiliger, aanbevolen voor enterprise)