• NAME
• General
• Preparations
• Receipts
  • First Call Example
• ENVIRONMENT
  • Android
  • CentOS
  • debian
  • eeDroid
  • EnterpriseLinux
  • Fedora
  • FreeBSD
  • Gentoo
  • Knoppix
  • Mandriva
  • MeeGo
  • MS-Windows - MSProducts
  • NetBSD
  • OpenBSD
  • OpenSolaris
  • OpenSUSE
  • RHEL
  • Scientific
  • Solaris
  • Ubuntu
• SEE ALSO
• AUTHOR
• COPYRIGHT

.

NAME

ctys-config-guest-sources - Configure installation automation of GuestOSs

General

This document describes the provisioning of automated installation procedures by ctys-createConfVM(1) , either semi-automatic or fully automatic .

The almost only required configuration is the access path to the installation media for the GuestOS. The media could be accessed by various protocols, either local or remote, in general more or less any URI is supported.

The resulting degree of automation depends on the provided means of the GuestOS. When a method like kickstart ist provided this could be configured as a parameter and provides a full turn-key automation. In case of means of offline installation like debootstrap a full degree of installation automation is provided too.

The predefined parameters may be used in cases of configuration-only calls too, where specific parameters for defined versions coul be predefined. This also comprises the abort of the installation for unsupported configuration requests.

The only drawback of a missing default set is the mandatory requirement of interactive proceeding.

Preparations

The first step is the configuration of the installation soources for ctys-createConfVM(1). Theese are are looked up first in the user's home directory

  ${HOME}/.ctys/ctys-createConfVM.d/defaults-${C_SESSIONTYPE}.ctys

second within the installation currently executed path

  ${MYCONFPATH}/ctys-createConfVM.d/defaults-${C_SESSIONTYPE}.ctys

Additionally new files have to be registered in the file

  ${MYCONFPATH}/ctys-createConfVM.d/hook.sh

The priority is to use the first matched value.

The installation by usage of a boot media does not require additional configurations, whereas the application of PXE may require some additional setup. This comprises the network services including the appropriate setup of the local BIOS, and probably the use of some initial boot-up media.

Once this step is completed, the option ' --auto ' and --auto-all ' could be applied for semi or full-automation.

Receipts

First Call Example

The configuration could be proceeded by editing the appropriate configuration file as defined in the preparations section.

The sources could be either provides by local file access including NFS mounts, or by use of protocols such as FTP or HTTP as provided by the installer of the guest system. The setup of PXE requires various additional configurations.

The hypervisors VirtualBox and VMware are supported by interactive configuration and manual installation of guest systems only.

The following call creates a dummy VM with a small dummy-image by application of --auto-all , which supports the complete automation of configuration and guest systems.

  
  MAC=00:11:22:33:44:55 \
  IP=12.12.12.12 \
  TCP=gecko \
  HDDBOOTIMAGE_INST_SIZE=128M \
  HDDBOOTIMAGE_INST_BLOCKSIZE=32M \
  HDDBOOTIMAGE_INST_BLOCKCOUNT=4 \
  ctys-createConfVM \
    -t XEN \
    --label=tst02 \
    --auto-all \
    --create-image
  

Attributes of the created VMs could be varied by application of the utility ctys-attribute(1).

ENVIRONMENT

The following keys are available for selection. These partly depend on additional attributes, e.g. the ARCH or ACCEL keys.

The current present configuration sources are listend within the following table. The configured paths has to be adapted within the configuration files. Missing configuration options are supported by interactive configuration only.

The distribution names and OS names are owned by their suppliers and may/are protected by trademarks.

SEE ALSO

UserManual , CommandReference , HowTo

ctys-attribute(1) , ctys-cloneVM(1) , ctys-createConfVM(1) , ctys-convertVM(1)

AUTHOR

Arno-Can Uestuensoez	<https://arnocan.wordpress.com/>
	<https://unifiedsessionsmanager.sourceforge.io/>
	<https://github.com/unifiedsessionsmanager>

COPYRIGHT

Copyright (C) 2008, 2009, 2010, 2011, 2020 Ingenieurbuero Arno-Can Uestuensoez

For BASE package following licenses apply,

• for software see GPL3 for license conditions,
• for documents see GFDL-1.3 with invariant sections for license conditions,

This document is part of the DOC package,

• for documents and contents from DOC package see
  'Creative-Common-Licence-3.0 - Attrib: Non-Commercial, Non-Deriv'
  
  
  with optional extensions for license conditions.

For additional information refer to enclosed Releasenotes and License files.