Gebruikershulpmiddelen

Site-hulpmiddelen


installatie

Installatie via Xampp:

Om de pool te kunnen gebruiken heb je een “webserver” nodig. Een webserver is een programma dat via een netwerk http(s)-verzoeken ontvangt en documenten naar de cliënt stuurt. Bij het bekijken van webpagina’s is deze cliënt doorgaans een webbrowser welke op een PC is geïnstalleerd.

De webserver dient ondersteuning voor PHP V7 of hoger te bieden. Ook een MySQL database server is benodigd. De eisen zijn redelijk standaard en installeren van deze pool zal dan over het algemeen bij een standaard “LAMP” server (zie Wiki lampserver) geen problemen opleveren.

Of je deze vereisten (PHP/MySql) kunt gebruiken hangt af van welke webserver je draait. Het is natuurlijk niet moeilijk om aan deze installatie eisen te voldoen.

Voor de installatie van de pool heb je enige kennis van bovenstaande nodig. Je kunt de installatie natuurlijk ook door een handige kennis laten uitvoeren en zelf het beheer van de pool op je nemen.

Een eigen webserver kan je m.b.v. een Linux-pc creëren of b.v. met een Windows webserver als “Xampp” op een standaard Windows PC. Xampp is een alles in een pakketje met “Apache-webserver”, PHP ondersteuning en een MySQL database server. Xampp is ook ideaal om “Jeroen’s ERE/BL/EK/WK/voetbal pool” op uit te proberen. Indien je op je internet modem een router hebt aangesloten en je een eigen webserver wilt “draaien” zal je port:80 in je router moeten doorsturen naar het IP-adres van de pc waarop de webserver geïnstalleerd is. Een eventueel geïnstalleerde firewall zal op de als webserver gebruikte PC inkomend verkeer voor port:80 open moeten hebben staan.

Samengevat is vereist:

  • Webserver met ondersteuning voor PHP7 of hoger
  • Een “MySql” database server en ondersteuning

In deze handleiding ga ik er van uit dat de pool wordt geïnstalleerd op een Windows PC onder “Xampp”. De webroot van deze webserver is “c:\xampp\htdocs\”. Het installatie path is “c:\xampp\htdocs\pool\”. Over Xampp zelf wordt verder niets vermeld. Voor alle informatie over Xampp zie: http://www.apachefriends.org. Het basis pakket volstaat.

1. De pool downloaden en op de juiste plek zetten: Om de pool te kunnen installeren heb je de pool bestanden nodig. Deze bestanden zijn te downloaden op het forum van http://voetbalpoeltje.nl Indien je de pool echt gaat gebruiken houdt dan het forum in de gaten of er misschien een nieuwe versie beschikbaar is en of er in de bestaande versie geen fouten zitten. Vlak voor het begin van het toernooi zullen er waarschijnlijk geen updates meer plaatsvinden. Dit om risico’s met updaten te voorkomen en omdat de pool op dat moment al redelijk definitief zal zijn. Eventuele (kleine) issues zal je dan zelf in de code moeten aanpassen.

Let op als je een door derden gemodificeerde pool gebruikt. Ondersteuning op het forum van een gemodificeerde pool is niet mogelijk! Een gemodificeerde pool is niet eenvoudig door een originele versie te updaten. Indien je vragen hebt, stel deze dan ik het juiste “topic”. Iedere versie heeft namelijk een eigen “vragen en oplossingen” topic.

Na het downloaden van de pool, welke gewoonlijk is gearchiveerd in een ZIP bestand, dient de complete inhoud van het archief uitgepakt te worden in het documenten-path van de webserver. In dit voorbeeld is dat “c:\xampp\htdocs\pool.

