Forudsætninger
											
										
																			
											
												Trin 1: Tilføj en Sudo-bruger
											
										
																			
											
												Trin 2: Opdater FreeBSD 11 System
											
										
																			
											
												Trin 3: Installer Apache Web Server
											
										
																			
											
												Trin 4: Installer PHP 7.1
											
										
																			
											
												Trin 5: Installer MariaDB (MySQL) Server
											
										
																			
											
												Trin 6: Opret database til Pagekit CMS
											
										
																			
											
												Trin 7: Installer Pagekit CMS-filer
											
										
																			
											
												Trin 8: Fuldfør installationen af Pagekit CMS
											
										
																	
												
						
												
Pagekit 1.0 CMS er et smukt, modulært, udvideligt og let, gratis og open source Content Management System (CMS) med en ren og intuitiv brugergrænseflade drevet af Vue.js. Pagekit 1.0 CMS har en modulær arkitektur bygget på Symfony-komponenter med en simpel ORM, en HTML- og Markdown-editor med forhåndsvisning i realtid, et kraftfuldt bruger- og tilladelsessystem og en fleksibel filhåndtering, der gør det muligt for webudviklere at redigere sider og administrere widgets med enkel træk og slip funktionalitet.
I denne tutorial skal vi installere Pagekit 1.0 CMS på en FreeBSD 11 FAMP VPS ved hjælp af Apache-webserver, PHP 7.1 og en MariaDB-database.
Forudsætninger
- En ren Vultr FreeBSD 11-serverinstans med SSH-adgang
Trin 1: Tilføj en Sudo-bruger
Vi starter med at tilføje en ny sudobruger.
Først skal du logge ind på din server som root:
ssh root@YOUR_VULTR_IP_ADDRESS
Den sudoKommandoen er ikke installeret som standard i Vultr FreeBSD 11 serversubsystem, så vil vi først installere sudo:
pkg install sudo
Tilføj nu en ny bruger kaldet user1(eller dit foretrukne brugernavn):
adduser user1
Den adduserkommando vil bede dig for masser af oplysninger om brugerens konto, så skal du blot vælge standarderne for de fleste af dem, når det giver mening at gøre det. Når du bliver spurgt, om Invite user1 into any other groups?du skal , skal du indtaste for wheelat tilføje user1til wheelgruppen.
Tjek nu /etc/sudoersfilen for at sikre, at sudoersgruppen er aktiveret:
visudo
Se efter et afsnit som dette:
# %wheel        ALL=(ALL)       ALL
Denne linje fortæller os, at brugere, der er medlemmer af wheelgruppen, kan bruge sudokommandoen til at opnå rootprivilegier. Det vil blive kommenteret ud som standard, så du bliver nødt til at fjerne kommentaren og derefter gemme og afslutte filen.
Vi kan bekræfte user1gruppemedlemskabet med groupskommandoen:
groups user1
Hvis du user1ikke er medlem af wheelgruppen, kan du bruge denne kommando til at opdatere user1gruppemedlemskabet:
pw group mod wheel -m user1 
Brug nu sukommandoen til at skifte til den nye sudo-brugerkonto user1:
su - user1
Kommandoprompten opdateres for at angive, at du nu er logget ind på user1kontoen. Du kan bekræfte dette med whoamikommandoen:
whoami
Genstart nu sshdtjenesten, så du kan logge på sshmed den nye ikke-root sudo-brugerkonto, du lige har oprettet:
sudo /etc/rc.d/sshd restart
Afslut user1kontoen:
exit
Afslut rootkontoen (hvilket vil afbryde forbindelsen til din sshsession):
exit
Du kan nu gå sshind i serverforekomsten fra din lokale vært ved at bruge den nye ikke-root sudo-brugerkonto user1:
ssh user1@YOUR_VULTR_IP_ADDRESS
Hvis du vil udføre sudo uden at skulle indtaste en adgangskode hver gang, skal du åbne /etc/sudoersfilen igen ved at bruge visudo:
sudo visudo
Rediger sektionen for wheelgruppen, så den ser sådan ud:
%wheel        ALL=(ALL)       NOPASSWD: ALL
Bemærk venligst:  Deaktivering af adgangskodekravet for sudo-brugeren er ikke en anbefalet praksis, men det er inkluderet her, da det kan gøre serverkonfigurationen meget mere bekvem og mindre frustrerende, især under længere systemadministrationssessioner. Hvis du er bekymret over sikkerhedskonsekvenserne, kan du altid gendanne konfigurationsændringen til den oprindelige, når du er færdig med dine administrationsopgaver. 
Når du vil logge ind på rootbrugerkontoen fra sudobrugerkontoen, kan du bruge en af følgende kommandoer:
sudo -i
sudo su -
Du kan forlade rootkontoen og vende tilbage til din sudobrugerkonto når som helst ved blot at skrive:
exit
Trin 2: Opdater FreeBSD 11 System
Før vi installerer nogen pakker på FreeBSD-serverinstansen, vil vi først opdatere systemet. 
Sørg for, at du er logget ind på serveren med en ikke-root sudo-bruger, og kør følgende kommandoer:
sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade
Trin 3: Installer Apache Web Server
Installer Apache-webserveren:
sudo pkg install apache24
Indtast, ynår du bliver bedt om det.
Brug nu sysrckommandoen til at aktivere Apache-tjenesten til at køre automatisk ved opstart:
sudo sysrc apache24_enable=yes
Den sysrckommando opdaterer /etc/rc.confkonfigurationsfil, så hvis du ønsker at kontrollere konfigurationen opdateringen manuelt kan du blot åbne /etc/rc.conffilen med din favorit terminal redaktør:
vi /etc/rc.conf
Start nu Apache-tjenesten:
sudo service apache24 start
Du kan hurtigt kontrollere, at apache kører, ved at besøge IP-adressen eller domænet for serverforekomsten i din browser:
http://YOUR_VULTR_IP_ADDRESS/
Du bør se standard FreeBSD Apache-siden, der viser teksten:
It works!
Tjek din Apache-standardkonfigurationsfil for at sikre, at DocumentRootdirektivet peger på den korrekte mappe:
sudo vi /usr/local/etc/apache24/httpd.conf
Den DocumentRootkonfiguration valgmulighed skal se sådan ud:
DocumentRoot "/usr/local/www/apache24/data"
Vi skal nu aktivere mod_rewriteApache-modulet. Vi kan gøre dette ved at søge i standard Apache-konfigurationsfilen for udtrykket mod_rewrite.
Som standard vil mod_rewriteApache-modulet blive kommenteret ud (hvilket betyder, at det er deaktiveret). Konfigurationslinjen på en ren Vultr FreeBSD 11-instans vil se sådan ud:
#LoadModule rewrite_module libexec/apache24/mod_rewrite.so
Du skal blot fjerne hash-symbolet for at fjerne kommentarer til linjen og indlæse modulet. Dette gælder selvfølgelig også for alle andre påkrævede Apache-moduler:
LoadModule rewrite_module libexec/apache24/mod_rewrite.so
Vi skal nu redigere DirectoryApache-direktivet i den samme konfigurationsfil, så det mod_rewritevil fungere korrekt med Pagekit CMS.
Find den del af konfigurationsfilen, der starter med, <Directory "/usr/local/www/apache24/data">og skift AllowOverride nonetil AllowOverride All. Slutresultatet (med alle kommentarer fjernet) vil se nogenlunde således ud:
<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>
Gem og afslut nu Apache-konfigurationsfilen.  
Vi genstarter Apache i slutningen af denne vejledning, men at genstarte Apache regelmæssigt under installation og konfiguration er bestemt en god vane, så lad os gøre det nu:
sudo service apache24 restart
Trin 4: Installer PHP 7.1
Vi kan nu installere PHP 7.1 sammen med alle de nødvendige PHP-moduler, der kræves af Pagekit CMS:
sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip php71-phar
FreeBSD 11 giver os mulighed for at bruge en udvikling php.inieller en produktion php.ini. Da vi skal installere Pagekit på en offentlig webserver, bruger vi produktionsversionen. Sikkerhedskopier først php.ini-production:
sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup
Så soft-link php.ini-productiontil php.ini:
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Vi skal konfigurere Apache til rent faktisk at bruge PHP, så lad os oprette en ny fil kaldet php.confi Apache- Includesmappen:
sudo vi /usr/local/etc/apache24/Includes/php.conf
Indtast følgende tekst i den nyoprettede fil:
<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>
Gem og afslut filen.
Lad os nu genstarte Apache, så den kan genindlæse konfigurationsændringerne:
sudo service apache24 restart
Trin 5: Installer MariaDB (MySQL) Server
FreeBSD 11 bruger som standard MariaDB-databaseserver, som er en forbedret, fuldt open source, community-udviklet drop-in-erstatning for MySQL-server.
Installer den seneste version af MariaDB-databaseserveren:
sudo pkg install mariadb102-server mariadb102-client
Start og aktiver MariaDB-serveren til at køre automatisk ved opstart:
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Sikre din MariaDB-serverinstallation:
sudo mysql_secure_installation
Når du bliver bedt om at oprette en MariaDB/MySQL- rootbruger, skal du vælge "Y" (for ja) og derefter indtaste en sikker rootadgangskode. Du skal blot svare "Y" på alle de andre ja/nej-spørgsmål, da standardforslagene er de mest sikre muligheder.
Trin 6: Opret database til Pagekit CMS
Log ind på MariaDB-skallen som MariaDB- rootbrugeren ved at køre følgende kommando:
sudo mysql -u root -p
For at få adgang til MariaDB-kommandoprompten skal du blot indtaste MariaDB- rootadgangskoden, når du bliver bedt om det.
Kør følgende forespørgsler for at oprette en MariaDB-database og databasebruger til Pagekit CMS:
CREATE DATABASE pagekit_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'pagekit_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON pagekit_db.* TO 'pagekit_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Du kan erstatte databasenavnet pagekit_dbog brugernavnet pagekit_usermed noget mere efter din smag, hvis du foretrækker det. Sørg også for at erstatte "UltraSecurePassword" med en faktisk sikker adgangskode.
Trin 7: Installer Pagekit CMS-filer
Skift din nuværende arbejdsmappe til standardwebbiblioteket:
cd /usr/local/www/apache24/data
Din nuværende arbejdsmappe vil nu være:   /usr/local/www/apache24/data. Du kan kontrollere dette med pwdkommandoen (udskriv arbejdsmappe):
pwd
Brug nu wgettil at downloade Pagekit CMS-installationspakken:
sudo wget http://pagekit.com/api/download/latest
List den aktuelle mappe for at kontrollere, at du har downloadet filen:
ls -la
Fjern index.html:
sudo rm index.html
Udkomprimer nu zip-arkivet:
sudo unzip latest
Skift ejerskab af webfilerne for at undgå problemer med tilladelser:
sudo chown -R www:www * ./
Genstart Apache igen:
sudo service apache24 restart
Nu er vi klar til at gå videre til det sidste trin. 
Trin 8: Fuldfør installationen af Pagekit CMS
Det er tid til at besøge IP-adressen på din serverforekomst i din browser, eller hvis du allerede har konfigureret dine Vultr DNS-indstillinger (og givet den tid nok til at sprede sig), kan du blot besøge dit domæne i stedet for.
For at få adgang til Pagekit CMS installationssiden skal du indtaste din Vultr-instans IP-adresse i din browsers adresselinje efterfulgt af /index.php:
http://YOUR_VULTR_IP_ADDRESS/index.php
De fleste af Pagekit CMS-installationsmulighederne er selvforklarende, men her er et par tips til at hjælpe dig på vej:
- Klik på pilen for at starte installationsprocessen. 
- Vælg dit sprog og klik på - NEXTknappen.
 
- Vælg - MySQLsom din- Database Driverog indtast derefter følgende databasedetaljer:
 - Hostname:           localhost
User:               pagekit_user
Password:           UltraSecurePassword
Database Name:      pagekit_db
Table Prefix:       pk_
 - Klik for - NEXTat fortsætte.
 
- Indtast din - Site Titleog- Administrator Detailssom følger:
 - Site Title:         <your site title>
Username:           <your admin username>
Password:           <your admin password>
Email:              <your admin email address>
 
- Klik for - INSTALLat køre Pagekit CMS-installationsprogrammet.
 
Du vil blive omdirigeret til Admin Login-siden. Hvis du ikke bliver omdirigeret til admin login-siden, kan du indtaste admin-adressen manuelt:
http://YOUR_VULTR_IP_ADDRESS/admin/login
Indtast blot dit admin-brugernavn og adgangskode på login-siden.
Du er nu klar til at begynde at tilføje dit indhold og konfigurere udseendet og følelsen af dit websted. Sørg for at tjekke den fremragende Pagekit CMS-dokumentation for mere information om, hvordan du opbygger og konfigurerer dit websted.