Barbara.Lundquist at sun.com wrote:
> Gang,
> Attached are the review drafts for AI for inclusion in RC1 if possible.
> Replace existing docs in package with these new versions.
>
> This is not required for RC1, but it would be nice to have our review
> drafts included in the RC1 build.
>
> Barbara
> ------------------------------------------------------------------------
>
> _______________________________________________
> caiman-discuss mailing list
> caiman-discuss at opensolaris.org
> http://mail.opensolaris.org/mailman/listinfo/caiman-discuss
Barbara,

    The comments may be little late. I was busy with making AI work. If 
you can incorporate these changes, it will be good. Otherwise please 
change the document and we can release with next version of 
SUNWinstalladm-tools package.

* Introduction to Automated Installer*:
    - "This service is available on a webserver" is not correct. It is 
more like "the service includes a web server, which stores the list of 
manifests that were made available by the administrator.
    - "Server setup is minimal and requires only one option, the 
location of the source image"  --> It requires source image and a target 
directory to setup the image to be used by the client during installation

*Automated Installer Features:*
    - "keyboard Language" (last bullet under SC manifest) is not 
supported. Please remove that now.
    - "Set up and update a DHCP server" bullet under "The installadm 
Utility" should be part of of the first bullet (Set up services and 
installation images) because there is no separate option to setup DHCP 
installadm

*System requirements:*
    - The first senetence "The automated installer requires the 
following setup:" is not right. Something like "The following table 
contains the requirements to setup an install server that can server AI 
clients" may be better.
    - Required packages - These are SVR4 package names. Use IPS package 
names. Get the packages names from the document 
http://www.opensolaris.org/os/project/caiman/auto_install/AI_install_server_setup.html
    - Under Network access, add the information that the server should 
have DNS as the name server and configured DNS correctly. Also add that 
default router should be set on the server. These are needed for the 
installadm tool to setup DHCP correctly. Check the document 
http://www.opensolaris.org/os/project/caiman/auto_install/AI_install_server_setup.html
 
for more information.

*Automated Installer Files*
    - installadm is at /usr/sbin/installadm and rest of the files are at 
/usr/lib/installadm
    - The files under var/installadm/ai-webserver/ should npt be 
documented. These are static files and changing these files will cause 
problems.

*Using the Automated Installer (Tasks):*
    - "Use the automated installer to perform two core tasks:" doesn't 
make sense. Change it to something like "The following tasks are needed 
to install OpenSolaris using Automated Installer"
    - "Edit the manifest files to design the images you want to 
install." can be changed to "Edit the manifest files to customize your 
installation"
    - "Run the installadm utility to create installer services and to 
customize your clients" can be changed to "Run the installadm utility to 
create installer services and setup associated configuration"

*AI Manifest files:*

    - Example 2.1: Replace the lines

        <main url="http://pkg.opensolaris.org"; authname="opensolaris.org"/> 
        <mirror url="" authname=""/> 

    with the following line.

        <main url="http://pkg.opensolaris.org"; authname="opensolaris.org"/>

    - Example 2.2: Use the example C from the document 
http://www.opensolaris.org/os/project/caiman/auto_install/AI_manifest_setup.html

*SC Manifest files:*

    - We don't support encrypted passwords in the SC manifest. Please 
replace the lines

        <propval name='userpass' type='astring' value='9Nd/cwBcNWFZg' />
        <propval name='rootpass' type='astring' value='wqy8hz4xKqw4o' /> 

    with the following lines

        <propval name='userpass' type='astring' value='jack' />
        <propval name='rootpass' type='astring' value='opensolaris' /> 

*installadm Command Reference:*

    - installadm create-service doesn't support option -d for 2008.11 
release.
    - installadm set  is not implemented for 2008.11 release

There are two other documents, you can add to this book. The AI setup 
instructions at 
http://www.opensolaris.org/os/project/caiman/auto_install/AI_install_server_setup.html
 
and detailed manifest examples at 
http://www.opensolaris.org/os/project/caiman/auto_install/AI_manifest_setup.html
 


Thanks,
Sundar


-------------- next part --------------
An HTML attachment was scrubbed...
URL: 
<http://mail.opensolaris.org/pipermail/caiman-discuss/attachments/20081108/8749ac71/attachment.html>

Reply via email to