ref: refs/heads/appliance-docs commit 8df9c645fa4b0275640feb2a0cdca5a14518c364 Author: Martin Vidner <mvidner@suse.cz> Date: Thu Nov 19 17:02:08 2009 +0100 Updated to RC2. what is in ftp://beta.suse.com/private/SUSE-Appliance-Program/WebYaST/RC2/ --- webclient/doc/appliance/webyast-announcement | 78 +++++++++++++++------- webclient/doc/appliance/webyast-howto | 90 ++++++++++++++++++++++++++ webclient/doc/appliance/webyast-howto.rc1 | 90 -------------------------- 3 files changed, 143 insertions(+), 115 deletions(-) diff --git a/webclient/doc/appliance/webyast-announcement b/webclient/doc/appliance/webyast-announcement index c7c9dbe..7f56dab 100644 --- a/webclient/doc/appliance/webyast-announcement +++ b/webclient/doc/appliance/webyast-announcement @@ -1,56 +1,72 @@ 0. Introduction =============== -WebYaST is a web-based remote console plugging into a stateless interface exposed -by an SLE-based appliance and providing a set of configuration modules appropriate -to enable minimal user control of the appliance "black box" environment. +WebYaST is a web-based remote console plugging into a stateless +interface exposed by an SLE-based appliance and providing a set of +configuration modules appropriate to enable minimal user control of +the appliance "black box" environment. 1. Installation =============== -WebYaST is not "installable" per se. It is a component available for building of appliances. - -To build appliances using WebYaST, set up the repository in your SUSE Studio instance. +WebYaST is not "installable" per se. It is a component available for +building of appliances. To build appliances using webYaST, set up the +repository in your SUSE Studio instance. REPOSITORY: -zypper ar ftp://beta.suse.com/private/SUSE-Appliance-Program/WebYaST/rc1/repo webyast +zypper ar ftp://beta.suse.com//private/SUSE-Appliance-Program/WebYaST/RC2/repo webyast-rc2 APPLIANCE DOWNLOAD: -ftp://beta.suse.com/private/SUSE-Appliance-Program/WebYaST/rc1/vm/WebYaST_on_SLES11.i686-0.11.0.vmx.tar.gz -ftp://beta.suse.com/private/SUSE-Appliance-Program/WebYaST/rc1/vm/WebYaST_on_SLES11.i686-0.11.0.vmx.tar.gz.asc - ( gpg --verify WebYaST_on_SLES11.i686-0.11.0.vmx.tar.gz.asc ) -sha1sum: ed262005d079939827b3ae6fbdd3443a15885b10 +ftp://beta.suse.com//private/SUSE-Appliance-Program/WebYaST/RC2/Signed_WebYaST_on_SLES11.i686-0.12.0.vmx.tar.gz +ftp://beta.suse.com//private/SUSE-Appliance-Program/WebYaST/RC2/Signed_WebYaST_on_SLES11.i686-0.12.0.vmx.tar.gz.asc + ( gpg --verify Signed_WebYaST_on_SLES11.i686-0.12.0.vmx.tar.gz.asc ) +sha1sum: 6c87495163e2223a278cce07e4355f639ef6245f + +MODULE SPECIFIC NEWS: +ftp://beta.suse.com//private/SUSE-Appliance-Program/WebYaST/RC2/ChangeLog -3. Usage +2. Usage ======== -Build an appliance (see a separate Howto) or use our sample appliance. -The WebYaST console is running at port 54984 in the resulting appliance. Point the browser to +Run our sample appliance. The WebYaST console is running at +port 54984 in the resulting appliance. Point the browser to + + https://<appliance-hostname>:54984/ (**) + +(Accept the 'WebYaST' certificate to establish a secure connection) + +Then, log in as 'root' with password 'linux' - https://<appliance-hostname>:54984/ +yast2-webservice-basesystem is included, guiding you through the base +setup (language, eulas, admin, network, time, mail, registration) -If yast2-webservice-basesystem is included, go through the base setup - (language, eulas, admin, network, time, mail, registration) +Use your SLE registration code to register WebYaST. -4. Known Issues +3. Known Issues =============== -538048 checking for patches may fail -545627 need firewall port definitions for webyast -553185 collectd in WebYaST needs "FQDNLookup false" -553250 after logout, I'm offered a list of hosts +538048 - checking for patches may fail +545627 - need firewall port definitions for webyast +555204 - Collectd does not "collect" data for the status module (*) +523122 - JQuery password field input unreliable +551784 - "Status" cannot be loaded in IE8 +554685 - language module: several errors +554699 - empty administrator password +555215 - Permission problem should not be escaled for ajax calls +553244 - Internal Server error in registration-module See this query for a complete bug list: https://bugzilla.novell.com/buglist.cgi?query_format=advanced&product=openSUSE+11.2&component=WebYaST&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=NEEDINFO&bug_status=REOPENED -5. Feedback + +4. Feedback =========== -We are eager to get your feedback. Please, report the bugs, post general comments -and questions to the studio-beta@suse.de mailing list. +We are eager to get your feedback. Please, report the bugs, post general +comments and questions to the studio-beta@suse.de mailing list. Other alternatives: - irc://irc.opensuse.org/yast @@ -59,3 +75,15 @@ Other alternatives: mention the appliance version.) See http://en.opensuse.org/Bugs/WebYaST - mailto:studio-beta@suse.de + + + +*) workaround: After delete /var/lib/collectd/* and restarting collectd with + "rccollectd restart" everything works fine. + +**) options: +- have the virtual machine set to network bridging +- tunnel out from the inside: + /root/bin/webyast-ssh 10.0.2.2 + (where 10.0.2.2 is how the VM sees the host in a VirtualBox NAT + setup. It forwards the ports 54984, 4984, and 10022->22) diff --git a/webclient/doc/appliance/webyast-howto b/webclient/doc/appliance/webyast-howto new file mode 100644 index 0000000..c2983e4 --- /dev/null +++ b/webclient/doc/appliance/webyast-howto @@ -0,0 +1,90 @@ +Creating an Appliance Containing WebYaST RC 2 in SUSE Studio +============================================================ + +Only SLE-11 based appliances are supported (both i586 and x86_64). + + +1 Import repository into Studio +------------------------------- + (see the release announcement for the URL) + + +2 Include webYaST packages +-------------------------- +All webYaST package names start with "yast2-web". These are the mandatory +packages needed for basic webYaST framework: + + yast2-webservice + yast2-webclient + + yast2-webservice-patch_updates + yast2-webservice-status + yast2-webservice-system + yast2-webclient-patches + yast2-webclient-status + yast2-webclient-system + +The following packages are also needed: + + openssl-certs (for yast*-registration HTTPS connections) + syslog-ng (bnc#553183) + +The following packages provide optional modules (pick the ones you need +for your appliance): + + yast2-webclient-administrator + yast2-webclient-custom-services + yast2-webclient-eulas + yast2-webclient-language + yast2-webclient-mailsettings + yast2-webclient-network + yast2-webclient-registration + yast2-webclient-services + yast2-webclient-systemtime + yast2-webservice-administrator + yast2-webservice-basesystem + yast2-webservice-eulas + yast2-webservice-language + yast2-webservice-mailsettings + yast2-webservice-network + yast2-webservice-ntp + yast2-webservice-registration + yast2-webservice-services + yast2-webservice-time + + +3 Other appliance modifications +------------------------------- +- General section: no changes needed. Network must be enabled. +- Storage and memory: no changes needed. 512MB of RAM is enough, 256 is not. +- Scripts: for the "end of the build" script, paste the following snippet: + + # source in profile + . /studio/profile + + # enable services + insserv collectd + insserv yastwc + insserv yastws + + change () { + KEY="$1" + VALUE="$2" + FILE="$3" + sed -i "s/^$KEY.*/$KEY$VALUE/" "$FILE" + } + + # bnc#544694 + change NETCONFIG_NTP_STATIC_SERVERS= pool.ntp.org /etc/sysconfig/network/config + + # bnc#553185 + change FQDNLookup " false" /etc/collectd.conf + # bnc#553185#c1 + echo "LoadPlugin df" >> /etc/collectd.conf + +- Firewall modifications: if you have the firewall enabled, include the + webyast-firewall-services-bnc545627.tar.bz2 overlay + and in the "end of the build" script, paste the following snippet: + + change FW_CONFIGURATIONS_EXT= '"webyast-ui"' /etc/sysconfig/SuSEfirewall2 + diff --git a/webclient/doc/appliance/webyast-howto.rc1 b/webclient/doc/appliance/webyast-howto.rc1 deleted file mode 100644 index f6cb2ed..0000000 --- a/webclient/doc/appliance/webyast-howto.rc1 +++ /dev/null @@ -1,90 +0,0 @@ -Creating an Appliance Containing WebYaST RC 1 in SUSE Studio - - -Only SLE-11 based appliances are supported (both i586 and x86_64). - - -1 Import repository into Studio -------------------------------- - (see the release announcement for the URL) - - -2 Include webYaST packages --------------------------- -All webYaST package names start with "yast2-web". These are the mandatory -packages needed for basic webYaST framework: - - yast2-webservice - yast2-webclient - - yast2-webservice-patch_updates - yast2-webservice-status - yast2-webservice-system - yast2-webclient-patches - yast2-webclient-status - yast2-webclient-system - -The following packages are also needed: - - openssl-certs (for yast*-registration HTTPS connections) - syslog-ng (bnc#553183) - -The following packages provide optional modules (pick the ones you need -for your appliance): - - yast2-webclient-administrator - yast2-webclient-custom-services - yast2-webclient-eulas - yast2-webclient-language - yast2-webclient-mailsettings - yast2-webclient-network - yast2-webclient-registration - yast2-webclient-services - yast2-webclient-systemtime - yast2-webservice-administrator - yast2-webservice-basesystem - yast2-webservice-eulas - yast2-webservice-language - yast2-webservice-mailsettings - yast2-webservice-network - yast2-webservice-ntp - yast2-webservice-registration - yast2-webservice-services - yast2-webservice-time - - -3 Other appliance modifications -------------------------------- -- General section: no changes needed. Network must be enabled. -- Storage and memory: no changes needed. 512MB of RAM is enough, 256 is not. -- Scripts: for the "end of the build" script, paste the following snippet: - - # source in profile - . /studio/profile - - # enable services - insserv collectd - insserv yastwc - insserv yastws - - change () { - KEY="$1" - VALUE="$2" - FILE="$3" - sed -i "s/^$KEY.*/$KEY$VALUE/" "$FILE" - } - - # bnc#544694 - change NETCONFIG_NTP_STATIC_SERVERS= pool.ntp.org /etc/sysconfig/network/config - - # bnc#553185 - change FQDNLookup " false" /etc/collectd.conf - # bnc#553185#c1 - echo "LoadPlugin df" >> /etc/collectd.conf - -- Firewall modifications: if you have the firewall enabled, include the - webyast-firewall-services-bnc545627.tar.bz2 overlay - and in the "end of the build" script, paste the following snippet: - - change FW_CONFIGURATIONS_EXT= '"webyast-ui"' /etc/sysconfig/SuSEfirewall2 - -- To unsubscribe, e-mail: yast-commit+unsubscribe@opensuse.org For additional commands, e-mail: yast-commit+help@opensuse.org