Web-EmpoweredChurch - wec_starter_install
INSTALLEREN: WEC StartPakket Extensie Sleutel: wec_Start_install Copyright 2005-2008, Christian Technology Ministries International Inc. http://www.CTMIinc.org Auteur: Web-Empowered Church Team, <
[email protected]> Support Community: http://www.webempoweredchurch.com/community/ Dit document is gepubliceerd onder de Open Content License verkrijgbaar op http://www.opencontent.org/opl.shtml De inhoud van dit document is gerelateerd aan TYPO3 - een GNU/GPL CMS/Framework verkrijgbaar op www.typo3.com
Inhoud INSTALLEREN: WEC Start Pakket........................1 Introductie..............................................................2 Wat is de Web-Empowered Church?..............2 Wat is het WEC Start Pakket?..........................2 Vereisten – voordat je installeert..........................3 Benodigde vaardigheden.................................3 Licenties............................................................3 Kies een Web Hosting Provider.......................4 Web Server Eisen..........................................4 Je computer (Cliënt) eisen.............................4 Installatie van het WEC Start Pakket....................6 Downloaden van de software..........................6 Download direct naar een Windows-based web server.....................................................6 Download direct naar een Linux-based web server met SSH.............................................7 Download en daarna upload naar een Linuxbased web server zonder SSH.......................7 Extraheren van de zip or tar.gz file.................8 Extraheren op een Windows-based server...8 Extraheren op een Linux-based server..........8 Het zetten van de server permissies.............10 Permissies instellen via FTP........................11 Permissies zetten via SSH..........................11 De Database aanmaken..................................13
Een database aanmaken met behulp van een control panel of een web-based database tool. 13 Maak een database via cPanel....................15 Maak een database via SSH.......................18 Aan zetten van de 1-2-3 Install Tool .............19 Het gebruik van de 1-2-3 Install Tool ............20 Stap 1: Database connectie parameters......20 Stap 2: Database selectie............................21 Stap 3: Data import (SQL-file database dump) .....................................................................22 Ga naar de backend login............................23 Een alternatief voor ISP of Firewall Proxy...24 Configuratie..........................................................26 Beperken van veiligheidsrisico's – backend gebruiker Admin.............................................28 Verwijderen van Security Risico's – Install Tool ..................................................................31 Zet een nieuw Install Tool wachtwoord........32 Website naam en Encryptie sleutel.............33 Configuratie – Website URL...........................35 Wat verder?..........................................................36 Appendix..........................................................37 Shell toegang .................................................37 FTP toegang....................................................37
INSTALL: WEC StarterPackage• 1
Web-EmpoweredChurch -
Introductie De Web-Empowered Church (WEC) ministry heeft ervoor gekozen om alle software en ministry oplossingen te bouwen op het open-source TYPO3 content management system (CMS). Het TYPO3 CMS biedt een gecentraliseerde manier om je website te beheren, je content op te slaan en te wijzigen, en om extra web applicaties de zogenaamde extensies toe te voegen of te verwijderen. Alle TYPO3 software en WEC software wordt geïnstalleerd op een web server. Om wijzigingen aan te brengen in de website content, heb je alleen een standaard browser, zoals Internet Explorer of Firefox, en een gebruikersnaam met wachtwoord nodig. Je kunt zoveel gebruikersnamen met wachtwoorden voor zoveel website editors als nodig is maken en je kan hen toegang geven to alleen specifieke pagina's.
Watis het WEC Start Pakket? Het WEC Start Pakket is een standaard installatie van het TYPO3 content management system. TYPO3 is nodig bij alle Web-Empowered Church software. Voor jouw gemak, in aanvulling op het installeren van TYPO3, het WEC Start Pakket bevat enkele veel gebruikte: ●
WEC add-on ministry extensies
●
WEC website sjablonen
●
vooraf gevulde voorbeeld pagina's en data om een vliegende start met je website te maken
Wat is de Web-Empowered Church? De Web-EmpoweredChurch(WEC) is een priesterschapvan ChristianTechnologyMinistries International(www.CTMIinc.org). De missieis web technologieverbreiden. WEC helptkerkenoverdehelewereld.Geeft cursussenentraining. Als je meerwilt wetenoverWEC of wilt helpenga dannaareenvande volgendewebsites: ➢
Voor gebruikers:
www.webempoweredchurch.com ➢
Voor ontwikkelaars:
www.webempoweredchurch.org
Dit document geeft richtlijnen en instructies voor: ●
het kiezen van een web hosting omgeving
●
het downloaden van het WEC Start Pakket
●
het installeren van het pakket op je web server
●
configureren van TYPO3
INSTALL: WEC StarterPackage• 2
Web-EmpoweredChurch -
Vereisten– voordatje installeert Benodigdevaardigheden Het gebruik van WEC software om de content van je website te wijzigen is zo simpel als het gebruik van de browser om email te typen. Echter voor het installeren van het WEC Start Pakket heb je basic web server management vaardigheden nodig om op afstand de web server te kunnen benaderen, bestanden over te sturen, en settings te wijzigen. Als je niet over basic web server management vaardigheden beschikt of je wilt het installatie proces vermijden, dan kan je contact opnemen met een “WEC turn-key” hosting provider, zoals VineHosting. VineHosting (www.vinehosting.com) is een non-profit web hosting ministry of Christian Technology Ministries International Inc. en biedt een speciaal WebEmpowered Church Plan dan omvat ook de domeinnaam registratie, het voorgeïnstalleerde WEC Start Pakket, en andere hosting services. Een lijst van turn-key hosting providers is beschikbaar op www.webempoweredchurch.com/gettingstarted/hosting.
Licenties Alle WEC-ontwikkelde software en bijbehorende bestanden, documenten, en training zijn wettelijk eigendom en copywrited door de Christian Technology Ministries International Inc. (http://www.CTMIinc.org). De software is vrij te gebruiken en te distribueren onder de voorwaarden van de GNU General Public License (GPL), Version 2, June 1991 (www.gnu.org/ licenses/gpl.html). Deze licentie geeft je de "wettelijke toestemming om de software te kopiëren, te distribueren en te wijzigen.” En er is geen garantie voor deze software." Christian Technology Ministries International verlangt dat je de WEC software vrijelijk gebruikt en de vruchten ervan plukt. Zoals je zult begrijpen, een aanzienlijke hoeveelheid energie en middelen is verbruikt om de Web-Empowered Church mogelijk te maken. Als een gevolg hiervan hebben we 3 verzoeken aan de gebruikers van WEC. ●
Gebruik de software niet in de een of ander vorm die beledigend is voor een Christelijke organisatie zoals de onze.
●
Indien je wilt aanmoedigen en de waardering voor WEC wilt laten zien, zet dan een WEC Button ergens op je website. De WEC Button is beschikbaar in verschillende maten en kleuren. De WEC Button Extensie in het WEC Start Pakket maakt het mogelijk om op een pagina te plaatsen in je website.
●
Indien je een Christian Church of een ministry bent en een deel van WEC gebruikt, laat ons dan weten wat je website is, zodat we een link naar jouw website kunnen plaatsen op de voorbeelden pagina (www.webempoweredchurch.com/example).
INSTALL: WEC StarterPackage• 3
Web-EmpoweredChurch -
Kies een Web HostingProvider Web-Empowered Church software en TYPO3 kan bij iedere hosting provider onder gebracht worden die aan de server eisen kan voldoen. Meestal zullen de lage kosten hosting opties (minder dan 10 euro per maand) niet goed werken omdat zij niet het geheugen en niet de processing middelen leveren die nodig zijn bij een content management systeem.
WebServerEisen Indien je niet je website bij een WEC turn-key provider host, dan moet je controleren of dat je gekozen hosting omgeving de navolgende server eisen kan ondersteunen: ●
Operating System: Unix (eg Linux), Windows, or Mac (Linux wordt aanbevolen)
●
Web Server: Apache of IIS (Apache wordt aanbevolen, IIS instructies zijn hier niet beschikbaar en moeten verkregen worden van de TYPO3.org website)
●
Middleware: PHP4
●
Database: MySQL of ieder andere ondersteunde database system (MySQL wordt aanbevolen, non-MySQL instructies zijn hier niet beschikbaar en moeten verkregen worden van de TYPO3.org website)
●
Hardware: Een normale web server met een moderne processor en minstens 256 MB RAM (1GB aan RAM wordt aanbevolen). Zoals bij alle database-gedreven applicaties, meer RAM is aan te raden.
Noot: Indien je PHP als CGI draait, lees de “Belangrijke waarschuwing over Geheugen gebruik.” Zie www.typo3.org/about/system-requirements. Indien je PHP draait in de PHPsuexec module, kan je problemen hebben met symlinked bestanden, maar er zijn 2 oplossingen. Je kunt de ZIP versie van het WEC Start Pakket downloaden welke geen gebruik maakt van de symlinks en vermijdt hiermee dit onderwerp volledig. De andere optie, aannemende dat je al symlinks gebruikt, is het bestand typo3_src/index.php kopiëren naar de root van je website, waarmee de symlinked versie van index.php overschreven wordt. Als je je site op een Apache web server host, moet je er zeker van zijn dat de mod_rewrite module is aangezet om gebruik te kunnen maken van het WEC Start Pakket's RealURL extensie. Indien je geen mod_rewrite rechten hebt, kan je nog steeds gebruik maken van het WEC Start Pakket, maar dan moet je de RealURL uit zetten om je site te laten werken. Vraag aan je hosting provider of de mod_rewrite module is geïnstalleerd
Je computer(Cliënt)eisen ●
Operating System: Windows, Unix (including Linux), or Mac
●
Browser: Iedere grafische browser met JavaScript en Cookies ingeschakeld. Voorbeelden zijn Internet Explorer, Firefox, Safari, Netscape, en Opera (Internet Explorer wordt aanbevolen).
●
Server Access: Om je web server vanaf jouw computer te benaderen, heb je een Secure Shell (SSH) programma voor Unix-based servers nodig, of een Remote Desktop programma voor Windows-based servers. Je hebt ook een secure file INSTALL: WEC StarterPackage• 4
Web-EmpoweredChurch -
transfer programma (SFTP) nodig om bestanden te versturen. ●
Hardware: Relatief moderne computer
INSTALL: WEC StarterPackage• 5
Web-EmpoweredChurch -
Installatievan het WEC Start Pakket Wanneer jij en je organisatie heeft besloten om de Web-Empowered Church software te gaan gebruiken, je hebt de benodigde server management vaardigheden, gaat akkoord met de licentie overeenkomst, en je hebt een web hosting omgeving dat voldoet aan de eisen, dan ben je er klaar voor om het WEC Start Pakket te installeren. Gedetailleerde instructies voor de meest gebruikte server configuraties vind je hieronder inclusief: ●
Windows-based web servers met Remote Desktop access of direct fysieke toegang die de Apache web server software en MySQL database software draaien. Noot: Deze configuratie werkt ook goed voor het maken van een locale test installatie op je Windows-based PC. Je kunt Apache en MySQL snel geïnstalleerd krijgen door een van de Windows-based TYPO3 Installeer Packages te downloaden van www.typo3.org/download/installers.
●
Linux-based web servers met of zonder Secure Shell (SSH) access die de Apache web server software en MySQL database software draaien.
Noot: Andere web server configuraties hebben een vergelijkbaar installatie proces.
Downloadenvan de software De eerst stap voor het installeren van het WEC Start Pakket is het downloaden van een kopie van het WEC Start Pakket van de Web-Empowered Church website. het WEC Start Pakket is een gecomprimeerd bestand van bestanden – zoals meerdere brieven in een enkele enveloppe. het WEC Start Pakket is beschikbaar in twee formaten om Windowsbased en Linux-based servers te ondersteunen en een verscheidenheid aan connectie methodes.
Downloaddirectnaar een Windows-basedweb server Wanneer je Remote Desktop access naar een Windows-based web server hebt, dan kan je de remote servers desktop benaderen vanaf jouw computer. Of, indien je fysiek toegang hebt tot de Windows-based server, kan je rechtstreeks in de server computer inloggen. Om de zip WEC Start Pakket direct naar de web server te downloaden: 1. Login op je web server met behulp van Remote Desktop of direct met behulp van de server computer's keyboard, muis, en monitor indien de fysiek toegang hebt. 2. Start een web browser en ga naar www.webempoweredchurch.com/gettingstarted/installing. 3. Kijk onder de kop “gebruiker Downloads” naar de link voor de download van het WEC Start Pakket file met de .zip extensie. 4. Klik op de link en sla het gedownloade bestand op je Dit is vaak de the root directory van de web server. INSTALL: WEC StarterPackage• 6
Web-EmpoweredChurch -
Noot: Je kunt zien dat de .zip file groter is dan de .tar.gz file. De .zip file is groter omdat het dubbele bestande bevat die niet nodig zijn voor een Unix-based server omdat Unix ondersteund symlinks. Symlinks maken een tweede “virtueel” bestand met de inhoud van een bestand op een andere locatie.
Downloaddirectnaar een Linux-basedweb servermetSSH Indien je Secure Shell (SSH) access naar je Unix-based web server hebt, kan je de tar.gz WEC Start Pakket direct naar de server downloaden met behulp van het wget commando. (Zie de bijlage voor enkele Shell toegang tips.) Noot: Om wget te gebruiken moet het wget commando geïnstalleerd zijn op je web server. 1. Login op je web server met behulp van SSH. Om de tar.gz WEC Start Pakket direct naar de web server te downloaden: 2. Ga naar de directory waar je de files wilt plaatsen vanuit het WEC Start Pakket. Dit is vaak de root directory van de web server. 3. In je SSH command window, type de complete wget commando hieronder in een enkele regel, en geef dan Enter . Dit kopieert het bestand naar de huidige directory. Voorbeeld: SSH commando om direct naar de web server te downloaden > wget http://webempoweredchurch.com/fileadmin/proj/wec_Start/src/wec_Start-4_2_ 1-1_0_0.tar.gz
Downloaden daarnauploadnaar een Linux-basedwebserverzonder SSH Voor Linux-based web servers zonder Secure Shell (SSH) toegang, moet je een file transfer programma gebruiken. Je maakt ook gebruik van de .zip WEC Start Pakket file. De reden dat de .zip file gebruikt moet worden is omdat de .tar.gz file de Unix symlinks bevat en de .tar.gz file niet geëxtraheerd kan worden zonder SSH access. Als eerste, download de zip WEC Start Pakket naar je computer: 1. Start een web browser en ga naar www.webempoweredchurch.com/gettingstarted/installing. 2. Kijk onder de kop “gebruiker Downloads” naar de link voor de download van het WEC Start Pakket file met de .zip extensie. 3. Klik op de link en sla het bestand op in de map waar je de bestanden van het WEC Start Pakket wil opslaan. Wanneer het bestand is gedownload naar je lokale computer, moet je het unzippen: 1. Extraheer het WEC Start Pakket bestanden en mappen. Enkele populaire Zip tools zijn:
INSTALL: WEC StarterPackage• 7
Web-EmpoweredChurch -
●
WinZip – Extract alle bestanden, selecteer het Gebruik Map Namen selectieveld.
●
WindowsXP File Explorer – Selecteer alle bestanden en mappen, kopieer/plak deze naar de nieuw map.
1. De lijst van geëxtraheerde bestanden en mappen moet eruit zien zoals het figuur hiernaast aangeeft.
Upload de unzipped bestanden en mappen naar de Linux-based web server: 1. Gebruik een Secure File Transfer Protocol (SFTP) programma of een ander file transfer programma en maak verbinding naar de web server. 2. Ga naar de directory waar je alle bestanden en mappen van het WEC Start Pakket naar toe wilt laden. Dit is vaak de root directory van de web server. 3. Gebruik het file transfer programma om het WEC Start Pakket bestanden en mappen naar de web server te laden.
Extraherenvan de zip or tar.gzfile Voor Windows-based servers en voor Linux-based servers met Secure Shell access, de volgende stap van de installatie van het WEC Start Pakket is het extraheren van de mappen en de bestanden van de zip of tar.gz bestand. Noot: Voor Linux-based servers zonder Secure Shell access, de bestanden en mappen zijn al geëxtraheerd gedurende het download en upload proces.
Extraherenop een Windows-based server Maak gebruik van Remote Desktop of een fysieke connectie om de bestanden te extraheren: 1. Extraheer het WEC Start Pakket bestanden en mappen in een directory in de web server root directory pad. Enkele populaire Zip tools zijn: ●
WinZip – Extract alle bestanden, selecteer het Gebruik Map namen keuzeveld.
●
WindowsXP File Explorer – Selecteer alle bestanden en mappen, kopieer/plak deze in de nieuwe map.
1. De lijst van geëxtraheerde bestanden en mappen moet er uit zien zoals het figuur hierboven.
Extraherenop een Linux-basedserver Extraheer de bestanden en mappen van het WEC Start Pakket tar.gz bestand door gebruik te maken van het tar commando. Gebruik de v (verbose output messages), x (extract files), z INSTALL: WEC StarterPackage• 8
Web-EmpoweredChurch -
(uncompress compressed archive), en f (archive file follows in the command line) commando opties. 1. Ga naar de map waar je de bestanden en mappen geëxtraheerd wilt hebben. 2. Geef bij de SSH command prompt, het tar commando met de vxzf opties. Voorbeeld: SSH commando om de tar.gz te extraheren naar de server > tar -vxzf wec_Start-4_0_3-1_0_0.tar.gz
INSTALL: WEC StarterPackage• 9
Web-EmpoweredChurch -
Het zettenvan de serverpermissies Voor Linux-based servers, de derde stap van het installeren van het WEC Start Pakket is het zetten van de permissies zodat de Apache web server essentiële gedownloade en geëxtraheerde bestanden kan aanpassen. Voor Windows-based servers kan je de volgende stap overslaan. De Apache web server applicatie draait onder een ander gebruikers account en moet ook de mogelijkheid hebben om te lezen te schrijven in sommige bestanden van het WEC Start Pakket. Deze bestanden zijn opgeslagen in de volgende mappen: ●
fileadmin
●
typo3conf
●
typo3temp
●
uploads
Hosting omgevingen verschillen nogal en je kan wel of niet toegang hebben of privileges voor bepaalde commando's. Lees door de lijst van opties hieronder en kies de eerste die het beste past. Het zetten van shared group access geeft een goede beveiliging en gebruikersgemak, maar die nivo van van besturing is bij veel hosting providers niet aanwezig. ●
Indien je een shared group kan maken die jouw gebruikersnaam en de gebruikersnaam van het web server programma (de web server gebruikersnaam is “nobody” op veel Linux installaties), maak dan de groep en gebruik een van de twee methoden hieronder om de permissies te zetten om de de groep en eigenaar en lees/schrijf toegang (octal 0770) tot de mappen hierboven genoemd.
●
Indien je geen shared group kan maken of je kunt de web server's gebruikersnaam niet aan de groep toevoegen, gebruik dan een van de twee onderstaande methoden om de permissies te zetten om world, group en owner lees/schrijf toegang (octal 0777) tot de mappen hierboven genoemd. Dit is de meest gebruikte optie.
INSTALL: WEC StarterPackage• 10
Web-EmpoweredChurch -
Permissies instellenvia FTP Om de bestands-en mappen toegang permissies te zetten met behulp van een windowsbased FTP cliënt programma: 1. Selecteer de 4 mappen of verander de permissies een voor een. 2. Klik rechtermuis-knop om de het snelkoppeling menu te openen en selecteer Permissies en Eigenschappen. 3. Klik de opties om de lees (R) en schrijf (W) permissies te zetten, of zet in het Octal veld: ●
voor een gedeelde groep, type 0770 om groep en eigenaar lees/schrijf toegang te geven
●
voor een niet gedeelde groep, type 0777 om world, groep en eigenaar lees/schrijf toegang te geven
1. Selecteer de Recursief optie om alle bestanden en mappen binnen deze map dezelfde permissies te geven. Het kiezen voor deze optie is zeer belangrijk. Klik OK.
Permissies zettenvia SSH Met behulp van SSH (Secure Shell), de bestand en mappen permissies kunnen handmatig gezet worden of met behulp van een shell script. Om de bestand en map permissies met de hand te zetten, gebruik het chmod commando voor elk van de 4 mappen. ●
Wees er zeker dat je het -R argument gebruikt om het chmod command recursief te laten werken in alle subdirectories zodat ieder bestande en iedere map dezelfde permissies krijgt. ●
Voor een gedeelde groep, gebruik 770 om groep, eigenaar en lees/schrijf rechten te geven
●
Voor een niet gedeelde groep, gebruik 777 om world, groep en eigenaar lees/schrijf toegang te geven
Voorbeeld: Het zetten van permissies voor groep en eigenaar met behulp van chmod
INSTALL: WEC StarterPackage• 11
Web-EmpoweredChurch -
> > > >
chmod chmod chmod chmod
-R -R -R -R
770 770 770 770
fileadmin typo3conf typo3temp uploads
INSTALL: WEC StarterPackage• 12
Web-EmpoweredChurch -
Voorbeeld: Het zetten van permissies voor wereld, groep en eigenaar met behulp van chmod > > > >
chmod chmod chmod chmod
-R -R -R -R
777 777 777 777
fileadmin typo3conf typo3temp uploads
Je kunt snel de bestand en map permissies zetten voor deze directories zetten op world, group, en eigenaar access met behulp van het meegeleverde shell script genaamde set_permissions.sh. ●
Dit script zet de permissies recursief op 777 voor alle vier de mappen.
●
De set_permissions.sh script staat in de web server root directory. In die directory, zul je ook deze 4 folders zien: fileadmin, typo3conf, typo3temp, en uploads.
Voorbeeld: Het zetten van permissies met behulp van shell script (SSH) > ./set_permissions.sh
De Databaseaanmaken De vierde stap is het aanmaken van een MySQL database waar de TYPO3 content management system zijn configuratie data en de content voor je website in opslaat. Deze stap kan nogal variëren van systeem tot systeem en is sterk afhankelijk van welk control panel je beschikbaar hebt. Een control panel is een web-based interface dat je helpt om je web server te beheren. Indien je een control panel hebt of een web-based database tool, zoals PHPMyAdmin, geïnstalleerd op je server, het wordt aanbevolen om dit te gebruiken om databases aan te maken. Let ook op dat je control panel specifieke naam conventies gebruikt bij het aanmaken van databases en indien deze naam conventies niet gevolgd worden dan zullen de automatische back-up scripts de database niet back-upen. Het is daarom belangrijk dat je begrijpt hoe je control panel werkt.
Een databaseaanmakenmetbehulpvan een control panel of een webbaseddatabasetool Indien mogelijk, maak een nieuwe database en een nieuwe database gebruiker. Indien je een bestaande database en een database gebruiker hebt, dan kan het ook goed gebruikt worden. Een nieuwe database is beter omdat dit het mogelijk conflict van dubbele tabelnamen voorkomt en omdat het de veiligheid bevorderd. 1. Gebruik je control panel of web-based database tool om een nieuwe database te maken. 2. Maak een database gebruiker (en wachtwoord) en geef die database gebruiker full access (Select ALL privileges) naar de nieuwe database. 3. Maak je niet druk over het toevoegen van tabellen en/of data aan de database. Daar wordt voor gezorgd door de 1-2-3 Install Tool in de volgende stap. INSTALL: WEC StarterPackage• 13
Web-EmpoweredChurch -
INSTALL: WEC StarterPackage• 14
Web-EmpoweredChurch -
Maakeen databasevia cPanel Deze sectie bevat gedetailleerde instructies voor gebruikers van het populaire cPanel control panel. Indien je hosting provider niet cPanel levert op je web server dan kan je deze sectie overslaan. Of, wanneer je een ander control panel gebruikt, kan je het algemene proces toch volgen omdat andere control panels vaak eenzelfde functionaliteit hebben voor het maken en beheren van MySQL databases. Verdere informatie kan bij je control panel's documentatie of van je web hosting support medewerkers verkregen worden. Indien je het cPanel wilt toevoegen aan je server, kan je een licentie van geautoriseerd cPanel distributeur verkrijgen of een test licentie door het maken van een licentie verzoek in de support sectie van www.cpanel.net. Een MySQL database aanmaken met cPanel: 1. Gebruik een web browser om in te loggen bij je web server cPanel account. Het web adres voor cPanel kan variëren maar ziet er vaak ongeveer zo uit www.mychurch.org/cpanel. Inloggen heeft een gebruikersnaam en wachtwoord nodig. 2. Het control panel “welkom pagina” wordt getoond. Zie beneden voor een voorbeeld van de cPanel's welkom pagina.
3. Klik op het database management icon. Het icon ziet er ongeveer zo uit (MySQL Databases).
INSTALL: WEC StarterPackage• 15
Web-EmpoweredChurch -
4. Indien een database gebruiker nog niet gedefinieerd is, voeg een nieuwe database gebruiker toe. Onder de Gebruikers heading, voer een database Username en Wachtwoord in. Klik de Add User knop. (zie onder) Klik de [Go Back] link op de bevestigingsboodschap om terug te keren naar de “MySQL Account Maintenance” window.
5. Onder de Databases heading, vul een database naam in, zoiets als wectypo3, en klik de Add Db knop. (zie beneden) Klik de [Go Back] link op de bevestiging boodschap om naar het “MySQL Account Maintenance” window terug te keren.
INSTALL: WEC StarterPackage• 16
Web-EmpoweredChurch -
6. Selecteer een Gebruiker en Database en voor Privileges:, selecteer de ALL selectievak. Klik de Add User to Db knop. (zie beneden) Klik de [Go Back] link op de bevestiging boodschap om naar het “MySQL Account Maintenance” window terug te keren.
7. De cPanel “MySQL Account Maintenance” window laat nu zien dat de gebruiker toegang heeft tot de database. (zie beneden)
INSTALL: WEC StarterPackage• 17
Web-EmpoweredChurch -
Maakeen databasevia SSH Indien je geen web-based tool zoals cPanel hebt, dan moet je in staat zijn om de database aan te maken door MySQL te starten vanaf de SSH command lijn. Om een MySQL database aan te maken met behulp van SSH: 1. Voer het mysql commando uit met de -u root en -p argumenten. Hiermee log je in als de gebruiker “root” en vraagt je om het MySQL root wachtwoord. 2. Na de welkom boodschap, create database commando met de database naam als argument. De naam “wectypo3” is in onderstaand voorbeeld gebruikt. > > > > > > > > >
./mysql -u root -p Enter password: Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 30 to server version: 4.0.24-standard Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql> create database wectypo3; Query OK, 1 row affected (0.00 sec)
3. Geef een gebruiker alle privileges op alle tabellen in de database (als in “wectypo3.*”). Beperk de gebruiker tot het localhost domein (zoals in “wectypo3user@localhost”). Dit betekent dat de gebruiker alleen kan verbinden met de MySQL database van de lokale server computer. In het voorbeeld hieronder de database naam is “wectypo3,” de gebruiker is “wectypo3user,” en het wachtwoord is “mypass.” > > > >
mysql> GRANT ALL PRIVILEGES ON wectypo3.* -> TO wectypo3user@localhost -> IDENTIFIED BY 'mypass'; Query OK, 0 rows affected (0.00 sec)
INSTALL: WEC StarterPackage• 18
Web-EmpoweredChurch -
Aan zettenvan de 1-2-3 Install Tool Voordat je de 1-2-3 Install Tool kunt gebruiker, moet je een wijziging aanbrengen om het aan te zetten om te gebruiken. Om veiligheidsredenen, de 1-2-3 Install Tool staat standaard uit zodat niet geautoriseerde gebruikers er geen gebruik van kunnen maken. Om de 1-2-3 Install Tool aan te zetten: 1. Met behulp van FTP of SSH, maak verbinding naar je web server en ga naar de map waar je de zip of tar.gz file hebt geëxtraheerd. Dit is waarschijnlijk de root directory van je web server. 2. Vervolg met te navigeren naar de subdirectory /typo3/install/ en vind de bestanden index.php en index.wec. 3. Hernoem het index.php bestand naar index.typo3, dan hernoem het index.wec bestand naar index.php. Het originele index.php en index.wec bestanden zijn identiek behalve de regels 45 tot en met 47 zijn uitgecommentarieerd in het index.wec bestand om de 1-2-3 Install Tool aan te zetten voor gebruik. Technische Noot: In de php scripting taal, de “/*” en “*/” symbolen worden gebruikt om een block van code uit te commentariëren en uitsluit voor uitvoering. De code dit is uitgecommentarieerd in de index.wec file is de code dat de install tool uit zet. Hieronder kan je zien wat de wijziging is. 42 > 43 >// This checks for my own IP at home. You can just remove the ifstatement. 44 >/* 45 >if (1==0 || (substr($_SERVER['REMOTE_ADDR'],0,7)!='192.168' && $_SERVER['REMO ... 46 > die("In the source distribution of TYPO3, the install script is disabled by ... 47 >} 48 >*/ 49 >
INSTALL: WEC StarterPackage• 19
Web-EmpoweredChurch -
Het gebruikvan de 1-2-3 Install Tool De volgende stap van het installeren van het WEC Start Pakket is het draaien van de 1-2-3 Install Tool. De 1-2-3 Install Tool kan gestart worden met behulp van een browser naar de root web adres van je website te gaan.(http://www.mychurch.org). TYPO3 ziet dat het installatie proces niet is afgerond en stuurt je browser direct naar de 1-2-3 Install Tool. Indien je de 1-2-3 Install Tool op een willekeurig punt het installatie proces onderbreekt, zal het teruggaan naar root web adres van je website de 1-2-3 Install Tool niet herstarten. Indien je de 1-2-3 Install Tool wilt herstarten, dan kan dit bereikt worden door root web adres met /typo3/install/index.php?mode=123&step=1 toegevoegd aan het adres. (http://mychurch.org/typo3/install/index.php?mode=123&step=1).
Stap 1: Databaseconnectieparameters De 1-2-3 Install Tool vraagt om de informatie die nodig is om de verbinding met je database te maken. ●
Gebruikersnaam – Geef de MySQL database Gebruikersnaam die hebt toegevoegd.
●
Wachtwoord – Geef het Wachtwoord die je hebt toegevoegd.
●
Host – Geef localhost tenzij de database applicatie en de web server op verschillende computers draaien.
●
Klik op de Continue knop.
Het voorbeeld toont de gebruikersnaam “webservant” en het wachtwoord “im4jesus.”
INSTALL: WEC StarterPackage• 20
Web-EmpoweredChurch -
Stap 2: Databaseselectie
Van de eerste drop-down list, selecteer de database die je in vorige sectie hebt aangemaakt. Het moet in de lijst staan. Het voorbeeld toont de selectie “wectypo3” database. Noot: Een alternatief om een database te maken zit in optie 2. Indien je database gebruiker de rechten heeft om een nieuwe databases te maken, dan type gewoon de naam van de database naam die je wilt maken en ga verder. Het nadeel van deze methode is, echter dat jouw nieuwe database misschien niet automatisch geback-uped worden door een control panel die uitgaat van een specifieke naam conventie.
INSTALL: WEC StarterPackage• 21
Web-EmpoweredChurch -
Stap 3: Dataimport(SQL-file databasedump)
Nu er een connectie is gemaakt met een werkelijke database is gemaakt, wordt het tijd om informatie aan de database toe te voegen. Het WEC Start Pakket bevat een “database dump” bestand die initiële data toevoegt aan je TYPO3 database. Deze database dump bestand bevat enig basis website content en een set van sjabloon voorbeelden. Het wordt getoond in de drop-down list en wordt wec_Start.sql genoemd. Kies de wec_Start.sql database dump en klik op de Import database knop. Zie onderstaand voorbeeld.
INSTALL: WEC StarterPackage• 22
Web-EmpoweredChurch -
Ga naar de backendlogin
Nu de database de initiële WEC Start data bevat, ben je klaar met de basis installatie. De laatste stap in de 1-2-3 Install Tool geeft en link naar de TYPO3 backend, welke gebruikt wordt om je website te maken. Volg de link om je website te configureren. Zie het onderstaande voorbeeld. In een nieuwe installatie, de login naar de TYPO3 backend is: Username:admin Password: password
INSTALL: WEC StarterPackage• 23
Web-EmpoweredChurch -
INSTALL: WEC StarterPackage• 24
Web-EmpoweredChurch -
Een alternatiefvoor ISP of FirewallProxy Veel firewall programma's, als ook enkele ISP's, plaatsen proxy tussen jou en het Internet dat maskeert deels de informatie vanwaar je verzoeken vandaan komen. Wanneer je een backend sessie begint zoals een backend login, TYPO3's standaard beveiliging is ingesteld om de verzender te controleren. Deze information wordt overgedragen in de HTTP_REFERER variabele. Indien de informatie wordt gemaskeerd door een proxy, zal de backend login niet werken en de volgende foutmelding geven. Je kunt deze fout krijgen wanneer je probeert naar de Backend Login te gaan ” als je een firewall programma gebruikt als ●
ZoneAlarm
●
Norton Internet Security
●
en anderen
of verbinding via een ISP zoals ●
AOL
Je kunt deze controle (en deze fout) voorkomen door het zetten van de [doNotCheckReferer] optie op aangevinkt of de boolean waarde '1'. Je bent dan in staat om in te loggen in TYPO3. Om de setting [doNotCheckReferer] te wijzigen, 1. Open de volledige TYPO3 Install Tool (in plaats van de 1-2-3 Install Tool) rechtstreeks, zonder eerst naar de backend te gaan. (www.mychurch.org/typo3/install/index.php). 2. Klik OK indien een security boodschap over de standaard password verschijnt. 3. Voer het standaard wachtwoord joh316 in en klik op de Log In knop. 4. Klik op de All Configuration optie.
INSTALL: WEC StarterPackage• 25
Web-EmpoweredChurch -
5. Scroll ongeveer 1/4 naar beneden op de pagina totdat je [doNotCheckReferer] ziet. Het staat bij de [SYS] sectie. 6. Klik op het [doNotCheckReferer] selectievak om deze optie te kiezen.
7. Scroll naar de het einde van de pagina en Klik de Write to localconf.php knop om de waarden op te slaan. Dit wijzigt de TYPO3 configuratie op de server.
8. Op het bevestiging formulier, Klik op de Backend admin in new window link om in te loggen in de TYPO3 backend.
INSTALL: WEC StarterPackage• 26
Web-EmpoweredChurch -
Configuratie Het doorlopen van de 1-2-3 Installer levert een werkende TYPO3 site, maar er zijn nog een paar belangrijke stappen om de website werkelijk draaiend te krijgen. De initiële gebruikersnamen en wachtwoorden zijn dezelfde van iedere installatie. Wachtwoorden moeten zo snel mogelijk gewijzigd worden. Wanneer je wacht, staat je systeem bloot aan veiligheidsrisico's. Je moet het volgende wijzigen: ●
TYPO3 Install Tool wachtwoord (je wilt waarschijnlijk in de toekomst de TYPO3 Install Tool gebruiken om wijzigingen in de configuratie aan te brengen. Daarom is het belangrijk om het aan te zetten en een nieuw moeilijk te raden wachtwoord te zetten.)
●
TYPO3 Backend Admin gebruiker wachtwoord
Om de configuratie te starten, login in de TYPO3 backend. De TYPO3 backend wordt gebruikt om je website te maken en te onderhouden. Een link naar de “backend login” wordt geleverd in de laatste stap van de 1-2-3 Install Tool. Volg deze link, of voeg /typo3/ aan het einde van je web site adres. Bijvoorbeeld, http://mychurch.org/typo3/ waar “mychurch.org” is het adres van je website. Dit laadt de TYPO3 backend login scherm. Geef standaard gebruikersnaam en wachtwoord in. Username:admin Password: password Als de login klaar is, een groot geel vierkant verschijnt op de hoofdpagina van TYPO3 backend, met zeer belangrijke informatie.
INSTALL: WEC StarterPackage• 27
Web-EmpoweredChurch -
Belangrijk Noot! De box toont 2 waarschuwingen van beveiligingsrisico's in de standaard install tool. ●
De backend login staat nog op de standaard waardes “admin” en “password.”
●
Het Install Tool wachtwoord staat nog op de standaard waarde van “joh316.”
Je moet deze wachtwoorden wijzigen om de server en website te beschermen tegen ongeautoriseerde personen om in te loggen met de TYPO3 standaard wachtwoorden. Als extra moet je de TYPO3 encriptiesleutel resetten. Deze sleutel wordt intern gebruikt door TYPO3 om pagina's te renderen vanuit de content in de database. Indien je niet reset kan een kwaadwillende hacker je website met verzoeken benaderen zodat de server zal crashen.
INSTALL: WEC StarterPackage• 28
Web-EmpoweredChurch -
Beperkenvan veiligheidsrisico's – backend gebruikerAdmin Het meest kritische wachtwoord om te veranderen is de TYPO3 backend admin gebruiker wachtwoord. Indien een kwaadwillende figuur er achter komt dat je website een TYPO3 site is en in de backend wil komen, is er een grote kans dat hij het standaard admin gebruikersnaam en wachtwoord eerst gebruikt. Wijzig dit direct.! Om de standaard gebruiker te wijzigen: 1. Klik de Web > List link aan de linker kant van het menu. Een paginaboom toont bij het midden van de pagina een lijst van webpagina's en mappen in de website. De inhoud van de paginaboom is aangemaakt bij WEC Start Pakket installatie. 2. In de paginaboom, klik op de de bovenste pagina (WEC Start Pakket) om de website met de lijst aan de rechterkant van geautoriseerde backend gebruikers. 3. Klik op de potlood icon naast de admin gebruiker. Het edit scherm voor de gebruiker opent aan de rechterkant. Zie het voorbeeld hieronder.
INSTALL: WEC StarterPackage• 29
Web-EmpoweredChurch -
4. Voer een nieuwe gebruikersaam in (voorbeeld toont myadmin). 5. Voer een nieuw wachtoord in (voorbeeld toont mypassword, maar kies een meer complex wachtwoord wat moeilijk te raden is). 6. Klik de
Bewaar of
Bewaar en sluiten knop boven aan de pagina.
7. Je keert terug naar de bovenkant van het edit scherm. Zie voorbeeld hieronder.
INSTALL: WEC StarterPackage• 30
Web-EmpoweredChurch -
INSTALL: WEC StarterPackage• 31
Web-EmpoweredChurch -
Verwijderenvan SecurityRisico's – Install Tool Om veiligheidsredenen, het wachtwoord van de install tool moet ook gewijzigd worden. De Install Tool kan vanuit de TYPO3 backend benaderd worden vanuit de Tools sectie aan de linkerkant. 1. Klik de Installatie link aan de linkerkant van het menu. De TYPO3 Install Tool zal openen. 2. Voer het standaard wachtwoord joh316 in 3. Klik de Log In knop. Zie het voorbeeld hieronder.
INSTALL: WEC StarterPackage• 32
Web-EmpoweredChurch -
Zeteen nieuwInstall Tool wachtwoord Nadat je ingelogd bent in de TYPO3 Install Tool: 1. De TYPO3 4.0 Install Tool startup scherm opent in de Over sectie. 2. Scroll naar beneden op deze pagina totdat je de scherm velden ziet waarin je het nieuwe wachtwoord kan invoeren. 3. Voer een nieuw wachtwoord en nogmaals, dan klik de Set new password knop. 4. Nadat je de bevestiging boodschap hebt ontvangen, klik de Basic Configuratie optie. Zie het voorbeeld hieronder.
INSTALL: WEC StarterPackage• 33
Web-EmpoweredChurch -
Websitenaamen Encryptiesleutel De website naam en de Encryptie sleutel kunnen in de Basis Configuratie sectie van de Install Tool gezet worden. 1. Scroll naar beneden in Basic Configuration pagina naar de Write config to localconf.php heading. 2. Blijf scrollen naar de Site Name en wijzig de waarde naar een naam van jouw keuze . 3. Hieronder, zet de Encriptie sleutel naar een random waarde door te klikken op de Genereer willekeurige sleutel knop. 4. Na het maken van deze wijzigingen, scroll naar het einde van de pagina en klik op de Update localconf.php knop op de wijzigingen op te slaan. Zie voorbeeld hieronder. Noot: Omdat de Basis Configuratie pagina zo lang is, worden alleen enkele bijzonderheden in het voorbeeld scherm getoond om je te helpen de secties te herkennen.
INSTALL: WEC StarterPackage• 34
Web-EmpoweredChurch -
INSTALL: WEC StarterPackage• 35
Web-EmpoweredChurch -
Configuratie– WebsiteURL Als toevoeging om veiligheidsrisico's te verwijderen, moet je wat basis informatie verstrekken dat je website configureert en persoonlijk maakt. Deze informatie kan ingevoerd worden in Web->WEC Config, met de “Edit Site Constanten” sectie.
Er zijn veel constanten die door de hele website werken, die in deze sectie gezet kunnen worden, maar de meest belangrijke is de website URL. De waarde die je hier invult is de naam waar je website mee gevonden kan worden op het internet, zoals http://mychurch.org/, en het moet altijd een slash aan het einde bevatten. Als deze waarde niet gezet is, zullen de links tussen de pagina's niet goed werken. Voor meer informatie over WEC Config en de WEC Constanten, zie de “Getting Started with the Web-Empowered Church” in de volgende sectie van dit document.
INSTALL: WEC StarterPackage• 36
Web-EmpoweredChurch -
Watverder? Als je zover gekomen bent is je installatie vam TYPO3 en het Web-Empowered Church Start Pakket compleet. De logische vraag is dan: Wat verder? “Getting Started with the Web-Empowered Church”, verkrijgbaar op http://www.webempoweredchurch.com/support/userdoc/, beantwoord deze vraag. Het geeft instructies over het instellen van je website sjabloon, het instellen van het WEC Start Pakket, en het gebruik van het TYPO3 backend om website inhoud aan te maken.
INSTALL: WEC StarterPackage• 37
Web-EmpoweredChurch -
Appendix Je kan het WEC Start Pakket installeren door gebruik te maken van een Secure Shell Access of een FTP toegang voor je web server.
Shell toegang Windows gebruiker zullen een SSH cliënt moeten downloaden. Een aanbevolen cliënt is PuTTY, gratis verkrijgbaar op http://www.chiark.greenend.org.uk/~sgtatham/putty/. Bij gebruik van PuTTY of elk andere grafische SSH cliënt, wordt de actuele server verbinding gemaakt door het SSH cliënt programma. Eenmaal verbonden worden alle commando's uitgevoerd middels een command regel. Voor Mac of Linux gebruikers moet command line SSH al geïnstalleerd zijn op het systeem. Neem contact op met je web hosting provider om na te gaan hoe toegang te krijgen tot de server middels SSH. Providers kunnen verschillende versies van SSH gebruiken of staan toegang alleen toe middels specifieke poorten of routes.
FTP toegang Als je FTP toegang wilt gebruiken, die standaard een meer grafische interface heeft dan de command regel Shell toegang, zul je een FTP cliënt programma moeten installeren als je er nog geen hebt geïnstalleerd. De gratis open-source applicatie FileZilla is verkrijgbaar op http://filezilla.sourceforge.net/ voor Windows gebruikers. Mac en Linux gebruikers kunnen gebruik maken van de standaard command regel applicatie of een programma downloaden als CuteFTP.
INSTALL: WEC StarterPackage• 38