Als voorbeeld wordt dus de complete inhoud van het pool zip bestand geplaatst in “c:\xampp\htdocs\pool”. De pool kan dan op de webserver PC/Server benaderd worden onder webadres: http://localhost/pool/ (er van uitgaande dat de webbrowser op de zelfde PC wordt opgestart als waar de Xamp-webserver wordt uitgevoerd. Omdat we het installatie script nog niet hebben uitgevoerd komt er op dit adres een melding dat de pool nog niet is geïnstalleerd.

Updaten: Maak eerst een kopie van het oude basis configuratie bestand (“c:\xampp\htdocs\pool\config\config.php”) voordat er een update van de pool wordt uitgevoerd! Een update kan eenvoudig worden uitgevoerd door de bestaande bestanden te overschrijven. Het basis-configuratiebestand van een nieuwere pool versie kan nieuwe configuratie instellingen bevatten. Neem in dat geval de gegevens van het oude over in het nieuwe config.php bestand. Indien het nieuwe configuratie bestand geen nieuwe instellingen bevat, kan de eerder gekopieerde oude configuratiebestand “terug” gekopieerd worden. Na het plaatsen van de nieuwe bestanden dient altijd het update script te worden uitgevoerd (zie uitvoeren installatie script 2.4).

2. Basis configuratie aanpassen in “config.php”: Voordat je de pool kunt installeren zal eerst het basis configuratie bestand “c:\xampp\htdocs\pool\config\config.php” moeten worden aangepast. Indien een “schone” installatie van de pool wordt uitgevoerd dienen onderstaande gegevens ingevuld te worden:

Eerste gebruiker instellingen (zie afbeelding -punt 1):

$eerste_admin = "admin";
$pasword_eerste_admin = "admin";
$eerste_email = "admin@admin.nl";

Met bovenstaande gegevens kun je voor de eerste keer bij de geïnstalleerde pool inloggen. Bij de profielinstellingen van het gebruikersmenu (na ingelogd te zijn) kun je aanvullende gegevens invullen of gegevens wijzigen. Bovenstaande “Login” heeft ook beheers rechten zodat je met dit account ook de pool instellingen kunt veranderen in het beheer menu. Ook kun je een nieuwe gebruiker aanmaken met “admin” rechten.

Geadviseerd wordt om na installatie bovenstaande regels uit het config.php bestand te verwijderen.

Extra beveiliging wachtwoorden (zie afbeelding -punt 2):

$extra_versleuteling = '(willekeurige string van letters) ';

Wachtwoorden worden extra versleuteld in de database met deze tekenreeks. Verander deze reeks niet meer na installatie. Na een eventuele update moet deze variabele het zelfde zijn anders is inloggen van bestaande accounts niet meer mogelijk!

Database (MYSQL) instellingen in config.php (zie afbeelding -punt 3):

$dbaseHost = "localhost";
$dbaseName = "ek2024";
$dbaseUsername = "(Gebruikersnaam invullen wat je bij het maken van de database hebt gebruikt";
$dbasePassword = "(Wachtwoord invullen wat je bij het maken van de database hebt gebruikt)";

Zoals gezegd maakt de pool gebruik van een “MySql-database”. Om gegevens te kunnen lezen of schrijven in deze database is er een account nodig voor deze database. Met bovenstaande instellingen kunnen we bij de in deze gebruiksaanwijzing Xampp-webserver automatisch een nieuwe database “EK2024” automatisch aanmaken. Standaard wordt de gebruiker “root” zonder paswoord door Xampp gebruikt. Bij de meeste hosting providers heb je een speciaal database account met wachtwoord instelling. Indien de database ook door andere pakketten (CMS, Blog of b.v. forum) wordt gebruikt, is het verstandig een “tabel prefix” (zie afbeelding -punt 4) te gebruiken. Hierdoor maakt het de kans kleiner dat verschillende pakketten de zelfde tabelnamen gebruiken. Het installatie script controleert overigens voor installatie of de pool tabelnamen niet al gebruikt worden.

TabelPrefix (zie afbeelding -punt 4):

$TabelPrefix = "pool_";

TabelPrefix is ook aan te passen naar eigen wens.

