!Welcome to vpsAdmin wiki!

{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Forum|http://forum.vpsadmin.org]
* [Launchpad bug tracker|https://bugs.launchpad.net/vpsadmin]
* [Team] '''We could use some help, so contact us, if you wish to make vpsAdmin better'''

'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].


!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}

!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].

!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:
{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

[Back to Main page|Main page]

!FAQ

!! What am I supposesupposed to do when I find a bug. Is there any tracking system like bugzilla?
Unfortunately, we do not have any reporting system yet. However, you can contact any of the developers directly. Please, visit [Team] section for more details. 

!! I would like to suggest a new feature to vpsAdmin developers. Where can I do that? / I've created a patch for vpsAdmin. Where should I submit it?
Please, send us your patches/suggestions directly - see [Team] section. Your patches/suggestions are more than welcome.

!Welcome to vpsAdmin wiki!

{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Forum|http://forum.vpsadmin.org]
* [Launchpad|https://bugs.launchpad.net/vpsadmin][Launchpad bug tracker|https://bugs.launchpad.net/vpsadmin]
* [Team]

'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].


!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}

!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].

!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:
{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

!Welcome to vpsAdmin wiki!

{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Forum|http://forum.vpsadmin.org]
* [Launchpad|https://launchpad.net/vpsadmin][Launchpad|https://bugs.launchpad.net/vpsadmin]
* [Team]

'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].


!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}

!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].

!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:
{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

[Back to Installation|Installation]

!vpsAdmin frontend installation

1) install packages
{{apt-get install php5-mysql libapache2-mod-php5}}
2) gracefully restart Apache server
{{apache2ctl graceful}}
3) change your cwd
{{cd /opt/}}
4) download vpsAdmin
{{wget http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz}}
5) unpack
{{tar xvf vpsadmin-1.0.1.tar.gz}}
6) create /etc/vpsadmin/config.php file using eg. the nano editor
{{mkdir -p /etc/vpsadmin/
nano /etc/vpsadmin/config.php}}
7) edit it to look like this
{{<?php
define ('HOSTNAME', 'vpsadminNode.company.com'); // node hostname
define ('SERVER_ID', 1); // not needed if you have only frontend here
define ('NETDEV', 'eth0'); // not needed if you have only frontend here
define ('DB_HOST', 'localhost'); // your DB host
define ('DB_USER', 'vpsadmin'); // your DB user
define ('DB_PASS', 'password'); // your DB password
define ('DB_NAME', 'vpsadmin'); // your DB name
define ('WWW_ROOT', "/opt/vpsadmin/"); // vpsAdmin installation path

// Edit these only if you know, what are you doing:
define ('BIN_VZLIST', 'sudo /usr/sbin/vzlist'); // not needed if you have only frontend here
define ('BIN_VZCTL', 'sudo /usr/sbin/vzctl'); // not needed if you have only frontend here
define ('BIN_CAT', 'sudo /bin/cat'); // not needed if you have only frontend here
define ('BIN_BRCTL', 'sudo /usr/sbin/brctl'); // not needed if you have only frontend here
?>}}
8) create vpsadmin www folder
{{mkdir -p /var/www/vpsadmin}}
9) make symlink of index.php
{{ln -s /opt/vpsadmin/index.php /var/www/vpsadmin/index.php
ln -s /opt/vpsadmin/ajax.php /var/www/vpsadmin/ajax.php
ln -s /opt/vpsadmin/js/ /var/www/vpsadmin/js
ln -s /opt/vpsadmin/template/ /var/www/vpsadmin/template}}

!Welcome to vpsAdmin wiki!

{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Forum|http://forum.vpsadmin.org]
* [Launchpad|https://launchpad.net/vpsadmin]
* [Team]

'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].


!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}

!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].

!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:
{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

!Welcome to vpsAdmin wiki!

{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Forum|http://forum.vpsadmin.org]
* [Team]

'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].


!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}

!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].

!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:
{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

!Donate
If you find vpsAdmin useful in any way, please support its next development.
{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 

[Back to Main page|Main page]

!Download

!![version 1.0.1|http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz]
{br}[Download|http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz]{br}
MD5 SUM:
{{3511fe9666dde66be3c9e1ea86c26d49  [vpsadmin-1.0.1.tar.gz|http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz]}}vpsadmin-1.0.1.tar.gz}}

SHA1 SUM:
{{b929583830144f848f2bc4600fddada98903a834  [vpsadmin-1.0.1.tar.gz|http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz]}}vpsadmin-1.0.1.tar.gz}}
!!!Changelog
* Several PHP notices fixed (but there are still some)
* Updated MySQL scheme (auto_increment was missing)

!![version 1.0|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]
{br}[Download|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]{br}
MD5 SUM:
{{60d645eb4c7d61676b4ab48b006bb630  [vpsadmin-1.0.tar.gz|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]}}vpsadmin-1.0.tar.gz}}

SHA1 SUM:
{{f8ffd0a4e6227c9fc4457e6eca748fc60b627ea2  [vpsadmin-1.0.tar.gz|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]}}vpsadmin-1.0.tar.gz}}

[Back to Main page|Main page]

!Download

[version!![version 1.0.1|http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz]
{br}
MD5 SUM:
{{3511fe9666dde66be3c9e1ea86c26d49  vpsadmin-1.0.1.tar.gz}}
[vpsadmin-1.0.1.tar.gz|http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz]}}
SHA1 SUM:
{{b929583830144f848f2bc4600fddada98903a834  vpsadmin-1.0.1.tar.gz}}[vpsadmin-1.0.1.tar.gz|http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz]}}
!!!Changelog
* Several PHP notices fixed (but there are still some)
* Updated MySQL scheme (auto_increment was missing)

[version!![version 1.0|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]
{br}
MD5 SUM:
{{60d645eb4c7d61676b4ab48b006bb630  vpsadmin-1.0.tar.gz}}[vpsadmin-1.0.tar.gz|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]}}

SHA1 SUM:
{{f8ffd0a4e6227c9fc4457e6eca748fc60b627ea2  vpsadmin-1.0.tar.gz}}[vpsadmin-1.0.tar.gz|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]}}

!Welcome to vpsAdmin wiki!

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Team]

!!'''We are happy to introduce vpsAdmin 1.0'''
'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].


!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}

!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].

