How-to: Een Exact Synergy Enterprise database migreren naar Windows SQL Azure voor Private Cloud
Introductie
Dit document beschrijft de stappen voor het migreren van een Exact Synergy
Enterprise database naar Microsoft SQL Azure.
Voorwaarden
Er dient aan de volgende voorwaarden te worden voldaan:
- Een bestaande Exact Synergy Enterprise omgeving met de database op
Microsoft SQL Server. Zorg ervoor dat:
- U beschikt over de benodigde Exact Synergy Enterprise licentie voor
de database.
- De Exact Synergy Enterprise administrator inlogt op de omgeving.
- U beschikt over SQL administrator rechten op de SQL Server.
- Exact SQL Azure tool. Vanaf product update 505 bevindt de tool (Exact.SQLAzure.Tool.exe) zich in de submap 'bin' van het installatiepad van Exact Synergy Enterprise.
- Toegang tot de SQL Azure server. Zorg voor:
- Het administrator account. Bijvoorbeeld de gebruikersnaam en het
wachtwoord van de SQL Azure administrator.
- Toegang tot de Exact Synergy Enterprise website in de cloudomgeving.
Zorg voor:
- FTP of portal-toegang wanneer Exact Synergy Enterprise wordt
uitgevoerd op de Azure website, of
- Remote desktop-toegang wanneer Exact Synergy Enterprise wordt
uitgevoerd op de Azure virtual machine.
Opmerking:
- U dient te beschikken over een back-up van de Exact Synergy Enterprise
database voor het geval er wat mis gaat bij het uitvoeren van onderstaande
stappen.
- Bij de stappen in dit document wordt ervan uitgegaan dat de Exact
Synergy Enterprise database migratie naar SQL Azure wordt uitgevoerd voor
het gebruik van Exact Synergy Enterprise hosted in Azure via federated
identity authentication.
- Tijdens de migratie van de database dient u de juiste SQL Server
Management Studio (SSMS) versie te gebruiken. Wanneer u bijvoorbeeld een SQL
Server 2016 database migreert, dient u over SSMS 2016 of hoger te
beschikken. Wanneer u een SQL Server 2017 database migreert dient u over
SSMS 17.x of hoger te beschikken.
Overzicht van het proces
Het migreren van de Exact Enterprise Synergy-database naar Microsoft SQL Azure omvat de volgende stappen, die later in dit document in detail worden uitgelegd:
- De database instellen
Om Exact Synergy Enterprise een database te laten gebruiken gehost op SQL Azure, is de databaseverbindingsmodus van SQL-Login vereist. Gebruik de functie in Exact Synergy Enterprise om deze modus in te stellen voordat u met de migratie begint.
- De database voorbereiden voor omzetting
Bepaalde functies die in de Microsoft SQL Server-database worden gebruikt, moeten worden voorbereid voor de migratie naar SQL Azure-servers, anders kunnen er fouten optreden tijdens de omzetting.
Gebruik de Exact SQL Azure Tool om deze voorbereiding op de database toe te passen via “Step 1” van de tool
- De database omzetten naar Microsoft SQL Azure
Nadat de database is voorbereid met de tool, kan de database worden gekopieerd (d.w.z. omgezet) naar Microsoft SQL Azure. Gebruik de functie "Deploy" in Microsoft’s SQL
Server Management Studio om de database in de Azure-omgeving te plaatsen.
- De SQL Azure Tool gebruiken om de database-omzetting te voltooien
Zodra de database is omgezet op een SQL Azure-server, moet de Exact SQL Azure
Tool opnieuw worden gebruikt om de migratie te voltooien. De functie “Step 3” van deze tool voltooit de conversie die is voorbereid in “Step 2”.
- Exact Synergy Enterprise instellen om de database te gebruiken
Nu kan de database op de SQL Azure-server worden geopend en gebruikt voor uw Exact Synergy Enterprise-applicatie.
De database instellen
Vanaf product update 257 biedt Exact Synergy Enterprise een functie om de
database verbindingsmodus aan te passen van application role naar SQL- login. Dit
is nodig omdat SQL Azure geen applicatierollen ondersteunt.
- Log in in de bestaande Exact Synergy Enterprise-omgeving met de Exact
Synergy Enterprise administrator-gebruiker.
Opmerking: Voer de browser uit als administrator, door deze te starten
met de rechtermuisknop en dan te kiezen voor Uitvoeren als administrator.
- Maak een gebruiker aan, of wijzig een gebruiker voor federated identity
(Microsoft Entra ID e-mailadres). Dit is het account dat u voor de eerste keer
gebruikt bij het benaderen van de cloud-hosted Exact Synergy Enterprise-omgeving.
Opmerking: In de bestaande Exact Synergy Enterprise-omgeving dient
een gebruiker aanwezig te zijn met een Microsoft Entra ID e-mailadres.
- Ga naar Modules > Systeem > Inrichting > Instellingen – Database > Verbindingsinstelling.
- Op de pagina Connection Setting, selecteert u SQL Login
bij Verbinding Modus.
- Geef vervolgens in de sectie Login de SQL Server-inloggegevens op.
Selecteer Geïntegreerde beveiliging om de huidige gebruiker te
gebruiken, of vink de optie uit en geef de gebruikersnaam en wachtwoord op.
- Klik op Bewaren.
Wanneer dit succesvol is uitgevoerd wordt de SQL Login -pagina geopend
wanneer u menupad Modules > Systeem > Inrichting > Instellingen – Database > Verbindingsinstelling opent. Deze pagina toont het veld Bijwerken database
wachtwoord. Zodra de Exact Synergy Enterprise verbindingsmodus is ingesteld
op "SQL Login", wordt een willekeurige SQL inlog en wachtwoord aangemaakt voor
de verbinding. De inloggegevens worden dan versleuteld en opgeslagen in het
db.config-bestand.
In de SQL-login verbinding modus kan de administrator het SQL wachtwoord
wijzigen via het veld Bijwerken database wachtwoord. Dit is een optionele
stap. Voor meer informatie, zie
Database wachtwoorden wijzigen.
Het db.config-bestand voor Exact Synergy Enterprise wordt aangepast voor het
gebruik van de SQL-login.

De SQL Azure-tool gebruiken
Vanaf product update 267 gebruiken Exact Synergy Enterprise-databases verbeterde beveiligingsfuncties die specifiek zijn voor Microsoft SQL Server of de SQL Azure-engine. Dit betekent dat wanneer de database naar Microsoft SQL Azure migreert, de in de database geïntegreerde beveiligingsimplementatie ook moet worden gemigreerd.
Dit doet u met de Exact SQL Azure-tool in de submap 'bin' van het installatiepad van Exact Synergy Enterprise.
Zodra de Exact Synergy Enterprise-database de verbindingsmodus voor de SQL Login-database gebruikt, kunt u de tool gebruiken om de omzetting voor te bereiden.
Opmerking: Het is raadzaam om voldoende schijfruimte op uw SQL Server te hebben.
- Start de Exact SQL Azure Tool met beheerdersrechten.
Opmerking: Voer het bestand Exact.SQLAzure.Tool.exe uit met beheerdersrechten door met de rechtermuisknop te klikken en vervolgens te klikken op Uitvoeren als beheerder.
- In stap 1 van de tool doet u het volgende:
- Voer de SQL Server-gegevens van de Exact Synergy Enterprise-database in.
- Specificeer de SQL-beheerdersreferenties
- Specificeer of de tool de huidige database of een kopie van de huidige database moet voorbereiden voor omzetting.
- Klik op Start om de database voor te bereiden voor omzetting.
Opmerking: Standaard is de aanbevolen optie voor het voorbereiden van een kopie van de database voor omzetting geselecteerd. Dit vereist echter voldoende schijfruimte zodat de tool de databasebestanden kan dupliceren. Als er onvoldoende schijfruimte is, schakelt u de optie Copy uit.

- Opmerking: Als u al een database hebt voorbereid en de tool opnieuw wilt starten, kunt u op Skip klikken om direct door te gaan naar stap 2 of stap 3. Een database moet één keer worden voorbereid voor omzetting.
De optie Skip is beschikbaar wanneer u de tool op enig moment in het migratieproces hebt gesloten en deze opnieuw moet starten om het proces voor te zetten.
- In stap 2 van de tool wordt de naam van de database weergegeven die moet worden omgezet.
- Als de optie om de oorspronkelijke database te kopiëren is geselecteerd, is de nieuwe naam van de database _sqlazure. Als deze optie niet is geselecteerd, wordt de oorspronkelijke database weergegeven.
- Volg de volgende stappen in dit document om de database om te zetten naar SQL Azure.

De database omzetten naar een Microsoft Azure SQL database
Zodra de Exact Synergy Enterprise-database is voorbereid met de SQL Azure Tool, kunt u de database omzetten naar SQL Azure.
- In de SQL Server Management Studio klikt u met de rechtermuisknop op de
betreffende database en klikt dan op Tasks, en vervolgens op
Deploy Database to Microsoft Azure SQL Database.
- In het Introduction-scherm, klikt u op Next.
- In het Deployment Settings-scherm, voert u het volgende uit:
- Klik op Connect.
- In het Connect to Server-scherm, geeft u de SQL Azure-gegevens op, en klikt vervolgens op Connect.
- In het Deployment Settings-scherm, geeft u de naam van de database op
bij New database name.
- De andere aanbevolen instellingen zijn:
- Selecteer Standard bij Edition of Microsoft Azure SQL
Database.
- Selecteer 250 bij Maximum database size (GB).
- Selecteer S2 bij Service Objective.
- Klik op Next.
- In het laatste scherm klikt u op Finish.
De SQL Azure Tool gebruiken om de database-omzetting te voltooien
Na de omzetting van de database naar SQL Azure met behulp van SQL Management Studio, moet u de Exact SQL Azure Tool gebruiken om de database te beveiligen en geschikt te maken om Exact Synergy Enterprise te kunnen gebruiken.
- Als het nog niet open is, start u de Exact SQL Azure Tool met beheerdersrechten.
- Klik op Skip in Step 1
- Klik op Next in Step 2
- Doe het volgende in Step 3 van de tool:
- Voer de SQL Azure-gegevens van de Exact Synergy Enterprise-database in.
- Specificeer de SQL Azure-beheerdersreferenties
- Klik op Reactivate


