I've just started to look at deploying a fairly large installation of
Spacewalk for patching and auditing reasons and I was toying on
expanding/rearranging the user documentation section of the Trac wiki,
thought I'd better check before I fiddle with it. I realise you can just
roll back my changes, feel free to do so if there's anything you don't like
of course, but I was aiming largely to keep everything on the current front
page but rearrange it and structure it in a vaguely similar way to the PHP
user documentation. I was also going to include a few more exteneral links
to related white papers and documentation for YUM, RPM etc, as Spacewalk
relates to the larger concept of system/package/patch management I thought
it might be relevent within reason. I'd hacked out the follow structure from
the existing and also my own bookmarks for the User doucmentation frontpage
(https://fedorahosted.org/spacewalk/wiki/UserDocs)...

Nb: (->) = external link and any sections in parameters were the content I
was going to put in there.

# Getting Started
   * Overview
      * Preface
      (
      * http://www.redhat.com/docs/manuals/satellite/ (->)
      * http://wiki.centos.org/HowTos/PackageManagement/Spacewalk (->)
      *
http://docs.fedoraproject.org/deployment-guide/f12/en-US/html/pt-pkg-management.html(->)
      * http://www.theregister.co.uk/2009/07/10/patch_management_/ (->)
      *
http://www.hpl.hp.com/techreports/2009/HPL-2009-153.html?mtxs=rss-hpl-tr(->)
      *
http://www.isaca.org/Template.cfm?Section=Home&CONTENTID=16685&TEMPLATE=/ContentManagement/ContentDisplay.cfm(->)
      )

   * Installing the server -- How to download and install Spacewalk Server.
Spanish Translation (->)
      * Setting up Spacewalk repo
      * Additional repos & packages
      * Oracle XE Pre-Requisites and Installation
      * Installing Spacewalk
      * Managing Spacewalk
      * Backing up Spacewalk

   * How to upgrade -- How to upgrade an existing Spacewalk installation to
the latest version.

   * Installing a proxy
      * Debugging Proxy -- Tip on solving problems with Spacewalk Proxy

   * Registering clients

# Up/Down-stream Spacewalk Reference Documentation
   (
   * http://www.redhat.com/docs/manuals/satellite/ (->)
   *
http://www.redhat.com/docs/en-US/Red_Hat_Network_Satellite/5.3/Installation_Guide/html/index.html
(->)
   *
http://www.redhat.com/docs/en-US/Red_Hat_Network_Satellite/5.3/Proxy_Installation_Guide/index.html(->)
   * http://wiki.centos.org/HowTos/PackageManagement/Spacewalk (->)
   )

# Related Technologies Documentation
   (
   * http://www.rpm.org/  (->)
   * http://en.wikipedia.org/wiki/RPM_Package_Manager  (->)
   * http://docs.fedoraproject.org/drafts/rpm-guide-en/index.html  (->)
   * http://docs.fedoraproject.org/deployment-guide/f12/en-US/html/ (->)
   *
http://docs.fedoraproject.org/deployment-guide/f12/en-US/html/pt-pkg-management.html(->)
   * http://yum.baseurl.org/ (->)
   * http://en.wikipedia.org/wiki/Yellow_Dog_Updater_Modified (->)
   * http://prefetch.net/articles/yum.html (->)
   )

# Features
   * Upload Content -- Upload RHEL, CENT, or Fedora content (or any other
rpms)
   * Kickstart with Spacewalk and Cobbler -- Spacewalk and Cobbler together:
How to use the new integration released in Spacewalk 0.4
   * Entitlement Certificates -- Create and activate your own certs for
Spacewalk
   * Install osad -- How to use osad to force scheduled actions to run
immediately on Spacewalk clients
   * Use Spacewalk to perform Linux audits -- How to setup Spacewalk to
search and review Linux audits
   * Setup osad and osa-dispatcher -- How does osad / osa-dispatcher /
jabberd work
   * Multiple Organizations -- A guide to setting up multiple organisations
   * Implementing PAM authentication -
http://www.redhat.com/docs/manuals/satellite/Red_Hat_Network_Satellite-5.1.0/html/Installation_Guide/s1-maintenance-pam-auth.html
   * Implementing SSH communication (instead of RHNMD and port 4545) -
http://www.redhat.com/docs/manuals/satellite/Red_Hat_Network_Satellite-5.2.0/html/Reference_Guide/s2-mon-rhnmd-sshd.html

# Best Practice Guides
   * Manage Fedora Systems -- Putting it all together in a best practice
guide for management of Fedora deployments.
   * Manage Solaris Systems -- Registering Solaris clients and uploading
content.
   * (Manage CentOS Systems)
   * (Manage Debian Systems)

# Core API Reference
   * ApiDocs -- Learn how to use our XMLRPC api to control your Spacewalk
server.
   * Spacewalk API Perl Guide -- A user contributed guide to using the
Spacewalk API in Perl.
   * Developer documentaton

# FAQ: Frequently Asked Questions

# Known Issues
   * Installation
   * Configuration
   * Oracle XE
   * Postgresql

# Contact
   * Email Addresses
   * Email Lists
   * IRC
   * Websites

# Appendices
   * History of PHP and related projects
   * Migrating from 0.5 to 0.6
   * Migrating from 0.6 to 0.7
   * Release notes for 0.5
   * Release notes for 0.6
   * Release notes for 0.7
   * Licenses


...obviously I was then going to start filling the extra pages and bits.
Just wanted to check if anyone wanted me to add anything whilst I was at it
or if there were any concerns etc?

-- 
Regards,
  Phil
_______________________________________________
Spacewalk-devel mailing list
[email protected]
https://www.redhat.com/mailman/listinfo/spacewalk-devel

Reply via email to