AI Image Management Changes

With the push of:

     Author: Susan Sohn <susan.sohn@oracle.com>
     Repository: /hg/caiman/slim_source
     Latest revision: 31c6d2de57315487c3c9bc4f00996e4fdcd562ca
     Total changesets: 1
     Log message:
     7042036 Implement ISIM project
     7010609 installadm create-client for Sparc clients may not clean up old wanboot.conf file
     7011274 installadm error usage message needs to be enhanced
     7015125 the return value should be not be "0" when delete non-existent client
     7015142 installadm should provide infomation what service name was created when without -n option
     7021675 the Macro should be deleted after client was deleted
     7034888 installadm list can probably stop displaying the port number
     7037518 installadm delete-service doesn't clean up /tftpboot
     7043712 RFE: clarify 'create-client' section in installadm to encompass a 'modify-client' condition
     4564 delete-client returned successful when non-existent mac address passed in
     6776 create-service should take imagepath with an option flag
     6778 create-service should take imagepath as an optional argument
     6812 create-service:Default service names are difficult to remember and not friendly
     7380 installadm create-service prints to stderr when returning good status
     8598 'installadm create-client' send error msgs to stdout instead of stderr in some cases
     10853 create-service:Should consider removing /tftpboot/rm.<service|client> scripts
     11293 delete-service: should check if clients are dependent on service
     11537 create-service: Look to mounting boot archives via service configuration and not modifying /etc/vfstab
     12812 create-client: image-path providence should be tracked through all error messages
     13927 create-client allows same client for multiple services
     14851 create-client should inherit boot options from install service
     15170 /usr/lib/installadm/setup-dhcp returns 1 on failure or manual DHCP setup needed
     15717 installadm list -n svc -m states error when no manifests
     18157 create_client.py: AttributeError: 'module' object has no attribute 'AIImageError'

in build 169, changes have been made to AI Image Management and to installadm(1M):

NOTE: See below for information on conversion script for existing AI servers.

1. The DHCP server used by installadm will be the ISC DHCP server rather than
the Solaris DHCP server. If desired, Solaris DHCP can still be configured
externally rather than using ISC DHCP. The existing Solaris DHCP configuration
can be used if desired. Any additional changes needed would have to be manually
configured.

2. The concept of an alias has been added. An alias is a service that uses an
existing service's imagepath, but has its own clients, manifests, and profiles.
An alias can only point to a service whose image is version 3 or later, i.e.,
those that are built after the integration of this project. The first
version 3 (or greater) service created of a given architecture will
automatically trigger the subsequent creation of a 'default-i386' or
'default-sparc' alias, which will provide the default boot service for that
architecture.

To manually create an alias, use the create-service subcommand:
     installadm create-service -t <existing_service> -n <svcname> [-b <bootargs>]

3. Also new in installadm(1M):

a. Any service, with the exception of the default-i386 or default-sparc service,
can now be renamed using the new subcommand, rename-service:
     installadm rename-service <svcname> <newsvcname>

b. An alias can be changed to point to a different existing service using the
subcommand set-service, i.e.,
     installadm set-service -o aliasof=<existing_service> <aliasname>

c. installadm delete-service
    o now automatically deletes the associated image. The -x option has
      been removed.
    o will not delete a service with dependent clients or
      aliases unless the newly added '-r|--autoremove' option is used.
      If the 'default-i386' or 'default-sparc' alias is being deleted, a
      confirmation prompt is displayed unless -y is also specified.

d. The -t option has been removed from create-client and disable.

e. Other create-service changes:
    o the -f option has been removed
    o the <imagepath>, previously <targetdir>, is now specified with the
      -d|--imagepath option. If not specified, the default location
      /export/auto_install/<svcmaname> will be used (a confirmation prompt
      is displayed unless -y is also specified).
    o the new -B option can be used to provide the IP address of the boot
      server from which clients should request bootfiles, if it cannot be
      determined by other means (only used for integrated ISC DHCP server).


Conversion script for existing AI servers
---------------------------------------------------------
Existing AI services are NOT compatible with this version of installadm(1M).

NOTE: A conversion script is available. To avoid having to run the
      conversion script, you can use installadm to delete your AI
      configuration (services, clients, etc.) PRIOR to updating the
      installadm package. You can then recreate the configuration after
      updating.

After updating to the build of Solaris and/or installadm package containing
these changes, the installadm service will not come online if old services are
present on the system. The installadm service log at:
    /var/svc/log/system-install-server:default.log
will show the incompatible services and tell you to run /usr/sbin/installadm-convert
to convert the services.

1. Dry Run mode
To perform a dry run of the conversion script (list out the changes that would
be performed without performing them), use the "-n|--dryrun" option.

2. Integrated AI and DHCP server support
If your AI server currently also provides DHCP for AI services, the conversion
script will generate a configuration file that you can use with ISC DHCP. The
configuration file should be moved to the location specified by the
config/config_file SMF property:
% svccfg -s svc:/network/dhcp/server:ipv4 listprop config/config_file

Once this is done, you should disable the Solaris DHCP service:
# svcadm disable svc:/network/dhcp-server:default

To *only* generate the ISC DHCP configuration file, run the conversion script
with the "-p|--dhcp" option.

Updated installadm usage
--------------------------------------

Usage: installadm [options] <subcommand> <args> ...
create-service
        [-n|--service <svcname>]
        [-t|--aliasof <existing_service>]
        [-s|--source <ISO>]
        [-b|--boot-args <boot property>=<value>,...]
        [-i|--ip-start <dhcp_ip_start>]
        [-c|--ip-count <count_of_ipaddr>]
        [-B|--bootfile-server <server_ipaddr>]
        [-d|--imagepath <imagepath>]
        [-y|--noprompt]
delete-service [-r|--autoremove] [-y|--noprompt] <svcname>]
rename-service    <svcname> <newsvcname>
set-service    -o|--option <prop>=<value> <svcname>
        prop=value can be:
            aliasof=<existing_service>
            default-manifest=<manifest/script name>
list    [-n|--service <svcname>] [-c|--client] [-m|--manifest] [-p|--profile]
enable    <svcname>
disable    <svcname>
create-client    [-b|--boot-args <property>=<value>,...]
        -e|--macaddr <macaddr> -n|--service <svcname>
delete-client    <macaddr>
add-manifest    -n|--service <svcname>
        -f|--file <manifest_file/script file>
        [-m|--manifest <manifest/script name>]
        [-c|--criteria <criteria=value|range> ... |
         -C|--criteria-file <criteria.xml>]
        [-d|--default]
update-manifest    -n|--service <svcname>
        -f|--file <manifest/script file>
        -m|--manifest <manifest/script name>
delete-manifest    -m|--manifest <manifest/script name>
        -n|--service <svcname>
create-profile -n|--service <svcname> -f|--file <profile_file>...
        [-p|--profile <profile_name>]
        [-c|--criteria <criteria=value|range> ...] |
        [-C|--criteria-file <criteria_file>]
delete-profile    -p|--profile <profile_name> ... -n|--service <svcname>
export    -n|--service <svcname>
        -m|--manifest <manifest/script name> ...
        -p|--profile <profile name> ...
        -o|--output <pathname>
validate    -n|--service <svcname>
        -P|--profile-file <profile_path> ... |
        -p|--profile <profile_name> ...
set-criteria    -m|--manifest <manifest/script name>
        -p|--profile <profile_name> ...
        -n|--service <svcname>
        -c|--criteria <criteria=value|range> ... |
        -C|--criteria-file <criteria.xml> |
        -a|--append-criteria <criteria=value|range> ...
help    [<subcommand>]