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

[wahwah at users.sourceforge.net]

Revision: 23426
          http://sourceforge.net/p/gar/code/23426
Author:   wahwah
Date:     2014-04-18 15:12:48 +0000 (Fri, 18 Apr 2014)
Log Message:
-----------
/home/maciej/opencsw/opencsw-manual/trunk: Migrating from Blastwave

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

Added Paths:
-----------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/migrating-from-blastwave-to-opencsw.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-18 09:07:31 UTC (rev 23425)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst	2014-04-18 15:12:48 UTC (rev 23426)
@@ -13,4 +13,5 @@
   solaris-10-sparse-zones
   installation-en-masse
   mirror-setup
+  migrating-from-blastwave-to-opencsw
   faq

Added: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/migrating-from-blastwave-to-opencsw.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/migrating-from-blastwave-to-opencsw.rst	                        (rev 0)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/migrating-from-blastwave-to-opencsw.rst	2014-04-18 15:12:48 UTC (rev 23426)
@@ -0,0 +1,56 @@
+-----------------------------------
+Migrating from Blastwave to OpenCSW
+-----------------------------------
+
+You cannot mix Blastwave packages with OpenCSW packages.
+
+You need to migrate your packages, which means you need to uninstall all
+Blastwave packages and install corresponding OpenCSW packages.
+
+Instructions
+------------
+
+Install CSWpkgutil, it provides the admin file required later.
+
+Create a list of currently installed CSW packages (Blastwave uses CSW package
+namespace), except CSWwget::
+
+  (cd /var/sadm/pkg; echo CSW*) | tr ' ' '\n' \
+    | grep -v CSWwget | grep -v CSWpkgutil \
+    > /var/tmp/before-migration.list
+
+Configure pkgutil to use an OpenCSW mirror.  Do you have 2 copies of
+pkgutil.conf, one in ``/opt/csw/etc`` and one in ``/etc/opt/csw``? Make sure
+you only have one copy, use ``/etc/opt/csw`` as the location::
+
+  opencsw_mirror="http://mirror.opencsw.org/opencsw/unstable/"
+  cp /etc/opt/csw/pkgutil.conf /etc/opt/csw/pkgutil.conf.bak
+  gsed -e '/^\s*mirror=/d' -i /etc/opt/csw/pkgutil.conf
+  echo >> /etc/opt/csw/pkgutil.conf "mirror=${opencsw_mirror}"
+
+Uninstall all the packages from the list.  In order to uninstall all the
+packages in a batch mode, we need to use a so called admin file.  There's one
+provided by CSWpkgutil, ``/var/opt/csw/pkgutil/admin``
+
+::
+
+  for pkg in `cat /var/tmp/before-migration.list`; do \
+    pkgrm -n -a /var/opt/csw/pkgutil/admin $pkg; \
+  done
+
+Update pkgutil's catalog cache::
+
+  pkgutil -U
+
+Create a new list of packages to install.  Some packages have been renamed and
+the package names aren't exactly the same in OpenCSW as in Blastwave. You can
+compare the list of packages against a catalog file to figure out which exact
+packages you need::
+
+  cp /var/tmp/before-migration.list /var/tmp/after-migration.list
+
+Use pkgutil to install the packages from the new list::
+
+  for pkg in `cat /var/tmp/after-migration.list`; do \
+    pkgutil -y -i $pkg; \
+  done

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 09:07:31 UTC (rev 23425)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/solaris-10-sparse-zones.rst	2014-04-18 15:12:48 UTC (rev 23426)
@@ -30,8 +30,13 @@
 Sparse zone with shared ``/usr``
 --------------------------------
 
-This setup won't work with OpenCSW packages, because the CSWcas-* package
-family installs `class action scripts`_ into ``/usr``.
+You need to install cswclassutils scripts (CSWcas-*) in the global zone.
 
+Otherwise your setup won't work with OpenCSW packages, because the CSWcas-*
+package family installs `class action scripts`_ into /usr. See the
+`cswclassutils wants to write in /usr`_ thread for more information. 
+
 .. _class action scripts:
    http://wiki.opencsw.org/cswclassutils-package
+.. _cswclassutils wants to write in /usr:
+   http://lists.opencsw.org/pipermail/maintainers/2009-December/010638.html

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