Advantage Database Server

WINGS Software Flexibel, efficiënt & accuraat

®

Download van de Advantage Database Server Ga naar de volgende site: http://devzone.advantagedatabase.com

Selecteer ‘Product Download’.

Selecteer de gewenste release versie Bv. 11.1

Selecteer Advantage Database Server.

Selecteer het gewenste platform. Bv. Windows 64 bit.

Klik’ Download’ en sla de bestanden op in een map ADS of een andere mapnaam van je keuze.

Unzip in de voorgestelde folder of een mapnaam van je keuze. Bv. Program Files\Advantage

Klik ‘Next’.

Selecteer ‘I accept the terms in the license agreement’ en klik ‘Next’.

Klik ‘Next’.

Klik ‘Install’ en wacht.

Het scherm ‘Product Information’ verschijnt achter het huidige, klik dit aan.

Vul het serienummer in dat je op de Advantage ID Card aantreft, evenals de validatiecode. De replicatiecode dien je NIET in te vullen.

Klik ‘Next’.

Deze link dien je enkel te gebruiken als je een gedurende 30 dagen geldige evaluatieversie wilt downloaden. Je bekomt dan een serienummer en een evaluatiecode. (Selecteer in dit geval ‘evaluation Authorization code’).

Vul de geregistreerde naam in voor de ADS en klik ‘Next’.

Selecteer als Ansi karakter set (Language Driver): English (American) en klik ‘Next’.

Opgepast: Wings zal niet correct werken als je hier een andere set selecteert.

Selecteer ‘USA’ en klik ‘Next’.

Klik ‘Finish’.

Opgepast: Wings zal niet correct werken als je hier een andere set selecteert.

Het tabblad ‘Database Info’ vermeldt de geconfigureerde settings voor deze registratie.(*) (*) Na installatie kun je hier controleren hoeveel users er in gebruik zijn

Het tabblad ‘Installation Info’ toont informatie over de installatie.

Registered to: zal reeds de geregistreerde naam bevatten.

Serial Number: zal reeds het serienummer bevatten.

Klik op het tabblad ‘Configuration Utility’ (*)

In ons voorbeeld gaan wij uit van een 5 User (gebruikers) versie. Pas de configuratie als volgt aan:

- verhoog CONNECTIONS tot 10 maal het aantal gebruikers - verhoog WORKAREAS tot 100 maal het aantal gebruikers - verhoog TABLES tot 50 maal het aantal gebruikers - verhoog INDEXES tot 50 maal het aantal gebruikers - verhoog LOCKS tot 100000 - klik ‘Apply’ om de settings toe te passen

(*) Kan na installatie worden opgestart met ads_cfg.exe in de map waar ADS is geInstalleerd.

Opm.: indien het gaat om een installatie met Wings CRM dan moet je alle parameters behalve de locks verdubbelen.

Het tabblad File Locations geeft een overzicht van de Path’s:

Error and Assert Log Path (pad voor de errorlogbestanden).

Transaction Log Files Path (pad voor de logbestanden van de transacties).

Advantage Installation Path (pad waar de Databaseserver zich bevindt).

Overzicht overige tabbladen:

Zorg dat de ANSI karakter set en de OEM karakter set correct zijn ingesteld. Klik ‘Apply’.

Klik ‘Finish’

Voeg volgende lijn toe aan Wings.INI om client/server-gebruik te activeren:

ClientServer=1

Maak in de wingsprogrammamap (b.v. f:\wings) een bestand ADS.INI aan. Dit bestand bevat de servernaam (b.v. SERVERNAME) IP-adres (b.v. 192.168.2.26) en poort (b.v. 6262):

Het volgende geldt enkel als voorbeeld en dient bijgevolg te worden aangepast aan de werkelijke waarden !

[SERVERNAME] LAN_IP=192.168.2.26 LAN_PORT=6262

CCCo Controleer steeds of de poort niet geblokkeerd wordt door een Firewall !!! Het gaat om een UDP-poort (User Datagram Protocol). Plaats dit type poort dus bij de exclusions.

ADS - Advantage Database Server

Wings gebruikt de Advantage Database Engine als databasemotor.

Deze wordt geïnstalleerd onder de vorm van enkele DLL's en hulpbestanden: ACE32.DLL

ADSLOC32.DLL AXCWS32.DLL

ADSLOCAL.CFG

ANSI.CHR EXTEND.CHR

ADS: Wanneer?

Wings maakt gebruik van een Advantage Database. De Local Server versie die in Wings is ingewerkt kan enkel gratis worden gebruikt indien Wings op een lokale PC is geïnstalleerd en daar wordt uitgevoerd. Wanneer Wings wordt geïnstalleerd in een netwerkomgeving moet eveneens de Advantage Database Server voor minimaal het corresponderend aantal users worden voorzien. Opm.: het aantal ADS users wordt bepaald per toestel, niet per geopende wingssessie.

ADS: Voordelen

- performantie: alle databasebewerkingen worden uitgevoerd op de server, enkel het resultaat van de databasebewerking wordt doorgestuurd via het netwerk en niet de database.

- integriteit: in Wings is een Transactie Tracking System (TTS) ingewerkt. Bij het uitvallen van een werkpost die in Wings aan het werken was gaat de server een rollback uitvoeren van de transactie die nog niet volledig

afgewerkt was.

ADS: Download Demo

http://devzone.advantagedatabase.com

ADS: Parameters

- Hoe nakijken?: (iedereen verlaat Wings) Start – Programma’s – zoek de map Advantage (soms ook ADS) en selecteer Configuration utility

- Parameters: ANSI Language Driver: Engl (Amer) OEM Character Set: USA CONNECTIONS: 5 maal het aantal gebruikers WORKAREAS: 100 maal het aantal gebruikers TABLES: 50 maal het aantal gebruikers INDEXES: 50 maal het aantal gebruikers LOCKS: 100000

- pas ERROR_ASSERT_LOGS (pad voor error-logbestanden) en TPS_LOGS (pad voor logbestanden transacties) aan als u geen rechten wil geven op de root directory; deze kan u best zetten naar de Data directory van

Wings - wanneer andere toepassingen rechtstreeks toegang nodig hebben tot de gegevens van Wings, is het nodig de

werkstations alleen-lezen rechten te geven op de gegevensdirectory's van Wings.

Opm.: de installatiecode dient niet herhaald te worden in het veld Replication code dat opgevraagd wordt bij

de installatie. De Replication code zal meestal leeg zijn; het veld dient enkel ingevuld te worden bij de installatie van een extra licentie als replication server.

ADS: Installatie via Terminal Server

- mag een Virtual Server zijn

- ADS en de data van Wings moeten op dezelfde (al dan niet virtuele) server staan

- de server moet in Installation mode staan - alle rechten op de registry moeten beschikbaar zijn bij installatie

- ADS.INI in de Wingsmap plaatsen (*) - ClientServer=1 in Wings.ini

- ACE32.dll van Wings op Windows\system32

ADS: Herstarten

Op de server: Control panel – Services – klik met de rechtermuisknop op ADS en vervolgens op RESTART

ADS problemen – oplossingen

1. Verschil tussen de versie waarmee Wings geschreven is en de versie van Advantage die geladen wordt bij het opstarten van het programma.

Kijk via de zoekfunctie van Windows na of er nog andere versies van deze DLL's op het systeem voorkomen en

verwijder de oude versies. Om na te kijken welke versie Wings gebruikt, kan je in Help - Info met Alt+V de versies bekijken. De versie van een individuele DLL nakijken kan door Eigenschappen te bekijken m.b.v. de

rechtermuisknop in de Verkenner.

2. Advantage DLL’s kunnen niet gevonden worden

DLL's worden in deze volgorde gezocht door Windows:

- de huidige directory - de Windows systeemdirectory (voor Windows 95/98/ME normaal C:\Windows\System, voor Windows

NT/2000 normaal C:\WinNT\System32) - de Windows directory (voor Windows 95/98/ME normaal C:\Windows, voor Windows NT/2000 normaal

C:\WinNT)

