VDSmanager installation

From ISPWiki

Jump to: navigation, search

This article provides information on how to install the control panel on your server, including pre-requisites and the stages you should pass, as well as instructions on how to start working in VDSmanager.

Follow the steps below to perform a successful installation of VDSmanager:

Contents

System requirements

Before installing VDSmanager make sure that the requirements listed below are met.

Operating system requirements

Choice of operating systems depends on the VDSmanager version. You may use the following operating systems:

  • VDSmanager-FreeBSD - FreeBSD 9 amd64
  • VDSmanager-Linux running on OpenVZ - Linux CentOS 5.5
  • VDSmanager-Linux running on Xen 3.2/4.0 - Linux Debian 5.0

Fresh installation is required. A system without additional packages should be installed for FreeBSD, Linux requires a minimal version of the operating system.

For more information on how to install VDSmanager-Linux on Xen, please read the article Installing XEN.

Disk format

  • VDSmanager-FreeBSD:
/ - 4 Gb
/vs - remaining space 
  • VDSmanager-Linux + OpenVZ:
/ - 6 Gb
/vz - remaining space
  • VDSmanager-Linux + Xen 4:
/ - 30 Gb    (you are requiring the root that is 5-10 Gb larger than the server operating memory).

You do not need to format the rest of the space as it will be used through LVM. See also Installing XEN because its automatic installation is not supported.

  • VDSmanager-Linux + Xen 3.2:

If Xen 3.2 is used, it can be installed by the automatic installer on Debian 5.0 from the repository from the standard Debian repositories. If Xen 3 is used, you cannot create virtual servers under the FreeBSD guest operating system (Linux only). Consider the following disk format:

/ - 6 Gb
/xen - remaining space


  • VDSmanager-Linux + KVM

The main requirement is free space in /tmp that will be used when migrating and backing up. At least 30 Gb is required depending on the size and the number of VPSs.

/ - 60 Gb

/kvm - remaining space (if virtual disk images will be kept as files).

If you are going to use LVM to store virtual disk images, you must have enough unpartitioned space to keep VPS images.

  • Swap (for all systems)

You need a partition that will be used as swap. Its size depends on the size of server's operating memory (4 GB is recommended).

If you want to store backup copies on the server, the size of the root partition must be enlarged by the size you want to use for backup copies.

Server IP-address

For software installation use a valid static IP-address from the server network and connect through http (you cannot use NAT).

The IP-address for which the VDSmanager license was obtained must be the first one on the IP-addresses list returned by ifconfig. If not, you can run the instal.sh script with the --ip IP-address key.

Installation guide

Step 1

You need to have a valid license. If you do not have a license yet, order it here. If you are not sure whether your license is active, you may check this in BILLmanager.

Step 2

Enter shell on your server and run any of the commands below:


fetch http://download.ispsystem.com/install.4.sh
wget http://download.ispsystem.com/install.4.sh
curl -o install.4.sh http://download.ispsystem.com/install.4.sh

Then

sh install.4.sh

Keys for the install.4.sh start command that you should specify in case of problems:

--os OS Specify operating system manually --arch ARCH Specify architecture manually (i386, i686) --ip IP Specify License IP-addresses manually

Once the installation has been completed, you will be required to enter the admin password to access VDSmanager.

Please enter admin password to access the control panel :

Once the new kernel of the operating system is installed, you will be prompted to reboot the server.

If you want ISPmanager administrators to install VDSmanager, let them know a root password to access your server. The technical specialists must have enough privileges to access your server via SSH. To do that, enable the PermitRootLogin yes option in the /etc/ssh/sshd_config file.

Step 3

In order to access VDSmanager follow the link below providing the IP-address of your server. For authorization use the user accounts from the VDSmanager configuration file, and the password that was set during installation. Log in to the control panel with the admin privileges.

https://IP-address/manager/vdsmgr

Technical details

Provide installation into the /usr/local/ispmgr directory.

If necessary, the following software will be installed (the software and its versions may vary depending on the distribution):

Apache Perl VDSmanager Kernel Additional utilities and disk templates

The Includedirective that allows for VDSmanager operation is added into the Apache configuration file:

Include /usr/local/ispmgr/etc/ispmgr.inc

Create secret keys for secure connection via SSL by running the following command:

openssl req -new -newkey rsa:1024 -nodes -keyout /etc/mail/certs/server.key -x509 -days 5000 -subj "/C=XX/CN=host-name/emailAddress=root@host-name" -out /etc/mail/certs/server.crt

The key and certificate are copied into the associated directories.

/usr/local/etc/apache/ssl.crt/server.crt /usr/local/etc/apache/ssl.key/server.key

VDSmanager user password is specified in the /usr/local/ispmgr/etc/vdsmgr.conf file. The line

User admin teH0wLIpW0gyQ

sets the test password for the admin user that can be further altered via the web-interface. You can also add new administrators, however you cannot delete or rename the admin user account that VDSmanager uses for internal requests.

Technical details for Linux

VDSmanager under Linux supports several virtualization technologies, such as OpenVZ, vServer, Xen and KVM (experimental). The type of virtualization is specified in the vdsmgr.conf configuration file by the Virtualization directive. It may have the following parameters: openvz, vserver, xen, kvm. xen.

Two types of xen are currently supported. xen1 uses mount to get access to VPS private data, whilst xen2 uses a VPS virtual com port. We are developing and supporting xen2 only. To specify a supported type, you need to create a symbolic link to a corresponding file:

cd /usr/local/ispmgr/lib/
ln -sf xen1.so xen.so

Before installation make sure that repositories are configured and already running in Debian (in case of default installation from the disk they may not be specified, so the installation will complete), for example /etc/apt/sources.list

deb http://ftp.ru.debian.org/debian lenny main contrib non-free
deb http://security.debian.org/ lenny/updates main contrib non-free

Xen 4 or later is required for installing a VPS under FreeBSD. This version is not available in the repositories, so you will need to perform installation manually by setting up Xen and the Linux kernel from sources.

See also

VDSmanager:Troubleshooting

Was this helpful? Yes | No
Personal tools