[csw-devel] SF.net SVN: gar:[16920] csw/mgar/pkg/opencsw-manual/trunk/files/ for-administrators

[dmichelsen at users.sourceforge.net]

Revision: 16920
          http://gar.svn.sourceforge.net/gar/?rev=16920&view=rev
Author:   dmichelsen
Date:     2012-01-27 10:21:19 +0000 (Fri, 27 Jan 2012)
Log Message:
-----------
opencsw-manaual: Enhance mirroring contents

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst

Added Paths:
-----------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/glossary.txt

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst	2012-01-27 09:32:32 UTC (rev 16919)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst	2012-01-27 10:21:19 UTC (rev 16920)
@@ -100,7 +100,7 @@
 
 Then you need to import the public key::
 
-  root# wget -O - http://www.opencsw.org/get-it/mirrors/  | gpg --import -
+  root# wget -O - http://www.opencsw.org/security/  | gpg --import -
   
 The current fingerprint looks like this::
 
@@ -110,6 +110,9 @@
   uid                  OpenCSW catalog signing <board at opencsw.org>
   sub   2048g/971EDE93 2011-08-31
 
+You may also trust the key once you verified the fingerprint::
+  root# /opt/csw/bin/gpg --edit-key board at opencsw.org trust
+
 Now everything is in place for enabling security in ``pkgutil``. Edit the ``/etc/opt/csw/pkgutil.conf``
 and uncomment the two lines with ``use_gpg`` and ``use_md5`` so they look like this::
 
@@ -138,3 +141,66 @@
   ==> 3173 packages loaded from /var/opt/csw/pkgutil/catalog.mirror_opencsw_current_sparc_5.10
   ...
 
+
+--------------------
+Package dependencies
+--------------------
+
+The OpenCSW packages have been compiled to allow easy forward migration and
+crossgrades/mixing between Sparc and x64 CPUs. That means the same version of the
+package is available for Solaris 10 and 11 for both Sparc and i386. There are
+some exceptions where the software is absolutely not available or has a version
+mismatch (e.g. acroread). To allow this there are usually no dependencies to
+SUNW packages. This sometimes leads to large dependency chains (and people
+thinking of OpenCSW packages as "bloated") but that is the price to pay for
+the interoperability and we feel that in times of ever growing disks the
+flexibility is worth more than the saved bytes.
+
+Package dependencies are modeled in the OpenCSW `catalog`_s" to allow automatic
+dependency resolution via pkgutil. To view the current dependencies for a
+package you can use
+::
+  pkgutil --deptree <pkg>
+
+
+Solaris 9/10/11 sparc vs. i386
+packaging strategy IPS may change
+graphviz tree
+pkgutil --deptree
+
+TBD: Identify packages depending on obsolete ones
+
+
+---------------------------
+Setting up a private mirror
+---------------------------
+
+Sometimes it is sufficient to just go on with a mirror on the internet. However, there are situations
+where a local mirror can be useful. When you have a lot of servers accessing the repository, want to control
+the package updates exactly or when your production servers just can't access the internet at all
+a local mirror is necessary.
+
+To set up the mirror you should use rsync as it can update your local copy quickly and with low
+bandwidth use and also preserves hardlinks. Not all mirrors provide access via the rsync protocol,
+a list can be found at http://www.opencsw.org/get-it/mirrors/ .
+To make a full copy of the OpenCSW repository use this::
+
+  pkgutil -y -i rsync
+  rsync -aH --delete rsync://rsync.opencsw.org/opencsw /my/server/repo
+
+The directory ``repo`` can either be shared via HTTP or via NFS to the pkgutil clients.
+Use http://myserver/url-to-repo/ for HTTP and file:///myserver/dir-to-repo for NFS as
+mirror option in pkgutil.
+
+
+Mirroring only a subset
+=======================
+
+You can also mirror only a subset of the repository, e.g. the 'unstable' catalog or even
+just a few packages.
+
+pkgutil --stream
+
+
+Layout of the mirror
+====================

Added: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/glossary.txt
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/glossary.txt	                        (rev 0)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/glossary.txt	2012-01-27 10:21:19 UTC (rev 16920)
@@ -0,0 +1,8 @@
+--------
+Glossary
+--------
+
+catalog
+
+A catalog contains a list of packages together with their catalog names, version, checksum
+and a list of dependencies to other packages.

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst	2012-01-27 09:32:32 UTC (rev 16919)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst	2012-01-27 10:21:19 UTC (rev 16920)
@@ -2,5 +2,13 @@
 Introduction
 ------------
 
+System administrators have to work with software every day. Solaris brings
+more and more programs with every release. However, the world of open source is
+big and there is always missing something. OpenCSW fills this gap by providing
+a large amount of precompiled software and open source build recipes.
+The p\xC3ackages can be installed comfortably with automatic dependency resolution
+but require root access to the machine. If you really want to compile your
+own software the build recipes are available for all packages too.
+
 Solaris 10 is fully supported whereas Solaris 8 and 9 are best effort
 and only get sporadic updates.

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.