Hvordan installere Pagekit 1.0 CMS på en FreeBSD 11 FAMP VPS

Pagekit 1.0 CMS er et vakkert, modulært, utvidbart og lett, gratis og åpen kildekode Content Management System (CMS) med et rent og intuitivt brukergrensesnitt drevet av Vue.js. Pagekit 1.0 CMS har en modulær arkitektur bygget på Symfony-komponenter med en enkel ORM, en HTML- og Markdown-editor med forhåndsvisning i sanntid, et kraftig bruker- og tillatelsessystem og en fleksibel filbehandling som lar webutviklere redigere sider og administrere widgets med enkel dra og slipp-funksjonalitet.

I denne opplæringen skal vi installere Pagekit 1.0 CMS på en FreeBSD 11 FAMP VPS ved å bruke Apache-webserver, PHP 7.1 og en MariaDB-database.

Forutsetninger

• En ren Vultr FreeBSD 11-serverforekomst med SSH-tilgang

Trinn 1: Legg til en Sudo-bruker

Vi starter med å legge til en ny sudobruker.

Først logger du på serveren din som root:

ssh root@YOUR_VULTR_IP_ADDRESS

Den sudokommandoen er ikke installert som standard i Vultr FreeBSD 11 server eksempel, så vil vi først installere sudo:

pkg install sudo

Legg nå til en ny bruker kalt user1(eller ditt foretrukne brukernavn):

adduser user1

Den adduserkommandoen vil be deg om mange detaljer for brukerkontoen, så velger du standardverdiene for de fleste av dem når det er fornuftig å gjøre det. Når du blir spurt om du vil Invite user1 into any other groups?, bør du skrive inn for wheelå legge user1til i wheelgruppen.

Sjekk nå /etc/sudoersfilen for å forsikre deg om at sudoersgruppen er aktivert:

visudo

Se etter en del som dette:

# %wheel        ALL=(ALL)       ALL

Denne linjen forteller oss at brukere som er medlemmer av wheelgruppen kan bruke sudokommandoen for å få rootprivilegier. Den vil bli kommentert ut som standard, så du må oppheve kommentaren og deretter lagre og avslutte filen.

Vi kan bekrefte user1gruppemedlemskapet med groupskommandoen:

groups user1

Hvis du user1ikke er medlem av wheelgruppen, kan du bruke denne kommandoen til å oppdatere user1gruppemedlemskapet:

pw group mod wheel -m user1 

Bruk nå sukommandoen for å bytte til den nye sudo- user1brukerkontoen:

su - user1

Ledeteksten vil oppdateres for å indikere at du nå er logget på user1kontoen. Du kan bekrefte dette med whoamikommandoen:

whoami

Start nå sshdtjenesten på nytt slik at du kan logge på sshmed den nye ikke-root sudo-brukerkontoen du nettopp har opprettet:

sudo /etc/rc.d/sshd restart

Avslutt user1kontoen:

exit

Avslutt rootkontoen (som vil koble fra sshøkten):

exit

Du kan nå gå sshinn i serverforekomsten fra din lokale vert ved å bruke den nye ikke-root sudo- user1brukerkontoen:

ssh user1@YOUR_VULTR_IP_ADDRESS

Hvis du vil kjøre sudo uten å måtte skrive inn et passord hver gang, åpner du /etc/sudoersfilen igjen ved å bruke visudo:

sudo visudo

Rediger seksjonen for wheelgruppen slik at den ser slik ut:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Vennligst merk: Deaktivering av passordkravet for sudo-brukeren er ikke en anbefalt praksis, men det er inkludert her da det kan gjøre serverkonfigurasjonen mye mer praktisk og mindre frustrerende, spesielt under lengre systemadministrasjonsøkter. Hvis du er bekymret for sikkerhetsimplikasjonene, kan du alltid tilbakestille konfigurasjonsendringen til den opprinnelige etter at du er ferdig med administrasjonsoppgavene.

Når du vil logge på rootbrukerkontoen fra sudobrukerkontoen, kan du bruke en av følgende kommandoer:

