Syntess Atrium Database Wizard

 

Voor het beheer van de database is door Syntess Software een apart programma gemaakt, de Syntess Atrium Database Wizard.

 

Met dit programma kunnen de volgende taken worden uitgevoerd:

 

▪Raadplegen van database eigenschappen: Database informatie

▪Schrijven van alle data in Atrium.fdb naar bestand Atrium.fbk: Back-up maken

▪Nieuwe database Atrium.fdb maken en deze vullen vanuit Atrium.fbk: Opnieuw opbouwen database (restore)

▪Bovenstaande twee taken gecombineerd uitvoeren: Back-up maken + opnieuw opbouwen database (restore)

▪Instellen van een paginagrootte (page size) voor de database, 4, 8 of 16 kB: Back-up en Restore opties

▪Instellen van een Sweep interval voor de database: Back-up en Restore opties of Configuratie opties

▪Direct uitvoeren van een éénmalige Sweep actie: Opschonen (sweep uitvoeren)

▪Valideren en eventueel repareren van een kapotte database: Valideren en repareren

▪Database blokkeren voor gebruik: Database off-line brengen

▪Database openstellen voor gebruik: Database on-line brengen

▪Bijwerken database vanwege een nieuwe Atrium versie: Bijwerken database

▪Bijwerken database gegevens op basis van een SQL-bestand: Uitvoeren SQL bestand

▪Beveiligen database toegang door het wijzigen van het wachtwoord van de database administrator (SYSDBA): Wijzigen wachtwoord database administrator

▪Beveiligen database toegang door het wijzigen van het wachtwoord van de database gebruiker (ATRIUM): Wijzigen wachtwoord database gebruiker

▪Verwijderen van de geïnstalleerde versie van Firebird: Verwijderen Firebird

▪Installeren van Firebird: Database / Firebird editie

▪Een Windows taak plannen voor het uitvoeren van een Database Wizard actie: Windows taak plannen

 

 

hmtoggle_plus1Starten van de Syntess Atrium Database Wizard

 

Op de computer waar Syntess Atrium is geïnstalleerd

 

Er zijn verschillende mogelijkheden om de Database Wizard te starten:

- Kies In het Windows-menu Start het item Database Wizard

 

 

Dbw1101

 

Het menu item start het hulpprogramma atriumdbadmin.exe. Dit start atriumdb.exe op als administrator. Dit kan van belang zijn voor het mogen schrijven van het logbestand in de data map.

 

▪In de Windows verkenner bladeren naar de Bin map C:\Program Files x86)\Syntess\Atrium\Bin en daar atriumdb.exe starten, of atriumdbadmin.exe.

▪In de opdrachtprompt (administrator) het commando "C:\Program Files x86)\Syntess\Atrium\Bin\atriumdb.exe" ingeven.

▪Vanaf een werkstation via de Atrium share starten \\servernaam\Atrium\Bin\atriumdb.exe of atriumdbadmin.exe

 

Op de computer waar de database staat maar Syntess Atrium niet is geïnstalleerd

 

▪In de Windows verkenner bladeren naar de Bin map \\<servernaam waar Atrium is geïnstalleerd>\Atrium\Bin en daar atriumdb.exe starten.

▪In de opdrachtprompt (administrator) het commando "\\<servernaam waar Atrium is geïnstalleerd>\Atrium\Bin\atriumdb.exe" ingeven.

 

Na het starten zijn er vier schermen die bij iedere taak worden getoond. Daarna kunnen specifieke keuzes worden gemaakt.

 

Dit betreft de volgende schermen:

 

Dbw1008

 

Kies [Volgende].

 

Dbw1009

 

De database wordt getoond die is geregistreerd in de licentie. Als er meerdere databases zijn geregistreerd kan uit de lijst worden gekozen. Als een andere database gewenst is kan deze via de knop [Bladeren…] worden gekozen of zelf in het veld ingevuld, bijvoorbeeld via kopiëren en plakken. Let op dat het pad van de database altijd begint met de servernaam waar de database staat en dat op de server waar de database staat ook Firebird is geïnstalleerd.

 

Kies [Volgende].

 

DbW1073

 

Als voor de gebruiker SYSDBA een wachtwoord is opgegeven (zie Beveiligen database server) wordt deze dialoog getoond en moet het wachtwoord worden ingevuld.

Het kenmerk "Wachtwoord onthouden" werkt alleen als op de server zelf wordt aangemeld. Het werkt niet vanaf een andere computer en ook niet als verbonden is via Extern bureaublad.

 

Vul het wachtwoord van SYSDBA in.

Kies [OK]

 

Dbw1010

 

Kies [Volgende] als database taken moeten worden uitgevoerd. Als er verbindingen zijn en dat niet is toegestaan voor de uit te voeren taak sluit dan eventuele Atrium sessies of Syntess Atrium services. De Database Wizard kan de verbindingen ook geforceerd stoppen.

 

Kies [Stoppen] als geen database taken op de database hoeven te worden uitgevoerd en het alleen gewenst is om informatie te raadplegen over de activiteiten op de database en de eigenschappen van de database. Dit kan worden bekeken terwijl de database in gebruik is en heeft verder geen effect.

 

 

