1.4 VHost Config Change

From OpenLiteSpeed Wiki

Revision as of 20:17, 28 August 2014 by Marmstrong (talk | contribs)

OpenLiteSpeed 1.4 features a change in where virtual host configuration files are stored by default.

Old configuration structure

In OpenLiteSpeed versions before 1.4, virtual host configuration files were stored by default in separated directories under /usr/local/lsws/. These directories were considered the virtual host root and often had a separate conf/ directory within them.

Virtual host "Example", for example, has the virtual host root /usr/local/lsws/Example/. Example's configurations are then stored in /usr/local/lsws/Example/conf/vhost.xml.

This could cause problems with the WebAdmin console if the WebAdmin user (lsadm) did not have access to these directories. Giving the WebAdmin console access to these directories, though, can be a security hole.

New configuration structure

To fix this, starting with OpenLiteSpeed 1.4, we have moved the default location for virtual host configuration files to directories under /usr/local/lsws/conf/vhosts. Non-configuration virtual host files (such as scripts and static content) are still found under the virtual host root.

For example, the main configuration file for virtual host "Example" is now in /usr/local/lsws/conf/vhosts/Example/vhost.conf. Other configuration files, such as passwords, groups, and realms should also be placed here. Scripts, static content, and other files are still found in Example's virtual host root — /usr/local/lsws/Example/.

We recommend that all users use this structure.

Upgrading from 1.3.x to 1.4.x

Configuration files are not moved when you upgrade from 1.3.x to 1.4.x. We recommend, though, that users move their virtual configuration files to this file layout.