// $Id: INSTALL.txt,v 1.17.2.3 2005/04/23 05:07:49 unconed Exp $ INHOUDSOPGAVE --------------------- * Noodzakelijk * Eventueel nodig * Installatie - Drupal beheer - Instellen sjablonen * Upgraden * Meer informatie NODIG ------------ Drupal heeft een webserver, PHP (4.3.3 of hoger) (http://www.php.net/) en MySQL (http://www.mysql.com/) of PostgreSQL (http://www.postgresql.org/) nodig. Let op: de Apache webserver en MySQL database worden aangeraden; andere webserver-database combinaties zoals IIS en PostgreSQL zijn wel mogelijk, maar niet even uitgebreid getest. Eventueel nodig --------------------- - Het gebruik van XML-gebaseerde diensten zoals de Blogger API, Jabber, RSS feeds is afhankelijk van PHP's XML uitbreiding. Deze uitbreiding is in de standaard PHP4 installatie ingeschakeld. - Voor nette URLs is mod_rewrite (Apache) nodig. Ook moet u de mogelijkheid hebben lokale .htaccess bestanden te gebruiken. (Zie voor meer informatie de Drupal handleiding op drupal.org) INSTALLATIE ------------ 1. DRUPAL DOWNLOADEN U kunt de laatste Drupal versie op http://drupal.org vinden. De bestanden in .tar.gz formaat kunnen worden uitgepakt met de meeste compressietoepassingen. Gebruik op de meeste gangbare Unix commandoregel de opdrachten: wget http://drupal.org/files/projects/drupal-x.x.x.tar.gz tar -zxvf drupal-x.x.x.tar.gz Een nieuwe map drupal-x.x.x/ met alle drupal bestanden en mappen wordt hierdoor aangemaakt. Verplaats de inhoud van de map naar de hoofdmap (document root) van uw webserver of naar de map met de naam public_html: mv drupal-x.x.x/* drupal-x.x.x/.htaccess /var/www/html 2. MAAK DE DRUPAL DATABASE Deze stap is slechts noodzakelijk indien u of uw host niet al een database heeft aangemaakt. Indien u databases beheert met behulp van een online configuratiescherm, raadpleeg dan de bijbehorende documentatie voor het aanmaken van databases; de volgende instructies zijn alleen geldig voor de commandoregel. De instructies zijn bedoeld voor MySQL. Raadpleeg indien u een andere database gebruikt, de bijbehorende handleiding. In de voorbeelden staat dba_gebruiker voor een MySQL gebruiker met de rechten voor CREATE en GRANT. Gebruik op uw systeem een toepasselijke gebruikersnaam. Begin met het aanmaken van een nieuwe database voor Drupal ('drupal' is hier de naam van de database): mysqladmin -u dba_gebruiker -p create drupal MySQL zal u om het wachtwoord voor 'dba_gebruiker' vragen en vervolgens de database bestanden aanmaken. Log nu in op de database en stel de toegangsrechten in: mysql -u dba_gebruiker -p U wordt wederom gevraagd om het wachtwoord van 'dba_gebruiker'. Type op de MySQL commandoregel: GRANT ALL PRIVILEGES ON drupal.* TO gebruikersnaam@localhost IDENTIFIED BY 'password'; waarbij 'drupal' de naam van uw database is 'gebruikersnaam@localhost' de gebruikersnaam van uw MySQL account is 'password' het wachtwoord van de MySQL gebruiker is MySQL beantwoord een geslaagde opdracht met de uitvoer: Query OK, 0 rows affected Activeer de nieuwe toegangsrechten met de opdracht: flush privileges; Geef de opdracht '\q' om MySQL te verlaten. 3. LAAD HET DRUPAL DATABASESCHEMA Na het aanmaken van de database, moeten de vereiste tabellen worden aangemaakt. Dit wordt gedaan door het uitvoeren van de SQL opdrachten in het bestand 'database.mysql' uit de drupalmap 'database' Als u een webgebaseerd configuratiescherm gebruikt, zou u het bestand 'database.mysql' uit de drupalmap 'database' moeten kunnen uploaden en direct als SQL opdrachten kunnen uitvoeren. Werkt u vanaf de commandoregel, gebruik dan de volgende opdracht (vervang 'nobody' and 'drupal' door uw MySQL gebruikersnaam en de naam van uw database): mysql -u nobody -p drupal < database/database.mysql 4. VERBINDEN MET DRUPAL De standaard configuratie kan worden gevonden in het bestand 'sites/default/settings.php' in de Drupal installatie. Voor u Drupal kunt uitvoeren, moet u eerst de database URL en de basis URL van de website instellen. Open daartoe het configuratiebestand en bewerk de $db_url regel, zodat deze overeenkomt met de eerder gemaakte database $db_url = "mysql://gebruikersnaam:wachtwoord@localhost/database"; waarbij 'gebruikersnaam', 'wachtwoord', 'localhost' en 'database' natuurlijk de gebruikersnaam, het wachtwoord, de server en databasenaam zijn die bij uw installatie horen. Let op: de server is hier de host waar de MySQL database is ondergebracht (vaak localhost). Pas de variabele $base_url aan zodat deze overeenkomt met het adres van uw Drupal website: $base_url = "http://www.example.com"; Een enkele drupal installatie kan meerdere websites, elk met hun eigen instellingen, huisvesten. Als u dit niet nodig hebt, kunt u verder gaan met het volgende hoofdstuk. Instellingen voor extra websites moeten in submappen van de map 'sites' geplaatst worden. In elke submap moet het bestand 'settings.php' met daarin de instellingen, geplaatst worden. Dit gaat het eenvoudigst door de map 'default' te kopiëren en vervolgens het bestand 'settings.php' aan te passen. De naam van de nieuwe map wordt opgebouwd uit de URL van de website. De instellingen voor www.example.com gaan bijvoorbeeld in 'sites/example.com/settings.php' (let erop dat u 'www.' achterwege laat als gebruikers uw website via http://example.com kunnen bereiken). Websites hoeven niet allen op een verschillend domein te resideren. U kunt tevens subdomeinen en mappen voor Drupal sites gebruiken. Zowel example.com, sub.example.com en sub.example.com/site3 kunnen allen verschillende Drupal sites zijn. De configuratiebestanden voor een dergelijke opzet zijn dan als volgt: sites/default/settings.php sites/example.com/settings.php sites/sub.example.com/settings.php sites/sub.example.com.site3/settings.php Drupal zoekt configuratiebestanden voor bijvoorbeeld www.sub.example.com/site3 in de volgorde zoals beneden en gebruikt het eerst gevonden bestand. sites/www.sub.example.com.site3/settings.php sites/sub.example.com.site3/settings.php sites/example.com.site3/settings.php sites/www.sub.example.com/settings.php sites/sub.example.com/settings.php sites/example.com/settings.php sites/default/settings.php Elke website kan zowel zijn eigen modules en sjablonen gebruiken als de modules en sjablonen in de standaardmappen 'modules' en 'themes'. Als u websitespecifieke modules of sjablonen wilt gebruiken dient u de map 'modules' of 'themes' aan te maken in de instellingenmap van de website. Stel dat sub.example.com een eigen sjabloon en een eigen module heeft, die niet toegankelijk zijn voor de andere websites, dan ziet de configuratie er als volgt uit: sites/sub.example.com/: settings.php themes/eigen_sjabloon modules/eigen_module NB: Lees de Drupal handleiding op drupal.org voor meer informatie over meerdere websites door een Drupal installatie. In die handleiding is tevens meer informatie te vinden over geavanceerde instellingen. 5. INSTELLEN VAN DRUPAL Het is handig een map 'files' te maken in de Drupal installatiemap. In 'files' worden bestand, zoals logos, avatars en andere media van uw nieuwe website bewaard. De map moet zowel kunnen worden beschreven als gelezen door het webserverproces waar Drupal op draait. U kunt de naam van de map aanpassen in het menu "Administer > Settings > File system settings". U kunt nu met uw browser naar uw Drupal website gaan. Maak een nieuw account aan en meld u aan. Het eerste account zal automatisch het hoofdaccount met alle toegangsrechten worden. 6. CRON TAAK Veel Drupal modules moeten periodieke taken uitvoeren (bijv. de zoekfunctie). Het starten van deze taken gaat door het bezoeken van http://www.example.com/cron.php -- deze pagina roept de modules aan die vervolgens beslissen of en zo ja wat ze moeten uitvoeren. Veel systemen beschikken over een crontab voorziening voor het plannen van taken zoals deze. De volgende voorbeeld opdracht voor crontab zal de cron pagina elk uur automatisch aanroepen. 0 * * * * wget -O - -q http://www.example.com/cron.php Meer informatie over crontaken kan worden gevonden in de hulppagina's voor beheerders en de Drupal handleiding op drupal.org. Voorbeeldscripts kunt u vinden in de map 'scripts'. DRUPAL BEHEER --------------------- Na de installatie is uw Drupal website zeer basaal ingesteld; er zijn slechts enkele modules actief, er is slechts een thema en toegangsrechten voor gebruikers zijn nog niet ingesteld. Gebruik het beheerdermenu voor het aanzetten en instellen van onderdelen. In "Administer > Settings" kunt u bijvoorbeeld algemene instelling voor uw website veranderen. Modules kunt u aanzetten via "Administer > Modules". Via "Administer > Users > Configure > Permissions" kunt u de toegangsrechten voor gebruikers instellen. Lees voor meer informatie over alle in te stellen opties, de instructies die op de diverse configuratiepagina's worden afgebeeld. Meer informatie is ook in het et menu "Adminster > Help" te vinden. Door de community bijgedragen modules and sjablonen zijn verkrijgbaar op http://drupal.org/. PAS UW SJABLOON AAN ------------------------- Nu de website draait, wilt u het ontwerp waarschijnlijk aanpassen. Drupal wordt standaard met een aantal sjablonen geleverd; overige sjablonen zijn te downloaden van drupal.org. Het aanpassen van sjablonen hangt af van de gebruikte sjabloonengine. In het algemeen bevatten sjablonen een PHP-bestand sjabloonnaam.theme. De functie header() in dit bestand kan worden aangepast voor het weergeven van uw eigen logo. De meeste sjablonen bevatten stylesheets waarmee zowel kleuren als opmaak kunnen worden aangepast; kijk in de diverse mappen onder 'themes' voor de REAME-bestanden die de diverse sjablonen beschrijven. UPGRADEN --------- 1. Maak een reservekopie van uw database en Drupal map - let daarbij vooral op het configuratiebestand in 'sites/default/settings.php' 2. Meldt u aan als de gebruiker met het gebruikers-ID 1. 3. Verwijder eerst alle oude Drupalbestanden, zet daarna pas de nieuwe Drupal- bestanden in de map van waaruit Drupal wordt uitgevoerd. 4. Verander het nieuwe configuratiebestand zodat het correcte instellingen bevat. 5. Voer update.php uit door het bezoeken van http://www.example.com/update.php. MEER INFORMATIE ---------------- Als u meer wilt lezen over de configuratie van Drupal in specifieke (software omgevingen) of als u andere hulp bij installatie en beheer nodig heeft, lees dan de Drupalhandleiding op http://drupal.org/. U kunt tevens ondersteuning vragen in het supportforum of via de mailinglijsten.