Configuring Sitebuilder after Installation

Sitebuilder parameters are configured automatically during installation. During this process, some configuration parameters are defined automatically from your system settings, and some acquire default meanings. If you wish to additionally configure your Sitebuilder after installation, you can do it using the sb_config utility.

Use the sb_config utility if you wish to:

Change some parameters in Sitebuilder configuration file according to your objectives
Change the default database and database user
Adjust the parameters of the Sitebuilder virtual host on Apache web-server
Install and remove Sitebuilder components (language packs and design templates) in the database

To additionally configure Sitebuilder, run the sb_config utility with the necessary configuration keys. The configuration utility is started by root user in the command line mode. The available keys with descriptions are shown in the table below.

Key	Description
--phpcli_path	Path to PHP CLI executable. Default value: `/usr/bin/php5`
--phpcgi_path	Path to PHP CGI executable. Default value: `/usr/bin/php5-cgi`
--update_locales	Update locales. Default value: `no`
--update_templates	Update templates. Default value: `no`
--update_modules	Update modules. Default value: `no`
--migrate_all	Migrate all sites. Default value: `no`
--help	Displays the help message with the current information in the console. Default value: `no`
--verbose	Be verbose. Default value: `no`
--[no]use_rewrite	Enable/disable `mod_rewrite` usage. Default value: `yes`
--sb_admin_passwd	Sitebuilder administrator password. Default value: not changed.
--db_host	MySQL database remote host. Default value: localhost.
--db_port=PORT	MySQL database remote port. Default value: 3306.
--db_admin_name	MySQL administrator username. Default value: `root`
--db_admin_passwd	MySQL administrator password.
--sb_db_user_name	Sitebuilder MySQL username. Default value: `root`
--sb_db_user_passwd	Sitebuilder MySQL password.
--sb_db_name	Sitebuilder database name. If there is no database, it will be created by Sitebuilder. Default value: `sitebuilder3`
--httpd_port	Apache port. Default value: 80
--sb_host_ip	Sitebuilder IP address used for virtual host creation on Apache. Default behavior: Sitebuilder creates Apache virtual host on the IP address it automatically retrieves from the system (command `/sbin/ifconfig`).
--sb_hostname	Sitebuilder hostname used for virtual host creation on Apache. Default behavior: the host name is defined automatically (command `hostname`). Sitebuilder adds the `sitebuilder-` prefix to the defined host name to form a virtual host name (`sitebuilder.`hostname`)`.
--httpd_owner	Apache user and group.
--[no]enable_ssl	Enable/disable SSL. Default value: `no`

Note: Make sure to run sb_config utility every time you have installed or removed Sitebuilder components, such as language packs and design templates. Running sb_config in this case won't re-generate Apache config: the config is regenerated only if major parameters, such as port or SSL option (enabled/disabled), have been changed.

Configuring Sitebuilder virtual host

To create a virtual host for Apache web server, the Sitebuilder server host name and IP address are required. Sitebuilder determines these parameters automatically during installation. It takes the server host name from the output of the command hostname, and adds the sitebuilder- prefix to it to form a Sitebuilder virtual host name (sitebuilder.hostname). The IP address is also retrieved from your system automatically (command /sbin/ifconfig).

You can specify your own host name and IP address for Sitebuilder virtual host. To do so, supply the appropriate --sb_hostname and --sb_host_ip parameters to the Sitebuilder sb_config utility.

The configuration file is stored in /sitebuilder home directory/config. By default, the Sitebuilder home directory is /usr/local/sitebuilder (on Debian and Ubuntu - /opt/sitebuilder/).

Note: When specifying data for virtual host, make sure that Sitebuilder hostname resolves to its IP address. For this to work correctly, a corresponding A DNS record (sb_hostname A IP) must exist on the authoritative name server.