Home Home > Documentation
Sign up | Login

Deprecation notice: openSUSE Lizards user blog platform is deprecated, and will remain read only for the time being. Learn more...

Archive for the ‘Documentation’ Category

Merging SVN Repositories Explained

October 30th, 2010 by

Adding files to a SVN server is usually a task done in seconds. However, having several independent SVN repositories and wanting to “combine” them, this is not trivial—especially if you want to preserve the history.

The doc team had had three different, independent repositories on BerliOS (opensuse-ha-doc, opensuse-docmaker, and opensuse-lfl) all holding separate information. This was a bit silly, so my task was to consolidate them into opensuse-doc by keeping all history.

(more…)

Read The Fabulous Manual

October 26th, 2010 by

We have a new place where we collect static documentation like manuals, user guides, quick start pages, developer documentation … and so on.
This new place is: rtfm.opensuse.org doc.opensuse.org.
Our “fabulous manuals” are also accessible at: doc.opensuse.org (in case you don’t like the word “fabulous”).

A few days ago Thomas Schraitle already wrote about this site before it was in a state that we wanted to announce – so sorry for any confusion this might have created.

This site is not meant to be a competitor to the documentation in the wiki. It was rather born from the need to have a central place to publish generated static documentation. Content on rtfm is not meant to be edited. If you want to contribute documentation we very welcome this in the wiki and encourage  you to link back to rtfm where applicable. The pages on rtfm are static but however they will be updated automatically upon changes (new releases of a project or product).

Currently we have published some great user guides and quick start pages for openSUSE (KDE, Gnome, Security, …) and SLES (AppArmor, Admin Guide, kvm, Xen, Security, …) as well as a user and vendor guide for WebYaST. There is also developer documentation available for YaST and Zypp (libzypp, satsolver) development.
In the next days or weeks we will add more documentation as soon as it is ready to be published.

Update:
We changed the domain name of that site. To read the fabulous manuals please use and link only to doc.opensuse.org. The domain docs.opensuse.org will be alias for it – please only link to doc and do not use rtfm anymore. Thanks for your appreciation.

RTFM!

October 23rd, 2010 by

Before and during the openSUSE conference, some nice people (Jens-Daniel, Jürgen, Darix) created the following site for you:

http://rtfm.opensuse.org http://doc.opensuse.org

Thank you guys! I like the thrilling name. 😉

It’s a static page (at the moment?) and collects the current documentation from several products and projects. Probably you will see more to come in the next weeks.

Have fun!

Update (AJ since Thomas is ill) 2010-10-27: Based on the feedback received, we’re going to  change now rtfm.opensuse.org to docs.opensuse.org. So, you can reach the fine side under http://docs.opensuse.org and http://doc.opensuse.org.

Documentation

October 13th, 2010 by

Hi folks,

this post is just request for all obs-packagers. Please, don’t forget write some documentation about your projects (which you maintain or develop). I mean, documentation for developers. This make more easy to understand logic of program, connection between some modules inside or interfaces between widget/applet and “system/hardware part”. For sure, comments in source code (or in changelog) help, but some times they give not so much clarity.

This is not so complicated to write one-two pages about project, which you hack. This also can save time of new developers. They will not ask you about architecture of project, and that will save your time too 😉

I don’t know how will be better to do it: use wiki (create a new page) or add just text-file in source project. Anyway it’s not so important where will be this documentation, main things that this documentation will be exist 🙂

Systems Management Zeitgeist

September 14th, 2010 by

Dear Lizards,
This recent release from IT World on the best Linux distributions out there caught my eye last weekend, as it declares “The package’s administration utility, YaST, is widely acknowledged as one of the best” in its entry on openSUSE and SLE (the documentation also drew praise, distinguishing itself as “some of the best printed documentation you’ll find for any distro“), and reminded me I wanted to share some of the positive feedback I collected during our 11.x development and after final release.  Ready? Here we go.

Some of the initial ‘Net commentary was all centered on performance and memory footprint, from Snorp’sI don’t think it’s possible to overstate just how much of an improvement it really is” to Duncan’s benchmarks providing interesting numerical comparisons like  “Yum uses about 9 times more memory” (and takes several times longer).  This was refreshing given that at the same time Yum’s less-than-nimble footprint was drawing some interesting comments from Zed and Zbr.