!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:
{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

!Donate
If you find vpsAdmin useful in any way, please support its next development.
{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 

[Back to Installation|Installation]

!vpsAdmin backend installation

1) install packages
{{apt-get install php5 php5-cli php5-mysql sudo}}
2) change your cwd
{{cd /opt/}}
3) download vpsAdmin
{{wget http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz}}http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz}}
4) unpack
{{tar xvf vpsadmin-1.0.tar.gz}}vpsadmin-1.0.1.tar.gz}}
5) create /etc/vpsadmin/config.php file using eg. the nano editor
{{nano /etc/vpsadmin/config.php}}
6) edit it to look like this
{{<?php
define ('HOSTNAME', 'vpsadminNode.company.com'); // node hostname
define ('SERVER_ID', 1); // use your cluster node count + 1 for SERVER_ID
define ('NETDEV', 'eth0'); // use linux ethernet interface name of that, which is connected to the Internet
define ('DB_HOST', 'localhost'); // your DB host
define ('DB_USER', 'vpsadmin'); // your DB user
define ('DB_PASS', 'password'); // your DB password
define ('DB_NAME', 'vpsadmin'); // your DB name
define ('WWW_ROOT', "/opt/vpsadmin/"); // vpsAdmin installation path

// Edit these only if you know, what are you doing:
define ('BIN_VZLIST', '/usr/sbin/vzlist');
define ('BIN_VZCTL', '/usr/sbin/vzctl');
define ('BIN_CAT', '/bin/cat');
define ('BIN_BRCTL', '/usr/sbin/brctl');
?>}}
7) Add these lines to /etc/crontab (use your installation path if it differs)
{{*/5 * * * * root php /opt/vpsadmin/cron.php 2> /dev/null
@reboot root php /opt/vpsadmin/cron_reboot.php 2> /dev/null}}
8) If you have vpsAdmin frontend installed, go to page '''Manage cluster''' and select '''Register new node'''
Fill in these values:
{{ID: your server ID (if this is your first node, then 1)
Name: short name of the node (eg. alfa)
Location: select location of this node (if you don't have any, you have to create one)
}}

[Back to Installation|Installation]

!vpsAdmin frontend installation

1) install packages
{{apt-get install php5-mysql libapache2-mod-php5}}
2) gracefully restart Apache server
{{apache2ctl graceful}}
3) change your cwd
{{cd /opt/}}
4) download vpsAdmin
{{wget http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz}}http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz}}
5) unpack
{{tar xvf vpsadmin-1.0.tar.gz}}vpsadmin-1.0.1.tar.gz}}
6) create /etc/vpsadmin/config.php file using eg. the nano editor
{{mkdir -p /etc/vpsadmin/
nano /etc/vpsadmin/config.php}}
7) edit it to look like this
{{<?php
define ('HOSTNAME', 'vpsadminNode.company.com'); // node hostname
define ('SERVER_ID', 1); // not needed if you have only frontend here
define ('NETDEV', 'eth0'); // not needed if you have only frontend here
define ('DB_HOST', 'localhost'); // your DB host
define ('DB_USER', 'vpsadmin'); // your DB user
define ('DB_PASS', 'password'); // your DB password
define ('DB_NAME', 'vpsadmin'); // your DB name
define ('WWW_ROOT', "/opt/vpsadmin/"); // vpsAdmin installation path

// Edit these only if you know, what are you doing:
define ('BIN_VZLIST', 'sudo /usr/sbin/vzlist'); // not needed if you have only frontend here
define ('BIN_VZCTL', 'sudo /usr/sbin/vzctl'); // not needed if you have only frontend here
define ('BIN_CAT', 'sudo /bin/cat'); // not needed if you have only frontend here
define ('BIN_BRCTL', 'sudo /usr/sbin/brctl'); // not needed if you have only frontend here
?>}}
8) create vpsadmin www folder
{{mkdir -p /var/www/vpsadmin}}
9) make symlink of index.php
{{ln -s /opt/vpsadmin/index.php /var/www/vpsadmin/index.php
ln -s /opt/vpsadmin/js/ /var/www/vpsadmin/js
ln -s /opt/vpsadmin/template/ /var/www/vpsadmin/template}}

[Back to Main page|Main page]

!Download

