Feng Office installeren op Debian 10

Feng Office is een gratis en open-source online projectbeheer en samenwerkingsprogramma geschreven in PHP. Het is een web-gebaseerd hulpmiddel dat Projectbeheer, Beheer van Klantrelaties, Financiering en Facturering integreert en je organisatie beter laat draaien. Feng Office biedt een rijke reeks functies, waaronder, Taakbeheer, Tijdregistratie, Gantt Grafiek, Kennisbeheer, Kalender, Timesheet, Automatische waarschuwingen en herinneringen en nog veel meer. Feng Office heeft drie edities, Community, Professional, en Enterprise.

In deze handleiding leggen we uit hoe je Feng Office Community Editie op Debian 10 VPS kunt installeren.

Vereisten

  • Een server met Debian 10 met minimaal 2 GB RAM.
  • Een geldige domeinnaam die naar het IP van je server wijst. In deze handleiding gebruiken we het domein example.com.
  • Een root wachtwoord is op je server ingesteld.

Aan de slag

Voor je begint, update je je systeem met de nieuwste versie. Je kunt dat doen door het volgende commando uit te voeren:

apt-get update -y
apt-get upgrade -y

Als je systeem bijgewerkt is, herstart je het om de veranderingen toe te passen.

Installeer Apache en MariaDB

Eerst moet je de Apache webserver en de MariaDB server op je server installeren. Je kunt ze installeren door het volgende commando uit te voeren:

apt-get install apache2 mariadb-server -y

Zodra beide pakketten geïnstalleerd zijn, start je de Apache en MariaDB service en zet je ze aan om te starten na herstart van het systeem met het volgende commando:

systemctl start apache2
systemctl start mariadb
systemctl enable apache2
systemctl enable mariadb

Als je klaar bent, kun je verder gaan met de volgende stap.

Installeer en configureer PHP

Standaard wordt Debian 10 geleverd met PHP 7.3. Je zult PHP versie 7.1 moeten installeren om Feng Office goed te laten werken.

Installeer eerst de vereiste pakketten met het volgende commando:

apt-get install software-properties-common ca-certificates apt-transport-https -y

Voeg vervolgens de SURY repository toe met het volgende commando:

wget https://packages.sury.org/php/apt.gpg
apt-key add apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/php7.list

Werk vervolgens de repository bij en installeer PHP met alle vereiste modules met het volgende commando:

apt-get install php7.1 php7.1-mysql php7.1-curl php7.1-json php7.1-cgi libapache2-mod-php7.1 php7.1-mcrypt php7.1-xmlrpc php7.1-gd php7.1-mbstring php7.1-common php7.1-soap php7.1-xml php7.1-intl php7.1-cli php7.1-ldap unzip php7.1-zip wget php7.1-readline php7.1-imap php7.1-tidy php7.1-recode php7.1-sq -y

Als alle pakketten geïnstalleerd zijn, open je het php.ini bestand en pas je enkele instellingen aan:

nano /etc/php/7.1/cli/php.ini

Verander de volgende regels:

max_execution_time = 300
max_input_time = 300
memory_limit = 512M
post_max_size = 128M
upload_max_filesize = 128M
html_errors = Off
display_startup_errors = Off
log_errors = On
output_buffering = Off

Sla het bestand op en sluit het.

Open vervolgens nog een php.ini bestand:

nano /etc/php/7.1/apache2/php.ini

Verander de volgende regels:

max_execution_time = 300
max_input_time = 300
memory_limit = 512M
post_max_size = 128M
upload_max_filesize = 128M
html_errors = Off
display_startup_errors = Off
log_errors = On
output_buffering = Off

Bewaar en sluit het bestand. Installeer dan andere door Feng Office vereiste pakketten met het volgende commando:

apt-get install catdoc xpdf ghostscript imagemagick wkhtmltopdf -y

Als alle pakketten geïnstalleerd zijn, kun je verder gaan met de volgende stap.

Configureer MariaDB voor Feng Office

Vervolgens moet je een databank en een gebruiker voor Feng Office maken.

Log eerst in op MariaDB shell met het volgende commando:

mysql -u root -p

Geef je root wachtwoord als daarom gevraagd wordt en maak dan een database en gebruiker voor Feng Office met het volgende commando:

MariaDB [(none)]> CREATE DATABASE fengdb;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON fengdb.* TO 'fenguser'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;

Spoel vervolgens de privileges door en verlaat de MariaDB shell met het volgende commando:

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

Als je klaar bent, kun je verder gaan met de volgende stap.

Download Feng Office

Download eerst de nieuwste versie van Feng Office met het volgende commando:

wget -O fengoffice.zip --no-check-certificate https://www.fengoffice.com/web/reference.php?dest=latest_version

Eenmaal gedownload pak je het gedownloade bestand uit met het volgende commando:

unzip fengoffice.zip

Verplaats vervolgens de uitgepakte map naar de Apache web root map met het volgende commando:

mv fengoffice-3.7.0.5 /var/www/html/fengoffice