Eventually, the improvements rolled over to the press, with Jason Perlow proclaiming 11 RC1 the Mercedes-Benz to Ubuntu’s Wolkswagen. Jason had plenty of praise in his review, but I am singling out “the most beautiful installer program I have ever seen” and “quite impressed with how fast the package repository management works” since this is the Systems Management team’s ticker-tape parade, after all.  Our then Community Ambassador Zonker followed up with his Package Keeper piece on the special that Linux Pro Magazine issued for the 11.0 release, focusing on package management as “one of the most impressive advances” in the release (link sadly missing as article still paywalled).   Linux Format retorted with “One of our favorite features of SUSE is the one-click install system” and “faster than any other package manager we’ve seen, and on top of that it looks great, too” in their What SUSE Does Best review (no link, as LXF requires subscription).

Finally, with the release of our Enterprise distribution, the commentary rolled over to our corporate customers, as I previously reported when one customer I like to track personally as particularly representative reported a 300% speed improvement in rolling updates to production.

Afterwards, we have moved up live distro upgrade (more famously known as zypper dup) to fully supported status, quickly receiving loud praise from a Linux Journal editor with clearly too many Debian-using friends.  We do relate to his plight, in a tongue-in-cheek manner, and are happy to help.  Indeed, other distributions have started adopting Zypper as well, with Ark leading the way.

So what is next for us? Well, with Btrfs around the corner, integrating snapshot and rollback into the update system stands clearly out from the crowd: an undo button to painlessly bring back the system to where it was before your last upgrade. Stay tuned!

The package’s administration utility, YaST, is widely acknowledged as one of the best,The package’s administration utility, YaST, is widely acknowledged as one of the best,

On-Access virus scanning on openSUSE 11.3

September 14th, 2010 by

One of the most useful deployment scenario for Linux in enterprise or educational environment is a fileserver with on access virus scanning, to serve Windows PCs on the network of course. Long ago there used to be samba-vscan that worked very nicely, it went missing in openSUSE 11.2 so dazuko kernel module worked in its place. On 11.3 dazuko is no longer available, enter dazukofs.

(more…)

KIWI-LTSP multiple image support improvements

September 8th, 2010 by

Savin Alex has been busy working on improving kiwi-ltsp lately. The basic idea behind the new development is easier management of multiple LTSP images that can be served over NBD or AOE. Earlier Shrenik Bhura had added multiple image support for AOE, now it is also supported when using NBD. (more…)

How to change GDM theme

July 25th, 2010 by

Run this command as root:

gconftool-2 --direct --config-source=xml::/etc/gconf/gconf.xml.vendor --set /desktop/gnome/background/picture_filename --type=string "/path/to/picture"
gconftool-2 --direct --config-source=xml::/etc/gconf/gconf.xml.vendor --set /desktop/gnome/background/picture_options --type=string "stretched"

Edit: The easier way

(more…)

How to setup Edu servers on Li-f-e

July 22nd, 2010 by

openSUSE Edu Li-f-e comes loaded with softwares useful for educational institutions, including servers that do everything from course management, student information system to library management.  Although the setup is fairly easy for sysadmins who know what exactly to do, it is quite a difficult task for new Linux user or a teacher without any prior sysadmin knowledge wanting to try out. Get in touch with us if you would like to contribute to openSUSE Education project by creating a script or better still a GUI to automate these tasks.

(more…)

Novell Client on openSUSE 11.2

April 20th, 2010 by

This has been covered on a couple of forums out there, but I’ve yet to find a decent comprehensive post. This is for 32bit systems, it’s easily modified for 64bit setups.

First off, search your favorite RPM repo for binutils-2.19-9.3. I like to use http://rpm.pbone.net, but at the time of writing, they happen to be down.

Get a copy of the Novell Client ISO from http://download.novell.com and mount it:

sudo mount -o loop novell-client-2.0-sp2-sle11-i586.iso /mnt

Extract the files from the RPM:

rpm2cpio binutils-2.19-9.3.i586.rpm | cpio -idv

This should create a “usr” directory in your present working directory. Go ahead and copy it’s contents to your filesystem:

sudo cp -R usr/* /usr/

Change directories to wherever you mounted your ISO (in this case “/mnt”) and run the installer:

cd /mnt && sudo ./ncl_install

As the packages attempt to install, you’ll be given options and warnings concerning libbfd and several other packages. Choose option “2” for everything (“Break dependencies”). Don’t worry about actually breaking anything, just roll with option 2.

Lastly, issue ldconfig as root and reboot:

sudo /sbin/ldconfig
sudo /sbin/reboot

That should get you up and running. You can run “ncl_tray” directly from the command line, or create a shortcut to the client. If you’re having connection issues, make sure that openSLP is configured.

The only issues I’ve had so far is the inability to browse trees, which turned out to be a DNS problem on my end. Occasionally I get warnings on login about novfs kernel modules not being properly loaded, but this appears to be benign.