Exact Synergy Enterprise instellen om de database op SQL Azure te gebruiken
Bij de stappen in deze sectie wordt ervan uitgegaan dat Exact Synergy
Enterprise wordt gehost op de Azure website of op de Azure virtual machine.
- Open het web.config-bestand voor de cloud-hosted Exact Synergy Enterprise-omgeving en zorg ervoor dat HostedEnvironment onder <appSettings> is
ingesteld op “2”.
- Zorg ervoor dat db.config leeg is.
- In de SQL Server Management Studio, maakt u verbinding met de SQL Azure database.
- Zorg ervoor dat er een federated identity gebruiker (Microsoft Entra ID)
bestaat in de Humres
tabel.
- Open Exact Synergy Enterprise in een browser.
- Log in met de federated identity die u heeft aangemaakt in de sectie De
database instellen.
- In het scherm Database: Create, selecteert u de Exact Synergy
Enterprise-licentie en klikt op Continue.
- Select Open an existing database.
- In het scherm Database: Open voert u het volgende uit:
- Selecteer SQL Azure bij DBMS.
- Geef de SQL Azure servernaam op bij Server.
- Geef de SQL Azure databasenaam op bij Database.
- Geef de SQL Azure administrator gebruikersnaam op bij Login name
en het wachtwoord bij Password.
- Klik op Open.
U kunt nu Exact Synergy Enterprise benaderen waarbij de database wordt gehost
op SQL Azure.
Known issues
De database instellen
Fout:
|
Invalid: Database - Failed to connect to server : Error in SQL statement
'DROP SCHEMA Baco' : Cannot drop schema 'Baco' because it is being
referenced by object 'DF__Integrati__Clien__1D5CFB42'.
|
Uitleg:
|
Dit kan voorkomen wanneer u in menupad
Systeem à
Inrichting à
Instellingen – Database
à
Verbindingsinstellingen AppRole wijzigt naar SQL Login
voor oudere databases die een Exact Lightweight
Integration Server (ELIS) Add On geactiveerd hadden die de
IntegrationClient tabel aanmaakte onder het Baco schema in plaats van dbo.
|
Oplossing:
|
Wijzig de schema owner van
IntegrationClient van Baco naar dbo middels het volgende statement:
ALTER
SCHEMA
dbo
TRANSFER
Baco.IntegrationServers
|
De database omzetten naar een Microsoft Azure SQL-database
Fout:
|
Error SQL71626: The element Symmetric Key:
[KEY1] is not supported in Microsoft Azure SQL Database v12.
Error SQL71626: The element Symmetric Key:
[KEY2] is not supported in Microsoft Azure SQL Database v12.
Error SQL71626: The element Symmetric Key:
[KEY3] is not supported in Microsoft Azure SQL Database v12.
Error SQL71626: The element Symmetric Key:
[KEY4] is not supported in Microsoft Azure SQL Database v12.
Error SQL71626: The element Symmetric Key:
[KEY5] is not supported in Microsoft Azure SQL Database v12.
Error SQL71626: The element Symmetric Key: [KEY6] is not
supported in Microsoft Azure SQL Database v12.
|
Uitleg:
|
De database is niet voorbereid voor omzetting met behulp van de Exact SQL Azure Tool.
|
Oplossing:
|
Gebruik de Exact SQL Azure-tool en pas stap 1 toe op de database. Probeer vervolgens de database opnieuw om te zetten met behulp van SQL Management Studio.
|
Fout:
|
Error SQL71564: Error validating element [dbo].[xxxxx]: The element [dbo].[xxxxx]
cannot be deployed as the script body is encrypted.
|
Uitleg:
|
SQL Azure ondersteunt geen versleutelde scripts. Deze scripts
dienen opnieuw aangemaakt te worden zonder versleuteling vóór het
uitvoeren van de migratie.
|
Oplossing:
|
Drop de aangepaste functie of
procedure.
|
Fout:
|
Could not import package.
Warning SQL0: A project which specifies SQL Server 2014 as the target
platform may experience compatibility issues with Microsoft Azure SQL
Database v12.
Error SQL72014: .Net SqlClient Data Provider: Msg 102, Level 15, State
1, Procedure T_D_DATA_SOURCE_MASTER, Line 97 Incorrect syntax near '@error_number'.
Error SQL72045: Script execution error. The executed script: ….
|
Uitleg:
|
SQL Azure ondersteunt RAISERROR niet. Scripts die dit commando
gebruiken moeten worden verwijderd of opnieuw worden gemaakt.
|
Oplossing:
|
DROP de functie, trigger, of procedure, of wijzig en COMMENT
de RAISERROR
regel.
|
Opmerking: De known issues komen alleen voor bij het migreren van
niet-standaard Exact Synergy Enterprise-databases. De oplossingen zijn slechts
suggesties voor workarounds, en dient u te evalueren voor uw eigen behoeften.
Gerelateerde documenten
Main Category: |
Attachments & notes |
Document Type: |
Online help main |
Category: |
|
Security level: |
All - 0 |
Sub category: |
|
Document ID: |
28.390.343 |
Assortment: |
Exact Synergy Enterprise
|
Date: |
02-05-2025 |
Release: |
|
Attachment: |
|
Disclaimer |