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

[wahwah at users.sourceforge.net]

Revision: 23425
          http://sourceforge.net/p/gar/code/23425
Author:   wahwah
Date:     2014-04-18 09:07:31 +0000 (Fri, 18 Apr 2014)
Log Message:
-----------
/home/maciej/opencsw/opencsw-manual/trunk: about sparse zones

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/setup.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/for-developers/index.rst

Added Paths:
-----------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/solaris-10-sparse-zones.rst

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst	2014-04-17 11:09:34 UTC (rev 23424)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst	2014-04-18 09:07:31 UTC (rev 23425)
@@ -10,6 +10,7 @@
   introduction
   getting-started
   setup
+  solaris-10-sparse-zones
   installation-en-masse
   mirror-setup
   faq

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/setup.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/setup.rst	2014-04-17 11:09:34 UTC (rev 23424)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/setup.rst	2014-04-18 09:07:31 UTC (rev 23425)
@@ -49,7 +49,11 @@
 ``/opt/csw/lib``, ``/usr/lib/ssh/sshd`` will try to load libcrypto from
 ``/opt/csw/lib`` and fail to start.
 
+For more information see `LD_LIBRARY_PATH - just say no`_.
 
+.. _LD_LIBRARY_PATH - just say no:
+   https://blogs.oracle.com/rie/entry/tt_ld_library_path_tt
+
 Upgrading packages
 ==================
 

Added: 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	                        (rev 0)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/solaris-10-sparse-zones.rst	2014-04-18 09:07:31 UTC (rev 23425)
@@ -0,0 +1,37 @@
+-----------------------
+Solaris 10 sparse zones
+-----------------------
+
+1. set inherit-pkg-dir on ``/opt/csw``
+2. install 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``.
+Instead of using ``/opt/csw/etc`` and ``/opt/csw/var`` (which are read-only),
+we use ``/var/opt/csw`` and ``/etc/opt/csw`` instead.
+
+Most packages built after July 2010 support local ``var``.
+
+
+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.
+
+Sparse zone with shared ``/usr``
+--------------------------------
+
+This setup won't work with OpenCSW packages, because the CSWcas-* package
+family installs `class action scripts`_ into ``/usr``.
+
+.. _class action scripts:
+   http://wiki.opencsw.org/cswclassutils-package

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-developers/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-developers/index.rst	2014-04-17 11:09:34 UTC (rev 23424)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-developers/index.rst	2014-04-18 09:07:31 UTC (rev 23425)
@@ -27,13 +27,16 @@
   LDFLAGS="-L/opt/csw/lib/64 -R/opt/csw/lib/64"
   PKG_CONFIG_PATH="/opt/csw/lib/64/pkgconfig"
 
-64-bit libraries live in the ``/opt/csw/lib/sparcv9`` and/or
-``/opt/csw/lib/amd64`` directories.  The ``/opt/csw/lib/64`` path is
-a symlink to a chosen architecture subdirectory. For example, on SPARC
-``/opt/csw/lib/64`` is a symlink to ``/opt/csw/lib/sparcv9``. All
-binaries compiled with the ``-R/opt/csw/lib/64`` flag will try to look
-at that path and find their libraries.
+64-bit libraries live in these directories, depending on the architecture::
 
+  /opt/csw/lib/sparcv9
+  /opt/csw/lib/amd64
 
-.. _LD_LIBRARY_PATH - just say no:
-   https://blogs.oracle.com/rie/entry/tt_ld_library_path_tt
+The ``/opt/csw/lib/64`` path is a symlink to a chosen architecture
+subdirectory. For example, on SPARC ``/opt/csw/lib/64`` is a symlink to
+``/opt/csw/lib/sparcv9``.
+
+All binaries compiled with the ``-R/opt/csw/lib/64`` flag will try to look at
+that path and find their corresponding sparcv9 or amd64 libraries. This way you
+can use the same ``-R`` flag for both sparc and intel 64-bit builds.
+

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