FreeVPS Documentation

FreeVPS Tools
(version 1.3)

 

Related Docs:  

FreeVPS Installation FreeVPS Kernel H-Sphere VPS Scripts FreeVPS Bug Tracker



To manage your Virtual Private Servers, you need special tools installed on your host:

For quota support inside VPS, please refer to VPS Quota Reconfiguration guide.

 

FreeVPS Tools

FreeVPS tools provide basic virtual context tools, such as:

- virtual context management:
- virtual context limits control:
- configure virtual network interfaces:
- calculate total file size on the virtual server;
- set/show extended attributes of the file in virtual context;
- tool to display top CPU processes for virtual context;
- VPS management script.

You can download the tarball with tools sources or rpm package from:

a) latest snapshots:
http://www.freevps.com/download/snapshots
b) latest stable release:
http://www.freevps.com/download/rpms/RH_73
http://www.freevps.com/download/rpms/RH_EL

Core FreeVPS tools contain the following utilities:

  1. vserver_ctl

    • create/destroy new virtual context structure in the kernel
    • set/remove capabilities for virtual context
    • allow/disallow processes creation at virtual context
    • migrate from the root context to the selected virtual context
    • execute commands in virtual context
    • display virtual context run status and brief context statistics
    • send signals to all processes in virtual server

  2. vserver_limit - manages VPS limits:

    • virtual memory usage limit for processes run in virtual context
    • resident memory usage limit for processes run in virtual context
    • limit on the number of processes run in virtual context
    • disk usage limit for the virtual context
    • limit on the number of the virtual context file handles
    • tcp connections limit to virtual context
    • root directory for virtual context

  3. showattrib, setattrib - manage files' and directories' additional attributes:

    • context tag
    • flag for files shared between contexts
    • immutable flag

  4. vdu - calculates disk usage for a context

  5. vifconfig - manages virtual network devices:

    • attach/detach virtual network interfaces
    • assign/disable IP addresses for using at virtual network interfaces
    • set virtual network interface shaper speed
    • set various flags to virtual interface

  6. vtop - display top CPU processes for virtual context

  7. vps - shows brief information about services running by contexts

  8. vserver - script to control VPS servers:

    • start/stop/restart VPS
    • enter VPS and start existing there shell
    • execute commands in VPS
    • return VPS status

You may also read man for each of these utilities to get more details on their syntax and functionality.

To build latest freevps-tools, please read building freevps-tools binaries.

 

H-Sphere VPS Scripts

H-Sphere VPS scripts require FreeVPS tools installed on a VPS host server.

These scripts create and manage virtual server environment, namely:

  • install core RPMS packages for basic VPS - base template;
  • add, delete, create and install additional H-Sphere VPS templates.

    The following templates are available:

     samba-server - Windows File Server;
     ftp-server - FTP Server;
     pgsql-server - Postgresql SQL Database;
     web-server - Web Server;
     dns-server - DNS Name Server;
     mysql-server - MySQL Database;
     mail-server - Mail Server;
     news-server - News Server;
     system-tools - System Tools;
     development-tools - Development Tools;
     perl-full - Perl programing language modules.

  • configure basic and additional services;
  • create required system devices;
  • create/destroy virtual network interfaces or virtual network interface aliases;
  • assign/remove/up/down reconfigure IPs on existing VPS's virtual network interfaces;
  • start/stop/suspend/resume VPS;
  • manage VPS limits;
  • provide VPS management via H-Sphere Control Panel interface.

Read the H-Sphere VPS Scripts guide for the comprehensive description of H-Sphere VPS scripts.

Also, read about H-Sphere VPS configuration in the H-Sphere VPS Host Installation guide:



Home   Downloads   Docs   FAQ   News  Partners   Contact
© Copyright 1998-2006. Positive Software Corporation.
All rights reserved.