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

[dmichelsen at users.sourceforge.net]

Revision: 16869
          http://gar.svn.sourceforge.net/gar/?rev=16869&view=rev
Author:   dmichelsen
Date:     2012-01-20 21:42:19 +0000 (Fri, 20 Jan 2012)
Log Message:
-----------
opencsw-manual: Add contents

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

Added Paths:
-----------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.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-01-20 20:04:35 UTC (rev 16868)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst	2012-01-20 21:42:19 UTC (rev 16869)
@@ -2,14 +2,62 @@
 Bootstrapping
 -------------
 
+OpenCSW uses a tool named pkgutil on top of the Solaris packaging utilities
+to automatically download, install and update packages. This has to be installed
+manually once, after that all maintenance is done via pkgutil.
+
 On a Solaris 10 system, you can use the capacity of pkgadd to download
-packages via http::
+and install it via http in one step::
 
   pkgadd -d http://get.opencsw.org/now
 
-On Solaris 8 and 9 (best effort support only), you need to download the
-package using e.g. wget and install it with::
+On Solaris 8 and 9 you need to download the package manually e.g. using wget
+and then install it::
 
   wget http://mirror.opencsw.org/opencsw/pkgutil.pkg
   pkgadd -d pkgutil.pkg
 
+Now is a good time to modify your profile to honour the OpenCSW programs.
+For a bourne shell add the following lines to your ``.profile``::
+
+  PATH=$PATH:/opt/csw/bin
+  MANPATH=$MANPATH:/opt/csw/share/man
+
+Please source it or logout and login again to make sure the environment is adjusted.
+
+You can now start installing packages. For a list of available packages use
+::
+  pkgutil -l
+
+As the list is quite long and you probably have an idea what you are looking for the
+list can be fuzzy-matched with
+::
+  root# pkgutil -a vim
+  common               package              catalog                        size
+  gvim                 CSWgvim              7.3.055,REV=2010.11.25       1.1 MB
+  vim                  CSWvim               7.3.055,REV=2010.11.25    1002.2 KB
+  vimrt                CSWvimrt             7.3.055,REV=2010.11.25       7.3 MB
+
+Lets just go ahead and try one::
+
+  root# pkgutil -i vim
+  ...
+  root# vim
+
+Voila! You have installed your first package!
+
+
+------------------
+Selecting a mirror
+------------------
+
+Now that you are about to install lots of stuff it may be a good time to select
+one of the mirrors from ``mirror.opencsw.org`` close to you. The official mirrors
+are listed at
+  http://www.opencsw.org/get-it/mirrors/
+
+
+-------------------------------------
+Setting up cryptographic verification
+-------------------------------------
+

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst	2012-01-20 20:04:35 UTC (rev 16868)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst	2012-01-20 21:42:19 UTC (rev 16869)
@@ -7,8 +7,10 @@
 .. toctree::
   :maxdepth: 2
 
+  introduction
   bootstrapping
   configuring-services
+  pkgutil-reference
 
 .. [#dagosscrapbook]
    `Dago's Scrapbook`_

Added: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst	                        (rev 0)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst	2012-01-20 21:42:19 UTC (rev 16869)
@@ -0,0 +1,6 @@
+------------
+Introduction
+------------
+
+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.