sudo -i
sudo su -

Du kan avslutte rootkontoen og gå tilbake til sudobrukerkontoen din når som helst ved å skrive:

exit

Trinn 2: Oppdater FreeBSD 11-systemet

Før vi installerer noen pakker på FreeBSD-serverforekomsten, vil vi først oppdatere systemet.

Pass på at du er logget på serveren med en ikke-root sudo-bruker og kjør følgende kommandoer:

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

Trinn 3: Installer Apache Web Server

Installer Apache-nettserveren:

sudo pkg install apache24

Skriv inn ynår du blir bedt om det.

Bruk nå sysrckommandoen for å aktivere Apache-tjenesten til å kjøre automatisk ved oppstart:

sudo sysrc apache24_enable=yes

Den sysrckommandoen oppdaterer /etc/rc.confkonfigurasjonsfilen, så hvis du ønsker å kontrollere konfigurasjonen oppdateringen manuelt kan du bare åpne /etc/rc.conffilen med din favoritt terminal redaktør:

vi /etc/rc.conf

Start nå Apache-tjenesten:

sudo service apache24 start

Du kan raskt sjekke at apache kjører ved å besøke IP-adressen eller domenet til serverforekomsten i nettleseren din:

http://YOUR_VULTR_IP_ADDRESS/

Du bør se standard FreeBSD Apache-siden som viser teksten:

It works!

Sjekk Apache standard konfigurasjonsfil for å sikre at DocumentRootdirektivet peker til riktig katalog:

sudo vi /usr/local/etc/apache24/httpd.conf

Den DocumentRootinnstilling skal se slik ut:

DocumentRoot "/usr/local/www/apache24/data"

Vi må nå aktivere mod_rewriteApache-modulen. Vi kan gjøre dette ved å søke i standard Apache-konfigurasjonsfilen for termen mod_rewrite.

Som standard vil mod_rewriteApache-modulen bli kommentert ut (som betyr at den er deaktivert). Konfigurasjonslinjen på en ren Vultr FreeBSD 11-forekomst vil se slik ut:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Bare fjern hash-symbolet for å fjerne kommentaren til linjen og last inn modulen. Dette gjelder selvfølgelig også for alle andre nødvendige Apache-moduler:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Vi må nå redigere DirectoryApache-direktivet i den samme konfigurasjonsfilen slik at den mod_rewritefungerer riktig med Pagekit CMS.

Finn delen av konfigurasjonsfilen som starter med <Directory "/usr/local/www/apache24/data">og endre AllowOverride nonetil AllowOverride All. Sluttresultatet (med alle kommentarer fjernet) vil se omtrent slik ut:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Lagre og avslutt Apache-konfigurasjonsfilen.

Vi vil starte Apache på nytt på slutten av denne opplæringen, men å starte Apache på nytt regelmessig under installasjon og konfigurasjon er absolutt en god vane, så la oss gjøre det nå:

sudo service apache24 restart

Trinn 4: Installer PHP 7.1

Vi kan nå installere PHP 7.1 sammen med alle nødvendige PHP-moduler som kreves av 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 gir oss muligheten til å bruke en utvikling php.inieller en produksjon php.ini. Siden vi skal installere Pagekit på en offentlig webserver, bruker vi produksjonsversjonen. Sikkerhetskopier først php.ini-production:

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

Deretter myklink php.ini-productiontil php.ini:

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Vi må konfigurere Apache til å faktisk bruke PHP, så la oss lage en ny fil som heter php.confi Apache- Includeskatalogen:

sudo vi /usr/local/etc/apache24/Includes/php.conf

Skriv inn følgende tekst i den nyopprettede filen:

<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>

Lagre og avslutt filen.

La oss nå starte Apache på nytt slik at den kan laste inn konfigurasjonsendringene på nytt:

sudo service apache24 restart

Trinn 5: Installer MariaDB (MySQL) Server

FreeBSD 11 bruker som standard MariaDB-databaseserver, som er en forbedret, fullstendig åpen kildekode, fellesskapsutviklet drop-in-erstatning for MySQL-server.

