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. 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<8 folders.
lib folders supports the latest version PHP8+ and
lib<8 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:
- Linux/ Windows Server
- Static IP or Host ONLYOFFICE at your premise
- Apache or IIS
- MySQL
- PHP
- cURL enabled
- mod_rewrite/ mcrypt/ xml modules
- wkhtmltopdf
- PDFtk
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).
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
- Controller
- Model
- View
- webroot
- lib
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
- Enabling mod_rewrite on apache: $ sudo a2enmod rewrite
- Restart apache: sudo service apache2 restart
- Installing mod_header: sudo a2enmod headers
- Install mbstring: sudo apt-get install php<your php version>-mbstring
- 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.
