Exact Synergy Enterprise

 

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:  

1. 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. 
2. 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 
3. 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. 
4. 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”. 
5. 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. 

1. 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.
   
2. 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.
3. Ga naar Modules > Systeem > Inrichting > Instellingen – Database > Verbindingsinstelling.    
       
4. Op de pagina Connection Setting, selecteert u SQL Login bij Verbinding Modus.
5. 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.
       
6. 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.

1. 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.
   
2. 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.
  
3. 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.
4. 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. 

1. 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.
        
2. In het Introduction-scherm, klikt u op Next.
        
3. 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.

1. 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 
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. 

1. Open het web.config-bestand voor de cloud-hosted Exact Synergy Enterprise-omgeving en zorg ervoor dat HostedEnvironment onder <appSettings> is ingesteld op “2”.
       
2. Zorg ervoor dat db.config leeg is.
3. In de SQL Server Management Studio, maakt u verbinding met de SQL Azure database.
4. Zorg ervoor dat er een federated identity gebruiker (Microsoft Entra ID) bestaat in de Humres tabel.
5. Open Exact Synergy Enterprise in een browser.
6. Log in met de federated identity die u heeft aangemaakt in de sectie De database instellen.
7. In het scherm Database: Create, selecteert u de Exact Synergy Enterprise-licentie en klikt op Continue.
       
8. Select Open an existing database.
9. 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.
10. 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

• Database verbindingsinstellingen wijzigen

     

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