Adding a virtual site (vsite) to Sputnik Control Center
How to create a new vsite in Sputnik Control Center 3.x. (Self-hosted Sputnik Control Center is legacy software, and is no longer supported without purchase of a professional support incident from the Sputnik online store.)
Open a shell on your Sputnik Control Center server.
You can generate multiple virtual sites on your Sputnik Control Center server, each with their own administrative interface and database and management daemon. Each virtual site name should contain 3 to 12 alphanumeric characters, but not start with a digit. For the instructions that follow, substitute the site name you have selected for the text called "newsite". After the site generation is complete, you can point your web browser to http://your.domain.com/newsite. The default login is username "admin" and password "sputnik".
# /usr/share/kosmos/libexec/scc_gensite --vsite=newsite --jabber_server=your.domain.com
NOTICE: CREATE TABLE will create implicit sequence 'kschema_kschema_id_seq' for SERIAL column 'kschema.kschema_id'
NOTICE: CREATE TABLE will create implicit trigger(s) for FOREIGN KEY check(s)Reloading httpd: [ OK ]
Putting a vsite on hold.
To "set aside" a site that is not needed, but that you may want to use later, simply rename its apache configuration file:
# cd /etc/httpd/conf.d
# mv kosmos-sitename.conf kosmos-sitename.conf.hold
# /sbin/service httpd reload
Reverse the order of the filename arguments to reverse the process (reactivate the site). The reason to put unused sites on hold is because they take up valuable RAM resources on the server, even if they are not generating any traffic.
Listing your vsites.
To show a list of sites, perform the following command:
# /usr/share/kosmos/libexec/scc_dbmaint --vsites
NOTE: don't create a vsite named "public".
Note, you may not use a vsite name of "public". If you try, you'll get this error:
# /usr/share/kosmos/libexec/scc_gensite --vsite=public --jabber_server=your.domain.com
Failed to create DB user 'public': ERROR: CREATE USER: user name "public" is reserved