Configuration file (VDSmanager)

From ISPWiki

All VDSmanager settings are kept in /usr/local/ispmgr/etc/vdsmgr.conf. The article below вуаштуы parameters that can be used in the configuration file.
Please note, that lines beginning with // (double slash), or beginning with /* and ending with */ are ignored by the control panel and can be used as comment lines.

Contents

General parameters

BackupCounts - the number of backup copies of VPS private files. We strongly recommend that you change this parameter only in the Backup module of the control panel.

BackupDestDir - the directory in which backup copies are stored. Specify the full path to the local directory, if used. If a remote FTP server is used, provide ftp as a first parameter, the second one should be specified in the ftp format://user:password@host/directory. We strongly recommend that you modify these parameters only in the Backup module of the control panel.

DefaultLang - a default language of the control panel interface.

DefaultTheme - a default theme of the control panel. The following themes are currently available: aqua, classic and modern (default).

InactivityTimeOut - the time elapsed from the latest operation performed in the control panel followed by the vdsmgr process upload from the memory. It can be used if there is insufficient system memory.

LogLevel - the VDSmanager logging level (/usr/local/ispmgr/var/ispmgr.log). The following logging levels are currently available:

0 - notes.

1 - fatal errors.

2 - not used.

3 - errors.

4 - warnings.

5 - information.

6 - detailed information.

7 - not used.

8 - оdebug information (for developers only)

9 - trace information (for developers only)

MountDir - the full path to the directory to which VPS disks are mounted when starting.

PrivateDiskDir - the full path to the directory where VPS private files are kept. If you want to use several directories, specify them space separated. The control panel will check equal that VPS disks are equally distributed among these parts.

VolumeGroupName - a name of the LVM group where VPS partitions were created. This parameter is only used for KVM. For example, VolumeGroupName kvm00.

TmpDir - a temporary directory that is used for migration, backups and restore.

TrustIP - an IP-address that is allowed to access VDSmanager without authorization. The second parameter is a username whose permissions will be used to access the control panel. If not specified, root privileges will be used.

VdsInterface - a name of the interface that is used for VPS creation.

AltTplMirror - this parameter allows to choose additional sources of VPS templates. For example: AltTplMirror http://10.1.1.1/templates means that VDSmanager is trying to download the list-file that contains a list of templates from the following sources:

Options

PresetChangesResource - apply changes made to a VPS template to all virtual servers that were created using that template.

ForceOrderLicense - order ISPmanager automatically for VPSs which templates do not include ISPmanager.

HumanFileSize - display the file size in the "Private files" module in the human readable format.

LicDeleteUnused - this option enables to unassign ISPmanager PRO from the IP address of a newly created virtual host, if "No ISPmanager license" was selected in the "ISPmanager licenses" field was selected.

If you want to activate several options, add the Option directive for each option.

User accounts

The User parameter of the configuration file describes properties of the control panel's administrator and user accounts. The first parameter is his login that is used to access the control panel, the second one is his password hash. For example:

User admin $2a$04

Disk template

A disk template is a set of pre-defined software for virtual private servers. You can have several templates. They allow to save disk space, as their files are shared among all virtual private servers that make use of them. These templates are described in the configuration file with disktemplate:

disktemplate "Template name" { parameters set }

Specify the following parameters:

Path - a full path to the directory where the template file is located.

Status - as the installation and update processes run automatically, this parameter shows the current status of that process. We recommend that you not modify this parameter.

VPS templates

VPS templates are pre-installed parameters for a virtual server creation. They are described in the configuration file with preset:

preset "Template name" { parameters set }

Specify the following parameters:

CPU - the maximum amount of (in MHz) CPU time allocated to a virtual private server.

NoBackup (yes/no) - check the box to allow/deny backing up of your server.

Disabled (yes/no) - check the box to suspend your VPS.

VDSmanager-FreeBSD

JailShutdownTimeout - sets the period that the processes are allowed to idle before they are terminated upon disabling of jail.

VDSmanager-Linux under Xen

path xen-kernel - the path to the Xen kernel, such as path xen-kernel /boot/vmlinuz-2.6.18-92.1.13.el5xen).

path xen-ramdisk - the path to initrd, such as path xen-ramdisk /boot/initrd-centos5-xen.img).

path xm - the path to the xm executable file.

VdsIpMask - allows to set a subnetwork mask for a newly created VPS.

VdsGateway - the gateway IP-address for a newly created VPS.

If the VdsIpMask and VdsGateway parameters are not specified, subnetwork mask 255.255.255.0 and the default gateway will be used.

CpuFreq - if VDSmanager failed to define CPU frequency, you can specify it in this parameter.

CpuCount - the number of cores.

VDSmanager-Linux under KVM

Option VirtualCD - allows to add ISO-image as CD-Rom, and provide the priority for the boot from the control panel (can be used when creating templates).

Option SoftReboot - adds the Disable and Reboot buttons to the toolbar to perform the same actions as the halt and reboot commands do in a VPS.

Option AntiSpoof - enables anti-spoofing (the sbin/kvm_ipctl script is executed every time you perform an action over an IP-address. The script adds rules to iptables).

Bridge - specifies a name for the network bridge that will be connected with virtual network interface.

OversellMem - allows to set overselling of RAM. For example, if you have a server with 8 GB of RAM and set OversellMem 1.5, the guaranteed RAM for virtual servers will be 12 GB. Note that using overselling may lead to extensive loss of productivity if virtual servers will start consuming too much RAM.