Help:1.4 VHost Config Change

From OpenLiteSpeed
Revision as of 16:29, 28 August 2014 by Marmstrong (talk | contribs) (Upgrading to 1.4.x)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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 commonly stored under the virtual host root.

Virtual host "Example11", for example, might have the virtual host root /usr/home/user11/Example11/. Example11'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. Other virtual host files (such as scripts and static content) can still be put under the virtual host root.

For example, the main configuration file for virtual host "Example11" is now in /usr/local/lsws/conf/vhosts/Example11/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 Example11's virtual host root — /usr/home/user11/Example11/.

We recommend that all users use this structure.

Upgrading to 1.4.x

Your configuration files are not automatically moved when you upgrade from a lower version to 1.4.x. We recommend, though, that users move their virtual host configuration files to this file layout.