Bepaalde velden zijn technisch van aard en niet relevant voor de beheerder. Deze informatie kan echter nuttig zijn voor Syntess Software medewerkers als support wordt verleend.

 

Tabblad Algemeen

 

Database

Database waarop de acties worden uitgevoerd. De hint toont het volledige pad.

 

Database versie

Versie van de database. Eerste twee nummers betreffen de Atrium versie. Het laatste nummer is een volgnummer voor de databaseversie.

 

Laatste Back-up

Laatste back-up + restore, geeft aan op welke datum de database opnieuw is opgebouwd.

 

Firebird versie

Versie van Firebird die op de server is geïnstalleerd waar de database staat.

 

FBClient versie

Versie van fbclient.dll welke door de Syntess Atrium wordt gebruikt om verbinding met de database te maken.

 

Editie

Geeft aan of de geïnstalleerde Firebird versie "Classic server" betreft of "Super server".

Bij "Classic server" is er één hoofdproces firebird.exe. Voor iedere database verbinding wordt een eigen proces firebird.exe gestart

Bij "Super server" is er één hoofdproces firebird.exe. Voor een database verbinding wordt geen apart proces gestart. Binnen het hoofdproces wordt voor iedere verbinding een aparte "thread" gestart.

 

Door Syntess Software wordt aangeraden de editie "Classic server" te gebruiken, zeker als er sprake is van meer dan 20 gebruikers.

 

ODS versie

Versie van de On Disc Structure, de interne bestand structuur van het Firebird database bestand. Iedere Firebird hoofdversie heeft een eigen ODS versie.

Firebird 3.0 heeft ODS versie 12.0.

 

SQL Dialect

Behoort 3 te zijn. Kan niet worden gewijzigd. Geeft aan welke SQL-commando’s kan worden gebruikt.

 

Status

Twee mogelijkheden:

On-line: de database is beschikbaar voor gebruik, zie Database on-line brengen.

Off-line; de database is niet beschikbaar voor gebruik, zie Database off-line brengen.

 

Cache pages

De grootte van het cachegeheugen dat door het Firebird proces wordt gebruikt, uitgedrukt in aantallen pages.

 

Deze waarde wordt gezet in het configuratiebestand van Firebird (C:\Program Files\Firebird\Firebird_3_0\firebird.conf) met de variabele DefaultDbCachePages.

 

Als in het configuratiebestand geen waarde is gezet is de standaard waarde voor de editie Super server 2048 en voor Classic server 256. De waarde 256 is te weinig, het wordt aangeraden daar 1024 van te maken. Als in het configuratiebestand geen waarde is gezet gebeurt dit automatisch door de Installatiemanager.

 

Page size

Een database bestand wordt door Firebird opgedeeld in pages (pagina’s). De grootte van een page kan 4 kB, 8 kB of 16 kB zijn. Als een page groter is dan ligt er meer data aaneengesloten op een page en kan dat gunstig zijn voor de snelheid van lezen. Een grotere page size geeft een groter database bestand omdat er meer ruimte wordt gereserveerd.

 

Standaard is door Syntess Atrium altijd 4 kB aangehouden. De page size kan worden gewijzgd door bij de restore de gewenste waarde op te geven.

 

Cache size

De grootte van het cachegeheugen dat door het Firebird proces wordt gebruikt, uitgedrukt in MB’s.

Deze waarde wordt bepaald door aantal Cache pages x Page size, bijvoorbeeld 1024 x 4 kB geeft 4,0 MB aan cachegeheugen.

Let op dat bij het wijzigen van de Page size van 4 kB naar 8 of 16 ook de Cache size groter wordt.

 

Voor Classic server wordt een Cache size van 4 MB geadviseerd, voor Super server kan 8 MB of groter worden gekozen.

 

OIT / OAT / OST

Voornamelijk ter info voor Syntess Software.

 

Het transactienummer van respectievelijk:

Oldest Interesting Transaction

Oldest Active Transaction

Oldest Snapshot

 

Hiermee kan worden berekend:

- het aantal oude transacties die kunnen worden opgeruimd door het ‘garbage collection’ proces  (OAT – OIT).

- het aantal oude transacties die kunnen worden opgeruimd door het ‘sweep’ proces (OST – OIT).

 

Sweep interval

Als het aantal transacties dat kan worden opgeschoond de aangegeven waarde bereikt vindt er automatisch een opschoonactie plaats.

Waarde = 0 betekent dat nooit automatisch een opschoonactie wordt uitgevoerd.

 

Tabblad verbindingen

 

Dbw1011

 

Laat zien welke processen op dat moment verbinding hebben met de database. Deze lijst wordt niet automatisch ververst. Met de pijltjes knop achter "Database informatie" kan worden ververst.

 

Programma

Pad en naam van het programma dat verbinding met de database heeft, de hint toont het volledige pad.

 

Computer

Naam of ip-adres van de computer waarop het proces is gestart.

 

Gebruiker

Atrium gebruiker. Is alleen ingevuld als het relevant is, bijvoorbeeld bij Atrium Kantoor, het programma atrium.exe.

 

