1. Open IIS Manager.
2. Select the website with KMP.
3. Double-click on "Request Filtering".
   
   
   
   
4. Select "Rules".
   
   
   
   
5. Click "Edit Feature Settings".
   
   
   
   
6. In the dialogue window that opens you can see the "Maximum allowed content length" field. It is set to 30 million bytes by default, which allows you to upload files up to almost 30MB. Let's say we want our files to be up to 1GB, then we would need to put "1073741824" there (this number equals 1GB exactly).
   
7. Also make sure that the "Allow double escaping" option is enabled. It must be enabled for correct downloading of files which names contain a space character.
8. Click OK. The new setting is usually applied without restarting IIS.
   
   

To insert the search box, you need to put this HTML code somewhere on your website:

Then URL that you need to put instead of the highlighted text is this:

if this URL doesn't work, try this instead:

Actual PHP versions work with IIS via FastCGI interface. We will explain how to install FastCGI and configure it to work with PHP.

• Installing the FastCGI Extension for IIS 7
• Windows Server
• Windows 7 and Windows Vista SP1
• Download and Install PHP
• Configure IIS 7 to Handle PHP Requests
• Using IIS Manager
• Setting FastCGI Configuration for Optimal Performance
• Configure default document in IIS
• Testing PHP CGI

Installing the FastCGI Extension for IIS 7 / IIS 8

Windows Server

Add the CGI role service by going to Server Manager -> Roles -> Add Role Services. This enables both the CGI and FastCGI services:

Windows 7 and Windows Vista SP1

Add the CGI feature by going to Control Panel -> Programs and Features -> Turn Windows features on or off. This enables both the CGI and FastCGI services.

Download and Install PHP

1. Download a PHP package for Windows 
   You need the latest version of PHP v5.6 family. Choose ZIP package VC11 x86 Non Thread Safe.
   
   Warning Box Title
   

   Please note that PHP v7.* and x64 versions are not supported at this time.

2. Extract the contents of PHP zip package to a folder on your server, e.g. C:\PHP\
3. Make a copy of the php.ini-production file and name it php.ini
4. Open the php.ini and setup the following parameters. Every parameter already exists in the php.ini and you just need to find it, uncomment (by removing ";" character from the beginning of the line), and change its value. Make sure that you do not have one of these options specified twice in the php.ini file.
   

   memory_limit = 256M
   post_max_size = 128M
   extension_dir = "C:\PHP\ext"
   upload_tmp_dir = "C:\PHP\upload"
   upload_max_filesize = 128M

   max_execution_time = 600
   max_input_time = 600
   max_input_vars = 2000

   cgi.force_redirect = 0
   cgi.fix_pathinfo = 1
   fastcgi.impersonate = 1

   extension=php_curl.dll
   extension=php_mbstring.dll
   extension=php_exif.dll
   extension=php_gd2.dll
   extension=php_ldap.dll
   extension=php_mysqli.dll
   
   session.save_path = "C:\PHP\session"

   session.use_cookies = 1

   Extensions Loading Order
   

   It is required to load "php_mbstring.dll" extension before "php_exif.dll". Make sure that order of extensions in your php.ini is the same as shown above.

5. Create "upload" and "session" sub-directories in the C:\PHP\ directory. You can use different names, just make sure that they match upload_tmp_dir and session.save_path parameters that you've set in the php.ini.
6. Setup date.timezone parameter in php.ini, for example:
   
   date.timezone = "America/New_York"
   

   Chose your city or at least a city from your time zone.

   You can find the full list of possible date.timezone values on PHP.net website.
   
   
7. Save the php.ini.
8. To test if the PHP installation is successful, run the following from the command line prompt:
   
   C:\PHP>php -i
   
   
   If PHP Fails to Start

   VC9 Versions are compiled with the Visual Studio 2008 compiler and have improvements in performance and stability. The VC9 versions require you to have the Microsoft 2008 C++ Runtime (x86)  or the Microsoft 2008 C++ Runtime (x64)  installed. You may need to download these extensions on old versions of Windows if PHP is unable to start.

Testing PHP CGI

After installing the FastCGI extension, and registering and configuring the PHP CGI, you can use KMP normally.

Restart the IIS server to apply all changes that you've made.

To test, create and request an info.php page in your site that contains the following:

You see something like: 

Note that the Server API indicates that PHP is hosted in FastCGI mode.

The remote installation API helps with fast deployment of new KMP packages. It assumes that all package files are already extracted from the package and uploaded to the remote server, and all necessary file/folder permissions are set.

