Chapter 2. Preparing the system

In order to use the WebIssues system, it's necessary to configure a server which is its central and most important part. This chapter describes a step-by-step process of installing the WebIssues server and preparing it to work. If you use an already existing server, you can skip this chapter. For more information on updating the system to a new version refer to the section called “Updating the system”.


You can install WebIssues server software on a computer with Unix/Linux, OS X or Windows operating system. Before installing you will need the following components:

  • A web server

  • A database server

  • PHP

You can use the Apache web server that runs on almost all operating systems (version 2.0 or later is recommended). You can also use the Microsoft IIS server which is part of Windows (version 7.0 or later is recommended).

One of the following database servers is required:

  • MySQL (version 5.0.15 or newer)

  • PostgreSQL (version 8.0 or newer)

  • Microsoft SQL Server (version 2005 or newer)

In order to install the system, you must create a database on one of these servers and a user account with sufficient permissions to create tables and indexes in the database.

In case of MySQL, support for the InnoDB engine is required. In case of PostgreSQL, the database should be created with Unicode character encoding. The SQL Server database can only be used if the WebIssues server is installed on Windows.

The WebIssues server also requires PHP, version 5.2.1 or newer, integrated with the web server. In case of IIS server, to get the best performance it's recommended to use the fastcgi module and the wincache extension. PHP must also have the mbstring extension installed and enabled in php.ini, and if you're using a MySQL or PostgreSQL database, also the mysqli or pgsql extension, respectively. In case of a SQL Server database, since version 5.3.15 and 5.4.5 of PHP, the com_dotnet extension must be enabled.

If you're installing the WebIssues server using an external web hosting service, make sure that it meets all these requirements. To create a database and configure the web server, use the tools provided by hosting provider and refer to the available documentation.


Some hosting services may have a specific configuration or other restrictions which make it difficult or even impossible to correctly install WebIssues server. They may, for example, limit the amount of available memory, the database size, or the size of files uploaded to the server.

Installing WebIssues on a server with the mod_security module enabled may cause problems. Depending on the configuration, it may prevent the Desktop Client from accessing the server or block legitimate requests containing certain words. It is recommended to disable mod_security completely or disable the rules that cause problems. For more information, please visit

Before installing the WebIssues server, install and configure the necessary components, and then create a database using the appropriate administrative tools. Refer to the documentation of these tools to get more information about them. More information about creating databases and configuring the web server can be found at