Standaard taal (zie afbeelding -punt 5):

$standaard_taal = 'nl';

De standaardtaal zal nu Nederlands zijn. Je kunt dit wijzigen naar de door jouw gewenste standaard taal.

3. Controleer directory toestemmingen: De meeste beveiliging instellingen (zeker onder Windows) staan goed. Voor het kunnen maken van een database back-up dient de “c:\xampp\htdocs\pool\backup\dump” beschrijf baar te zijn (voor Linux gebruikers zal dit modus 777 zijn). Indien de rechten van deze directory niet goed zijn ingesteld, zullen er bij het maken van een back-up foutmeldingen worden weergegeven.

4. Installatie script uitvoeren: Als je eerder het juiste database account met de juiste toestemmingen in config.php hebt ingevuld en je webserver installatie staat toe dat je met PHP een database mag aanmaken, dan is de installatie verder zeer gemakkelijk. Type http://localhost/pool/install/install.php in als adres in je webbrowser. De volgende melding verschijnt:

Kan de database 'ek2024' niet openen! Selecteer benedenstaande link om de database inclusief inhoud aan te maken:

“— Maak database aan —” (http://localhost/pool/install/installek2024.php?do=aanmaken_db)

Klik op “— Maak database aan —“. Als alles goed gaat krijg je een complete lijst met alle tabellen en velden van de pas aangemaakte database te zien.

Ga naar de geïnstalleerde pool door te klikken op: “Ga naar geïnstalleerde pool” (http://localhost/pool/)

N.B.: Bij het door mij gebruikte Xampp versie 1.7.3 ging de installatie niet helemaal zonder problemen. Het installatie script werd netjes uitgevoerd, maar in eerste instantie werd de pool niet goed weergegeven omdat een bepaalde instelling (short_open_tag) in “php.ini” was veranderd. Hierdoor werd de verkorte notatie (<?) van “<?php” niet meer herkent. Vanaf versie 5.4 van de pool is wordt consequent “<?php” gebruikt indien php-code begint. En zal hiermee het probleem verholpen moeten zijn!

5. Database aanmaken niet mogelijk door script: Als je in vorig hoofdstuk allerlei foutmeldingen kreeg en de : “Ga naar geïnstalleerde pool” link gaf geen goed resultaat, dan zal je handmatig een database moeten aanmaken of nog eens goed controleren of je database account instellingen in config.php juist zijn. Bij het aanmaken van een database moet je vaak ook een database gebruiker en wachtwoord opgeven voor betreffende database. Neem de naam van je aangemaakte database en account gegevens over in je config.php en voer het installatie script opnieuw uit. Indien de database gegevens in config.php goed zijn en de pas aangemaakte database bevat nog geen tabelen, dan zal het installatie script direct doorgaan en deze database vullen met de juiste tabellen.

6. Een update uitvoeren: Het is mogelijk een geïnstalleerde pool niet ouder dan versie 9.0. te updaten als het een pool betreft van het zelfde jaar. Normaal begin ik ieder nieuw ERE/BL/EK/WK weer met een nieuwe versie van de pool. Het is dan noodzakelijk de pool in zijn geheel opnieuw te installeren. Het simpelste is om alle bestanden te overschrijven behalve het config.php bestand: “c:\Xampp\htdocs\pool\config\config.php”. Naar overschrijving dient het update script uitgevoerd te worden: http://localhost/pool/install/update.php. Als je het updatescript uitvoert wordt gevraagd om een geldig deelnemer account met beheerdersrechten! Indien je dit niet hebt is een update niet mogelijk. Indien de laatste versie al is geïnstalleerd wordt de volgende melding gegeven:

Als je de database wilt herstellen, voer dan het installatie script opnieuw uit!” Alle huidige gegevens in de database worden dan overschreven !!!!

installatie.txt · Laatst gewijzigd: 2024/03/29 06:56 door jeroen

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki