VDS64_CentOS54, VDS_CentOS54: Virtual Dedicated Server Applications

Functional overview

VDS64_CentOS54 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 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	Notes
VDS64_CentOS54	1.0.0-1	CentOS 5.4 (64 bit)
VDS_CentOS54	1.0.0-1	CentOS 5.4
VDS64_CentOS50	1.0.15-1	CentOS 5 (64 bit)	This application has been deprecated; it is suggested to use VDS64_CentOS54.
VDS_CentOS51	1.0.14-1	CentOS 5.1	This application has been deprecated; it is suggested to use VDS_CentOS54.

Boundary

Resources

VDS_CentOS54

Resource	Minimum	Maximum	Default
CPU	0.05	16	0.25
Memory	128 MB	32 GB	256 MB
Bandwidth	1 Mbps	2 Gbps	1 Mbps
Storage	1.4 GB	80 GB	2 GB

VDS64_CentOS54

Resource	Minimum	Maximum	Default
CPU	0.05	16	0.25
Memory	128 MB	32 GB	512 MB
Bandwidth	1 Mbps	2 Gbps	1 Mbps
Storage	1.6 GB	80 GB	2.5 GB

Terminals

Name	Dir	Protocol	Description
`none`

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).

User Volumes

None

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`	String	Defines the default IPv6 network gateway (router) for the external interface. This property should be defined if IPv6 is used. Default: (empty).
`dns1`	String	Defines the primary nameserver (v4 or v6). This property is mandatory.
`dns2`	String	Defines the secondary server (v4 or v6). Default: (empty).
`dns3`	String	Defines the third server (v4 or v6). Default: (empty).

Typical Usage

The folowing shows the typical useage of the VDS_CentOS54 application

VDS_CentOS54 is to be used by hosting providers in order to offer dedicated servers using 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_CentOS54 can be done by running a single command that can be automated from the providers portal.

app provision VDS_CentOS54_r1 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_CENTOS54.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 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.

To see the full list of open source packages used in VDS64_CentOS54, please see its implementation design.

To see the full list of open source packages used in VDS_CentOS54, please see its implementation design.