Installing Faveo Helpdesk Freelancer, paid and Enterprise on Windows

Installing Faveo Helpdesk Freelancer, paid and Enterprise on Windows

Ubuntu

Faveo can run on Windows Server.

Prerequisites

Faveo depends on the following:

  • IIS
  • PHP 7.3+
  • MariaDB 10.3+
  • Task Scheduler+
  • Utility Tools WinRar.

Step 1: Install IIS server

To install IIS Server open Server Manager and locate the Manage button on top right corner click on it and select -> Add Roles and Features

  • A wizard will open disaplying the overview click on next and under “Installation Type” select Role-based and Feature-based installation and select next. Leave the deafult in “Sever Selection” and click next. Now under “Server Roles” search and enable checkbox for “Web Server IIS” and click on Add Features window and proceed by clicking next.

    • In “Features” section locate the .NET Framework 3.5 and .NET Framework 4.7 select the packages as show in the below image.

Features_selection Click next -> next -> thrice to confirm the settings and finally click on Install . It will get the IIS installed on the server. To verify the installation, you can type the following url in the browser

http://localhost

Step 2: Install PHP-7.3

  • To make the installation easy and smooth, we will be using Web platform Installer. It is a special tool provided by Microsoft for quick installation of most of our requirement. You can download from following link and install it.

Click here to download Web platform installer

  • After installation locate “Tools” in the Server Manager Dashboard on the top right corner click on it and select “Internet Information Services (IIS) Manager”
  • Now in the Left Pane of the IIS Manager window select your server then you will find the “Web Platform Installer” if it is installed from the previous step.
  • Open the Web Platform Installer and search the following Extensions to add.

    PHP 7.3
    URLRewrite
    MySQL Connector/Net

  • Click on install and accept the license agreement the installation should take few minutes to complete.

  • Download and install PHP Manager from the below link
  • Click here to download PHP Manager

  • Extract the ZIP file and install PHP Manager.

Step 3: Install MariaDB-10.3

  • Download and install MariaDB-10.3 from the official MariaDB website. “https://downloads.mariadb.org/mariadb/10.3.13/”

  • Execute the installer and peform the required installation steps and set the root password.

Step 4: Copy and Enable cacert.pem file in php.ini.

This is required to avoid “cURL 60 error” which is one of the Probes that Faveo checks. In other words this is a neccessary step to run Faveo on IIS Server.

- Step 4(a)

Download and Extract the “cacert.pem” file and copy it to the PHP root directory. Usually found in the below mentioned location. If it is differnt in your server copy it to that location.

(C:\Program Files\PHP\v7.3)

Click here to download cacaert.pem file

- Step 4(b)

Edit the php.ini file which is found inside the PHP root directory. Uncomment and add the location of cacert.pem to “curl.cainfo”.

curl.cainfo = "C:\Program Files\PHP\v7.3\cacert.pem"

Note: The location of PHP 7.3 in IIS Server is following. You will need this location to add extensions in your websites.

Step 5: Install Ioncube Loader

- Step 5(a)

Download the Ioncube loader from the below link and extract

Click here to download IonCube

- Step 5(b)

  • Copy the “ioncube_loader_win_7.3.dll” from extracted Ioncube folder and paste it in PHP extension diectory. which can be found here “C:\Program Files\PHP\v7.3\ext"

ioncube-dll

  • Copy the “loader-wizard.php” from the extracted Ioncube folder and paste it in the IIS Root Directory. which can be found here “C:\inetpub\wwwroot"

loader-wizard

Step 6: Configure the php.ini file.

  • Add the below line in your php.ini file to enable Ioncube.
zend_extension = "C:\Program Files\PHP\v7.3\ext\ioncube_loader_win_7.3.dll"
  • Make sure the below lines present in the php.ini file if not add or uncomment the respective lines.
extension=php_mysqli.dll
extension=php_pdo_mysql.dll
extension=php_ldap.dll
extension=phpfileinfo.dll
  • Run the below URL to verify the ionCube Installation. Note: If you didn’t get the below output try restarting the IIS Server.
localhost/loader-wizard.php

Step 6: Faveo Installation

Once all the above softwares are installed:

1. Upload Faveo Please download Faveo Helpdesk from https://billing.faveohelpdesk.com and upload it to below directory

c:/inetpub/wwwroot/

2. Give Permissions to the Faveo folder

We need to give full write permission to “IIS_IUSRS” and “Users” for wwwroot folder.

c:/inetpub/wwwroot/

3. Configure Faveo in IIS Manager.

  • Open IIS Manager and in the left pane explore till you find default_website select it and in the right pane you will see the “Basic Settings” option click on it and set the Pyhsical Path value to “%SystemDrive%\inetpub\wwwroot\public”

4. Configure web.config file for IIS

Open notepad and copy the below and the save the file under c:\inetpub\wwwroot\public as web.config and make sure while saving you select all file types otherwise you will end up having the file as web.config.txt which is not acceptable because the file type should be “CONFIG File”.

<?xml version="1.0" encoding="UTF-8"?>

<configuration>

    <system.webServer>

        <rewrite>

            <rules>

                <rule name="Imported Rule 1" stopProcessing="true">

                    <match url="^" ignoreCase="false" />

                    <conditions logicalGrouping="MatchAll">

                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />

                        <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />

                    </conditions>

                    <action type="Rewrite" url="index.php" />

                </rule>

            </rules>

        </rewrite>

    </system.webServer>

</configuration>

5. Setting up the Database.

Open MariaDB 10.3 Command Line Client and run the below commands.

Create a database called ‘faveo’.

CREATE DATABASE faveo;

Create a user called ‘faveo’ and its password ‘strongpassword’.

CREATE USER 'faveo'@'localhost' IDENTIFIED BY 'strongpassword';

We have to authorize the new user on the faveo db so that he is allowed to change the database.

GRANT ALL ON faveo.* TO 'faveo'@'localhost';

And finally we apply the changes and exit the database.

FLUSH PRIVILEGES;
exit

6. Configure IIS webserver

To Open the Faveo on your domain , you must set the binding. Go to Bindings option on right pane and select “HTTP” and edit the hostname to your concern.

Now you can open the browser and enter the IP or Domain Name to open Faveo

7. Install Faveo

Now you can install Faveo via GUI Wizard or CLI

Step 7: Configure Task Scheduler

To open Taskscheduler press ctrl + R and Type “taskschd.msc”.

To Setup Schedule task for Faveo. Open Task scheduler on server and follow this steps

On the Right pane of Task scheduler select “create basic task” and enter a name for the task and click next.

Under Trigger section select daily and click next and leave the default values in daily section and proceed next.

Now under Action section select start a program and click next and in Start a program copy the below value in to the program/script field.

C:\Windows\System32\cmd.exe

Add following value in Argument :

/c php "c:\inetpub\wwwroot\faveo\artisan" schedule:run

Finally under Finish section select the checkbox to open the properties window after finish and click finish button.

In the properties window select the Triggers tab and click on Edit and select the checkbox for “Repeat task every” and set values to run every 5 minutes for indefinitely and click on OK.

Select the schedule and click Edit and set the cron to run every 10 minutes. You can change according to your needs.

Step 8: SSL Installation

Secure Sockets Layer (SSL) is a standard security technology for establishing an encrypted link between a server and a client. Let’s Encrypt is a free, automated, and open certificate authority.

This is an optional step and will improve system security and is highly recommended.

Let’s Encrypt SSL installation documentation

Step 9: Final step

The final step is to have fun with your newly created instance, which should be up and running to http://localhost or the domain you have configured Faveo with.

Updated: