Skip to content

Latest commit

 

History

History
127 lines (86 loc) · 2.83 KB

INSTALL.md

File metadata and controls

127 lines (86 loc) · 2.83 KB

OpenVZ Web Panel Installation

Table of contents:

  1. Requirements
  2. Installation the build
  3. Installation from SVN repository
  4. Uninstallation

1. Requirements

The following software is required to be installed on server with panel:

  • Ruby 1.8.5+ (1.9 is not supported)
  • RubyGems
  • Ruby SQLite3 support

The following software is required to be installed on physical server, which will be used for OpenVZ containers:

  • OpenVZ kernel
  • OpenVZ tools (vzctl, vzlist)
  • Ruby 1.8.5+ (1.9 is not supported)

2. Installation of the build

Place build archive to the server where you plan to run the panel. Move build archive content to destination directory, e.g. /opt/ovz-web-panel/. This can be achived using the following command:

tar -xzvf ovz-web-panel-X.X.tgz -C /opt/

Panel is written on Ruby. So you need to have it to run the panel. Please check the Ruby version:

ruby -v

If you haven't ruby installed jet it's time to install it. For example on Ubuntu using apt:

apt-get install ruby rubygems libsqlite3-ruby

To start the panel run the command:

sudo /opt/ovz-web-panel/script/owp start
# or
/etc/init.d/owp start

To shutdown application the following command can be used (be careful):

sudo /opt/ovz-web-panel/script/owp stop
# or
/etc/init.d/owp stop

Then need to place hardware daemon on the server with OpenVZ. There are two possible scenarios: panel is installed on hardware node or panel is on separate server. Physical server daemon located at /utils/hw-daemon/ Copy content of directory to OpenVZ physical server. Then copy hw-daemon.ini.sample to hw-daemon.ini. Next step is to generate unique key, which will be used for authorization between panel and daemon. Key can be generated using the following command for example:

head -c 200 /dev/urandom | md5sum

Key should be placed to hw-daemon.ini as a value of "key" parameter. Now daemon can be started by the command:

sudo ruby hw-daemon.rb start

Daemon should work under root user to be able to manipulate with containers.

To start the daemon run:

sudo ruby hw-daemon.rb start

Daemon can be stopped using the following command

sudo ruby hw-daemon.rb stop

3. Installation from SVN repository

Source code can be checked out anonymously via:

svn checkout http://ovz-web-panel.googlecode.com/svn/trunk/ owp

File http://code.google.com/p/ovz-web-panel/source/browse/trunk/build/build.sh contains information on how to prepare working copy.

One of key steps is to create/upgrade database after code update:

cd /opt/ovz-web-panel/
rake db:migrate RAILS_ENV="production"

4. Uninstallation

To uninstall the product need to run the command:

wget -O - http://ovz-web-panel.googlecode.com/svn/installer/ai.sh | sh -s UNINSTALL=1