Cluster sites.conf configuration file

From ISPWiki

The cluster_sites.configuration file is required for working with oProxy and the clusterlogs и sitesctl utilities.

Contents 1 Configuration file format 1.1 Account 1.2 WebServer section 1.3 Site section 2 Example

Configuration file format

The cluster_sites.conf configuration file contains sections and their parameters. Each section begins with a key word followed by required parameters and an opening brace, and ends with a closing brace and a semicolon.

 Account "username" "group" {
     Enabled value;
     DefaultIPAddress value;
     MinimumPresence value;
     
     WebServer IP-address {
     };
     
     Site domain_name {
         Enabled value;
         IPAddress value;
         Aliases value;
         DocumentRoot "value";
         AccessLog type "value";
         ErrorLog type "value";
     };
 };
 [...]

Account

Enabled

Defines an account status that may have the following values: yes, no, on and off. The default value is yes.

DefaultIPAddress

Default IP-address for web-sites (WWW domains) for a user account. The default value is 127.0.0.1.

MinimumPresence

Minimum number of nodes that process this account. The default value is 2.

WebServer section

Web-server IP-address is the required parameter in this section.

Site section

Enabled

Defines a web-site (WWW domain) status that may has the following values: yes, no, on and off. The default value is yes.

IPAddress

Web-site (WWW domain) IP-address. The default value is an account DefaultIPAddress.

Aliases

Web-site (WWW domains) aliases. They are not specified by deafult.

DocumentRoot

Web-site (WWW domain) root directory. Not specified by default.

AccessLog

Web-site (WWW domain) access log. Its value should be as follows: "type" - "value". ПNot specified by default.

ErrorLog

Web-site (WWW domain) error log. Its value should be as follows: "type" - "value". ПNot specified by default.

Example

 ...
 Account "example" "example" {
     Enabled yes;
     MinimumPresence 2;
     
     WebServer 10.0.1.1 {
     };
     
     WebServer 10.0.1.2 {
     };
     
     WebServer 10.0.1.3 {
     };
     
     Site example.com {
         Enabled yes;
         IPAddress 82.146.37.210;
         Aliases www.example.com;
         DocumentRoot "/var/www/example/data/www/example.com";
         AccessLog file "/var/www/httpd-logs/example.com.access.log";
         ErrorLog file "/var/www/httpd-logs/example.com.error.log";
     };
 };
 ...