Linux-based Virtual Dedicated Server Applications: VDS64_CentOS54, VDS

Reference Information › Application Catalog Reference Guide › VDS: Virtual Dedicated Server Application Templates › VDS64_CentOS63, VDS_CentOS63 › VDS64_CentOS55, VDS_CentOS55: Virtual Dedicated Server Applications

VDS64_CentOS55, VDS_CentOS55: Virtual Dedicated Server Applications

Latest Version: 1.0.7-1

Functional Overview

VDS64_CentOS50 and VDS_CentOS54 are dedicated virtual server applications. They are designed to be deployed as standalone applications with no catalog parts.

VDS applications can scale from approximately one twentieth of a physical server to a full physical server depending on the resource needs of the end user.

VDS applications include a basic build environment with GCC (if available).

With CentOS based VDS's, any of the other CentOS packages can be installed by the end user, simply by running yum -y install <package> while running as root user.

VDS applications are provided to allow hosting providers a quick and easy way to offer a dedicated server offering on the CA AppLogic® Grid.

VDS applications configure themselves through properties on first boot. The initial user is created and the root password is placed in a file (/home/<user>/su.txt). VDS applications can be reset to their default properties by deleting /appliance/passwd.stamp from the appliance and restarting the application.

Application	Latest Version	OS
VDS64_CentOS55	1.0.7-1	CentOS 5.5 (64 bit)
VDS_CentOS55	1.0.7-1	CentOS 5.5

Boundary

Resources

VDS_CentOS55

Resource	Minimum	Maximum	Default
CPU	0.05	16	0.25
Memory	160 MB	32 GB	256 MB
Bandwidth	1 Mbps	2 Gbps	1 Mbps

VDS64_CentOS55

Resource	Minimum	Maximum	Default
CPU	0.05	16	0.25
Memory	160 MB	32 GB	512 MB
Bandwidth	1 Mbps	2 Gbps	1 Mbps

Terminals

The external interface is enabled. It is used for incoming and outgoing traffic. Its network settings are configured through properties.

The default interface is enabled. It is used for maintenance (incoming ssh connections from the controller).

Properties

Property name	Type	Description
hostname	String	Defines the hostname to assign. This property is mandatory.
user	String	Defines the user to be created on provisioning of the application. This property is mandatory.
user_pw	String	Defines the password of the user account to be created. This property is mandatory.
root_pw	String	Defines the password of the root account. It will be set on the first boot and written to the /home/<user>/su.txt file. This property is mandatory.
primary_ip	String	Defines the primary IP address (v4 or v6) of the external interface of the appliance. This property is mandatory.
secondary_ip	String	Defines the secondary IP address (v4 or v6) of the external interface of the appliance. Default: (empty).
netmask	IP address	Defines the network mask of the external interface. This property should be defined if IPv4 is used. Default: (empty).
gateway	IP address	Defines the default IP network gateway (router) for the external interface. The gateway address can be outside the network specified by netmask. To use a gateway that does not expose an IP and serves as proxy ARP, set this property to 0.0.0.0. This property should be defined if IPv4 is used. Default: (empty).
ipv6_gateway	IP address	Defines the default IPv6 network gateway (router) for the external interface. This property should be defined if IPv6 is used. Default: (empty).
dns1	IP address	Defines the primary nameserver (v4 or v6). This property is mandatory.
dns2	IP address	Defines the secondary server (v4 or v6). Default: (empty).
dns3	IP address	Defines the third server (v4 or v6). Default: (empty).

Typical Usage

VDS_CentOS54 is to be used by hosting providers to offer dedicated servers using CA AppLogic® without the need for any other 3rd party software or licenses.

VDS_CentOS54 is distributed only as an application containing a single instance of the appliance and does not reside in any catalogs.

Notes

By way of example, provisioning VDS_CentOS55 can be done by running a single command that can be automated from the providers portal.

app provision VDS_CentOS55_r3 ExampleClient \
    user=Exampleuser user_pw=abcd1234 root_pw=acbde12345 \
    primary_ip=fe80::1/64 secondary_ip=209.100.100.12 netmask=255.255.255.0 gateway=209.100.100.1 \
    ipv6_gateway=fe80::10 hostname=mydomain.com dns1=fe80::5 dns2=209.101.1.2 \
    cpu.dflt=0.50 mem.dflt=1G VDS_CENTOS55.boot.size=10G

Limitations/Requirements

The /appliance directory MUST be left intact. Any changes to any files in this directory can cause the appliance to stop working.

Preventing vmad or vme from the /appliance directory from running on start will cause the appliance to stop working (on next restart).

Kernel updates and replacements should be based on CA AppLogic®-provided kernel sources.

The /root/.ssh/authorized_keys file should not be modified; it will be overwritten by the build system at runtime.

Error Messages

In case of application startup failure, the following errors may be logged to the system log:

Error message	Description
Incorrect 'primary_ip' value	VDS failed to validate 'primary_ip' configuration option.
Incorrect 'secondary_ip' value	VDS failed to validate 'secondary_ip' configuration option.
IPv4 DNS must be defined if IPv4-only networking is used	At least one IPv4 DNS server must be defined.
IPv6 DNS must be defined if IPv6-only networking is used	At least one IPv6 DNS server must be defined.
Failed to set hostname	VDS failed to setup appliance hostname.
Failed to set up external network	VDS failed to setup appliance interface.
Failed to set up external network -- primary and secondary IP's are identical	Primary and secondary IP's must differ
Failed to set up external network -- secondary IP XXX is in use	Secondary IP XXX is in use
Property netmask must be defined if IPv4 networking is used	Property netmask must be defined if defined any IPv4 address
Property gateway must be defined if IPv4-only networking is used	Property gateway should be defined when using only IPv4 networking
Property ipv6_gateway must be defined if IPv6-only networking is used	Property ipv6_gateway should be defined when using only IPv6 networking
Gateway is not defined	Either gateway or ipv6_gateway property should be defined

Open source and 3rd party software used inside of the application

VDS64_CentOS54 and VDS_CentOS54 do not use any open source packages in addition to those of their base OS CentOS 5.4 (64 bit) and CentOS 5.4 (32bit) respectively.