VDSmanager installation

From ISPWiki

System requirements

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

VDSmanager-FreeBSD - FreeBSD 8.0 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; for FreeBSD - system without additional packages, for Linux - minimal installation. For more information about how to install VDSmanager-Linux running on Xen, please read Installing XEN.

Disk format

VDSmanager-FreeBSD:

/ - 4 Gb
/vs - the rest of the space

VDSmanager-Linux + OpenVZ:

/ - 6 Gb
/vz - the rest of the space

VDSmanager-Linux + Xen 4:

/ - 30 Gb    (you need a 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 an automatic installer on Debian 5.0 from the repository from the standard Debian repositories. If Xen 3 is used, you cannot create virtual servers with guest FreeBSD operating system (only with Linux). Note the following disk format:

/ - 6 Gb
/xen - the rest of the space.

Swap (for all systems)

You will also need a partition that will be used as swap. Its size depends on the server operating memory, and 4 GB is normally enough.

If you wish to make backup copies on the server, the size of a root partition should be enlarged by the size that you want to use for backup copies.

Server IP-address

For the software installation use a real static IP-address, that is located on the network server. Use it for connection via http (addresses translation is not allowed).

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

Installation guide

Step 1

You should have a valid license. If not, you can order it here here. If you are not sure whether your license is active, you may check it in BILLmanager.

Step 2

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

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

Then

sh install.sh

Keys for the install.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 prompted you for an admin password to access VDSmanager.

Please enter admin password to access the control panel :

Also a new kernel of the operating system will be installed and you will be prompted for the server reboot.

If you want ISPmanager administrators to install VDSmanager, you should let them know the root password on your server. This administrator should have access to the server via SSH. To do so, enable the PermitRootLogin yes option in the /etc/ssh/sshd_config file.

Step 3

To access VDSmanager use this URL, using IP-address of your server. For authorization use accounts from the VDSmanager configuration file, password is set when installing. Log in to the control panel with admin privileges.

https://IP-address/manager/vdsmgr

Technical details for FreeBSD

Install into /usr/local/ispmgr

If necessary, the following software will be installed (the list and versions may vary depending on the distribution): Apache Perl VDSmanager Kernel Additional utilities and disk templates

Apache

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

Include /usr/local/ispmgr/etc/ispmgr.inc To add secret keys for secure connection via SSL, use 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 directories required for their operation.

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

Notes for Debian (Xen 3.2)

Virtualization type is specified in the vdsmgr.conf configuration file, the corresponding type of virtualization (Virtualization xen) specifies the required virtualization system (xen1 for 3.2 and xen2 for 4.0) by means of a symbolic link in the /usr/local/ispmgr/lib/ directory. For example for xen 3.2.

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

A VDSmanager user's password is specified in the /usr/local/ispmgr/etc/vdsmgr.conf file:

User admin teH0wLIpW0gyQ

Sets a test password for admin