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

[dmichelsen at users.sourceforge.net]

Revision: 17324
          http://gar.svn.sourceforge.net/gar/?rev=17324&view=rev
Author:   dmichelsen
Date:     2012-03-07 16:08:20 +0000 (Wed, 07 Mar 2012)
Log Message:
-----------
manual: Update tbd and add config files

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

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst	2012-03-07 16:05:49 UTC (rev 17323)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst	2012-03-07 16:08:20 UTC (rev 17324)
@@ -155,14 +155,6 @@
   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
 ---------------------------

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/configuring-services.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/configuring-services.rst	2012-03-07 16:05:49 UTC (rev 17323)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/configuring-services.rst	2012-03-07 16:08:20 UTC (rev 17324)
@@ -5,13 +5,29 @@
 /etc/opt/csw vs. /opt/csw/etc
 =============================
 
-...
+There are two locations where configuration files are stored. This may look confusing at first,
+the reason is that we try to support both sparse zones and full zones as good as possible.
+Remember that in a sparse root environment `/opt` is shared from the global zone. As a rule
+of thumb configuration files which are specific to a zone are kept in `/etc/opt/csw` which is
+also generally preferred (these are in fact most of the configuration files), whereas
+`/opt/csw/etc` is used for configuration files which are globally set. Some packages honour
+both locations, where the global `/opt/csw/etc` is read first and can be customized by
+`/etc/opt/csw`, but this is specific to the package as not all upstream software allows
+this easily.
 
+There are some exceptions like Apache, where the configuration files are historically in
+`/opt/csw/apache2/etc`, but these are likely to go away some time.
+
+
 preserveconf
 ============
 
-...
+Configuration files are usually shipped as template with a `.CSW` suffix which is copied during installation
+to the native name without the suffix. This file is meant to be user-adjustable. On package
+deinstallation or update the template is deinstalled whereas the configuration file without suffix
+is kept unless it hasn't been modified.
 
+
 RC/SMF
 ======
 

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