[indiana-discuss] [docs-discuss] Updateing and Release Notes

[alan mcclellan]

Thanks for the inputs on the docs. Will take a look and see how we can 
address these concerns.

Also, am posting to indiana-discuss. Can someone on this list comment on 
the upgrade problem Jorgen encountered?

-alan



Jørgen Austvik wrote:
> Yesterday I had a horrible experience upgrading OpenSolaris from 2008.05 to 2008.11.
>
> I tried to follow http://dlc.sun.com/osol/docs/content/2008.11/getstart/upgrade.html, but it failed a couple of times. The first attempt hanged during downloading nblib(?). The second attempt failed like this:
>
> -------------
> PHASE                                        ACTIONS
> Removal Phase                            53860/53860
> Update Phase                             55283/123816 Action upgrade failed for 'opt/SUNWjavadb/docs/html/adminguide/cadminapps49914.html' (pkg:/SUNWjavadb):
> OSError: [Errno 2] No such file or directory: '/tmp/tmpOHwMOe/opt/SUNWjavadb/docs/html/adminguide/cadminapps49914.html'
> pkg: An unexpected error happened during image-update: [Errno 2] No such file or directory: '/tmp/tmpOHwMOe/opt/SUNWjavadb/docs/html/adminguide/cadminapps49914.html'
> The running system has not been modified. Modifications were only made to a clone of the running system.  This clone is mounted at /tmp/tmpOHwMOe should you wish to inspect it.
>
> Traceback (most recent call last):
>  File "/usr/bin/pkg", line 1440, in ?
>    ret = main_func()
>  File "/usr/bin/pkg", line 1404, in main_func
>    return image_update(img, pargs)
>  File "/usr/bin/pkg", line 391, in image_update
>    img.imageplan.execute()
>  File "/usr/lib/python2.4/vendor-packages/pkg/client/imageplan.py", line 452, in execute
>    p.execute_update(src, dest)
>  File "/usr/lib/python2.4/vendor-packages/pkg/client/pkgplan.py", line 297, in execute_update
>    dest.install(self, src)
>  File "/usr/lib/python2.4/vendor-packages/pkg/actions/file.py", line 125, in install
>    os.chmod(temp, mode)
> OSError: [Errno 2] No such file or directory: '/tmp/tmpOHwMOe/opt/SUNWjavadb/docs/html/adminguide/cadminapps49914.html'
> -------------
>
> During the 3-4 hours pkg ran, the (2GB mem, F4005 Ferrari) machine was swapping like crazy, and totally unusable (seconds of delay from entering a button on the keyboard until it appeared in gterm).
>
> Off course, when I whine about the experience to the local OpenSolaris Wizards (and starts to compare it to my mount old perfect experience of updating to the latest Ubuntu), I get this answer:
>
>   pfexec pkg refresh --full
>   pfexec pkg install SUNWipkg at 0.5.11-0.$(uname -v | sed s/snv_//) 
>
> Funny enough, this is mentioned in the 2008.05 release notes:
> http://www.opensolaris.org/os/project/indiana/resources/relnotes/200805/x86/#Update_Inst
>
> But not in the 2008.11 release notes:
> http://www.opensolaris.org/os/project/indiana/resources/relnotes/200811/x86/
>
> Actually, it is worse than that, because our update instructions does not mention them:
> http://dlc.sun.com/osol/docs/content/2008.11/getstart/upgrade.html
> (Oh, actually I find a link there now, after a day of problems, and nobody else I have whined to have seen the link either.)
>
> Suggestions:
> - Please make the release notes say something about what you have to do to upgrade from the previous release
> - Please make the release notes more readable - a list of bugs does not make a release notes IMNSHO
> - Please make the instructions for updating from the previous release more visible
> - pkg failed on two different places on two different tries while it simultaneously rendered the computer useless while running for many hours. Please put resources into fixing pkg.
>