Installer den nyeste versjonen av MariaDB databaseserver:

sudo pkg install mariadb102-server mariadb102-client

Start og aktiver MariaDB-serveren til å kjøre automatisk ved oppstart:

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

Sikre din MariaDB-serverinstallasjon:

sudo mysql_secure_installation

Når du blir bedt om å opprette en MariaDB/MySQL- rootbruker, velg "Y" (for ja) og skriv deretter inn et sikkert rootpassord. Svar ganske enkelt "Y" på alle de andre ja/nei-spørsmålene, da standardforslagene er de sikreste alternativene.

Trinn 6: Opprett database for Pagekit CMS

Logg inn på MariaDB-skallet som MariaDB- rootbrukeren ved å kjøre følgende kommando:

sudo mysql -u root -p

For å få tilgang til MariaDB-ledeteksten, skriv ganske enkelt inn MariaDB- rootpassordet når du blir bedt om det.

Kjør følgende spørringer for å opprette en MariaDB-database og databasebruker for 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 brukernavnet pagekit_usermed noe mer du liker, hvis du foretrekker det. Pass også på at du erstatter "UltraSecurePassword" med et faktisk sikkert passord.

Trinn 7: Installer Pagekit CMS-filer

Endre din nåværende arbeidskatalog til standard nettkatalog:

cd /usr/local/www/apache24/data

Din nåværende arbeidskatalog vil nå være: /usr/local/www/apache24/data. Du kan sjekke dette med pwdkommandoen (skriv ut arbeidskatalog):

pwd

Bruk nå for wgetå laste ned Pagekit CMS-installasjonspakken:

sudo wget http://pagekit.com/api/download/latest

List gjeldende katalog for å kontrollere at du har lastet ned filen:

ls -la

Fjern index.html:

sudo rm index.html

Dekomprimer nå zip-arkivet:

sudo unzip latest

Endre eierskap til nettfilene for å unngå problemer med tillatelser:

sudo chown -R www:www * ./

Start Apache på nytt:

sudo service apache24 restart

Nå er vi klare til å gå videre til det siste trinnet.

Trinn 8: Fullfør Pagekit CMS-installasjonen

Det er på tide å besøke IP-adressen til serverforekomsten din i nettleseren din, eller hvis du allerede har konfigurert Vultr DNS-innstillingene (og gitt den nok tid til å spre seg), kan du ganske enkelt besøke domenet ditt i stedet.

For å få tilgang til Pagekit CMS-installasjonssiden, skriv inn IP-adressen til Vultr-forekomsten din i nettleserens adresselinje, etterfulgt av /index.php:

http://YOUR_VULTR_IP_ADDRESS/index.php

De fleste installasjonsalternativene for Pagekit CMS er selvforklarende, men her er noen tips for å hjelpe deg:

1. Klikk på pilen for å starte installasjonsprosessen.

2. Velg ditt språk og klikk på NEXTknappen.

3. Velg MySQLsom din Database Driverog skriv deretter inn følgende databasedetaljer:

   Hostname:           localhost
   User:               pagekit_user
   Password:           UltraSecurePassword
   Database Name:      pagekit_db
   Table Prefix:       pk_
   

   Klikk for NEXTå fortsette.

4. Skriv inn 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>
   

5. Klikk for INSTALLå kjøre Pagekit CMS-installasjonsprogrammet.

Du vil bli omdirigert til Admin Login-siden. Hvis du ikke blir omdirigert til admin-påloggingssiden, kan du angi admin-adressen manuelt:

http://YOUR_VULTR_IP_ADDRESS/admin/login

Bare skriv inn ditt admin brukernavn og passord på påloggingssiden.

Du er nå klar til å begynne å legge til innholdet ditt og konfigurere utseendet på nettstedet ditt. Sørg for å sjekke ut den utmerkede Pagekit CMS-dokumentasjonen for mer informasjon om hvordan du bygger og konfigurerer nettstedet ditt.