List of Directives

The following table lists the various directives in the configuration file.

Name of the directive

Type / Default Value

Significance / Notes

virtual_root_path

Type: String

Default Value: /home/virtual

The base directory for the file system of all the sites on the server.

Do not modify this value.

logfile

Type: String

Default Value: /var/log/ensim/epl.log

The file where the backend messages from the control panel are saved.

import_export_priority

Type: Integer

Default Value: 10

The numeric value indicating the priority of the Export/Import process. This is set to 10, so that the Export/Import process has a lower priority while running to avoid overloading the system.

Do not change this value unless you really want to assign a high priority to the process. A negative value causes the export/import process to run with elevated priority overloading your system.

redirect_protocol

Type: String

Default Value: https

The protocol used by the control panel while redirecting Web pages. The directive is used if you access the control panel using the HTTPS protocol, otherwise, it is ignored.

Do not modify this value.

redirect_port

Type: Integer

Default Value: 19638

The secure port on which Parallels Pro Control Panel responds to HTTPS requests.

If you change this value, make sure that the welcome page index.shtml located at /var/www/html/ and /var/www/html/admin/ are modified to redirect requests to the new port.

gui_logfile

Type: String

Default Value: /var/log/ensim/eplcp.log

The file where messages from the control panel (frontend) are recorded.

gui_pidfile

Type: String

Default Value: /var/run/eplcp.pid

The file containing the process ID (PID) of the running control panel process.

Do not change this value.

server_admin

Type: String

Default Value: root@localhost

The email address of the Server Administrator as indicated by the HTTP directive ServerAdmin, in the configuration file eplhttpd.conf.

See http://httpd.apache.org/docs/2.2/mod/core.html#serveradmin for details.

server_phpmyadmin

Type: String

Default Value: The host name of the Parallels Pro server

The server on which phpMyAdmin is installed. Typically, phpMyAdmin runs on the Parallels Pro Control Panel server, so you don't need to modify this value.

However, modify the directive if you access the control panel using a host name or IP Address that is different from the Parallels Pro Control Panel server, for example, when you access the control panel from a remote location, and the host name / IP address undergoes network address translation. The URL eventually displayed by Parallels Pro Control Panel is http://<server_phpmyadmin>/MyAdmin/index.php

server_domainpreview

Type: String

Default Value: The host name of the Parallels Pro server

The host name of the Parallels Pro Control Panel server on which a domain can be previewed. Parallels Pro Control Panel allows a domain to be accessed using http://<server_name>/<domain_name>/.

Modify this value to a different host name or IP address if you expect to preview the domain using http://<new_host_name>/<domain_name>/ or http://<new_ip_address>/<domain_name>/

maxRequestBodySize

Type: Integer

Default Value: 100 * 1024 * 1024 (100 MB expressed as bytes)

The maximum size (in bytes) of a file that can be uploaded using the File Manager service in Parallels Pro.

cacheRefreshPolicy

Type: Boolean

Default Value: True

True: The Parallels Pro Control Panel server forces the client browsers to reload certain resources every time a page is accessed and to validate certain pages every time it is accessed. This is to ensure that the browser displays customized settings such as skin preferences without requiring the user to manually clear the browser's cache. This also means more HTTP traffic, since the browsers are not allowed to cache resources aggressively. Set this to False if you do not expect your users to change their preferences often.

False: The Parallels Pro Control Panel server allows client browsers to cache resources to reduce HTTP traffic.

See also cacheMustReload, cacheMustVerify, and cacheVerificationDate directives.

cacheMustReload

Type: String

Default Value: .css$

  • If the cacheRefreshPolicy directive is set to True, this directive indicates that certain resources must be reloaded every time a page is accessed.

Notes:

  • This string is expected to be a valid Python regular expression.
    See http://docs.python.org/lib/re-syntax.html for syntax details.
  • Use this variable with care. The browser is not allowed to cache any resource whose URL matches this expression; it is fetched by the browser every time the page loads.
  • As the default value indicates, all the css files (HTML stylesheets) are loaded each time to ensure a consistent experience while changing skin preferences.

cacheMustVerify

Type: String

Default Value: (.gif|.jpg|.jpeg|.png|.bmp)$

If the cacheRefreshPolicy directive is set to True, this directive indicates that certain resources must be revalidated every time a page is accessed in the control panel.

Notes:

  • This string is expected to be a valid Python regular expression.
    See http://docs.python.org/lib/re-syntax.html for syntax details.
  • Use this variable with care. The browser is forced to revalidate each time any resource whose URL matches this expression. The browser may choose to serve these pages from the cache, if the resource has not changed.
  • As the default value indicates, all the image files(GIF, JPEG, PNG, BMP) are re-validated every time to ensure that new images of a skin are loaded by the browser whenever the skin changes.

cacheVerificationDate

Type: String

Default Value: Tue, Jan 04 1977 00:00:00 GMT

The date when the contents of the browser's cache are reviewed for validity. HTTP browser caching works on the principle of URL expiration dates wherein the browser reuses the cache contents till the specified expiration date without sending a request to the server. This date is sent by Parallels Pro for all the resources that match the pattern in the cacheMustVerify directive. To force a re-validation, an expiration date which has been exceeded, should be returned by the server.

honourLookAndFeel

Type: Boolean

Default Value: False

True: When a higher level administrator auto-logs in to a lower level of the control panel, the look and feel of the lower level control panel is retained.

False: When a higher level administrator auto-logs in to a lower level of the control panel, the look and feel of the higher level is retained at the lower level.

In this section:

Modifying the Configuration File

Viewing the List of Directives

Retrieving the Settings of a Directive

Modifying a Directive

Reverting a Directive to Its Default Value