Contents

• Creating the Request
  
• XML Reference
  
• Sample XML Request
• Sample PHP Request (Using CURL)
  
• A Successful Installation Response
  
• An Erroneous Installation Response
  
• Error Codes
  
• Installation by Shell Script

Creating the Request

Before launching remote installation of KMP copy, make sure that:

• All files are uploaded on the remote server.
• Correct permissions are set.
• Package is not installed yet.

XML Reference

• xml version - XML declaration which specifies the version of XML being used
• methodCall - The root node of the XML document. It outlines your request
• methodName - type of request. It must be "install.setup" for installation request.
• params - This node contains all parameters that you send
• product_key - Product key for KMP. You can get it from your member area.
• db_prefix - Prefix for database tables (optional)
• db_host - Database server address
• db_login - The username of the Database user
• db_password - The Database password for the above user
• db_name - The name of the MySQL database to install the KMP in to
• acc_login - The username of the knowledgebase administrator
• acc_password - The password to assign the KMP administrator account
• acc_first_name - The first name of the knowledgebase administrator
• acc_last_name - The last name of the knowledgebase administrator
• acc_email - The email address of the knowledgebase administrator
• smtp_host - SMTP (mail) server address
• smtp_port - SMTP server port

Sample XML Request

Sample PHP Request (Using CURL and IXR)

The following sample code is written on PHP with usage of CURL functionality.

You can also find this sample in the KMP package: /examples/installation-api/rpc_install.php

Although it uses IXR as XML RPC library (include 'inc/xmlrpc.php') it is just a sample, and you may use any library suitable for you.

A Successful Installation Response

A successful installation response has the following format.

<?xml version="1.0"?>
<methodResponse>
  <params>
    <param>
      <value>
        <string>Installation completed successfully</string>
      </value>
    </param>
  </params>
</methodResponse>

An Erroneous Installation Response

If an error occurred during installation or server doesn't meet KMP requirements, you will get an erroneous installation message. It includes error code and error message with information why installation cannot proceed.

<?xml version="1.0"?>
<methodResponse>
  <fault>
    <value>
      <struct>
        <member>
          <name>faultCode</name>
          <value><int>-101</int></value>
        </member>
        <member>
          <name>faultString</name>
          <value><string>Not all parameters specified. Following parameters are required: acc_login, acc_password, acc_first_name, acc_last_name</string></value>
        </member>
      </struct>
    </value>
  </fault>
</methodResponse>

Error Codes

The table below outlines all possible error messages for faultCode attribute.

Error Code	Message
-101	Not all parameters specified. Following parameters are required: [list of parameters]
-201	Your PHP version is not compatible. Current PHP version is [current version]. Required version: [required version]
-202	Some of the required modules are missing: [list of missing extensions]
-203	Some of the required custom checks has been failed: [list of custom checks]
-301	File system permissions are incorrect: [list of files with incorrect permissions]
-401	Can not connect to database server
-402	Can not select database
-403	Unknown error while database connection
-410	MySQL error when executing sql dump: [mysql error]
-411	MySQL error when executing sql dump for administrator's account: [mysql error]
-501	Error when setup configuration file
-502	Error when setup file [file name]
-601	Wrong license key
-701	Unable to run installation process because KMP has been already installed

Installation by Shell Script

Installation shell script supports installation of KMP from UNIX shell. Before starting the script:

• Check that server meets the KMP requirements
• Upload files from the KMP package on server
• Setup correct permissions
• Create an empty database for KMP
• Specify correct installation details including database connection parameters, administrator account details, etc in the installation script

To translate it you just need to create your own rating form at Customization > Custom Rating Forms. You can specify the replacement for "Rate It!" text at the second wizard step:

Then you can set this form on your front-end at Customization > Styling and Front-end Settings > Article

New settings will be applied to the current category anyway, so the first checkbox is disabled.

Three other checkboxes allow you to apply changes to child articles, subcategories, and articles in subcategories.

The "add groups" and  the "replace groups" options have different effect on child objects.

If you choose "add groups", the list of groups that have access to child articles/categories will be modified according to your changes. Let's see that on example:

Let's say we have a category. "Group B" and "Group C" have access to it.

We remove "Group C" and add "Group A".

Save it and get a confirmation.

We want to apply changes to all articles from this category with "add groups" option and click OK.

Before applying these changes we had an article in this category. Look at its "Access" column:

Due to the option "add groups", "Group C" is no longer have access to the article, and "Group A" obtains the access.

