Add the rpkgmanager how to.
authorluxh <luxh@web>
Wed, 9 Nov 2011 22:08:36 +0000 (14:08 -0800)
committerCharlie <root@leaf.dragonflybsd.org>
Wed, 9 Nov 2011 22:08:36 +0000 (14:08 -0800)
docs/howtos/rpkgmanager/index.mdwn

index 54f6d64..3b66c65 100644 (file)
@@ -1 +1,53 @@
-rpkgmanager is a simple way of keeping your packages updated. It is based around a list with packages that you wish to have installed.
+### Introduction
+rpkgmanager is a simple way of installing and keeping your packages updated. It builds from source and uses what pkgsrc tree you have checked out in /usr/pkgsrc. It is based around a list with packages that you wish to have installed. rpkgmanager is written in ruby.
+
+### Setting it up
+Begin by installing lang/ruby, pkgtools/p5-pkgsrc-Dewey, installing the needed gem and cloning the rpkgmanager git repo:
+
+    # pkg_radd ruby p5-pkgsrc-Dewey
+    # gem19 install open4
+    > git clone git://gitorious.org/rpkgmanager/rpkgmanager.git && cd rpkgmanager
+
+Now it's time to set up wanted.db, the file that holds all packages you want installed. There is a sample wanted.db file in your checked out directory. This is what I use:
+
+    devel/mercurial,42
+    devel/scmgit,42
+    devel/subversion-base,42
+    lang/pcc-current,42
+    lang/ruby,42
+    mail/mutt-devel,42
+    mail/offlineimap,42
+    misc/screen,42
+    multimedia/mplayer,42
+    net/avahi,42
+    net/netatalk,42
+    net/nmap,42
+    net/rsync,42
+    net/rtorrent,42
+    pkgtools/p5-pkgsrc-Dewey,42
+    security/sudo,42
+    sysutils/cdrtools,42
+    sysutils/smartmontools,42
+    wip/jdk16,42
+    www/apache22,42
+    www/apache-tomcat6,42
+    www/curl,42
+    www/links,42
+
+The number after the comma tells rpkgmanager in which order to install/upgrade the packages. I really don't care, so all packages have the same priority.
+
+### Using it
+
+Running rpkgmanager may take some time depending on how many packages you install. It has to gather information on everyone of them. It will ask the simple Yes or No question when done. Remember that it will want to remove all packages that are not in your wanted.db file. Proceed or not.
+
+To run it, just execute the ruby file.
+
+    # ./rpkgmanager.rb
+
+I've set it up to run every night answering No to the proceed question, just to see what it wants to do. Add this to your /etc/crontab:
+
+    0 3 * * * root cd /usr/pkgsrc && /usr/pkg/bin/git pull && echo n | /home/luxh/bin/rpkgmanager.rb
+
+Then in the morning when you've read the night's logs and wish to upgrade your packages:
+
+    # yes | rpkgmanager.rb