README.txt
1 The main objective of this part of the Virtulatization Assistant Live-CD framework
2 is automating the build process of OpenSolaris JeOS images. As a secondary objective,
3 it provides means for automation of builds for OpenSolaris based application images too.
4
5 It leverages the OpenSolaris 200906 Automated Installer (AI). Consult the OpenSolaris
6 Automated Installer project (http://www.opensolaris.org/os/project/caiman/auto_install/)
7 for background information.
8
9 SSH access is enabled by default (assuming that a GRUB menu item with "+SSH" is selected). It is
10 however limited to public/private key pair based authentication (Amazon EC2 style).
11
12 You can attach an aditional virtual disk with zpool named "instance" to allow automatic
13 loading of authorized_keys. This zpool will be read when the system boots. The distribution
14 archive contains samples of zpool "instance".
15 You can use a GRUB menu item with "-SSH" to start the system with the SSH deamon disbaled
16 in order to edit keys safely.
17
18 Sample data for access to the VA Live-CD with SSH authorized keys are located in:
19 /usr/share/distro_const/virt_assist/sshvmkeys/
20
21
22 The functionality of the OpenSolaris 200906 Virtulatization Assistant Live-CD Prototype is
23
24 End User focused
25
26 * A) Small "Recovery Console" like functionality for Virtual Environments based
27 on OpenSolaris 200906 JeOS package list
28 * B) Easy iPKG/Repo AI Client based install of the OpenSolaris 200906 JeOS Prototype
29 to 10+ popular Virtualization Platforms with customization options
30 * C) Easy ZFS stream install of OpenSolaris 200906 JeOS Prototype ZFS snapshots
31 to 10 most popular Virtualization Platforms
32 * D) Easy HW migration between 10+ popular Virtualization Platforms
33 * E) Easy cleaning of installed OpenSolaris systems with ZFS snapshot/ZFS streaming
34
35 Developer focused
36
37 * I. It will display te IP address at the boot so developers don't need to login
38 for dynamic DHCP/IP assignments
39 * II. SSH in will be allowed only based on keys and will implement a mechanism to deliver
40 SSH keys and instance data on addon virtual disk
41 * III. Will implement cloning itself for customization with AI client profile, creation of
42 a distro constructor VM environment for VA Live-CD customizations (adding 64 bit
43 support, more drivers and bug fixes)
44 * IV. Will implement the creation of VM PKG REPO freezes with a pre-defined package lists
45 for fully local development
46 * V. Will implement call-home feature to be able to deliver news to users/developers
47 and get usage stats
48
49
50 See readmes in individual directories for modules functions and usage.
51
52 - Modules for testing the main VA Live-CD AI functionality
53
54 Module "testdrive.default" tests the AI Client functionality with default.xml
55 manifest (Full GUI Live-CD like installation profile) {x86 and SPARC}
56
57 Module "testdrive.JeOS" tests the AI Client functionality with JeOS.$myarch.xml
58 manifest (Set of packages selected to be in OpenSolaris 200906 JeOS
59 prototype) {x86 and SPARC}
60
61 Module "testdrive.JeOSlr" tests the AI Client functionality with JeOS-lr.$myarch.xml
62 manifest based on a local IPS repository and IPS cluster on a set of packages from
63 previous test {x86 and SPARC}
64
65 - Module with common functionality
66
67 Module "common.lib" - some scripts which are shared across other modules
68
69 - Module for Local IPS Repository Recipe
70
71 Module "repo.clone.JeOS" - a sample for creation and usage of a local IPS
72 repository clone with all 160 JeOS packages, for really local
73 "local disk" and "localhost" network based installation.
74
75 - Module for Installing the OpenSolaris 200906 JeOS Prototype
76
77 Module "install.JeOS" - This module will install the OpenSolaris 200609 JeOS
78 Prototype with the needed post install customization.
79
80 - Module for cleaning OS Runtime Data
81
82 Module "clean.os.runtime" - will clean the OS from logs and other information
83 from previous boots
84
85 - Module for HW architecture change and HW reconfiguration
86
87 Module "reconfig.hw.v2v" - will reconfigure the HW on the booted OS instance
88 so it can be imported and booted a different Virtual HW environment
89 (V2V Migration)
90
91 - Module for securing installed OS instance
92
93 Module "secure.JeoS.ISC - the module implements additional OpenSolaris
94 hardening following "Secure by default" policies
95
96 Its part of "install.JeOS" module when option "--harden" is selected.
97
98 - Module for shrinking the disk with ZFS send/receive through 2 disks
99
100 Module "stream.l2d.zfs" - simple and fast procedure for a single system
101
102 - Module for shrinking the disk with ZFS send/receive through archive NFS
103
104 Module "stream.sadr.zfs" - a more complex and slower procedure, where "origin"
105 and "target" systems can be different.
106
107 - Module for various Virtual Hardware support
108
109 Module "platform.virt.conf" - This modul includes JeOS modifications for
110 various HW platforms including some know workarounds for OpenSolaris 200906 on
111 Virtual Platforms
112
113
114 Last build process scripts for Distro Constructor VA Live-CD recipe are in:
115 /usr/share/distro_const/virt_assist/
116
117 A sample for building customized version of the VA Live-CD is in:
118 /usr/share/distro_const/virt_assist/customize.me/
119
120 Projet pages:
121 OpenSolaris Project: JeOS - Just enough Operating System
122 http://opensolaris.org/os/project/jeos/
123
124 JeOS Discusion alias
125 jeos-discuss (a] opensolaris.org
126
127