Installing KnowledgeTree on IIS and Windows 2008

From KnowledgeTree Community

Jump to: navigation, search

Contents

Description

The following post provides detailed instructions on how to configure KnowledgeTree to run with IIS 7.0 on Windows 2008, using Zend Server.

Requirements

  • KnowledgeTree 3.6.X Stack Installer
  • Zend Server Installer
  • Microsoft Windows Server 2008
  • A pre-installed IIS 7.0 Server

Instructions

1. Install KnowledgeTree Stack

Install the KnowledgeTree Stack onto the target server. For more details please see the KnowledgeTree Installation Guide -

http://docs.knowledgetree.com/manuals/ig

2. Disable Apache

Before switching to IIS you should disable the Apache server installed by the KnowledgeTree Stack Installer.

1) Browse to Control Panel, Administrative tools

2) Open Services

3) Locate the KTApache service

4) Right-click on the service and select Stop

5) Right-click on the service and select Properties

6) On the General Tab select Disabled from the Startup type drop-down menu

3. Install Zend Server

1) Download Zend Server Installer http://www.zend.com/en/products/server/downloads

2) Run the installer;

3) Choose a Typical Install when prompted;

4) When prompted to select a Web Server to install to, select Configure installation for existing IIS Web Server;

5) Browse to the Zend Server Control Panel (Default: http://localhost/ZendServer);

6) Complete the installation by setting a your password on the Control Panel;

Note: If you do not have a license leave the Order Number and License Key fields empty and select Enter without a license

4. Configure Web Root

You should now have a functioning Zend Server installation running on IIS. To get KnowledgeTree up and running on this server, you'll need to configure a new Virtual Directory.

NOTE: Please ensure that you adhere to security best practices when configuring your IIS server.


1) Browse to Control Panel, Administrative tools;

2) Open Internet Information Services Manager;

3) Right-click on Default website on the left-hand panel;

4) Select Add Virtual Directory;

You should now be prompted for a virtual directory alias and location.

5) Enter 'knowledgeTree' as the Alias;

6) Select the KnowledgeTree Source directory as the physical path (Default: c:\Program Files\ktdms\knowledgeTree). 

 <path to KnowledgeTree Installation>\knowledgeTree\

5. Configure File System Permissions

Now that you have created a Virtual Directory for KnowledgeTree you will need to ensure that file system permissions are correctly set.

1) Give IIS write access to the KnowledgeTree Var directory:

- a) Browse to the KnowledgeTree installation directory (Default: C:\Program Files\ktdms\);

- b) Right-click on the var folder (Default: C:\Program Files\ktdms\var);

- c) Select Properties from the menu;

- d) Select the Security tab;

- e) Select Edit;

- d) Give the Users group the Write permission.


2) Give IIS write access to the KnowledgeTree Documents directory:

- a) Browse to the KnowledgeTree installation directory (Default: C:\Program Files\ktdms\);

- b) Right-click on the Documents folder (Default: C:\Program Files\ktdms\Documents);

- c) Select Properties from the menu;

- d) Select the Security tab;

- e) Select Edit;

- d) Give the Users group the Write permission.

You should now be able to browse to the KnowledgeTree Web Interface and log in. (Default: http://localhost/knowledgeTree/)

6. Configuring the Task Scheduler

The task scheduler is required for a number of background tasks, including full-text indexing, bulk downloads and reporting.

1) Disable the KnowledgeTree Scheduler

- a) Browse to Control Panel, Administrative tools;

- b) Open Services;

- c) Locate the KTScheduler service;

- d) Right-click on the service and select Stop;

- e) Right-click on the service and select Properties;

- f) On the General Tab select Disabled from the Startup type drop-down menu.


2) Modify the Scheduler Batch File:

- a) Browse to the KnowledgeTree bin directory (Default: C:\Program Files\ktdms\bin); 

\<Path to KnowledgeTree Installation>\ktdms\bin

- b) Open schedulerTask.bat in a text editor;

- c) Overwrite the content in the file with the following: 

 @echo off
 setlocal
 cd "C:\PROGRA~2\ktdms\knowledgeTree\bin"
 "php" -Cq scheduler.php


3) Apply a patch to scheduler.php;

- a) Locate scheduler.php (Default: c:\Program Files\ktdms\knowledgeTree\bin) 

\<Path to KnowledgeTree installation>\knowledgeTree\bin

- b) Download the patched Scheduler file: http://kt-download.s3.amazonaws.com/customer-files/scheduler.zip

- c) Extract the archived sheduler.php over the existing version in the following directory: 

\<path to KnowledgeTree installation>\knowledgeTree\bin\


4) Set the path to PHP:

- a) In the KnowledgeTree Web Interface, browse to Administration  » System Configuration  » General Settings;

- b) Locate the section called External Binaries;

- c) Set the PHP binary path to the following just 'php';

- d) Click on Save to save the setting.


5) Set the Root URL:

- a) In the KnowledgeTree Web Interface, browse to Administration  » System Configuration  » General Settings;

- b) Locate the section called KnowledgeTree;

- c) Change the Root Url value to the URL path of your KnowledgeTree server; 

E.g. if your server is http://localhost/knowledgeTree, set the value to '/knowledgeTree'

- d) Click on Save to save the setting.


6) Create a Windows Scheduler task:

- a) Browse to Control Panel, Administrative tools;

- b) Open the Task Scheduler;

- c) Click Create basic task;

- d) Enter a task name and description, then click Next;

- e) Set the task to run Daily, then click Next;

- f) Set the task to recur every 1 day(s), then click Next;

- g) Select Start a program, then click Next;

- h) Click Browse and locate the KnowledgeTree Scheduler executable: 

\<KnowledgeTree Directory>\bin\schedulerTask.bat

- i) Click Next then Finish;

- j) Right-click on the task and select Properties;

- k) On the General tab, select Run whether user is logged in or not;

- l) On the Triggers tab, edit the Daily trigger;

- m) Select Repeat task every: and set the frequency to 10 minutes, then click OK;

- n) Click OK to save the task's properties and enter the Administrator password when prompted.

Configuring Bulk Downloads Feature

1) In the KnowledgeTree Web Interface, browse to Administration  » System Configuration  » General Settings

2) Locate the section called Export

3) Set Use Bulk Download Queue to false

4) Click on Save to save the setting.

Retrieved from "http://www.knowledgetree.org/Installing_KnowledgeTree_on_IIS_and_Windows_2008"
Personal tools