SF.net SVN: gar:[23427] csw/mgar/pkg/opencsw-manual/trunk/files

[wahwah at users.sourceforge.net]

Revision: 23427
          http://sourceforge.net/p/gar/code/23427
Author:   wahwah
Date:     2014-04-18 17:49:46 +0000 (Fri, 18 Apr 2014)
Log Message:
-----------
/home/maciej/opencsw/opencsw-manual/trunk: Added tips from Laurent

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/getting-started.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/solaris-10-sparse-zones.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/index.rst

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/getting-started.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/getting-started.rst	2014-04-18 15:12:48 UTC (rev 23426)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/getting-started.rst	2014-04-18 17:49:46 UTC (rev 23427)
@@ -4,6 +4,8 @@
 Getting started
 ---------------
 
+.. _getting-started:
+
 ::
 
   pkgadd -d http://get.opencsw.org/now

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/solaris-10-sparse-zones.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/solaris-10-sparse-zones.rst	2014-04-18 15:12:48 UTC (rev 23426)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/solaris-10-sparse-zones.rst	2014-04-18 17:49:46 UTC (rev 23427)
@@ -3,7 +3,7 @@
 -----------------------
 
 1. set inherit-pkg-dir on ``/opt/csw``
-2. install packages in the global zone
+2. install OpenCSW packages in the global zone
 
 When inherited by non-global zones, ``/opt/csw`` is read-only.  Two directories
 that might need local (per-zone) modifications are ``etc`` and ``var``.
@@ -12,23 +12,18 @@
 
 Most packages built after July 2010 support local ``var``.
 
+**Keep all your zones running** when installing packages. Otherwise class
+action scripts won't have a chance to run and you'll end up with a broken
+installation, e.g. missing configuration files.
 
-Local mount hack (unsupported)
-------------------------------
+**Create users in advance.** Some packages create users on installation, if
+these users don't exist already.  Users are created by name, without
+controlling what UIDs they get.  If you want to keep UIDs of these users
+consistent across all zones, create your users in advance.
 
-If you're using a package which wasn't configured to use ``/etc/opt/csw``
-and/or ``/var/opt/csw`` but you still need to have per-zone changes, you can
-mount your own, writable ``/opt/csw/etc`` on top of the read only ``/opt/csw``::
 
-  # /etc/vfstab entries
-  /path/to/your/local/etc - /opt/csw/etc lofs - yes -
-  /path/to/your/local/var - /opt/csw/var lofs - yes -
-
-This is only a hack that might help you with a legacy package, it's not a
-supported way of using OpenCSW packages.
-
 Sparse zone with shared ``/usr``
---------------------------------
+================================
 
 You need to install cswclassutils scripts (CSWcas-*) in the global zone.
 
@@ -40,3 +35,18 @@
    http://wiki.opencsw.org/cswclassutils-package
 .. _cswclassutils wants to write in /usr:
    http://lists.opencsw.org/pipermail/maintainers/2009-December/010638.html
+
+
+Local mount hack (unsupported)
+==============================
+
+If you're using a package which wasn't configured to use ``/etc/opt/csw``
+and/or ``/var/opt/csw`` but you still need to have per-zone changes, you can
+mount your own, writable ``/opt/csw/etc`` on top of the read only ``/opt/csw``::
+
+  # /etc/vfstab entries
+  /path/to/your/local/etc - /opt/csw/etc lofs - yes -
+  /path/to/your/local/var - /opt/csw/var lofs - yes -
+
+This is only a hack that might help you with a legacy package, it's not a
+supported way of using OpenCSW packages.

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/index.rst	2014-04-18 15:12:48 UTC (rev 23426)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/index.rst	2014-04-18 17:49:46 UTC (rev 23427)
@@ -7,7 +7,7 @@
 Welcome to the OpenCSW manual!
 ==============================
 
-Contents:
+First time here? Go to :ref:`getting started <getting-started>`.
 
 .. toctree::
    :maxdepth: 1

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