[Drobo-utils-devel] SF.net SVN: drobo-utils:[188] trunk
Brought to you by:
peter_silva
Menu
▾
▴
[Drobo-utils-devel] SF.net SVN: drobo-utils:[188] trunk
|
From: <pet...@us...> - 2009-01-27 13:19:13
|
Revision: 188
http://drobo-utils.svn.sourceforge.net/drobo-utils/?rev=188&view=rev
Author: peter_silva
Date: 2009-01-27 12:19:59 +0000 (Tue, 27 Jan 2009)
Log Message:
-----------
More documentation fixups.
Added developer and CHANGES to the web site.
Modified Paths:
--------------
trunk/CHANGES
trunk/DEVELOPERS.txt
trunk/TODO
trunk/index.html
Modified: trunk/CHANGES
===================================================================
--- trunk/CHANGES 2009-01-27 04:09:21 UTC (rev 187)
+++ trunk/CHANGES 2009-01-27 12:19:59 UTC (rev 188)
@@ -1,19 +1,24 @@
0.5.0
+ * replaced DroboDMP C extension by DroboIOctl python class. no need
+ for architecture dependent packages. this also means you can just
+ try it out straight after download, no need to install anything.
+ much easier.
+ * device detection completely re-written. It works better now.
+ * Now displays mount points where it makes sense to do so.
* status command output better/different. shows all devices and mount points
for each drobo.
- * DiscoverMounts method added to Drobo class.
- * Multiple LUN detection now done properly, should work better
- with multiple LUNS and multiple Drobos.
+ * full Multiple LUN support. should do what is expected.
+ * full multiple Drobo support. should do what is expected.
* tested with multiple devices, now generally works in all cases.
* added modular info printing with csv list of outputs.
- * as of fw 1.3.0, put of settings page works, changing the name.
+ * firmware 1.3.0, has enabled formerly broken functionality which
+ name makes the sync command rename every drobo to 'hi there'.
+ fixed.
* added 'name' command, to name Drobo. (functionality of Sync)
* corrected detection logic, which depended on formerly immutable name.
(affects fw >= 1.3.0) now use same mechanisms as sg_scan from sg3_utils.
- * replaced DroboDMP C extension by DroboIOctl python class. no need
- for architecture dependent packages.
-0.4.0
+0.4.0 Release: 2008/12/28
* IMPORTANT: firmware 1.3.0 support added. Earlier drobo-utils
versions will not recognize a drobo running 1.3.0 or later.
* CLI is more normal... use getopts (got rid of device as fixed place arg.)
@@ -37,7 +42,7 @@
* firmware load issues should all be gone.
* Brad's fix for ddiag.c, done properly this time (my bad!)
-0.3.2
+0.3.2 release 2008/10/25
* for v1, still don't understand index.txt file.
* after testing, some more fixes, v2 downloads now work.
@@ -46,7 +51,7 @@
* added fwload directive to drobom.
* added root user check to give a bigger hint.
-0.3.1
+0.3.1 release 2008/10/01
* OK I know checking for firmware updates doesn't work
right now, but I need to find out why. code seems correct.
@@ -56,7 +61,7 @@
* header CRC on 32bit was broken on 64bit.
* 32 vs. 64 bit kludge needed.
-0.3.0
+0.3.0 release 2008/09/04
* added ability to format Drobo
* added ability to set lun sizes
* bugfix for firmware:
@@ -67,17 +72,17 @@
* some work done towards lunsize setting, but incomplete.
* some work towards indicating relay out progress, not tested...
-0.2.2 Released August 2008
+0.2.2 Released 2008/08/08
* firmware uploads work with .tdz as well
* tested with older firmwares, contains a few fixes to improve compatibility.
works well enought upgrade old firmwares.
-0.2.1 Released July 2008
- uploaded to drobospace & sourceforge.
+0.2.1 Released: 2008/08/06
+ * uploaded to drobospace & sourceforge.
* firmware upload works for .tdf's
0.1.1 Initial version uploaded april 2008
- to drobospace.com and sf.net
+ * to drobospace.com and sf.net
* confirmed to work with firmware 1.1.1
* shows status, disk slots filled, model, etc..
* shows fw version loaded.
Modified: trunk/DEVELOPERS.txt
===================================================================
--- trunk/DEVELOPERS.txt 2009-01-27 04:09:21 UTC (rev 187)
+++ trunk/DEVELOPERS.txt 2009-01-27 12:19:59 UTC (rev 188)
@@ -10,20 +10,43 @@
Random useful bits for developers. (aka notes to myself ;-)
-dpkg vs. Python Install
+Getting an SVN Snapshot
-----------------------
- the dpkg stuff in notdebian puts stuff in /usr/sbin while setup.py puts things in /usr/bin.
- python install does not install man pages either, which the dpkg takes care of.
- The libs are placed differently too. haven't reviewed for other conflicts, least
- confusing to use one or the other method on a system.
- (if you do python install, then dpkg --purge drobo-utils)
- There doesn't seem to be a distutils way to remove a package.
- I just do an installation, then manually remove the files it puts it.
+If you are told 'it is svn', and you want it now::
+ # svn co https://drobo-utils.svn.sourceforge.net/svnroot/drobo-utils/trunk mine
+ # cd mine # go into the source directory you downloaded
+ # ./drobom status # try it out...
+ # python setup.py install # install it in system places...
+ # drobom status # try it out...
+The 'setup.py' script is a convention from the distutils python packaging system. distutils installation is slightly different from installation from packages.
+There doesn't seem to be a distutils way to remove a package. touch all
+the files, do an installation, then manually remove the files it installed.
+
+If moving between packaging methods, check out the next
+section.
+
+
+
+Dpkg vs. Python Install
+-----------------------
+
+drobo-utils has been picked up for inclusion in debian. The "real" packaging
+for debian packages is kept in a separate tree, and maintained by debian
+developers. In the drobo-utils' tree, there is a directory (called notdebian)
+for building local packages for debian and ubuntu that isn't what is used
+for the distros.
+
+The dpkg stuff in notdebian puts stuff in /usr/sbin while setup.py puts things in /usr/bin. Python install does not install man pages either, which the dpkg takes care of. The libs are placed differently too. haven't reviewed for other conflicts, least confusing to use one or the other method on a system.
+
+(if you do distutils install, then remove the debian package via: dpkg --purge drobo-utils)
+
+
Making a Release
----------------
+
1 - make a branch
svn copy https://drobo-utils.svn.sourceforge.net/svnroot/drobo-utils/trunk https://drobo-utils.svn.sourceforge.net/svnroot/drobo-utils/branches/<branch>
@@ -34,49 +57,46 @@
3 - Build packages for testing & Install them. (see separate recipe.)
4 - Run QA.
- typically make a branch for each release. Record results of release tests in the branch (QA.txt)
- as new tests are created, modify QA.txt on trunk for to keep references for the next release.
+ Record results of release tests in the branch (QA.txt) As new tests are created, modify QA.txt on trunk for to keep references for the next release.
Building Debian & Ubuntu Packages
---------------------------------
- assumes you have installed the Build dependencies::
+assumes you have installed the Build dependencies::
- # obtain a fresh tree with no svn cruft to just build a package:
- % svn export https://drobo-utils.svn.sourceforge.net/svnroot/drobo-utils/branches/<version>
+ # obtain a fresh tree with no svn cruft to just build a package:
+ % svn export https://drobo-utils.svn.sourceforge.net/svnroot/drobo-utils/branches/<version>
+ % mv trunk drobo-utils-<version>
+ % cd drobo-utils-<version>
+ % ln -s notdebian debian # real debian packages use another debian/ tree.
+ % chmod 755 notdebian/rules # I dunno why the permissions are wrong...
- % mv trunk drobo-utils-<version>
- % cd drobo-utils-<version>
- % ln -s notdebian debian # real debian packages use another debian/ tree.
- % chmod 755 notdebian/rules # I dunno why the permissions are wrong...
-
-
- # this debian/ config is just for non-distro packages.
+ # this debian/ config is just for non-distro packages.
# builds for debian and Ubuntu.
- % dpkg-buildpackage -rfakeroot
- % cd ..
- # rename it for whatever distro is appropriate...
- % mv drobo_utils_0.3.3-1_i386 --> droboutils_0.3.3-1_i386_ubunutuIntrepid.deb
+ % dpkg-buildpackage -rfakeroot
+ % cd ..
+ # rename it for whatever distro is appropriate...
+ % mv drobo_utils_0.3.3-1_i386 --> droboutils_0.3.3-1_i386_ubunutuIntrepid.deb
- # rebuild the source tar because it will have the 'debian' link in it.
- % cd drobo-utils-0.99.9
- % rm debian
- % cd ..
- % tar -czvf drobo-utils-0.3.3-1.tgz drobo-utils-0.99.9
+ # rebuild the source tar because it will have the 'debian' link in it.
+ % cd drobo-utils-0.99.9
+ % rm debian
+ % cd ..
+ % tar -czvf drobo-utils-0.3.3-1.tgz drobo-utils-0.99.9
- apply QA tests. as per QA.txt recording results there.
+apply QA tests. as per QA.txt recording results there.
Updating Documentation
----------------------
- update the web site:
+update the web site:
- scp README.html <user>,dro...@we...:htdocs
+ % scp README.html <user>,dro...@we...:htdocs
Administrivia
Modified: trunk/TODO
===================================================================
--- trunk/TODO 2009-01-27 04:09:21 UTC (rev 187)
+++ trunk/TODO 2009-01-27 12:19:59 UTC (rev 188)
@@ -1,7 +1,6 @@
in no particular order:
-revamp documentation for 0.5.0... simplified.
BUGS:
when running two fw uploads, the second one will not run easily.
Modified: trunk/index.html
===================================================================
--- trunk/index.html 2009-01-27 04:09:21 UTC (rev 187)
+++ trunk/index.html 2009-01-27 12:19:59 UTC (rev 188)
@@ -24,10 +24,12 @@
<H2>Links & Help!</H2>
<UL>
<LI><A HREF="README.html">README.txt</a> -- Drobo-Utils Documentation
+<LI><A HREF="http://groups.google.com/group/drobo-talk?hl=en">http://groups.google.com/group/drobo-talk?hl=en</a> -- independent forum
<LI><A HREF="http://drobo.com">http://drobo.com</a> -- where to get a drobo
<LI><A HREF="http://sourceforge.net/projects/drobo-utils/">http://sourceforge.net/projects/drobo-utils/ </a> -- development home page. source code there as a download too...
<LI><A HREF="http://drobospace.com">http://drobospace.com</a> -- vendor forums. (serial number required for access.)
-<LI><A HREF="http://groups.google.com/group/drobo-talk?hl=en">http://groups.google.com/group/drobo-talk?hl=en</a> -- independent forum
+<LI><A HREF="DEVELOPERS.html">DEVELOPERS.txt</a> -- developer notes.
+<LI><A HREF="CHANGES.html">CHANGES.txt</a> -- What's in each version.
</UL>
If you have questions, you can try the google groups or just post to dro...@so..., but for now, it's just me... my email works too... Pet...@gm... (help welcome!)
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
