Previous Topic: Virtual Dedicated Server Application TemplatesNext Topic: Install Virtual Server for Installation of Oracle Database


VDS64_CentOS62: Virtual Dedicated Server Application

Latest Version: 2.0.1-1

Functional Overview

VDS64_CentOS62 is a dedicated virtual server application. The application is designed to be deployed standalone 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 VDSs, 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® for System z 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_CentOS62

2.0.1-1

CentOS 6.2 (64 bit)

Boundary

Resources

VDS64_CentOS62

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

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

This application is to be used by hosting providers to offer dedicated servers using CA AppLogic® for System z without the need for any other third-party software or licenses.

VDS64_CentOS62 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 the application can be done by running a single command that can be automated from the providers portal.

app provision VDS64_CentOS62_r2 ExampleClient \
    user=Exampleuser user_pw=abcd1234 root_pw=acbde12345 \
    primary_ip=fe80::1/64 secondary_ip=192.168.100.12 netmask=255.255.255.0 gateway=192.168.100.1 \
    ipv6_gateway=fe80::10 hostname=mydomain.com dns1=fe80::5 dns2=192.168.1.2 \
    cpu.dflt=0.50 mem.dflt=1G VDS64_CENTOS62.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® for System z-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 third-party software used inside of the application

This application does not use any open source packages in addition to those of their base OS CentOS 6.2 (64 bit).