Geef vervolgens de juiste permissies aan de map fengoffice:

chown -R www-data:www-data /var/www/html/fengoffice
chmod -R 777 /var/www/html/fengoffice

Als je klaar bent, kun je verder gaan met de volgende stap.

Configureer Apache voor Feng Office

Vervolgens moet je een Apache virtual host configuratiebestand maken om de Feng Office toepassing te serveren. Je kunt dat doen met het volgende commando:

nano /etc/apache2/sites-available/feng.conf

Voeg de volgende regels toe:

<VirtualHost *:80>
     ServerAdmin [email protected]
     DocumentRoot /var/www/html/fengoffice
     ServerName example.com

     <Directory /var/www/html/fengoffice/>
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Sla het bestand op en sluit het als je klaar bent. Schakel dan de Apache virtuele host, header en herschrijfmodule in met het volgende commando:

a2ensite feng.conf
a2enmod rewrite
a2enmod headers

Herstart vervolgens de Apache webdienst om de veranderingen toe te passen:

systemctl restart apache2

Je kunt de status van de Apache webserver controleren met het volgende commando:

systemctl status apache2

Je zou de volgende uitvoer moeten krijgen:

? apache2.service - The Apache HTTP Server
   Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
   Active: active (running) since Mon 2019-12-02 07:02:28 EST; 1min 3s ago
     Docs: https://httpd.apache.org/docs/2.4/
  Process: 2329 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
 Main PID: 2333 (apache2)
    Tasks: 7 (limit: 1138)
   Memory: 21.8M
   CGroup: /system.slice/apache2.service
           ??2333 /usr/sbin/apache2 -k start
           ??2334 /usr/sbin/apache2 -k start
           ??2335 /usr/sbin/apache2 -k start
           ??2336 /usr/sbin/apache2 -k start
           ??2337 /usr/sbin/apache2 -k start
           ??2338 /usr/sbin/apache2 -k start
           ??2341 /usr/sbin/apache2 -k start

Dec 02 07:02:28 debian systemd[1]: Starting The Apache HTTP Server...
Dec 02 07:02:28 debian apachectl[2329]: AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.
Dec 02 07:02:28 debian systemd[1]: Started The Apache HTTP Server.

Toegang tot Feng Office Web Interface

Open nu je webbrowser en navigeer naar de URL http://example.com. Je wordt doorverwezen naar de volgende pagina:

Feng Kantoor Installateur

Klik op de Volgende knop. Je zou de volgende pagina moeten zien:

Omgevingscontrole

Controleer of alle vereisten goed geïnstalleerd zijn. Klik dan op de Next knop. Je zou de volgende pagina moeten zien:

Database verbinding

Geef nu je Database naam, Database gebruikersnaam, wachtwoord op, selecteer Core_dimensions en Workspaces modules en klik op de knop Volgende. Je zou de volgende pagina moeten zien:

Installatie voltooid

Klik nu op de knop Finish om de installatie te voltooien. Je zou de volgende pagina moeten zien:

Log in op feng

Geef je admin gebruikersnaam, e-mail en wachtwoord op en klik op de Submit knop. Je wordt nu doorgestuurd naar de Feng Office login pagina:

Inlogformulier

Geef nu je admin gebruikersnaam, wachtwoord en klik op de Login knop. Je zou nu het Feng Office dashboard moeten zien op de volgende pagina:

Feng office dashboard

Beveilig Feng Office met Let’s Encrypt Free SSL

Feng Office is nu geïnstalleerd en geconfigureerd. Vervolgens is het aan te bevelen het te beveiligen met Let’s Encrypt gratis SSL. Om dat te doen moet je een Certbot client op je server installeren. Certbot is een Let’s Encrypt client die gebruikt kan worden om een SSL certificaat voor je domein te downloaden en te installeren.

Voeg eerst de Certbot repository aan je server toe met het volgende commando:

add-apt-repository ppa:certbot/certbot

Als de repository is toegevoegd, update je de repository en installeer je Certbot met het volgende commando:

apt-get update -y
apt-get install certbot python-certbot-apache -y

Certbot is nu geïnstalleerd en klaar voor gebruik.

Voer het volgende commando uit om het SSL certificaat voor je domein te verkrijgen en te installeren:

certbot --apache -d example.com

Je wordt gevraagd je e-mailadres op te geven en akkoord te gaan met de servicevoorwaarden.

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

Vervolgens moet je kiezen of je HTTP verkeer al dan niet wilt omleiden naar HTTPS, waarbij de HTTP toegang verwijderd wordt, zoals hieronder te zien is:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Kies optie 2 om een gratis SSL certificaat voor je domein te downloaden en te installeren en druk op Enter om de installatie te voltooien.

Nu kun je je Feng Office veilig benaderen met de URL https://example.com.

Conclusie

Gefeliciteerd! Je hebt Feng Office met succes geïnstalleerd, geconfigureerd en beveiligd op Debian 10 server. Je kunt nu je project gemakkelijk beheren met de Feng Office web interface.