Installation Manual For Free On-Premise Lite Users (Multiple Servers)

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

 

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:
public $default = array(      "datasource" => "Database/Mysql",      "persistent" => false,      "host" => "localhost",      "login" => "add your username",      "password" => "*********",      "database" => "flinkiso",      "prefix" => "",      "encoding" => "utf8", );

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.


class EmailConfig {   public $default = array(     "transport" => "Mail",     "from" => array("noreply@flinkiso.com" => "FlinkISO"),     //"charset" => "utf-8",     //"headerCharset" => "utf-8", );   public $smtp = array(     "transport" => "Smtp",     "from" => array("your_email@your_domain.com" => "FlinkISO"),     "host" => "your_host",     "port" => 465,     "timeout" => 30,     "username" => "username",     "password" => "********",     "client" => null,     "log" => false, );   public $fast = array(   "from" => "your_email@your_domain",     "sender" => null,     "to" => null,     "cc" => null,     "bcc" => null,     "replyTo" => null,     "readReceipt" => null,     "returnPath" => null,     "messageId" => true,     "subject" => null,     "message" => null,     "headers" => null,     "viewRender" => null,     "template" => false,     "layout" => false,     "viewVars" => null,     "attachments" => null,     "emailFormat" => null,     "transport" => "Smtp",     "host" => "your_host",     "port" => 465,     "timeout" => 30,     "username" => "username",     "password" => "********",     "client" => null,     "log" => true,     //"charset" => "utf-8",     //"headerCharset" => "utf-8", );

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

<Directory /> Options FollowSymLinks AllowOverride All </Directory>

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: <Directory /var/www/> Options FollowSymLinks AllowOverride All Require all granted </Directory> 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 <Directory /usr/share/phpmyadmin> Options SymLinksIfOwnerMatch DirectoryIndex index.php AllowOverride All . . </Directory>

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

max_execution_time = 300 max_input_time = 600 post_max_size = 80M upload_max_filesize = 200M Adjust these values as per restrictions you may want to add to your PHP application and then restart apache.