FlinkISO Open Source QMS Software
Installation Manual For Free On-Premise Lite Users

Installation

Note:

FlinkISO QMS Application is based on CakePHP-2 Framework. You can follow CakePHP requirements & installation guide at CakePHP website here.

Note: We have updated the lib folders from https://github.com/kamilwylegala/cakephp2-php8 to suite the application requirments. Please do not overwrite lib folder with this reposutory directly. Use the lib folder which comes with the download. With this update, latest version of FlinkISO supports both 8+ as well as <8 PHP versions. When you download the application, you could see lib & lib-older folders. lib folders supports the latest version PHP8+ and lib-older is for the older PHP versions.

Latest CakePHP:

We are in the process for upgrading the entire application from CakePHP2x to CakePHP5x. This upgrade will be rolled out in few months for all (free and paid) users.

ONLYOFFICE & Static IP:

You must have Static IP or host the application on a server with qualified domain. Hosted application must be Internet Facing. If not, you will not be able to use ONLYOFFICE functionality. FlinkISO APIs will work without Static IP. After installation, you need to send us email at [email protected] to obtain our ONLYOFFICE access secret.

You can ignore Static IP, if you host both FlinkISO and ONLYOFFICE at your premise on two different servers. You can use VM and install ONLYOFFICE on VM. Always use IP address to connect (http://localhost/ will not work). In such case, you must change the ONLYOFFICE API path in app/Config/core.php file to your IP and add your own secret.

Use of HTTPS is highly recommended.

FlinkISO On-Premise will run smoothly on LAMP Stack: Linux/ Apache/ MySQL/ PHP. Before you download the application make sure you have the following:

 

Ubuntu Commands to install PDFtk & whkhtmltopdf:

sudo apt install pdftk
cd ~
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb
sudo apt install ./wkhtmltox_0.12.6.1-2.jammy_amd64.deb

Before Download:

Before you begin, you may want to download & install any of the following, incase you do not have a running Apache Sserver:

Download MAMP | Download XAMPP

Step 1: Copy Application

Copy application to your server's WWW directory or the directory you have defined as Site Directory.

Step 2: Update Application Configuration Files

Go to your_directory/flinkiso/app/Config/Core.php

  • Do not change "ApiPath".
  • Change "OnlyofficePath", "onlyofficesecret" & "OnlyofficeConversionApi" to your ONLYOFFICE server, if you are not useing FlinkISO-ONLYOFFICE server.
  • Change "WkHtmlToPdfPath" & "PDFTkPath" to your locally installed WkHtmlToPdf/ PDFTk. You will also need to change the WkHtmlToPdf path in AppController.php & app/Plugin/CakePdf/Pdf/Engine/WkHtmlToPdfEngine.php
  • Find "date_default_timezone_set("Asia/Calcutta");" and replace "Asia/Calcutta" to your timezone.
  • Find "Configure::write("Security.salt" and replace with your value (keep the string lenght same, make this change before you regisster the instance).
  • Find "Configure::write("Security.cipherSeed" and replace with your value (keep the lenght same, make this change before you regisster the instance).
  • Find "Configure::write('dateFormat', 'd/m/Y'); // options d-m-Y, dd-mm-YY, d M Y etc" and replace it with your prefered date format. (Note: This will only reflect in exported PDF files for now)


Go to your_directory/flinkiso/app/Config/Database.php.

Update database configuration with your details:

Step 3: Install Database

Database file can be found at app/webroot/schema/flinkiso-on-premise.sql. If you are using phpMyAdmin, go to https://your_ip/phpmyadmin and import the file.
See Documentation for more details.

Step 4 : Update Email SMTP Configuration

Go to your_directory/flinkiso/app/Config/Email.php
Update class EmailConfig { } with your email's SMTP credentials. Provide values for all three options viz: $default, $smtp & $fast.



Step 5: Directory Permissions

Following directories must have full read-write-execute permissions.

  • app
    • tmp - Recursive
      • logs
      • sessions
      • tests
      • cache
        • views
        • models
        • persistent
    • Controller
    • Model
    • View
    • webroot
  • lib
    • Cake/Cache - Recursive

 

In most of the cases, changing these settings will start the application without any issues. Incase you face any issues and unable to debug & resolve them, you can opt in for our installation service @ USD 150.


Step 6: Setup Application

In order to start using the application, you must first run the registration locally. To do that go to:
http(s)://< your server address >/< flinkiso_directory >/users/register page.
Enter the exact same Email Address which you are used to register on FlinkISO website during the download processs, and click "Proceed". This will complete your installation process and redirect you to the Login Page. Your email address is your username and password. You can change this password after login through "Change Passoword" link.

Optional Instructions: These instructions are not mandatory if you are using MAMP or XAMPP

  1. Enabling mod_rewrite on apache: $ sudo a2enmod rewrite
  2. Restart apache: sudo service apache2 restart
  3. Installing mod_header: sudo a2enmod headers
  4. Install mbstring: sudo apt-get install php<your php version>-mbstring
  5. Restart apache: sudo service apache2 restart

Configure rewrite module form https.conf, in ubuntu/linux it apache2.conf: sudo vi /etc/apache2/apache2.conf

For users having Apache 2.4 and above, you need to modify the configuration file for your httpd.conf or virtual host configuration to look like the following: Restart Apache: sudo service apache2 restart

Install mysql extension for php: sudo apt-get install php<your php version>-mysql
Restart Apache: sudo service apache2 restart

Adding XML modules: sudo apt-get install php<your php version>-xml

Adding mcrypt module: sudo apt-get install mcrypt

Adding directive to: vi /etc/apache2/apache2.conf

Update: /etc/mysql/mysql.conf.d/mysqld.cnf
sql_mode = "STRICT_TRANS_TABLES, NO_ZERO_IN_DATE, NO_ZERO_DATE, ERROR_FOR_DIVISION_BY_ZERO, NO_AUTO_CREATE_USER, NO_ENGINE_SUBSTITUTION"

Restart apache.

Adjust PHP config from sudo vi /etc/php/<your php version>/apache2/php.ini

Adjust these values as per restrictions you may want to add to your PHP application and then restart apache.

What Clients Say?
Testimonials

The FlinkISO Online System certainly has revolutionized our business, it certainly allows us to work "smarter, not harder".

The online tracker, database, reports and graphs etc, have outperformed our initial system.

All the documentation is accessible at the press of a button, needless to say we are proud to be affiliated with you and with this level of professionalism.

Mrs. V. Donjeany
LEPRO Corporation CC, South Africa.


We have been using FlinkISO as our Quality Management Software for the past few years and we are extremely satisfied with the software and services offered.

The support team installed the software for us and worked with us to customize our Quality Management website which made the transition from a paper-based system to an online one effortless.

They always respond promptly to any questions or inquiries and have processed our web customization requests with speed and reliability.

I would highly recommend their services.

Priyangi Perera
Pro-Lab Diagnostics, Round Rock, Texas.

Siemens Ltd.
lepro pro-labs univida acekraft wello solidus honix htsi


Choose

  •  

    On Cloud

    Start your 45 days On-Cloud QMS trial. No payment required. One free training session included. Live chat & email support.

    Register
  •  

    On Premise

    Download Free Quality Management Software On-Premise Edition. Installation, Training, Support Services on-demand.

    Free Download