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
