Manual Apache server configuration

This topic contains instructions on how to configure Apache server manually to work with Corporate App Catalog. Follow these instructions if installation via the setup wizard has completed with any errors, or if you already have your own Apache server of version 2.4 or later installed.

We recommend that you use a SSL connection when working with Apache server to ensure the required security level. To use the SSL connection, enable SSL support and configure SSL connection parameters in the configuration file of your Apache server. For more information, please refer to the Apache server documentation.

To configure Apache server manually:

  1. Open the %WebInterfaceDir%\htdocs folder, where %WebInterfaceDir% is the path to the Apache server installation folder.
  2. Copy this folder's content to the DocumentRoot folder specified in the DocumentRoot directive in the Apache server configuration file. This configuration file is located at %ServerRoot%\conf\httpd.conf, where %ServerRoot% is the path to the Apache server installation folder. Usually, the DocumentRoot directive is set to %ServerRoot%\htdocs.
  3. Copy the mod_kscwc.so file from the installation folder to the folder containing Apache server modules (usually, it is the %ServerRoot%\modules folder).
  4. Create an empty file with the kscwc name and save it to the cgi-bin folder (usually, it is the %ServerRoot%\cgi-bin folder). If the cgi-bin folder is not created, create it and grant read permissions for files in this folder to Apache server.
  5. Make sure that the option to load the mod_mime.so and mod_dir.so modules is enabled in the Apache server configuration file. These modules are included in the Apache server installation package. If downloading the mod_mime.so and mod_dir.so modules is not enabled, add the following strings to the configuration file or remove comment symbols for them:
    • LoadModule mime_module modules/mod_mime.so
    • LoadModule dir_module modules/mod_dir.so
  6. In the Apache server configuration file, enable the option to load the mod_kscwc.so module by adding the following string:
    • LoadModule kscwc_module modules/mod_kscwc.so
  7. In the Apache server configuration file, set the following parameters for the DocumentRoot folder:
    • Options Indexes FollowSymLinks Includes
    • DirectoryIndex index.shtml
    • AddType text/html .shtml
    • AddOutputFilter INCLUDES .shtml
    • AddDefaultCharset utf-8
  8. In the Apache server configuration file, set the following parameters for the cgi-bin folder:
    • Options +ExecCGI
    • SetHandler kscwc-script
  9. Add the following string to the end of the Apache server configuration file:
    • FastCgiExternalServer "<Path_to_folder_cgi-bin>/kscwc" -host localhost:9000

      where localhost:9000 is the address for connecting to Apache server.

    When writing the path to the cgi-bin folder, you must use slashes (not backslashes). For example, the path to c:\apache\cgi-bin should be specified as c:/apache/cgi-bin, and the following string should be written to the configuration file: FastCgiExernalServer "c:/apache/cgi-bin/kscwc" -host localhost:9000.

  10. Open the system registry and go to the following section:
    • HKEY_LOCAL_MACHINE\SOFTWARE\KasperskyLab\Components\34\CSWebInterface\1.0.0.0
  11. Add the following keys to this section:
    • "TotalChilds"=dword:0000000a

      Specifies the number of commands executed by Apache server.

    • "Listen"="localhost:9000"

      Specifies the address and port used by Apache server to connect to Corporate App Catalog.

    • "ServerAddr"="localhost"

      Specifies the address of Kaspersky Security Center server used by Corporate App Catalog to send requests to Kaspersky Security Center.

    • "ServerPort"="13000"

      Specifies the port number of Kaspersky Security Center server used by Corporate App Catalog to send requests to Kaspersky Security Center.

    • "InstallPath"="C:\\Program Files\\Kaspersky Lab\\Kaspersky Security Center Web-Console\\"

      Specifies the path to the folder with xsl. files.

    • "TraceLevel"=dword:00000000

      Specifies the event log detail level (0 – do not log events, 5 – log all events).

    • "SessionTimeout"=dword:00015180

      Specifies the maximum length of inactive session. The count is started from the time of the last request.

    • "StdinMaxReadSize"=dword:0000ffff

      Specifies the maximum length of HTTP requests to Apache server. The key is used to protect Apache server from too long requests.

    • "ListenQueueBacklog"=dword:000000c8

      Specifies the size of queue of user requests that are waiting for processing. This parameter is crucial at the peak workload. If the number of user requests exceeds the parameter value, the "Server not available" error message will appear to users. The default value is c8(200).

  12. Restart Apache server (the server name is Apache2.4).
  13. Create a License Agreement file (eula.txt or eula.html) and, if necessary, a FAQ file (faq.txt or faq.html). Copy these files to the Apache server installation folder (to the htdocs\help subfolder).

Page top