ref: refs/heads/appliance-docs commit c142bc0d6d0844da3c908a55d706353299941435 Author: Martin Vidner Date: Fri Nov 6 15:31:03 2009 +0100 Better separated the announcement from the repo->appliance howto. --- webclient/doc/appliance/webyast-announcement | 59 ++++++++++++++++---------- webclient/doc/appliance/webyast-howto.rc1 | 51 +++------------------- 2 files changed, 43 insertions(+), 67 deletions(-) diff --git a/webclient/doc/appliance/webyast-announcement b/webclient/doc/appliance/webyast-announcement index 23d25f3..796a42a 100644 --- a/webclient/doc/appliance/webyast-announcement +++ b/webclient/doc/appliance/webyast-announcement @@ -1,3 +1,17 @@ +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. + + +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. + REPOSITORY: zypper ar http://www.suse.de/~mvidner/webyast-rc0.9 webyast-rc0.9 @@ -8,36 +22,35 @@ http://www.suse.de/~mvidner/webyast-rc0.9/vm/WebYaST_on_SLES11.i686-0.0.25.v... sha1sum: ed262005d079939827b3ae6fbdd3443a15885b10 internal: ftp://cml.suse.cz/testing/webyast/WebYaST_on_SLES11.i686-0.0.25.vmx.tar.gz -USAGE: -1. Run the appliance - In the 1st run, accept the SLES EULA -2. Point the browser to HTTPS port 54984 (**) - Log in as root, with password linux -3. Go through the base setup +3. 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 + + https://<appliance-hostname>:54984/ + +If yast2-webservice-basesystem is included, go through the base setup (language, eulas, admin, network, time, mail, registration) - -GENERAL NEWS: -- UI styling improved again -- Added pool.ntp.org as the NTP server -MODULE SPECIFIC NEWS: -http://www.suse.de/~mvidner/webyast-rc0.9/ChangeLog -KNOWN BUGS: -- 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 +4. Known Issues +=============== + +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 +=========== + +We are eager to get your feedback. Please, report the bugs, post general comments +and questions to the studio-beta@suse.de mailing list. -FEEDBACK: +Other alternatives: - irc://irc.opensuse.org/yast - https://bugzilla.novell.com/enter_bug.cgi?component=WebYaST&product=openSUSE+11.2&format=guided (please disregard the oS11.2 version and instead remember to mention the appliance version.) See http://en.opensuse.org/Bugs/WebYaST - mailto:yast-devel@opensuse.org - -**) 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.rc1 b/webclient/doc/appliance/webyast-howto.rc1 index 306ab15..028b578 100644 --- a/webclient/doc/appliance/webyast-howto.rc1 +++ b/webclient/doc/appliance/webyast-howto.rc1 @@ -1,38 +1,16 @@ Creating an Appliance Containing WebYaST RC 1 in SUSE Studio -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. - - -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. - - -2. Building webYaST-enabled appliances -====================================== - Only SLE-11 based appliances are supported (both i586 and x86_64). -2.1 Import repository into Studio ---------------------------------- - http://dist.suse.de/ibs/Devel:/WebYaST/SUSE_SLE-11_Update/ -(we use the internal studio and internal BS only for build speed reasons, TODO -switch to public ones) -(TODO base it on release snapshots, not on BS repos which (quickly or slowly) -change) +1 Import repository into Studio +------------------------------- + (see the release announcement for the URL) -2.2 Include webYaST packages ----------------------------- +2 Include webYaST packages +-------------------------- All webYaST package names start with "yast2-web". These are the mandatory packages needed for basic webYaST framework: @@ -75,8 +53,8 @@ for your appliance): yast2-webservice-time -2.3 Other appliance modifications ---------------------------------- +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: @@ -110,18 +88,3 @@ for your appliance): change FW_CONFIGURATIONS_EXT= '"webyast-ui"' /etc/sysconfig/SuSEfirewall2 -3. Usage -======== - -The webYaST console is running at port ... in the resulting appliance. Point the browser to - - https://<appliance-hostname>:54984/ - - -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. - - -- To unsubscribe, e-mail: yast-commit+unsubscribe@opensuse.org For additional commands, e-mail: yast-commit+help@opensuse.org