[version 1.0.1|http://vpsadmin.org/downloads/vpsadmin-1.0.1.tar.gz]
{br}
MD5 SUM:
{{3511fe9666dde66be3c9e1ea86c26d49  vpsadmin-1.0.1.tar.gz}}

SHA1 SUM:
{{b929583830144f848f2bc4600fddada98903a834  vpsadmin-1.0.1.tar.gz}}

[version 1.0|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]
{br}
MD5 SUM:
{{60d645eb4c7d61676b4ab48b006bb630  vpsadmin-1.0.tar.gz}}

SHA1 SUM:
{{f8ffd0a4e6227c9fc4457e6eca748fc60b627ea2  vpsadmin-1.0.tar.gz}}

[Back to Installation|Installation]

!vpsAdmin backend installation

1) install packages
{{apt-get install php5 php5-cli php5-mysql}}php5-mysql sudo}}
2) change your cwd
{{cd /opt/}}
3) download vpsAdmin
{{wget http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz}}
4) unpack
{{tar xvf vpsadmin-1.0.tar.gz}}
5) create /etc/vpsadmin/config.php file using eg. the nano editor
{{nano /etc/vpsadmin/config.php}}
6) edit it to look like this
{{<?php
define ('HOSTNAME', 'vpsadminNode.company.com'); // node hostname
define ('SERVER_ID', 1); // use your cluster node count + 1 for SERVER_ID
define ('NETDEV', 'eth0'); // use linux ethernet interface name of that, which is connected to the Internet
define ('DB_HOST', 'localhost'); // your DB host
define ('DB_USER', 'vpsadmin'); // your DB user
define ('DB_PASS', 'password'); // your DB password
define ('DB_NAME', 'vpsadmin'); // your DB name
define ('WWW_ROOT', "/opt/vpsadmin/"); // vpsAdmin installation path

// Edit these only if you know, what are you doing:
define ('BIN_VZLIST', '/usr/sbin/vzlist');
define ('BIN_VZCTL', '/usr/sbin/vzctl');
define ('BIN_CAT', '/bin/cat');
define ('BIN_BRCTL', '/usr/sbin/brctl');
?>}}
7) Add these lines to /etc/crontab (use your installation path if it differs)
{{*/5 * * * * root php /opt/vpsadmin/cron.php 2> /dev/null
@reboot root php /opt/vpsadmin/cron_reboot.php 2> /dev/null}}
8) If you have vpsAdmin frontend installed, go to page '''Manage cluster''' and select '''Register new node'''
Fill in these values:
{{ID: your server ID (if this is your first node, then 1)
Name: short name of the node (eg. alfa)
Location: select location of this node (if you don't have any, you have to create one)
}}

[Back to Installation|Installation]

!Database setup
1) install MySQL server
{{apt-get install mysql-server}}
2) use your favorite MySQL manager and create an empty database
If you wish to have more cluster nodes than one, or your database server is different than your OpenVZ server, you need to allow access to the DB from those nodes.
3) fill your DB with these data:
(also available in setup/db_schema.sql in the vpsAdmin package)
{{CREATE TABLE `cfg_diskspace` (
  `d_id` int(10) unsigned NOT NULL auto_increment,
  `d_gb` int(10) unsigned NOT NULL,
  `d_label` varchar(64) NOT NULL,
  PRIMARY KEY  (`d_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `cfg_dns` (
  `dns_id` int(10) unsigned NOT NULL auto_increment,
  `dns_ip` varchar(63) NOT NULL,
  `dns_label` varchar(63) NOT NULL,
  `dns_is_universal` tinyint(1) unsigned default '0',
  `dns_location` int(10) unsigned default NULL,
  PRIMARY KEY  (`dns_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `cfg_privvmpages` (
  `vm_id` int(10) unsigned NOT NULL,NULL auto_increment,
  `vm_label` varchar(64) NOT NULL,
  `vm_lim_hard` int(10) unsigned NOT NULL,
  `vm_lim_soft` int(10) unsigned NOT NULL,
  `vm_usable` tinyint(1) NOT NULL default '1',
  PRIMARY KEY  (`vm_id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;
CREATE TABLE `cfg_templates` (
  `templ_id` int(10) unsigned NOT NULL auto_increment,
  `templ_name` varchar(64) NOT NULL,
  `templ_label` varchar(64) NOT NULL,
  `templ_info` text,
  PRIMARY KEY  (`templ_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `firewall` (
  `id` int(11) NOT NULL auto_increment,
  `ip` int(11) NOT NULL,
  `command` varchar(255) character set latin1 default NULL,
  `ordinal` int(11) default NULL,
  `approved` tinyint(1) default NULL,
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;
CREATE TABLE `locations` (
  `location_id` int(10) unsigned NOT NULL auto_increment,
  `location_label` varchar(63) NOT NULL,
  `location_has_ipv6` tinyint(1) NOT NULL,
  PRIMARY KEY  (`location_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `members` (
  `m_info` text,
  `m_id` int(10) unsigned NOT NULL auto_increment,
  `m_level` int(10) unsigned NOT NULL,
  `m_nick` varchar(63) NOT NULL,
  `m_name` varchar(255) NOT NULL,
  `m_pass` varchar(255) NOT NULL,
  `m_mail` varchar(127) NOT NULL,
  `m_address` text NOT NULL,
  `m_lang` varchar(16) default NULL,
  `m_paid_until` varchar(32) default NULL,
  `m_last_activity` int(10) unsigned default NULL,
  PRIMARY KEY  (`m_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `servers` (
  `server_id` int(10) unsigned NOT NULL auto_increment,
  `server_name` varchar(64) NOT NULL,
  `server_location` int(10) unsigned NOT NULL,
  `server_availstat` text,
  `server_ip4` varchar(127) NOT NULL,
  `server_maxvps` int(10) unsigned default NULL,
  `server_path_vz` varchar(63) NOT NULL default '/var/lib/vz',
  PRIMARY KEY  (`server_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `servers_status` (
  `id` bigint(20) unsigned NOT NULL auto_increment,
  `server_id` int(10) unsigned NOT NULL,
  `timestamp` int(10) unsigned NOT NULL,
  `ram_free_mb` int(10) unsigned default NULL,
  `disk_vz_free_gb` float unsigned default NULL,
  `cpu_load` float unsigned default NULL,
  `vpsadmin_version` varchar(63) default NULL,
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `sysconfig` (
  `cfg_name` varchar(127) NOT NULL,
  `cfg_value` text,
  PRIMARY KEY  (`cfg_name`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;
CREATE TABLE `transactions` (
  `t_id` int(10) unsigned NOT NULL auto_increment,
  `t_group` int(10) unsigned default NULL,
  `t_time` int(10) unsigned default NULL,
  `t_m_id` int(10) unsigned default NULL,
  `t_server` int(10) unsigned default NULL,
  `t_vps` int(10) unsigned default NULL,
  `t_type` int(10) unsigned NOT NULL,
  `t_success` int(10) unsigned NOT NULL,
  `t_done` tinyint(1) unsigned NOT NULL,
  `t_param` text,
  `t_output` text,
  PRIMARY KEY  (`t_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `transaction_groups` (
  `id` int(10) unsigned NOT NULL auto_increment,
  `is_clusterwide` tinyint(1) unsigned default '0',
  `is_locationwide` tinyint(1) unsigned default '0',
  `location_id` int(10) unsigned default '0',
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `transfered` (
  `tr_id` int(10) unsigned NOT NULL auto_increment,
  `tr_ip` varchar(127) NOT NULL,
  `tr_nix_in` bigint(63) unsigned default '0',
  `tr_nix_out` bigint(63) unsigned default '0',
  `tr_tzt_in` bigint(63) unsigned default '0',
  `tr_tzt_out` bigint(63) unsigned default '0',
  `tr_time` int(10) unsigned NOT NULL,
  PRIMARY KEY  (`tr_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `vps` (
  `vps_id` int(10) unsigned NOT NULL auto_increment,
  `m_id` int(63) unsigned NOT NULL,
  `vps_hostname` varchar(64) default 'darkstar',
  `vps_template` int(10) unsigned NOT NULL default '1',
  `vps_info` mediumtext,
  `vps_nameserver` varchar(255) NOT NULL default '4.2.2.2',
  `vps_privvmpages` int(10) unsigned NOT NULL default '1',
  `vps_cpulimit` varchar(255) default NULL,
  `vps_cpuprio` varchar(255) default NULL,
  `vps_diskspace` int(10) unsigned NOT NULL default '1',
  `vps_server` int(11) unsigned NOT NULL,
  `vps_fuse_enabled` tinyint(1) default '0',
  `vps_tuntap_enabled` tinyint(1) default '0',
  `vps_iptables_enabled` tinyint(1) default '0',
  PRIMARY KEY  (`vps_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8 AUTO_INCREMENT=100;
CREATE TABLE `vps_ip` (
  `ip_id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `ip_v` int(10) unsigned NOT NULL default '4',
  `ip_location` int(10) unsigned NOT NULL,
  `ip_addr` varchar(40) NOT NULL,
  PRIMARY KEY  (`ip_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `vps_snapshots` (
  `s_id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `server_id` varchar(63) NOT NULL,
  `s_name` varchar(63) NOT NULL,
  `s_time` int(10) unsigned NOT NULL,
  `s_size_mb` int(10) unsigned default NULL,
  PRIMARY KEY  (`s_id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;
CREATE TABLE `vps_status` (
  `id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `timestamp` int(10) unsigned NOT NULL,
  `vps_up` tinyint(1) unsigned default NULL,
  `vps_nproc` int(10) unsigned default NULL,
  `vps_vm_used_mb` int(10) unsigned default NULL,
  `vps_disk_used_mb` int(10) unsigned default NULL,
  `vps_admin_ver` varchar(63) default 'not set',
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
INSERT INTO `members` (
`m_info`, `m_id`, `m_level`,
`m_nick`, `m_name`, `m_pass`,
`m_mail`, `m_address`, `m_lang`,
`m_paid_until`, `m_last_activity` )
 VALUES (NULL ,  '1',  '99',
'admin',  'fill in',
'f6fdffe48c908deb0f4c3bd36c032e72',
'admin@admin.example',  'fill in', NULL , NULL , NULL);}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running front-end from a hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.
{br}
Follow instructions [described here|vpsAdmin frontend installation] with these changes:

0) Your vpsAdmin path is not /opt/vpsadmin/, but the one you can access via FTP, so you don't do any unpacking from the terminal. Just unpack the vpsAdmin files on your computer and upload them to the hosting via FTP, you don't need to care what the absolute path is.
1) Don't do any symlinks (ignore step 9 in above mentioned page)
2) Don't save config.php file into /etc/vpsadmin/, instead use the same directory where your index.php is.
2)
3) WWW_ROOT variable in config.php has to be set to '' (empty value)
3)
4) Run following two commands in vpsAdmin's frontend location:
{{sed 's/\/etc\/vpsadmin/./g' index.php > index.php.new && mv index.php.new index.php 
sed 's/\/etc\/vpsadmin/./g' index.php > ajax.php.new && mv ajax.php.new ajax.php
}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running front-end from a hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.
{br}
Follow instructions [described here|vpsAdmin frontend installation] with these changes:

0) Your vpsAdmin path is not /opt/vpsadmin/, but the one you can access via FTP, so you don't do any unpacking from the terminal. Just unpack the vpsAdmin files on your computer and upload them to the hosting via FTP, you don't need to care what the absolute path is.
1) Don't save config.php file into /etc/vpsadmin/, instead use the same directory where your index.php is.
2) WWW_ROOT variable in config.php has to be set to '' (empty value)
3) Run following two commands in vpsAdmin's frontend location:
{{sed 's/\/etc\/vpsadmin/./g' index.php > index.php.new && mv index.php.new index.php 
sed 's/\/etc\/vpsadmin/./g' index.php > ajax.php.new && mv ajax.php.new ajax.php
}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running front-end from a hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.
{br}
Follow instructions [described here|vpsAdmin frontend installation] with these changes:

1) Don't save config.php file into /etc/vpsadmin/, instead use the same directory where your index.php is.
2) WWW_ROOT variable in config.php has to be set to '' (empty value)
3) Run following two commands in vpsAdmin's frontend location:
{{
sed{{sed 's/\/etc\/vpsadmin/./g' index.php > index.php.new && mv index.php.new index.php 
sed 's/\/etc\/vpsadmin/./g' index.php > ajax.php.new && mv ajax.php.new ajax.php
}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running front-end from a hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.
{br}
Follow instructions [described here|vpsAdmin frontend installation] with these changes:

1) Don't save config.php file into /etc/vpsadmin/, instead use the same directory where your index.php is.
2) WWW_ROOT variable in config.php has to be set to '' (empty value)
3) Line 22Run following two commands in vpsAdmin's frontend location:
{{
sed 's/\/etc\/vpsadmin/./g' index.php has to be modified in this way:
{{include './config.php';}}
> index.php.new && mv index.php.new index.php 
sed 's/\/etc\/vpsadmin/./g' index.php > ajax.php.new && mv ajax.php.new ajax.php
}}

[Back to Main page|Main page]

!Team

!!Pavel SnajdrŠnajdr (snajpa)
Project: '''overall design'''
Code: '''almost everything'''
mail: snajpa AT snajpa DOT net
jabber: snajpa AT jabber.lbfree DOT net

!!Tomas!!Tomáš Srnka (toms)
Project: '''PR'''
Code: '''IP management''', '''l10n''', '''UI improvements'''
E-mail/Gtalk: tomas.srnka AT gmail DOT com
Blog: [Tomas Srnka@wordpress|http://tomassrnka.wordpress.com]

!!Contributors:

Frantisek Kucera (xkucf03), traffic counting
Michal Krenek (mikos), iptables/tuntap/fuse enabler

[Back to Main page|Main page]

!Team

!!Pavel Snajdr (snajpa)
Project: '''overall design'''
Code: '''almost everything'''
mail: snajpa AT snajpa DOT net
jabber: snajpa AT jabber.lbfree DOT net

!!Tomas Srnka (toms)
Project: '''PR'''
Code: '''IP management''', '''l10n''''''l10n''', '''UI improvements'''
E-mail/Gtalk: tomas.srnka AT gmail DOT com
Blog: [Tomas Srnka@wordpress|http://tomassrnka.wordpress.com]

!!Contributors:

Frantisek Kucera (xkucf03), traffic counting
Michal Krenek (mikos), iptables/tuntap/fuse enabler

[Back to Main page|Main page]

!Team

!!Pavel Snajdr (snajpa)
Project: '''overall design'''
Code: '''almost everything'''
mail: snajpa AT snajpa DOT net
jabber: snajpa AT jabber.lbfree DOT net

!!Tomas Srnka (toms)
Project: '''PR'''
Code: '''IP management''', '''l10n'''
E-mail/Gtalk: tomas.srnka AT gmail DOT com
Blog: [Tomas Srnka@wordpress|http://tomassrnka.wordpress.com]

!!Frantisek!!Contributors:

Frantisek Kucera (xkucf03)(xkucf03), traffic counting
Michal Krenek (mikos), iptables/tuntap/fuse enabler

!Welcome to vpsAdmin wiki!

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Team]

!!'''We are happy to introduce vpsAdmin 1.0'''
'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].

!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}

!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].

!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:
{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

!Donate
If you find vpsAdmin useful in any way, please support its next development.
{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 

!Welcome to vpsAdmin wiki!

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Team]

!!'''We are happy to introduce vpsAdmin 1.0'''
'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].

!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}

!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].

!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:
{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

!Donate
{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" style="border:0px;" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"  style="border:0px;" />
    </form>
{/html} 


{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

!Welcome to vpsAdmin wiki!

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Team]

!!'''We are happy to introduce vpsAdmin 1.0'''
'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].

!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}


!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].


!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:

!Donate
{html}   <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
      <input type="hidden" name="cmd" value="_s-xclick" />
      <input type="hidden" name="hosted_button_id" value="9713803" />
      <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" />
      <img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1" />
    </form>
{/html} 


{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running front-end from a hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.
{br}
Follow instructions [described here|vpsAdmin frontend installation] with these changes:

1) Don't save config.php file into /etc/vpsadmin/, instead use the same directory where your index.php is.
2) WWW_ROOT variable in config.php has to be set to '' (empty value)
3) Edit lineLine 22 in index.php has to be modified in this way:
{{include './config.php';}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running front-end from a hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.
{br}
Follow instructions [described here|vpsAdmin frontend installation] with these changes:

1) Don't save the config.php file into /etc/vpsadmin/, instead use the same directory where your index.php is.
2) WWW_ROOT variable in config.php has to be set to '' (empty value)
3) Edit line 22 in index.php this way:
{{include './config.php';}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running front-end from a hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.
{br}
Follow instructions [described here|vpsAdmin frontend installation] with these changes:

1) Don't save the config.php file into /etc/vpsadmin/, instead use the same directory where your index.php isis.
2) WWW_ROOT variable in config.php has to be set to '' (empty value)
3) Edit line 22 in index.php this way:
{{include './config.php';}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running front-end from a hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.

Follow instructions [described here|vpsAdmin frontend installation] with these changes:

1) You of course have different vpsAdmin path, we will reflect that in config.php
2) Don't save the config.php file into /etc/vpsadmin/, instead use the same directory where your index.php is
3)
2) WWW_ROOT variable in config.php has to be set to '' (empty value)
4)
3) Edit line 22 in index.php this way:
{{include './config.php';}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running frontendfront-end from somea hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.

Follow instructions as [described here|vpsAdmin frontend installation] with these changes:

1) You of course have different vpsAdmin path, we will reflect that in config.php
2) Don't save the config.php file tointo /etc/vpsadmin/, instead use the same directory where your index.php is
3) Use '' (empty content) for WWW_ROOT variable in config.php has to be set to '' (empty value)
4) Edit line 22 in index.php this way:
{{include './config.php';}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

When running frontend from some hosting panels, they are often quite secured by default, so they don't allow including files from other directory than under htdocs tree.
The frontend should work under both mod-php and fcgi HTTPd extensions.

Follow instructions as [described here|vpsAdmin frontend installation] with these changes:

1) You of course have different vpsAdmin path, we will reflect that in config.php
2) Don't save the config.php file to /etc/vpsadmin/, instead use the same directory where your index.php is
3) Use '' (empty content) for WWW_ROOT variable in config.php
4) Edit line 22 in index.php this way:
{{include './config.php';}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

1) Follow instructions as [described here|vpsAdmin frontend installation] with these changes:

1) You of course have different vpsAdmin path, we will reflect that in config.php
2) Don't save the config.php file to /etc/vpsadmin/, instead use the same directory where your index.php is
3) Use '' (empty content) for WWW_ROOT variable in config.php
4) Edit line 22 in index.php this way:
{{include './config.php';}}

[Back to Installation|Installation]

!!Running frontend from hosting panel

1) 

[Back to Main page|Main page]

!Installation

This page describes installation process on fresh installation of '''Debian 5.0 (lenny)'''
Please note that OpenVZ Quotas for diskspace VPS accounting supports only '''ext2'''/'''ext3''' filesystems. You might use other file-system than ext2/ext3, but OpenVZ won't be able to limit disk usage of VPS. Thus, vpsAdmin will not be capable of setting those limits. 

Installation process consists of three main parts, which can be split on different servers:
* database server for vpsAdmin (MySQL5+ only)
* cron backend (PHP5)
* web frontend (Apache + PHP5)

To install vpsAdmin, please continue in following sections:

* [OpenVZ installation]
* [Database setup]
* [vpsAdmin frontend installation]
* [Basic vpsAdmin setup]
* [vpsAdmin backend installation]
* [Get the migration working]
* [Running frontend from hosting panel (ISPcp, ISPconfig...)|Frontend from hosting panel]

[Back to Main page|Main page]

!Team

!!Pavel Snajdr (snajpa)
jabber: snajpa AT jabber.lbfree DOT net

!!Tomas Srnka (toms)
E-mail/Gtalk: tomas.srnka AT gmail DOT com
Blog: [TomasSrnka.wordpress.com|http://tomassrnka.wordpress.com][Tomas Srnka@wordpress|http://tomassrnka.wordpress.com]

!!Frantisek Kucera (xkucf03)

[Back to Main page|Main page]

!Team

!!Pavel Snajdr (snajpa)
jabber: snajpa AT jabber.lbfree DOT net

!!Tomas Srnka (toms)
E-mail/Gtalk: tomas.srnka AT gmail DOT com
Blog: [TomasSrnka.wordpress.com|http://tomassrnka.wordpress.com]

!!Frantisek Kucera (xkucf03)

!Welcome to vpsAdmin wiki!

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Team]

!!'''We are happy to announceintroduce vpsAdmin 1.0'''
'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz].

!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}


!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].


!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:

{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

[Back to Main page|Main page]

!vpsAdmin concepts

!!vpsAdmin cluster
Because of multiple server support, vpsAdmin enables the administration of every single physical server via one particular computer. This enables the administrator to manage all VPSs and users from a single spot. 

!!Cluster locations 
You might encouter a situation when you have servers in a one datacenter and you need to set up another server in a '''different datacenter'''. The problem is that the new server will be probably in different subnet. To avoid the installation of new vpsAdmim and decentralized administration we implemented "locations" support, so that you can still comfortably manage your VPSs from one spot.

!!Separated back-end & front-end 
vpsAdmin uses separated concept: there is one main '''database server''', which connects the '''frontends''' (web interfaces) with the '''backends''' (OpenVZ-enabled servers). Hence you may have multiple web frontend installations and multiple virtualization servers with installed back-end. So, if any of your servers which provides web fronted fails, you are still able to manage your servers with vpsAdmin from different location. You can even set up MySQL replication (e.g. via [phpMyAdmin 3.3|http://phpmyadmin.net]) to provide higher availability. 

!!Transactions
To simplify the design and to support large number of cluster nodes (frontends or backends), we came up with an idea of '''cluster transactions'''.
A transaction is an atomic action performed either on particular VPS, particular physical server or on the servers in whole location.
Transactions can handle actions such as "Start VPS", "Set limits", "Restart physical server" and many others.

[Back to Main page|Main page]

!vpsAdmin concepts

!!vpsAdmin cluster
ThanksBecause of multiple server support, vpsAdmin enables the administration of every single physical server via one particular computer. This enables the administrator to manage all VPSs and users from a single spot. 

!!Cluster locations 
You might encouter a situation when you have servers in a one datacenter and you need to set up another server in a '''different datacenter'''. The problem is that the new server will be probably in different subnet. To avoid the installation of new vpsAdmim and decentralized administration we implemented "locations" support, so that you can comfortably manage your VPSs from one spot.

!!Separated back-end & front-end 
vpsAdmin uses separated concept: there is one main '''database server''', which connects the '''frontends''' (web interfaces) with the '''backends''' (OpenVZ-enabled servers). Hence you may have multiple web frontend installations and multiple virtualization servers with installed back-end. So, if any of your servers which provides web fronted fails, you are still able to manage your servers with vpsAdmin from different location. You can even set up MySQL replication (e.g. via [phpMyAdmin 3.3|http://phpmyadmin.net]) to provide higher availability. 

!!Transactions
To simplify the design and to support large number of cluster nodes (frontends or backends), we came up with an idea of '''cluster transactions'''.
A transaction is an atomic action performed either on particular VPS, particular physical server or on the servers in whole location.
Transactions can handle actions such as "Start VPS", "Set limits", "Restart physical server" and many others.

!Welcome to vpsAdmin wiki!

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Team]

'''vpsAdmin'''!!'''We are happy to announce vpsAdmin 1.0'''
'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz]. There is no stable release available, but we are very close to publication of the version 1.0.

!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}


!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].


!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:

{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

!Welcome to vpsAdmin wiki!

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [FAQ]
* [Team]

'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz] (currently available only in Czech languge).[vpsFree.cz|http://vpsFree.cz]. There is no stable release available, but we are very close to publication of the version 1.0.

!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}


!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].


!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:

{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

[Back to Main page|Main page]

!Download

[version 1.0|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]
{br}
MD5 SUM:
{{9ed15962ba5b3ae1e997e4b670cdbdd8{{60d645eb4c7d61676b4ab48b006bb630  vpsadmin-1.0.tar.gz}}

SHA1 SUM:
{{740f40432125e3f05116b7d77a6ce56f417d60c7{{f8ffd0a4e6227c9fc4457e6eca748fc60b627ea2  vpsadmin-1.0.tar.gz}}

[Back to Main page|Main page]

!Download

[version 1.0|http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz]
{br}
MD5 SUM:
{{d5b4b55599763593480a149f655f2497 vpsadmin-1.0.tar.gz}}{{9ed15962ba5b3ae1e997e4b670cdbdd8  vpsadmin-1.0.tar.gz}}

SHA1 SUM:
{{419063317c02def5c6deb5b8f65eefb4114ab26a vpsadmin-1.0.tar.gz}}{{740f40432125e3f05116b7d77a6ce56f417d60c7  vpsadmin-1.0.tar.gz}}

[Back to Installation|Installation]

!Database setup
1) install MySQL server
{{apt-get install mysql-server}}
2) use your favorite MySQL manager and create an empty database
If you wish to have more cluster nodes than one, or your database server is different than your OpenVZ server, you need to allow access to the DB from those nodes.
3) fill your DB with these data:
(also available in setup/db_schema.sql in the vpsAdmin package)
{{CREATE TABLE `cfg_diskspace` (
  `d_id` int(10) unsigned NOT NULL auto_increment,
  `d_gb` int(10) unsigned NOT NULL,
  `d_label` varchar(64) NOT NULL,
  PRIMARY KEY  (`d_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `cfg_dns` (
  `dns_id` int(10) unsigned NOT NULL auto_increment,
  `dns_ip` varchar(63) NOT NULL,
  `dns_label` varchar(63) NOT NULL,
  `dns_is_universal` tinyint(1) unsigned default '0',
  `dns_location` int(10) unsigned default NULL,
  PRIMARY KEY  (`dns_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `cfg_privvmpages` (
  `vm_id` int(10) unsigned NOT NULL,
  `vm_label` varchar(64) NOT NULL,
  `vm_lim_hard` int(10) unsigned NOT NULL,
  `vm_lim_soft` int(10) unsigned NOT NULL,
  `vm_usable` tinyint(1) NOT NULL default '1',
  PRIMARY KEY  (`vm_id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;
CREATE TABLE `cfg_templates` (
  `templ_id` int(10) unsigned NOT NULL auto_increment,
  `templ_name` varchar(64) NOT NULL,
  `templ_label` varchar(64) NOT NULL,
  `templ_info` text,
  PRIMARY KEY  (`templ_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `firewall` (
  `id` int(11) NOT NULL auto_increment,
  `ip` int(11) NOT NULL,
  `command` varchar(255) character set latin1 default NULL,
  `ordinal` int(11) default NULL,
  `approved` tinyint(1) default NULL,
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;
CREATE TABLE `locations` (
  `location_id` int(10) unsigned NOT NULL auto_increment,
  `location_label` varchar(63) NOT NULL,
  `location_has_ipv6` tinyint(1) NOT NULL,
  PRIMARY KEY  (`location_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `members` (
  `m_info` text,
  `m_id` int(10) unsigned NOT NULL auto_increment,
  `m_level` int(10) unsigned NOT NULL,
  `m_nick` varchar(63) NOT NULL,
  `m_name` varchar(255) NOT NULL,
  `m_pass` varchar(255) NOT NULL,
  `m_mail` varchar(127) NOT NULL,
  `m_address` text NOT NULL,
  `m_lang` varchar(16) default NULL,
  `m_paid_until` varchar(32) default NULL,
  `m_last_activity` int(10) unsigned default NULL,
  PRIMARY KEY  (`m_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `servers` (
  `server_id` int(10) unsigned NOT NULL auto_increment,
  `server_name` varchar(64) NOT NULL,
  `server_location` int(10) unsigned NOT NULL,
  `server_availstat` text,
  `server_ip4` varchar(127) NOT NULL,
  `server_maxvps` int(10) unsigned default NULL,
  `server_path_vz` varchar(63) NOT NULL default '/var/lib/vz',
  PRIMARY KEY  (`server_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8 AUTO_INCREMENT=100;CHARSET=utf8;
CREATE TABLE `servers_status` (
  `id` bigint(20) unsigned NOT NULL auto_increment,
  `server_id` int(10) unsigned NOT NULL,
  `timestamp` int(10) unsigned NOT NULL,
  `ram_free_mb` int(10) unsigned default NULL,
  `disk_vz_free_gb` float unsigned default NULL,
  `cpu_load` float unsigned default NULL,
  `vpsadmin_version` varchar(63) default NULL,
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `sysconfig` (
  `cfg_name` varchar(127) NOT NULL,
  `cfg_value` text,
  PRIMARY KEY  (`cfg_name`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;
CREATE TABLE `transactions` (
  `t_id` int(10) unsigned NOT NULL auto_increment,
  `t_group` int(10) unsigned default NULL,
  `t_time` int(10) unsigned default NULL,
  `t_m_id` int(10) unsigned default NULL,
  `t_server` int(10) unsigned default NULL,
  `t_vps` int(10) unsigned default NULL,
  `t_type` int(10) unsigned NOT NULL,
  `t_success` int(10) unsigned NOT NULL,
  `t_done` tinyint(1) unsigned NOT NULL,
  `t_param` text,
  `t_output` text,
  PRIMARY KEY  (`t_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `transaction_groups` (
  `id` int(10) unsigned NOT NULL auto_increment,
  `is_clusterwide` tinyint(1) unsigned default '0',
  `is_locationwide` tinyint(1) unsigned default '0',
  `location_id` int(10) unsigned default '0',
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `transfered` (
  `tr_id` int(10) unsigned NOT NULL auto_increment,
  `tr_ip` varchar(127) NOT NULL,
  `tr_nix_in` bigint(63) unsigned default '0',
  `tr_nix_out` bigint(63) unsigned default '0',
  `tr_tzt_in` bigint(63) unsigned default '0',
  `tr_tzt_out` bigint(63) unsigned default '0',
  `tr_time` int(10) unsigned NOT NULL,
  PRIMARY KEY  (`tr_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `vps` (
  `vps_id` int(10) unsigned NOT NULL auto_increment,
  `m_id` int(63) unsigned NOT NULL,
  `vps_hostname` varchar(64) default 'darkstar',
  `vps_template` int(10) unsigned NOT NULL default '1',
  `vps_info` mediumtext,
  `vps_nameserver` varchar(255) NOT NULL default '4.2.2.2',
  `vps_privvmpages` int(10) unsigned NOT NULL default '1',
  `vps_cpulimit` varchar(255) default NULL,
  `vps_cpuprio` varchar(255) default NULL,
  `vps_diskspace` int(10) unsigned NOT NULL default '1',
  `vps_server` int(11) unsigned NOT NULL,
  `vps_fuse_enabled` tinyint(1) default '0',
  `vps_tuntap_enabled` tinyint(1) default '0',
  `vps_iptables_enabled` tinyint(1) default '0',
  PRIMARY KEY  (`vps_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;CHARSET=utf8 AUTO_INCREMENT=100;
CREATE TABLE `vps_ip` (
  `ip_id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `ip_v` int(10) unsigned NOT NULL default '4',
  `ip_location` int(10) unsigned NOT NULL,
  `ip_addr` varchar(40) NOT NULL,
  PRIMARY KEY  (`ip_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `vps_snapshots` (
  `s_id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `server_id` varchar(63) NOT NULL,
  `s_name` varchar(63) NOT NULL,
  `s_time` int(10) unsigned NOT NULL,
  `s_size_mb` int(10) unsigned default NULL,
  PRIMARY KEY  (`s_id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;
CREATE TABLE `vps_status` (
  `id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `timestamp` int(10) unsigned NOT NULL,
  `vps_up` tinyint(1) unsigned default NULL,
  `vps_nproc` int(10) unsigned default NULL,
  `vps_vm_used_mb` int(10) unsigned default NULL,
  `vps_disk_used_mb` int(10) unsigned default NULL,
  `vps_admin_ver` varchar(63) default 'not set',
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
INSERT INTO `members` (
`m_info`, `m_id`, `m_level`,
`m_nick`, `m_name`, `m_pass`,
`m_mail`, `m_address`, `m_lang`,
`m_paid_until`, `m_last_activity` )
 VALUES (NULL ,  '1',  '99',
'admin',  'fill in',
'f6fdffe48c908deb0f4c3bd36c032e72',
'admin@admin.example',  'fill in', NULL , NULL , NULL);}}

[Back to Installation|Installation]

!Database setup
1) install MySQL server
{{apt-get install mysql-server}}
2) use your favorite MySQL manager and create an empty database
If you wish to have more cluster nodes than one, or your database server is different than your OpenVZ server, you need to allow access to the DB from those nodes.
3) fill your DB with these data:
(also available in setup/db_schema.sql in the vpsAdmin package)
{{CREATE TABLE `cfg_diskspace` (                  
  `d_id` int(10) unsigned NOT NULL auto_increment,
  `d_gb` int(10) unsigned NOT NULL,               
  `d_label`
  `d_label` varchar(64) NOT NULL,                 
  PRIMARY
  PRIMARY KEY  (`d_id`)                           
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;            
CREATE
CREATE TABLE `cfg_dns` (                          
  `dns_id` int(10) unsigned NOT NULL auto_increment,
  `dns_ip` varchar(63) NOT NULL,                    
  `dns_label`
  `dns_label` varchar(63) NOT NULL,                 
  `dns_is_universal` tinyint(1) unsigned default '0',
  `dns_location` int(10) unsigned default NULL,      
  PRIMARY
  PRIMARY KEY  (`dns_id`)                            
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;               
CREATE
CREATE TABLE `cfg_privvmpages` (                     
  `vm_id`
  `vm_id` int(10) unsigned NOT NULL,                 
  `vm_label`
  `vm_label` varchar(64) NOT NULL,                   
  `vm_lim_hard`
  `vm_lim_hard` int(10) unsigned NOT NULL,           
  `vm_lim_soft`
  `vm_lim_soft` int(10) unsigned NOT NULL,           
  `vm_usable`
  `vm_usable` tinyint(1) NOT NULL default '1',       
  PRIMARY
  PRIMARY KEY  (`vm_id`)                             
)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;                
CREATE
CREATE TABLE `cfg_templates` (                       
  `templ_id` int(10) unsigned NOT NULL auto_increment,
  `templ_name` varchar(64) NOT NULL,                  
  `templ_label`
  `templ_label` varchar(64) NOT NULL,                 
  `templ_info`
  `templ_info` text,                                  
  PRIMARY
  PRIMARY KEY  (`templ_id`)                           
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                
CREATE
CREATE TABLE `firewall` (                             
  `id`
  `id` int(11) NOT NULL auto_increment,               
  `ip`
  `ip` int(11) NOT NULL,                              
  `command` varchar(255) character set latin1 default NULL,
  `ordinal` int(11) default NULL,                          
  `approved`
  `approved` tinyint(1) default NULL,                      
  PRIMARY
  PRIMARY KEY  (`id`)                                      
) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;
CREATE TABLE `locations` (                                  
  `location_id`
  `location_id` int(10) unsigned NOT NULL auto_increment,   
  `location_label`
  `location_label` varchar(63) NOT NULL,                    
  `location_has_ipv6`
  `location_has_ipv6` tinyint(1) NOT NULL,                  
  PRIMARY
  PRIMARY KEY  (`location_id`)                              
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                      
CREATE
CREATE TABLE `members` (                                    
  `m_info`
  `m_info` text,                                            
  `m_id`
  `m_id` int(10) unsigned NOT NULL auto_increment,          
  `m_level`
  `m_level` int(10) unsigned NOT NULL,                      
  `m_nick`
  `m_nick` varchar(63) NOT NULL,                            
  `m_name`
  `m_name` varchar(255) NOT NULL,                           
  `m_pass`
  `m_pass` varchar(255) NOT NULL,                           
  `m_mail`
  `m_mail` varchar(127) NOT NULL,                           
  `m_address`
  `m_address` text NOT NULL,                                
  `m_lang`
  `m_lang` varchar(16) default NULL,                        
  `m_paid_until`
  `m_paid_until` varchar(32) default NULL,                  
  `m_last_activity`
  `m_last_activity` int(10) unsigned default NULL,          
  PRIMARY
  PRIMARY KEY  (`m_id`)                                     
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                      
CREATE
CREATE TABLE `servers` (                                    
  `server_id`
  `server_id` int(10) unsigned NOT NULL auto_increment,     
  `server_name`
  `server_name` varchar(64) NOT NULL,                       
  `server_location`
  `server_location` int(10) unsigned NOT NULL,              
  `server_availstat`
  `server_availstat` text,                                  
  `server_ip4`
  `server_ip4` varchar(127) NOT NULL,                       
  `server_maxvps`
  `server_maxvps` int(10) unsigned default NULL,            
  `server_path_vz` varchar(63) NOT NULL default '/var/lib/vz',
  PRIMARY KEY  (`server_id`)                                  
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                        
CREATECHARSET=utf8 AUTO_INCREMENT=100;
CREATE TABLE `servers_status` (                               
  `id`
  `id` bigint(20) unsigned NOT NULL auto_increment,           
  `server_id`
  `server_id` int(10) unsigned NOT NULL,                      
  `timestamp`
  `timestamp` int(10) unsigned NOT NULL,                      
  `ram_free_mb`
  `ram_free_mb` int(10) unsigned default NULL,                
  `disk_vz_free_gb`
  `disk_vz_free_gb` float unsigned default NULL,              
  `cpu_load`
  `cpu_load` float unsigned default NULL,                     
  `vpsadmin_version`
  `vpsadmin_version` varchar(63) default NULL,                
  PRIMARY
  PRIMARY KEY  (`id`)                                         
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                        
CREATE
CREATE TABLE `sysconfig` (                                    
  `cfg_name`
  `cfg_name` varchar(127) NOT NULL,                           
  `cfg_value`
  `cfg_value` text,                                           
  PRIMARY
  PRIMARY KEY  (`cfg_name`)                                   
)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;                         
CREATE
CREATE TABLE `transactions` (                                 
  `t_id`
  `t_id` int(10) unsigned NOT NULL auto_increment,            
  `t_group`
  `t_group` int(10) unsigned default NULL,                    
  `t_time`
  `t_time` int(10) unsigned default NULL,                     
  `t_m_id`
  `t_m_id` int(10) unsigned default NULL,                     
  `t_server`
  `t_server` int(10) unsigned default NULL,                   
  `t_vps`
  `t_vps` int(10) unsigned default NULL,                      
  `t_type`
  `t_type` int(10) unsigned NOT NULL,                         
  `t_success`
  `t_success` int(10) unsigned NOT NULL,                      
  `t_done`
  `t_done` tinyint(1) unsigned NOT NULL,                      
  `t_param`
  `t_param` text,                                             
  `t_output`
  `t_output` text,                                            
  PRIMARY
  PRIMARY KEY  (`t_id`)                                       
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                        
CREATE
CREATE TABLE `transaction_groups` (                           
  `id`
  `id` int(10) unsigned NOT NULL auto_increment,              
  `is_clusterwide`
  `is_clusterwide` tinyint(1) unsigned default '0',           
  `is_locationwide`
  `is_locationwide` tinyint(1) unsigned default '0',          
  `location_id`
  `location_id` int(10) unsigned default '0',                 
  PRIMARY
  PRIMARY KEY  (`id`)                                         
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                        
CREATE
CREATE TABLE `transfered` (                                   
  `tr_id`
  `tr_id` int(10) unsigned NOT NULL auto_increment,           
  `tr_ip`
  `tr_ip` varchar(127) NOT NULL,                              
  `tr_nix_in`
  `tr_nix_in` bigint(63) unsigned default '0',                
  `tr_nix_out`
  `tr_nix_out` bigint(63) unsigned default '0',               
  `tr_tzt_in`
  `tr_tzt_in` bigint(63) unsigned default '0',                
  `tr_tzt_out`
  `tr_tzt_out` bigint(63) unsigned default '0',               
  `tr_time`
  `tr_time` int(10) unsigned NOT NULL,                        
  PRIMARY
  PRIMARY KEY  (`tr_id`)                                      
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                        
CREATE
CREATE TABLE `vps` (                                          
  `vps_id`
  `vps_id` int(10) unsigned NOT NULL auto_increment,          
  `m_id`
  `m_id` int(63) unsigned NOT NULL,                           
  `vps_hostname`
  `vps_hostname` varchar(64) default 'darkstar',              
  `vps_template`
  `vps_template` int(10) unsigned NOT NULL default '1',       
  `vps_info`
  `vps_info` mediumtext,                                      
  `vps_nameserver`
  `vps_nameserver` varchar(255) NOT NULL default '4.2.2.2',   
  `vps_privvmpages`
  `vps_privvmpages` int(10) unsigned NOT NULL default '1',    
  `vps_cpulimit`
  `vps_cpulimit` varchar(255) default NULL,                   
  `vps_cpuprio`
  `vps_cpuprio` varchar(255) default NULL,                    
  `vps_diskspace`
  `vps_diskspace` int(10) unsigned NOT NULL default '1',      
  `vps_server`
  `vps_server` int(11) unsigned NOT NULL,                     
  `vps_fuse_enabled`
  `vps_fuse_enabled` tinyint(1) default '0',                  
  `vps_tuntap_enabled`
  `vps_tuntap_enabled` tinyint(1) default '0',                
  `vps_iptables_enabled`
  `vps_iptables_enabled` tinyint(1) default '0',              
  PRIMARY
  PRIMARY KEY  (`vps_id`)                                     
)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;                        
CREATE TABLE `vps_ip` (
  `ip_id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `ip_v` int(10) unsigned NOT NULL default '4',
  `ip_location` int(10) unsigned NOT NULL,
  `ip_addr` varchar(40) NOT NULL,
  PRIMARY KEY  (`ip_id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
CREATE TABLE `vps_snapshots` (
  `s_id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `server_id` varchar(63) NOT NULL,
  `s_name` varchar(63) NOT NULL,
  `s_time` int(10) unsigned NOT NULL,
  `s_size_mb` int(10) unsigned default NULL,
  PRIMARY KEY  (`s_id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;
CREATE TABLE `vps_status` (
  `id` int(10) unsigned NOT NULL auto_increment,
  `vps_id` int(10) unsigned NOT NULL,
  `timestamp` int(10) unsigned NOT NULL,
  `vps_up` tinyint(1) unsigned default NULL,
  `vps_nproc` int(10) unsigned default NULL,
  `vps_vm_used_mb` int(10) unsigned default NULL,
  `vps_disk_used_mb` int(10) unsigned default NULL,
  `vps_admin_ver` varchar(63) default 'not set',
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
INSERT INTO `members` (
`m_info`, `m_id`, `m_level`,
`m_nick`, `m_name`, `m_pass`,
`m_mail`, `m_address`, `m_lang`,
`m_paid_until`, `m_last_activity` )
 VALUES (NULL ,  '1',  '99',
'admin',  'fill in',
'f6fdffe48c908deb0f4c3bd36c032e72',
'admin@admin.example',  'fill in', NULL , NULL , NULL);}}

!Welcome to vpsAdmin wiki!

* [Download]
* [vpsAdmin concepts] (We recommend to read this document, before you go to installation process)
* [Installation]
* [Basic usage]
* [FAQ]
* [Team]

'''vpsAdmin''' is free software application providing web-based GUI for administration of [OpenVZ|http://openvz.org] containers technology. It is written in PHP 5.2 using MySQL 5 database for storing and replicating data. The application is originally written for personal purpose of [vpsFree.cz|http://vpsFree.cz] (currently available only in Czech languge). There is no stable release available, but we are very close to publication of the version 1.0.

!Key features
* Full VPS and customers management (including basic support for payments)
* Ability to change RAM + HDD limits of VPS
* IP address management (both IPv4 and '''IPv6''' support)
* Multiple server support - '''cluster management'''
* Separation of executive (privileged) and web-GUI (unprivileged) parts to provide more security; providing '''transaction log'''
* Multilingual support via gettext (at the moment, only English language is available)
* Supported host OS: '''Debian GNU/Linux 5.0 (lenny)''', {small}CentOS has been confirmed to work as well{/small}


!License
vpsAdmin is relased under [GNU General Public License v3|http://www.gnu.org/licenses/gpl-3.0-standalone.html].


!GIT Repository
Our GIT repository can be found at [gitorious.org/vpsadmin|http://gitorious.org/vpsadmin]. If you want to get the latest code, simply run from terminal:

{{git clone git://gitorious.org/vpsadmin/vpsadmin.git }}

[Back to Main page|Main page]

!Installation

This page describes installation process on fresh installation of '''Debian 5.0 (lenny)'''
Please note that OpenVZ Quotas for diskspace VPS accounting supports only '''ext2'''/'''ext3''' filesystems. You might use other file-system than ext2/ext3, but OpenVZ won't be able to limit disk usage of VPS. Thus, vpsAdmin will not be capable of setting those limits. 

Installation process consists of three main parts, which can be split on different servers:
* database server for vpsAdmin (MySQL5+ only)
* cron backend (PHP5)
* web frontend (Apache + PHP5)

To install vpsAdmin, please follow stepscontinue in following sections:

* [OpenVZ installation]
* [Database setup]
* [vpsAdmin frontend installation]
* [Basic vpsAdmin setup]
* [vpsAdmin backend installation]
* [Get the migration working]

[Back to Installation|Installation]

!vpsAdmin backend installation

1) install packages
{{apt-get install php5 php5-cli php5-mysql}}
2) change your cwd
{{cd /opt/}}
3) download vpsAdmin
{{wget http://vpsadmin.org/downloads/vpsadmin-1.0.tar.gz}}
4) unpack
{{tar xvf vpsadmin-1.0.tar.gz}}
5) create /etc/vpsadmin/config.php file using eg. the nano editor
{{nano /etc/vpsadmin/config.php}}
6) edit it to look like this
{{<?php
define ('HOSTNAME', 'vpsadminNode.company.com'); // node hostname
define ('SERVER_ID', 1); // use your cluster node count + 1 for SERVER_ID
define ('NETDEV', 'eth0'); // use linux ethernet interface name of that, which is connected to the Internet
define ('DB_HOST', 'localhost'); // your DB host
define ('DB_USER', 'vpsadmin'); // your DB user
define ('DB_PASS', 'password'); // your DB password
define ('DB_NAME', 'vpsadmin'); // your DB name
define ('WWW_ROOT', "/opt/vpsadmin/"); // vpsAdmin installation path

// Edit these only if you know, what are you doing:
define ('BIN_VZLIST', 'sudo /usr/sbin/vzlist');'/usr/sbin/vzlist');
define ('BIN_VZCTL', 'sudo /usr/sbin/vzctl');'/usr/sbin/vzctl');
define ('BIN_CAT', 'sudo /bin/cat');'/bin/cat');
define ('BIN_BRCTL', 'sudo /usr/sbin/brctl');'/usr/sbin/brctl');
?>}}
7) Add these lines to /etc/crontab (use your installation path if it differs)
{{*/5 * * * * root php /opt/vpsadmin/cron.php 2> /dev/null
@reboot root php /opt/vpsadmin/cron_reboot.php 2> /dev/null}}
8) If you have vpsAdmin frontend installed, go to page '''Manage cluster''' and select '''Register new node'''
Fill in these values:
{{ID: your server ID (if this is your first node, then 1)
Name: short name of the node (eg. alfa)
Location: select location of this node (if you don't have any, you have to create one)
}}

[Back to Main page|Main page]

!Installation

This page describes installation process on fresh installation of '''Debian 5.0 (lenny)'''
Please note that OpenVZ Quotas for diskspace VPS accounting supports only '''ext2'''/'''ext3''' filesystems. You might use other file-system than ext2/ext3, but OpenVZ won't be able to limit disk usage of VPS. Thus, vpsAdmin will not be capable of setting those limits. 

Installation process consists of three main parts, which can be split on different servers:
* database server for vpsAdmin (MySQL5+ only)
* cron backend (PHP5)
* web frontend (Apache + PHP5)

To install vpsAdmin, please follow these steps:steps in sections:

* [OpenVZ installation]
* [Database setup]
* [vpsAdmin frontend installation]
* [Basic vpsAdmin setup]
* [vpsAdmin backend installation]
* [Get the migration working]