Notice that, since we haven't changed access for "Group B" and "Group D" when we edited category permissions, these two groups have the same access to this article: "Group B" didn't have access before and doesn't have it now, and "Group D" still has access to this article.

If we'd selected "replace groups" option, child article would have the same permissions as its parent category. Current category permissions are copied to the child objects (articles, subcategories, and/or articles in subcategories) selected in the confirmation window when you select "replace groups" option.

 Setup Instructions

1. Go to the "LDAP Settings" section in Administration > General Settings.
2. First of all tick the "Enable LDAP Authentication" checkbox to start and select a LDAP platform.
   
   
   
   
3. Specify correct LDAP host and port.
   
   
   LDAP Host and Port
   

   Double check these settings because application may freeze for 10 minutes if you try to connect to nonexistent LDAP server. 

   
   
   
   LDAPS (LDAP via SSL)

   If you would like to enable LDAPS (LDAP via SSL) you may need to follow the instructions in this guide (for IIS and Apache on Windows 2003/2008).

4. Specify additional connection settings.
   If your LDAP server hold references to other servers you may want to enable "Allow Follow Referrals" option.
   Enable "LDAP Version 3" option if you would like to use LDAPv3 protocol.
   The "Negotiate TLS" option allows establishment of Transport Layer Security on the connection.
   
   
   
   
5. If you would like to get users by certain parameters, you may want to modify the "Search String" value. Otherwise, left the default value.
   
   
   
   
6. Usually "Base DN" consists of two parts: OU (Organizational Unit, "company" in our example), and dc (Domain Component, "example" and "com" in our example; if your LDAP server name includes more domain levels, there will be more dc's).
   You may not specify OU and get full tree of directory groups then.
   
   Object Unit
   

   If you specify OU (Organizational Unit), make sure that LDAP users that you want to import belong to this OU as well as their parent groups. Otherwise, they won't be imported.

   

7. Setup username and password for connection on the LDAP server. This user must have permission to see LDAP entries.
   
   
   
   
8. Check the mapping attributes.
   
   
   Mapping Attributes
   

   Remember that LDAP users that you want to import must have all these required attributes: account name, first name, last name, email. Otherwise they won't be imported. Make sure that attributes here in KMP preferences match user attributes on the LDAP server.

   

9. Setup synchronization options.
   If you would like KMP to inactivate user account if he gets deleted from the LDAP server, set the "Disable User When Deleted" checkbox.
   If you would like to synchronize LDAP user details and LDAP groups each time a LDAP user log in, set checkboxes accordingly. If these checkboxes are not set, account and group information will be synchronized upon the first login only.
   
   
   
   
10. Check "Group Mapping Settings".
    A user that belongs to a LDAP group that is not mapped to any KMP group will be assigned to the group set in "Default Group Mapping Action".
    Check the "LDAP Group Member Attribute" to match the group entry that stores a list of group members.
    Check all LDAP settings, click "Save" above and mark the "Enable LDAP Group Mapping" to start mapping.
    
    
    
    
11. You will see the tree of LDAP groups on the left upon successful connection and the tree of KMP groups on the right. Now you need to map some groups from the LDAP server with groups in KMP. Mapping of LDAP group A to KMP group B means that users from LDAP group A will be assigned to the KMP group B.
    Just drag-n-drop a LDAP group to a KMP group to map them. You can map several LDAP groups to one KMP group. Click "Save" above when finished.
    
    
    
    
    
12. After successful mapping you can proceed with one of the two approaches.

• You can go to Users & Groups > Manage Users and click the "Get LDAP Users" button to import LDAP users to KMP immediately. Please note that usage of the "Get LDAP Users" button is not required for successful integration of KMP with your LDAP directory - there is no need to import all LDAP users at once, especially considering limited number of user accounts in KMP. When someone tries to login to KMP and KMP doesn't have this user account in its database, it asks the LDAP server and if a user with these username and password exists on the LDAP server, the account in KMP will be created automatically. Also, "Get LDAP Users" has some limitations due to limits of LDAP servers - they often do not allow to get more than a 1000 users at a time remotely, and if you're using "Get LDAP Users" button while having thousands of users on the LDAP server, you may not find the user that you wanted to import. This doesn't mean that LDAP or KMP functions incorrectly - simply use it another way as specified below:
• Or you can skip the "Get LDAP Users" step and try to login as one of the users from mapped groups. If all settings are correct, you'll be able to login with username and password of this user gotten from the LDAP server. Account in KMP will be created automatically upon login.