Barb, Here's my comments for the DC guide.
Customizable scripts on page 6: I'm wondering if the user will be confused and think they can only customize the scripts we provide and not that they actually should be creating their own for customization. They could customize ours. Not sure if that's a good idea though. Page 8: We also use python library modules located in /usr/lib/python2.4/vendor-packages/osol_install . Page 10: Please change all references to the default repository from http://pkg.opensolaris.org to http://pkg.opensolaris.org/release Page 11: If they don't want to use checkpointing, the easiest thing to do is disable it in the manifest file via the checkpoint_enable param. Set it to false. After an image is created, you have the following structure: <build_area> is from the manifest file. <build_area>/build_data/pkg_image == package image area <build_area>/build_data/bootroot == bootroot build area <build_area>/build_data/tmp == temporary directory.... <build_area>/media == Area the output images are placed <build_area>/logs == area that holds the log files. <output-image> remove this because it's not true. The output is now in <build_area>/media Page 12: Not all scripts are in /usr/share/distro_const. Some are in subdirs of that. Karen just removed pre_bootroot_pkg_image_mod You're missing the following from the default scripts: bootroot_configure, grub_setup.py Page 13: You write : "Other arguments can be passed into scripts by specifying them as key-value pairs." I think that's might be confusing to people. You may want to ask Jack since he's the finalizer guy. Page 14: "To use the checkpointing feature, you must specify a ZFS dataset as your package image" should be "To use the checkpointing feature, you must specify a ZFS dataset as your build_area" In the table description for distro_const build manifest "Creates an full image" should be "Creates a full image" "Lists valid steps at which user" should be "Lists valid steps at which the user" I believe im-mod is no longer a valid step. Page 16: The table... do you think the user realizes that if the Resumable column has an X in it, they can use that step to resume from? You might want to explain that. If you have questions about what I mean ask. Page 19: The manifest here is out of date. You should just replace the whole example manifest with our new one which has comments, another field that Karen added, and a few other small changes. Jean Barbara.Lundquist at Sun.COM wrote: > Installation Gang, > > Thank you for your edits to the first batch of installation documents. > I'll be integrating your > feedback to those documents next week for 10/28 delivery. > > Here's the second and final batch of 2008.11 installation documentation > for review: > the Auto Install and Distribution Constructor documents. These are new > documents. > > This second batch of documents are not due until about 11/14, so we have > more time to develop > these documents. Please start sending your edits and your suggestions on > how to > further revise and expand these documents to me and to our alias. > > > 1) OpenSolaris 2008.11 Automated Installer Guide > http://www.opensolaris.org/os/project/caiman/files/AIinstall.pdf > > 2) installadm(1M) man page (for Auto Install) > http://www.opensolaris.org/os/project/caiman/files/installadm.1m.txt > > 3) OpenSolaris 2008.11 Distribution Constructor Guide > http://www.opensolaris.org/os/project/caiman/files/DistroConst.pdf > > 4) distro_const(1M) man page > http://www.opensolaris.org/os/project/caiman/files/distro_const.1m.txt > > Thank you! > Barbara > > > > > > _______________________________________________ > caiman-discuss mailing list > caiman-discuss at opensolaris.org > http://mail.opensolaris.org/mailman/listinfo/caiman-discuss >