- de directory's opgegeven in de PATH omgevingsvariabele

De meest aangewezen oplossing is de Wings programmadirectory op te nemen in de PATH omdat het kopiëren van de Advantage DLL's naar de Windows directory('s) een probleem kan vormen wanneer een

nieuwe versie van Advantage geïnstalleerd wordt samen met een update van Wings (zie punt 1.) De PATH

omgevingsvariable wordt normaal gezet in de AUTOEXEC.BAT voor Windows 95/98/ME, voor Windows NT/2000 gebeurt dit via de Systeem-applet in het Configuratiescherm (tabblad: "Omgeving").

3. Ongeldige directory's in Wings.INI of AdsLocal.CFG

De bestanden Wings.ini EN AdsLocal.CFG in de Wingsprogrammamap (b.v. f:\wings) bevatten een verwijzing naar de locatie van de Wingsgegevens.

Zo moet de parameter DataLocation in Wings.INI en ERROR_ASSERT_LOGS in AdsLocal.CFG naar de juiste Wings Data directory wijzen op alle werkstations.

Opm.: omdat bij Microsoft netwerken het vaak voorkomt dat de driveletter van de ene werkpost niet gelijk is aan deze van een andere, is het best om hiervoor UNC notatie te gebruiken (Universal Naming Convention).

De driveletter van een traditionele padnaam wordt hierbij vervangen door \\ServerName\ShareName (b.v. "F:\Wings" wordt \\Server\Drive_C\Wings).

Opm.: op een Novell netwerk is ServerName de naam van de server die men kan vinden bij Netwerkomgeving. ShareName is de volumenaam (b.v. SYS); bij Microsoft netwerken is ServerName de computernaam van de

server (deze kan men ook zien bij Netwerkomgeving). Bij twijfel kan men deze op het servertoestel terugvinden onder Netwerk bij het Configuratiescherm. De ShareName kan men op de server vinden door in

de Verkenner op de rechtermuisknop te klikken op de driveletter die gedeeld wordt.

4. Error 5004 op alle tijdelijke files ($Txxxxxxx.DBF) in Wings op de Vista/TS werkstations

- Omgeving:

Advantage Database Server (op Win64). Small Business Server 2008 of Windows Server 2008

Sommige werkstations onder Vista of TS en andere werkstations onder niet-Vista of niet-TS (b.v. XP) (TS=Terminal Services)

- Oplossing: Afzetten SMB 2 op server (=Server Message Blocks Protocol 2.0). Aanmaken van een registry entry op de server (via regedit) in:

HKLM\System\CurrentControlSet\Services\LanmanServer\Parameters

- Klik met de rechtermuisknop in de witruimte.

- Klik op DWORD (32-bit) Value

- Klik op New Value en tik in Smb2

5. Error 5185 bij opstarten Wings (zonder afstandswerken)

Plaats ADS.INI in de Wingsmap (*).

6. Error 6420 unable to discover the Advantage Database Server

Controleer ADS.INI (*).

7. Error 7004 Maximum number of work areas exceeded

(iedereen verlaat Wings)

Start – Programma’s – zoek de map Advantage (soms ook ADS), selecteer Configuration utility en verhoog het aantal workareas (minimum 100 maal het aantal gebruikers)

De standaardwaarde

bij het toekennen van een nieuwe entry is 0.

(Value data: 0 (=off)). Herstart de server.

8. Error 7008 af en toe op alle tijdelijke files ($Txxxxxxx.DBF) in Wings (zowel op server als werkstations)

- Omgeving: Advantage Database Server (op Win64). Small Business Server 2011 of Windows Server 2011. Mogelijk wordt het probleem veroorzaakt door een aangepaste Windows indexing service (SearchProtocolHost.exe)

- Oplossing: Afzetten Windows Search service op de fileserver

Control panel – Services

Dubbelklik op Windows Search