Firebird

Firebird gebruiker die de verbinding heeft gemaakt. In Syntess Atrium kan dit ATRIUM of SYSDBA zijn. Het is echter mogelijk dat de Atrium beheerder voor eigen gebruik een andere Firebird gebruiker heeft aangemaakt waarmee met een derde partij tool de database wordt benaderd. Dit gaat buiten Atrium om en valt onder de verantwoording van de beheerder.

 

Auth

Geeft aan met welke authenticatie methode verbinding is gemaakt.

Kan de waarde Srp of "Legacy_auth" bevatten. Bij voorkeur zijn er alleen Srp verbindingen, die zijn het meest beveiligd.

 

Tabblad Firebird gebruikers

 

Dbw1012

 

Om verbinding met de database te kunnen maken moet bij Firebird worden aangemeld met een Firebird gebruiker. Dit gebeurt op de achtergrond, een Atrium gebruiker hoeft daar niets voor te doen.

Standaard zijn aanwezig de Firebird gebruikers SYSDBA voor de Database Wizard en ATRIUM voor verbinding met Syntess Atrium.

Van deze gebruikers zijn twee soorten aanwezig, een gebruiker om volgens de Srp methode verbinding te maken en een gebruiker om volgens de Legacy methode verbinding te maken. In de Syntess Atrium Database Wizard worden deze gebruikers weergegeven als volgt:

 

Gebruikersnaam

De gebruikersnaam om bij Firebird aan te melden.

Standaard worden de gebruikers SYSDBA en ATRIUM getoond. Er kunnen meer gebruikers aanwezig zijn maar die zijn dan niet vanuit Atrium aangemaakt.

 

Plugin

Geeft aan volgens welke authenticatie methode door deze Firebird gebruiker verbinding wordt gemaakt.

 

Tabblad Geplande taken

 

Dbw1013

 

Geeft aan welke Windows taken zijn ingepland. Deze taken zijn door de Syntess Atrium Database Wizard aangemaakt, zie Windows taak plannen.

 

Taak

Beschikbare taken zijn

- Back-up en Restore

- Back-up

- Opschonen (Sweep)

- Uitvoeren SQL bestand

 

Laatst uitgevoerd

Datum tijdstip waarop de taak het laatst is uitgevoerd.

 

Resultaat

Geeft aan of het uitvoeren van de taak juist is verlopen.

 

Dbw1002

 

Klik op één van de acties om de gewenste taak uit te voeren, of kies [Volgende] voor het uitvoeren van een de taak Beheren.

 

Onderstaande taken zijn mogelijk:

 

Beheren

 

Back-up maken, database opnieuw opbouwen (restore)

▪Back-up maken + opnieuw opbouwen database (restore)

▪Back-up maken

▪Opnieuw opbouwen database (restore)

 

Valideren, repareren en opschonen

▪Valideren en repareren

▪Opschonen (sweep uitvoeren)

 

Off-line en on-line

▪Database off-line brengen

▪Database on-line brengen

 

Configureren

▪Configureren sweep interval

 

Bijwerken

▪Bijwerken database versie

▪Uitvoeren SQL bestand

 

Beveiligen

▪Wijzigen wachtwoord database administrator (SYSDBA)

▪Wijzigen wachtwoord database gebruiker (ATRIUM)

 

Verwijderen Firebird

▪Verwijderen Firebird

 

 

Bij het uitvoeren van een deel van de taken mogen er geen verbindingen zijn met de database.

 

Als er nog verbindingen zijn, dan wordt aan het begin van het uitvoeren onderstaande scherm getoond:

 

Dbw1001

 

Bij de keuze [Stoppen] wordt de taak niet uitgevoerd en de Database Wizard afgesloten.

 

Openstaande Atrium sessies kunnen worden afgesloten en daarna via [Opnieuw controleren] getest of er nog verbindingen zijn. Zo nee dan wordt de taak uitgevoerd.

 

Bij de keuze [Alle verbindingen verbreken] worden de databaseverbindingen door de Database Wizard verbroken en de taak uitgevoerd. In principe geeft dit geen inconsistenties in de database. Atrium-sessies die open staan, kunnen daarna wel fouten geven en vastlopen.

 

 

De taken van de Database Wizard kunnen ook via de Opdrachtprompt worden uitgevoerd door de juiste parameters aan atriumdb.exe mee te geven.

 

Dbw1015

 

 

Zodra de Syntess Atrium Database Wizard wordt gestart wordt in de Windows Temp map van de gebruiker een logbestand <jjjjmmdd>_atriumdb.log aangemaakt. Hierin worden logregels geschreven van al de activiteiten die door de wizard worden uitgevoerd.

 

Als het bestand al bestaat worden nieuwe logregels aan het bestaande bestand toegevoegd. Na het sluiten van de Database Wizard wordt het logbestand gekopieerd naar de map waar de database staat waar de acties op zijn uitgevoerd, mits de wizard schrijfrechten heeft in deze map.

 

Als er problemen gemeld worden aan Syntess met betrekking tot database acties stuur dan altijd het logbestand op.