ref: refs/heads/appliance-docs commit a86eb91fad18e6da5d38a4b3c38d13149613575e Author: Martin Vidner <mvidner@suse.cz> Date: Fri Nov 6 13:52:20 2009 +0100 Moved the related files to the appliance subdir. --- webclient/doc/appliance/custom_services.yml | 12 ++ webclient/doc/appliance/logs.yml | 7 + .../doc/appliance/webyast-apce-build-script.sh | 50 ++++++++ .../webyast-firewall-services-bnc545627.tar.bz2 | Bin 0 -> 437 bytes webclient/doc/appliance/webyast-howto.rc1 | 127 ++++++++++++++++++++ .../doc/appliance/webyast-ssh-tunnels.tar.bz2 | Bin 0 -> 2300 bytes webclient/doc/custom_services.yml | 12 -- webclient/doc/logs.yml | 7 - webclient/doc/webyast-apce-build-script.sh | 50 -------- .../webyast-firewall-services-bnc545627.tar.bz2 | Bin 437 -> 0 bytes webclient/doc/webyast-howto.rc1 | 127 -------------------- webclient/doc/webyast-ssh-tunnels.tar.bz2 | Bin 2300 -> 0 bytes 12 files changed, 196 insertions(+), 196 deletions(-) diff --git a/webclient/doc/appliance/custom_services.yml b/webclient/doc/appliance/custom_services.yml new file mode 100644 index 0000000..a23d706 --- /dev/null +++ b/webclient/doc/appliance/custom_services.yml @@ -0,0 +1,12 @@ +# /etc/webyast/custom_services.yml +postfix: + description: The Postfix Mailer + status: "/etc/init.d/postfix status" + start: "/etc/init.d/postfix start" + stop: "/etc/init.d/postfix stop" +counter: + description: A Dumb Counter + start: "echo >> /var/tmp/counter" + status: "wc -c /var/tmp/counter" + stop: "rm -f /var/tmp/counter" + diff --git a/webclient/doc/appliance/logs.yml b/webclient/doc/appliance/logs.yml new file mode 100644 index 0000000..b930a80 --- /dev/null +++ b/webclient/doc/appliance/logs.yml @@ -0,0 +1,7 @@ +# /etc/webyast/vendor/logs.yml +system: + path: /var/log/messages + description: System messages +apache: + description: Apache + path: /var/log/apache2/access_log diff --git a/webclient/doc/appliance/webyast-apce-build-script.sh b/webclient/doc/appliance/webyast-apce-build-script.sh new file mode 100644 index 0000000..3bdb9f9 --- /dev/null +++ b/webclient/doc/appliance/webyast-apce-build-script.sh @@ -0,0 +1,50 @@ +#!/bin/bash + +# 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 + +change FW_CONFIGURATIONS_EXT= '"webyast-ui"' /etc/sysconfig/SuSEfirewall2 + +# do not point to internal SLE repos, point to external ones instead +cp -a /etc/zypp/repos.d{,.bak} +rm /etc/zypp/repos.d/* + +# TODO overlay instead? +cat <<EOF > /etc/zypp/services.d/nu_novell_com.service +[nu_novell_com] +name=nu_novell_com +enabled=1 +autorefresh=1 +url = https://nu.novell.com/?credentials=NCCcredentials +type = ris +repostoenable = SLES11-Extras SLES11-Pool +EOF +cat <<EOF > /etc/zypp/repos.d/YaST_Web.repo +[YaST_Web] +name=Web interface for YaST modules (SLE_11) +type=rpm-md +baseurl=http://download.opensuse.org/repositories/YaST:/Web/SLE_11/ +gpgcheck=1 +gpgkey=http://download.opensuse.org/repositories/YaST:/Web/SLE_11/repodata/repomd.x... +enabled=1 +EOF diff --git a/webclient/doc/appliance/webyast-firewall-services-bnc545627.tar.bz2 b/webclient/doc/appliance/webyast-firewall-services-bnc545627.tar.bz2 new file mode 100644 index 0000000..3b428d5 Binary files /dev/null and b/webclient/doc/appliance/webyast-firewall-services-bnc545627.tar.bz2 differ diff --git a/webclient/doc/appliance/webyast-howto.rc1 b/webclient/doc/appliance/webyast-howto.rc1 new file mode 100644 index 0000000..306ab15 --- /dev/null +++ b/webclient/doc/appliance/webyast-howto.rc1 @@ -0,0 +1,127 @@ +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) + + +2.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 + + +2.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 build script + use + + 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. + + diff --git a/webclient/doc/appliance/webyast-ssh-tunnels.tar.bz2 b/webclient/doc/appliance/webyast-ssh-tunnels.tar.bz2 new file mode 100644 index 0000000..f22b0be Binary files /dev/null and b/webclient/doc/appliance/webyast-ssh-tunnels.tar.bz2 differ diff --git a/webclient/doc/custom_services.yml b/webclient/doc/custom_services.yml deleted file mode 100644 index a23d706..0000000 --- a/webclient/doc/custom_services.yml +++ /dev/null @@ -1,12 +0,0 @@ -# /etc/webyast/custom_services.yml -postfix: - description: The Postfix Mailer - status: "/etc/init.d/postfix status" - start: "/etc/init.d/postfix start" - stop: "/etc/init.d/postfix stop" -counter: - description: A Dumb Counter - start: "echo >> /var/tmp/counter" - status: "wc -c /var/tmp/counter" - stop: "rm -f /var/tmp/counter" - diff --git a/webclient/doc/logs.yml b/webclient/doc/logs.yml deleted file mode 100644 index b930a80..0000000 --- a/webclient/doc/logs.yml +++ /dev/null @@ -1,7 +0,0 @@ -# /etc/webyast/vendor/logs.yml -system: - path: /var/log/messages - description: System messages -apache: - description: Apache - path: /var/log/apache2/access_log diff --git a/webclient/doc/webyast-apce-build-script.sh b/webclient/doc/webyast-apce-build-script.sh deleted file mode 100644 index 3bdb9f9..0000000 --- a/webclient/doc/webyast-apce-build-script.sh +++ /dev/null @@ -1,50 +0,0 @@ -#!/bin/bash - -# 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 - -change FW_CONFIGURATIONS_EXT= '"webyast-ui"' /etc/sysconfig/SuSEfirewall2 - -# do not point to internal SLE repos, point to external ones instead -cp -a /etc/zypp/repos.d{,.bak} -rm /etc/zypp/repos.d/* - -# TODO overlay instead? -cat <<EOF > /etc/zypp/services.d/nu_novell_com.service -[nu_novell_com] -name=nu_novell_com -enabled=1 -autorefresh=1 -url = https://nu.novell.com/?credentials=NCCcredentials -type = ris -repostoenable = SLES11-Extras SLES11-Pool -EOF -cat <<EOF > /etc/zypp/repos.d/YaST_Web.repo -[YaST_Web] -name=Web interface for YaST modules (SLE_11) -type=rpm-md -baseurl=http://download.opensuse.org/repositories/YaST:/Web/SLE_11/ -gpgcheck=1 -gpgkey=http://download.opensuse.org/repositories/YaST:/Web/SLE_11/repodata/repomd.x... -enabled=1 -EOF diff --git a/webclient/doc/webyast-firewall-services-bnc545627.tar.bz2 b/webclient/doc/webyast-firewall-services-bnc545627.tar.bz2 deleted file mode 100644 index 3b428d5..0000000 Binary files a/webclient/doc/webyast-firewall-services-bnc545627.tar.bz2 and /dev/null differ diff --git a/webclient/doc/webyast-howto.rc1 b/webclient/doc/webyast-howto.rc1 deleted file mode 100644 index 306ab15..0000000 --- a/webclient/doc/webyast-howto.rc1 +++ /dev/null @@ -1,127 +0,0 @@ -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) - - -2.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 - - -2.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 build script - use - - 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. - - diff --git a/webclient/doc/webyast-ssh-tunnels.tar.bz2 b/webclient/doc/webyast-ssh-tunnels.tar.bz2 deleted file mode 100644 index f22b0be..0000000 Binary files a/webclient/doc/webyast-ssh-tunnels.tar.bz2 and /dev/null differ -- To unsubscribe, e-mail: yast-commit+unsubscribe@opensuse.org For additional commands, e-mail: yast-commit+help@opensuse.org