Getting Started

Contents

• Install php
• Php.ini
• Nginx
• Apache
• Get Project Code
• Setup Config.php
• Build Static Files
• Updating PMSF
• More Info

Install php

CentOS

MySQL/MariaDB

yum -y install php php-mysql php-fpm php-curl

PostgreSQL

yum -y install php php-pgsql php-fpm php-curl

Ubuntu

MySQL/MariaDB

apt-get -y install php php-mysql php-fpm php-curl

PostgreSQL

apt-get -y install php php-pgsql php-fpm php-curl

Php.ini

• How to find your php.ini file.

Change default timezone to your local time zone in this format:

date.timezone=Europe/Brussels

Restart your webserver.

Nginx

Setup Nginx: Nginx

Use Nginx or Apache, not both

Apache

Make sure you have mod_rewrite enabled, how to check if enabled

Make sure you AllowOverride in your apache config file, how to check

Use Nginx or Apache, not both

Get Project Code

Install via Git

Navigate to your Web Host and git clone https://github.com/pmsf/PMSF.git

Setup Config.php

Create a config.php file in the config folder, look at example.config.php for all the settings.

Go to the config file wiki page for more info: Config file

Build Static Files

In order to run from a git clone, you must compile the front-end assets with node. Make sure you have node installed for your platform:

• Windows/OSX (Click the Windows or Macintosh Installer respectively)
• Linux - refer to the package installation for your flavor of OS

Once node/npm is installed, open a command window and validation your install:

node --version
npm --version

The output should look something like:

$ node --version
v4.7.0
$ npm --version
3.8.9

Once node/npm is installed, you can install the node dependencies and build the front-end assets:

npm install

# The assets should automatically build (you'd see something about "grunt build")
# If that doesn't happen, you can directly run the build process:
npm run build

Composer

Install Composer

apt-get install composer

Install Composer dependencies

composer install

UICONS cache folder

PMSF needs a writable cache folder for icons to be displayed properly. In the root of your installation:

mkdir .cache
sudo chown -R www-data:www-data .cache
sudo chmod 744 .cache

if www-data is incorrect for your webserver, adjust accordingly.

Updating PMSF

Because PMSF is being actively updated it is often needed to update your frontend.

You can update with only 2 commands:

git pull
npm run build

More Info

CentOS

https://www.digitalocean.com/community/tutorials/how-to-install-linux-nginx-mysql-php-lemp-stack-on-centos-7

Ubuntu

https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mysql-php-lamp-stack-on-ubuntu-16-04