Hvordan installere Anchor CMS på en FreeBSD 11 FAMP VPS

Anchor CMS er en superenkel og ekstremt lett, gratis og åpen kildekode Content Management System (CMS) Blog Engine som støtter redigering av innhold i Markdown eller HTML, og er fullt i18n-kompatibel ut av esken. Å lage og endre temaer er like enkelt som å skrive noen veldig enkle PHP og HTML/CSS, så det er ingen nye malspråk å lære. Anchor CMS veier kun 250KB (komprimert), så det er den perfekte løsningen for webutviklere og bloggere som er lei av bloatware og bare vil ha en enkel og minimalistisk bloggingmotor som får jobben gjort uten ekstra komplikasjoner.

I denne opplæringen skal vi installere Anchor 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 inn følgende:

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 vil 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 DocumentRootkonfigurasjon alternativet vil 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 Anchor 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 Anchor 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 Anchor 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

We need to configure Apache to actually use PHP, so let's create a new file called php.conf in the Apache Includes directory:

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

Enter the following text into the newly created file:

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

Save and exit the file.

Now let's restart Apache so that it can reload the configuration changes:

sudo service apache24 restart

Step 5: Install MariaDB (MySQL) Server

FreeBSD 11 defaults to using MariaDB database server, which is an enhanced, fully open source, community developed, drop-in replacement for MySQL server.

Install the latest version of MariaDB database server:

sudo pkg install mariadb102-server mariadb102-client

Start and enable MariaDB server to execute automatically at boot time:

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

Secure your MariaDB server installation:

sudo mysql_secure_installation

When prompted to create a MariaDB/MySQL root user, select "Y" (for yes) and then enter a secure root password. Simply answer "Y" to all of the other yes/no questions as the default suggestions are the most secure options.

Step 6: Create Database for Anchor CMS

Log into the MariaDB shell as the MariaDB root user by running the following command:

sudo mysql -u root -p

To access the MariaDB command prompt, simply enter the MariaDB root password when prompted.

Run the following queries to create a MariaDB database and database user for Anchor CMS:

CREATE DATABASE anchor_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'anchor_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON anchor_db.* TO 'anchor_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

You can replace the database name anchor_db and username anchor_user with something more to your liking, if you prefer. Also, make sure that you replace "UltraSecurePassword" with an actually secure password.

Trinn 7: Installer Anchor 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 Anchor CMS-installasjonspakken:

sudo wget https://github.com/anchorcms/anchor-cms/archive/0.12.3a.zip

Merk: Du bør definitivt se etter den nyeste versjonen ved å gå til Anchor CMS-nedlastingssiden .

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 0.12.3a.zip

Flytt alle installasjonsfilene til webrotkatalogen:

sudo mv anchor-cms-0.12.3a/* /usr/local/www/apache24/data

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

sudo chown -R www:www * ./

Start Apache på nytt:

sudo service apache24 restart

Trinn 8: Installer og kjør Composer

Anchor CMS krever at vi bruker for composerå laste ned noen plugins, så vi må først installere composer. Dessverre er ikke versjonen av den forhåndsbygde binære versjonen av composer i FreeBSD-pakkelagerene kompatibel med PHP 7.1. Så i stedet for å installere composermed pkgkommandoen, vil vi i stedet kompilere den fra kilden.

Først, la oss konfigurere FreeBSD 11-systemet til å kompilere PHP-programvare ved å bruke PHP versjon 7.1 i stedet for standard 5.6.

Opprett en ny fil i /etc/katalogen som heter make.conf:

sudo vi /etc/make.conf

Skriv inn følgende tekst i filen:

DEFAULT_VERSIONS+= php=7.1

Lagre og lukk filen nå.

Deretter må vi laste ned FreeBSD-portsamlingen ved å bruke portsnapkommandoen:

sudo portsnap fetch extract update

Når portsnapkommandoen er fullført, bytt til php-composerkildekodekatalogen:

cd /usr/ports/devel/php-composer/

Start nå php-composerkompileringen og installasjonen ved å bruke makekommandoen:

sudo make install clean

Hvis du ikke er vant til å kompilere programvare, kan skjermen se litt skremmende ut for deg. Du vil se mye tekst som ruller forbi og vil av og til bli bedt om å velge noen kompileringsinnstillinger. Bare godta standardverdiene og velg for OKå fortsette kompileringen.

Merk: Det kan ta lang tid å kompilere programvare, men sørg for å holde øye med skjermen, da du kanskje må bekrefte detaljer under kompileringen.

Når kompileringen er fullført, bytt til webroot-katalogen:

cd /usr/local/www/apache24/data

Kjør komponist med wwwbrukeren:

sudo -u www composer install -d /usr/local/www/apache24/data

Du bør se noen advarselsmeldinger fra composerom ikke å kunne skrive til hurtigbufferen, men ikke bekymre deg for mye om det siden alt fortsatt skal installeres helt fint.

Vi er nå klare til å gå videre til det siste trinnet.

Trinn 9: Fullfør Anchor 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 Anchor CMS-installasjonssiden, skriv inn IP-adressen til Vultr-forekomsten din i nettleserens adresselinje, etterfulgt av /install/:

http://YOUR_VULTR_IP_ADDRESS/install/

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

1. På Anchor CMS-landingssiden klikker du ganske enkelt på Run the installerknappen for å starte installasjonsprosessen.

2. Velg din Languageog Timezoneog klikk på Next Stepknappen.

3. Skriv Database Detailsinn følgende databaseverdier på siden:

   Database Host:          localhost
   Port:                   3306
   Username:               anchor_user
   Password:               UltraSecurePassword
   Database Name:          anchor_db
   Table Prefix:           anchor_
   Collation:              utf8_unicode_ci
   

   Klikk for Next Stepå fortsette.

4. Skriv Site metadatainn følgende detaljer på siden:

   Site Name:              <your site name>
   Site Description:       <a site description>
   Site Path:              /
   

   Klikk for Next Stepå fortsette.

5. Skriv deretter inn passende administratorpåloggingsdetaljer:

   Username:               admin   
   Email Address:          <admin email address>
   Password:               <admin password>
   

6. Klikk på Completeknappen for å fullføre installasjonen.

Du vil se en knallgrønn side med meldingen Install complete!.

For å få tilgang til admin-delen klikker du på Visit your admin panelknappen og skriver inn brukernavn og passord. Hvis du ikke blir omdirigert til admin-påloggingssiden, kan du angi admin-adressen manuelt:

http://YOUR_VULTR_IP_ADDRESS/admin/panel

Av sikkerhetsgrunner, sørg for at du sletter /install/katalogen fra webroot-katalogen:

sudo rm -rf ./install/

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