Stop de service en plaats Startup type op Disabled

9. Error 7041 na installatie van ADS op een Linux server

- Oplossing: Aanpassen ADS.CONF – LOWERCASE_ALL PATHS Hierdoor wordt er steeds naar lowercase files gezocht.

Bestandsnamen bij updates: Om problemen bij updates te vermijden is het noodzakelijk om via een script op Linux nieuwe files automatisch in lowercase te benoemen.

Voor verdere vragen verwijzen wij naar de installatiedocumentatie van ADS voor Linux: http://devzone.advantagedatabase.com

10. Wings blijft hangen in reorganisatie en/of

Probleem met afdrukken van gegevens van (klanten/leveranciers) codes die beginnen met Z

Wijzig de ANSI language driver van de Advantage Database server in Engl (Amer) Start – Programma’s – zoek de map Advantage (soms ook ADS) en selecteer Configuration utility

11. Client/Server verbinding mislukt

Dit kan wijzen op een probleem met ADS.INI (*). Indien Wings ondanks een correcte ADS.INI geen connectie met ADS kan maken, kan het volgende nagekeken

worden: - draait de service? (nakijken via ads_cfg.exe op de server)

- zijn er firewalls actief op client of server? - zijn er voldoende rechten? is de servernaam correct? (vanop de client datapath openen via Windows

Explorer)

(*) ADS.INI

- aanmaken (via kladblok) in de wingsprogrammamap (b.v. f:\wings) - bevat de servernaam (b.v. WINGS) IP-adres (b.v. 192.168.2.26) en poort (b.v. 6262):

b.v. [SERVERNAME]

LAN_IP=192.168.2.26

LAN_PORT=6262 Het bovenstaande geldt enkel als voorbeeld en dient bijgevolg te worden aangepast aan de werkelijke waarden

Opm.: de aanwezigheid van ADS.INI is aan te bevelen bij een ADS installatie. Het vermijdt dat de client alle IP

adressen moet scannen om een connectie met ADS te maken.

Opm.: controleer of de poort niet geblokkeerd wordt door de Firewall.

Opm.: controleer (de bereikbaarheid van) het IP-adres. - open het Netwerkcentrum via Configuratiescherm

- klik onder Verbinding op Status weergeven

- klik op Details: het IP-adres van de computer wordt weergegeven in de kolom Waarde, naast 'IPV4 IP-adres'

Opm.: ook de instructie IPconfig in DOS geeft als resultaat het IP-adres van het toestel. - geef in DOS de instructie ping <IP-adres server> in om de bereikbaarheid van de server te controleren

Verhoging aantal users in Advantage Database Server Indien je het aantal gebruikers voor de ADS wenst te verhogen dien je gebruik te maken van de ADSSTAMP-utility. Deze utility zal je toelaten om op basis van een nieuwe validatiecode, het aantal users aan te passen. Allereerst dien je de Services van de ADS te stoppen. Via de Windows-verkenner ga je in de installatie-directory van de ADS op zoek naar de EXE. Bv. C:\Program Files\Advantagex.x\Server>

Dubbelklik op ADS_CFG.EXE; het volgende scherm verschijnt:

Klik

Klik

Via de Windows-verkenner ga je in de installatie-directory van de ADS op zoek naar de EXE. B.v. C:\Program Files\Advantagex.x\Server>

Dubbelklik op ADSSTAMP.EXE; het volgende scherm verschijnt:

Klik op .

Het serienummer zal verschijnen. Tik bij ‘Validation Code’, de nieuwe code in.

Klik op . De Replication Code dien je NIET in te vullen.

De geregistreerde naam zal ingevuld zijn. Klik .

Klik op

Controle van het gebruikersaantal Advantage Configuration Utility

Via de Windows-verkenner ga je in de installatie-directory van de ADS op zoek naar de EXE. Bv. C:\Program Files\Advantagex.x\Server>

Dubbelklik op ADS_CFG.EXE. Pas de waarden aan volgens de regels in het ads-install document:

Klik om de services te herstarten.