2 .\" Copyright (c) 2008, 2012, Oracle and/or its

     2 .\" Copyright (c) 2008, 2012, Oracle and/or its affiliates. All rights reserved.

     3 .\" affiliates. All rights reserved.

     3 .TH installadm 1M "29 Jun 2012" "SunOS 5.11" "System Administration Commands"

     4 .TH installadm 1M "20 Apr 2012" "SunOS 5.11" "System Administration Commands"

    20 installadm create-service

    19 installadm create-service [-n|--service \fIsvcname\fR]

    21     [-n|--service \fIsvcname\fR]

    20     [-s|--source \fIsource\fR]

    22     [-t|--aliasof \fIexisting_service\fR]

    21     [-p|--publisher \fIpublisher\fR=\fIorigin\fR]

    23     [-p|--publisher \fIprefix\fR=\fIorigin\fR]

    25     [-s|--source \fIFMRI_or_ISO\fR]

    23     [-d|--imagepath \fIimagepath\fR] [-y|--noprompt]

    26     [-b|--boot-args \fIboot_property\fR=\fIvalue\fR,...]

    24     [-t|--aliasof \fIaliasof\fR]

    27     [-i|--ip-start \fIdhcp_ip_start\fR]

    25     [-i|--ip-start \fIstart\fR] [-c|--ip-count \fIcount\fR]

    28     [-c|--ip-count \fIcount_of_ipaddr\fR]

    26     [-b|--boot-args \fIproperty\fR=\fIvalue\fR,...]

    29     [-B|--bootfile-server \fIserver_ipaddr\fR]

    27     [-B|--bootfile-server \fIserver\fR]

    30     [-d|--imagepath \fIimagepath\fR]

    28 .fi

    31     [-y|--noprompt]

    29 

    32 .fi

    30 .LP

    33 

    31 .nf

    34 .LP

    32 installadm set-service -o|--option \fIproperty\fR=\fIvalue\fR \fIsvcname\fR

    35 .nf

    33 .fi

    36 installadm set-service

    34 

    37     -o|--option \fIprop\fR=\fIvalue\fR \fIsvcname\fR

    35 .LP

    36 .nf

    37 installadm update-service [-p|--publisher \fIpublisher\fR=\fIorigin\fR]

    38     [-s|--source \fIFMRI\fR] \fIsvcname\fR

    57 installadm delete-service

    58 installadm delete-service [-r|--autoremove] [-y|--noprompt]

    58     [-r|--autoremove] [-y|--noprompt] \fIsvcname\fR

    59     \fIsvcname\fR

    59 .fi

    60 .fi

    60 

    61 

    61 .LP

    62 .LP

    62 .nf

    63 .nf

    63 installadm list

    64 installadm list [-n|--service \fIsvcname\fR] [-c|--client]

    64     [-n|--service \fIsvcname\fR]

    65     [-m|--manifest] [-p|--profile]

    65     [-c|--client] [-m|--manifest] [-p|--profile]

    71     -f|--file \fImanifest_or_script_filename\fR

    71     -f|--file \fIfilename\fR [-m|--manifest \fImanifest\fR]

    72     [-m|--manifest \fImanifest_name\fR]

    72     [-c|--criteria \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR... |

    73     -C|--criteria-file \fIcriteriafile\fR] [-d|--default]

    74 .fi

    75 

    76 .LP

    77 .nf

    78 installadm update-manifest -n|--service \fIsvcname\fR

    79     -f|--file \fIfilename\fR [-m|--manifest \fImanifest\fR]

    80 .fi

    81 

    82 .LP

    83 .nf

    84 installadm delete-manifest -n|--service \fIsvcname\fR

    85     -m|--manifest \fImanifest\fR

    86 .fi

    87 

    88 .LP

    89 .nf

    90 installadm create-profile -n|--service \fIsvcname\fR

    91     -f|--file \fIfilename\fR... [-p|--profile \fIprofile\fR]

   104     -f|--file \fIprofile_filename\fR

    99     -f|--file \fIfilename\fR [-p|--profile \fIprofile\fR]

   105     [-p|--profile \fIprofile_name\fR]

   100 .fi

   106 .fi

   101 

   107 

   102 .LP

   108 .LP

   103 .nf

   109 .nf

   104 installadm delete-profile -n|--service \fIsvcname\fR

   110 installadm delete-profile -p|--profile \fIprofile_name\fR...

   105     -p|--profile \fIprofile\fR...

   111     -n|--service \fIsvcname\fR

   117     -m|--manifest \fImanifest_name\fR...

   111     -m|--manifest \fImanifest\fR... -p|--profile \fIprofile\fR...

   118     -p|--profile \fIprofile_name\fR...

   125     -P|--profile-file \fIprofile_filename\fR... |

   118     -P|--profile-file \fIfilename\fR... | -p|--profile \fIprofile\fR...

   126     -p|--profile \fIprofile_name\fR...

   119 .fi

   127 .fi

   120 

   128 

   121 .LP

   129 .LP

   122 .nf

   130 .nf

   123 installadm set-criteria -n|--service \fIsvcname\fR

   131 installadm set-criteria

   124     -m|--manifest \fImanifest\fR -p|--profile \fIprofile\fR...

   132     -m|--manifest \fImanifest_name\fR

   133     -p|--profile \fIprofile_name\fR...

   134     -n|--service \fIsvcname\fR

   142 installadm create-client

   132 installadm create-client -n|--service \fIsvcname\fR

   143     [-b|--boot-args \fIproperty\fR=\fIvalue\fR,...]

   133     [-b|--boot-args \fIproperty\fR=\fIvalue\fR,...] -e|--macaddr \fImacaddr\fR

   144     -e|--macaddr \fImacaddr\fR -n|--service \fIsvcname\fR

   338 .RS 14n

   344 .sp .6

   339 .rt  

   345 .RS 4n

   351 \fB\fBhelp [\fIsubcommand\fR]\fR\fR

   357 \fB\fBinstalladm help [\fIsubcommand\fR]\fR\fR

   362 .RS 14n

   368 .sp .6

   363 .rt  

   369 .RS 4n

   373 \fB\fBcreate-service [\fB-n\fR|\fB--service\fR \fIsvcname\fR] [\fB-t\fR|\fB--aliasof\fR \fIexisting_service\fR] [\fB-p\fR|\fB--publisher\fR \fIprefix\fR=\fIorigin\fR] [\fB-a\fR|\fB--arch\fR \fIarchitecture\fR] [\fB-s\fR|\fB--source\fR \fIFMRI_or_ISO\fR] [\fB-b\fR|\fB--boot-args\fR \fIboot_property\fR=\fIvalue\fR,...] [\fB-i\fR|\fB--ip-start\fR \fIdhcp_ip_start\fR] [\fB-c\fR|\fB--ip-count\fR \fIcount_of_ipaddr\fR] [\fB-B\fR|\fB--bootfile-server\fR \fIserver_ipaddr\fR] [\fB-d\fR|\fB--imagepath\fR \fIimagepath\fR] [\fB-y\fR|\fB--noprompt\fR]\fR\fR

   379 \fB\fBinstalladm create-service [-n|--service \fIsvcname\fR]\fR\fR

   380 .ad

   381 .br

   382 .na

   383 \fB\fB[-s|--source \fIsource\fR]\fR\fR

   384 .ad

   385 .br

   386 .na

   387 \fB\fB[-p|--publisher \fIpublisher\fR=\fIorigin\fR]\fR\fR

   388 .ad

   389 .br

   390 .na

   391 \fB\fB[-a|--arch \fIarchitecture\fR]\fR\fR

   392 .ad

   393 .br

   394 .na

   395 \fB\fB[-d|--imagepath \fIimagepath\fR] [-y|--noprompt]\fR\fR

   396 .ad

   397 .br

   398 .na

   399 \fB\fB[-t|--aliasof \fIaliasof\fR]\fR\fR

   400 .ad

   401 .br

   402 .na

   403 \fB\fB[-i|--ip-start \fIstart\fR] [-c|--ip-count \fIcount\fR]\fR\fR

   404 .ad

   405 .br

   406 .na

   407 \fB\fB[-b|--boot-args \fIproperty\fR=\fIvalue\fR,...]\fR\fR

   408 .ad

   409 .br

   410 .na

   411 \fB\fB[-B|--bootfile-server \fIserver\fR]\fR\fR

   387 When the first install service of a given architecture is created on an install server, an alias of that service, \fBdefault-i386\fR or \fBdefault-sparc\fR, is automatically created. This default service is used for all installations to clients of that architecture that were not added to the install server explicitly with the \fBcreate-client\fR subcommand. To change the service aliased by the \fBdefault-\fIarch\fR\fR service, use the \fBset-service\fR subcommand.

   425 When the first install service of a given architecture is created on an install server, an alias of that service, \fBdefault-i386\fR or \fBdefault-sparc\fR, is automatically created. This default service is used for all installations to clients of that architecture that were not added to the install server explicitly with the \fBcreate-client\fR subcommand. To change the service aliased by the \fBdefault-\fIarch\fR\fR service, use the \fBset-service\fR subcommand. To update the \fBdefault-\fIarch\fR\fR service, use the \fBupdate-service\fR subcommand.

   388 .sp

   426 .sp

   389 If a \fBdefault-\fIarch\fR\fR alias is changed to a new install service and a local ISC DHCP configuration is found, this default alias bootfile is set as the default DHCP server-wide bootfile for that architecture.

   427 If a \fBdefault-\fIarch\fR\fR alias is changed to a new install service and a local ISC DHCP configuration is found, this default alias boot file is set as the default DHCP server-wide boot file for that architecture.

   405 Even when \fB-i\fR and \fB-c\fR arguments are provided and DHCP is configured, no binding exists between the install service being created and the IP range. When \fB-i\fR and \fB-c\fR are passed, the IP range is set up, a new DHCP server is created if needed, and that DHCP server remains up and running for all install services and all clients to use. The network information provided to the DHCP server has no specific bearing on the service being created.

   443 Even when \fB-i\fR and \fB-c\fR arguments are provided and DHCP is configured, no binding exists between the install service being created and the IP range. When \fB-i\fR and \fB-c\fR are passed and the value of \fBall_services/manage_dhcp\fR is \fBtrue\fR, the IP range is set up, a new DHCP server is created if needed, and that DHCP server remains up and running for all install services and all clients to use. The network information provided to the DHCP server has no specific bearing on the service being created.

   417 \fB\fB\fB-n\fR|\fB--service\fR \fIsvcname\fR\fR\fR

   455 \fB\fB-n|--service \fIsvcname\fR\fR\fR

   418 .ad

   456 .ad

   419 .sp .6

   457 .sp .6

   420 .RS 4n

   458 .RS 4n

   421 Optional: Uses this install service name instead of a system-generated service name. The \fIsvcname\fR can consist of alphanumeric characters, underscores (\fB_\fR), and hyphens (\fB-\fR). The first character of \fIsvcname\fR cannot be a hyphen.

   459 Optional: Uses this install service name instead of a system-generated service name. The \fIsvcname\fR can consist of alphanumeric characters, underscores (\fB_\fR), and hyphens (\fB-\fR). The first character of \fIsvcname\fR cannot be a hyphen. The length of the \fIsvcname\fR cannot exceed 63 characters.

   422 .sp

   460 .sp

   423 If the \fB-n\fR option is not specified, a service name is generated automatically. 

   461 If the \fB-n\fR option is not specified, a service name is generated automatically. The default name includes architecture and OS version information.

   424 .RE

   462 .RE

   425 

   463 

   426 .sp

   464 .sp

   427 .ne 2

   465 .ne 2

   428 .mk

   466 .mk

   429 .na

   467 .na

   430 \fB\fB\fB-t\fR|\fB--aliasof\fR \fIexisting_service\fR\fR\fR

   468 \fB\fB-s|--source \fIsource\fR\fR\fR

   431 .ad

   432 .sp .6

   433 .RS 4n

   434 Optional: This new service is an alternate name for \fIexisting_service\fR. 

   435 .RE

   436 

   437 .sp

   438 .ne 2

   439 .mk

   440 .na

   441 \fB\fB\fB-a\fR|\fB--arch\fR \fIarchitecture\fR\fR\fR

   442 .ad

   443 .sp .6

   444 .RS 4n

   445 Optional: Selects a specific variant architecture. Legal values are \fBi386\fR or \fBsparc\fR. If not specified, the variant corresponding to the server's architecture is selected.

   446 .sp

   447 The \fB-a\fR option only applies when the \fB-s\fR argument is a \fBpkg\fR(5) package.

   448 .RE

   449 

   450 .sp

   451 .ne 2

   452 .mk

   453 .na

   454 \fB\fB\fB-p\fR|\fB--publisher\fR \fIprefix\fR=\fIorigin\fR\fR\fR

   455 .ad

   456 .sp .6

   457 .RS 4n

   458 Optional: A \fBpkg\fR(5) publisher, in the form \fIprefix\fR=\fIorigin\fR, from which to install the client image.

   459 .sp

   460 If the \fB-p\fR option is not specified, then the first publisher in the system's publisher preference list that provides an instance of the package is used.

   461 .RE

   462 

   463 .sp

   464 .ne 2

   465 .mk

   466 .na

   467 \fB\fB\fB-s\fR|\fB--source\fR \fIFMRI_or_ISO\fR\fR\fR

   476 The full FMRI of a \fBpkg\fR(5) package.

   477 The FMRI of an IPS AI net image package. This is the default. If the \fB-s\fR option is not specified, the newest available version of the \fBinstall-image/solaris-auto-install\fR package is used. The package is retrieved from the publisher specified by the \fB-p\fR option or from the first publisher in the install server's publisher preference list that provides an instance of the package.

   484 .sp

   485 .RE

   485 .LP

   486 

   486 If \fB-s\fR is not specified, the \fBinstall-image/solaris-auto-install\fR package used is from either of:

   487 .sp

   487 .RS +4

   488 .ne 2

   488 .TP

   489 .mk

   489 .ie t \(bu

   490 .na

   490 .el o

   491 \fB\fB-p|--publisher \fIpublisher\fR=\fIorigin\fR\fR\fR

   491 The publisher specified with the \fB-p\fR parameter.

   492 .ad

   492 .RE

   493 .sp .6

   493 .RS +4

   494 .RS 4n

   494 .TP

   495 Optional: Only applies when the service is being created from an IPS package. Specifies the IPS package repository from where you want to retrieve the \fBinstall-image/solaris-auto-install\fR package. An example is \fBsolaris=http://pkg.oracle.com/solaris/release/\fR.

   495 .ie t \(bu

   496 .sp

   496 .el o

   497 If the \fB-p\fR option is not specified, the publisher used is the first publisher in the install server's publisher preference list that provides an instance of the package.

   497 The first publisher in the system's publisher preference list that provides an instance of that package.

   498 .RE

   498 .RE

   499 

   499 .RE

   500 .sp

   500 

   501 .ne 2

   501 .sp

   502 .mk

   502 .ne 2

   503 .na

   503 .mk

   504 \fB\fB-a|--arch \fIarchitecture\fR\fR\fR

   504 .na

   505 .ad

   505 \fB\fB\fB-b\fR|\fB--boot-args\fR \fIboot_property\fR=\fIvalue\fR,...\fR\fR

   506 .sp .6

   506 .ad

   507 .RS 4n

   507 .sp .6

   508 Optional: Only applies when the service is being created from an IPS package. Specifies the architecture of the clients to be installed with this service. The value can be either \fBi386\fR or \fBsparc\fR. The default is the architecture of the install server.

   508 .RS 4n

   509 .RE

   509 Optional: For x86 clients only. Sets a property value in the service-specific \fBmenu.lst\fR file in the service image. Use this option to set boot properties that are specific to this service. This option can accept multiple comma-separated \fIboot_property\fR=\fIvalue\fR pairs.

   510 

   510 .RE

   511 .sp

   511 

   512 .ne 2

   512 .sp

   513 .mk

   513 .ne 2

   514 .na

   514 .mk

   515 \fB\fB-d|--imagepath \fIimagepath\fR\fR\fR

   515 .na

   516 .ad

   516 \fB\fB\fB-i\fR|\fB--ip-start\fR \fIdhcp_ip_start\fR\fR\fR

   517 .sp .6

   517 .ad

   518 .RS 4n

   518 .sp .6

   519 Optional: Specifies the path at which to create the net image. If not specified, the image is created in a \fIsvcname\fR directory at the location defined by the value of the \fBall_services/default_imagepath_basedir\fR property. For the default value of this property, see "Install Server Configuration Properties." A confirmation prompt is displayed unless \fB-y\fR is also specified.

   519 .RS 4n

   520 .RE

   520 Optional: Specifies the starting IP address in a range to be added to the local DHCP configuration. The number of IP addresses is provided by the \fB-c\fR option. If a local ISC DHCP configuration does not exist, an ISC DHCP server is started.

   521 

   521 .RE

   522 .sp

   522 

   523 .ne 2

   523 .sp

   524 .mk

   524 .ne 2

   525 .na

   525 .mk

   526 \fB\fB-y|--noprompt\fR\fR

   526 .na

   527 .ad

   527 \fB\fB\fB-c\fR|\fB--ip-count\fR \fIcount_of_ipaddr\fR\fR\fR

   528 .sp .6

   528 .ad

   529 .RS 4n

   529 .sp .6

   530 Optional: Suppresses any confirmation prompts and proceeds with service creation using the supplied options and any default values (see \fB-d\fR).

   530 .RS 4n

   531 .RE

   531 Optional: Sets up a total number of IP addresses in the DHCP configuration equal to the value of the \fIcount_of_ipaddr\fR. The first IP address is the value of \fIdhcp_ip_start\fR that is provided by the \fB-i\fR option.

   532 

   532 .RE

   533 .sp

   533 

   534 .ne 2

   534 .sp

   535 .mk

   535 .ne 2

   536 .na

   536 .mk

   537 \fB\fB-t|--aliasof \fIaliasof\fR\fR\fR

   537 .na

   538 .ad

   538 \fB\fB\fB-B\fR|\fB--bootfile-server\fR \fIserver_ipaddr\fR\fR\fR

   539 .sp .6

   540 .RS 4n

   541 Optional: This new service is an alternate name for the \fIaliasof\fR install service.

   542 .RE

   543 

   544 .sp

   545 .ne 2

   546 .mk

   547 .na

   548 \fB\fB-i|--ip-start \fIstart\fR\fR\fR

   549 .ad

   550 .sp .6

   551 .RS 4n

   552 Optional: Specifies the starting IP address in a range to be added to the local DHCP configuration. The number of IP addresses is provided by the \fB-c\fR option. If a local ISC DHCP configuration does not exist, an ISC DHCP server is started if the value of \fBall_services/manage_dhcp\fR is \fBtrue\fR.

   553 .RE

   554 

   555 .sp

   556 .ne 2

   557 .mk

   558 .na

   559 \fB\fB-c|--ip-count \fIcount\fR\fR\fR

   560 .ad

   561 .sp .6

   562 .RS 4n

   563 Optional: Sets up a total number of IP addresses in the DHCP configuration equal to the value of the \fIcount\fR. The first IP address is the value of \fIstart\fR that is provided by the \fB-i\fR option.

   564 .RE

   565 

   566 .sp

   567 .ne 2

   568 .mk

   569 .na

   570 \fB\fB-b|--boot-args \fIproperty\fR=\fIvalue\fR,...\fR\fR

   571 .ad

   572 .sp .6

   573 .RS 4n

   574 Optional: For x86 clients only. Sets a property value in the service-specific boot configuration file in the service image. Use this option to set boot properties that are specific to this service. This option can accept multiple comma-separated \fIproperty\fR=\fIvalue\fR pairs.

   575 .RE

   576 

   577 .sp

   578 .ne 2

   579 .mk

   580 .na

   581 \fB\fB-B|--bootfile-server \fIserver\fR\fR\fR

   545 .sp

   588 .RE

   546 .ne 2

   589 

   547 .mk

   590 .sp

   548 .na

   591 .ne 2

   549 \fB\fB\fB-d\fR|\fB--imagepath\fR \fIimagepath\fR\fR\fR

   592 .mk

   550 .ad

   593 .na

   551 .sp .6

   594 \fB\fBinstalladm set-service -o|--option \fIproperty\fR=\fIvalue\fR \fIsvcname\fR\fR\fR

   552 .RS 4n

   595 .ad

   553 Optional: Specifies the path at which to create the net image. If not specified, the image is created in a \fIsvcname\fR directory at the location defined by the value of the \fBall_services/default_imagepath_basedir\fR property. For the default value of this property, see "Install Server Configuration Properties." A confirmation prompt is displayed unless \fB-y\fR is also specified.

   596 .sp .6

   554 .RE

   597 .RS 4n

   555 

   598 .sp

   556 .sp

   599 .ne 2

   557 .ne 2

   600 .mk

   558 .mk

   601 .na

   559 .na

   602 \fB\fB-o|--option \fIproperty\fR=\fIvalue\fR\fR\fR

   560 \fB\fB\fB-y\fR|\fB--noprompt\fR\fR\fR

   561 .ad

   562 .sp .6

   563 .RS 4n

   564 Optional: Suppresses any confirmation prompts and proceeds with service creation using the supplied options and any default values (see \fB-d\fR).

   565 .RE

   566 

   567 .RE

   568 

   569 .sp

   570 .ne 2

   571 .mk

   572 .na

   573 \fB\fBset-service \fB-o\fR|\fB--option\fR \fIprop\fR=\fIvalue\fR \fIsvcname\fR\fR\fR

   574 .ad

   575 .sp .6

   576 .RS 4n

   577 .sp

   578 .ne 2

   579 .mk

   580 .na

   581 \fB\fB\fB-o\fR|\fB--option\fR \fIprop\fR=\fIvalue\fR\fR\fR

   588 \fB\fIprop\fR=\fIvalue\fR\fR can be:

   609 \fB\fIproperty\fR=\fIvalue\fR\fR can be:

   589 .RS +4

   610 .RS +4

   590 .TP

   611 .TP

   591 .ie t \(bu

   612 .ie t \(bu

   592 .el o

   613 .el o

   593 \fBaliasof=\fIexisting_service\fR\fR

   614 \fBaliasof=\fIaliasof\fR\fR

   594 .sp

   615 .sp

   595 Makes \fIsvcname\fR an alias of \fIexisting_service\fR.

   616 Makes \fIsvcname\fR an alias of the \fIaliasof\fR install service.

   603 Relocates the service's imagepath after the service has been created. 

   624 Relocates the \fBimagepath\fR of an existing service.

   604 .RE

   625 .RE

   605 .RS +4

   626 .RS +4

   606 .TP

   627 .TP

   607 .ie t \(bu

   628 .ie t \(bu

   608 .el o

   629 .el o

   609 \fBdefault-manifest=\fImanifest_name\fR\fR

   630 \fBdefault-manifest=\fImanifest\fR\fR

   610 .sp

   631 .sp

   611 Designates a particular manifest or script that is already registered with a given service to be the default manifest or script for that service. Use the following command to show a list of manifests and scripts registered with this service.

   632 Designates a particular manifest or derived manifests script that is already registered with the specified service to be the default manifest or script for that service. Use the \fBinstalladm list\fR command to show a list of manifests and scripts registered with this service.

   640 \fB\fBrename-service \fIsvcname\fR \fInewsvcname\fR\fR\fR

   661 \fB\fBinstalladm update-service [-p|--publisher \fIpublisher\fR=\fIorigin\fR]\fR\fR

   641 .ad

   662 .ad

   642 .sp .6

   663 .br

   643 .RS 4n

   664 .na

   644 Renames the install service \fIsvcname\fR to \fInewsvcname\fR. The \fInewsvcname\fR can consist of alphanumeric characters, underscores (\fB_\fR), and hyphens (\fB-\fR). The first character of \fInewsvcname\fR cannot be a hyphen.

   665 \fB\fB[-s|--source \fIFMRI\fR] \fIsvcname\fR\fR\fR

   645 .RE

   666 .ad

   646 

   667 .sp .6

   647 .sp

   668 .RS 4n

   648 .ne 2

   669 Updates the image associated with \fIsvcname\fR, where \fIsvcname\fR is an alias of a service that was created using an IPS AI net image package. A new service is created with the updated image, and \fIsvcname\fR is aliased to the new service.

   649 .mk

   670 .sp

   650 .na

   671 .ne 2

   651 \fB\fBenable \fIsvcname\fR\fR\fR

   672 .mk

   673 .na

   674 \fB\fB-p|--publisher \fIpublisher\fR=\fIorigin\fR\fR\fR

   675 .ad

   676 .sp .6

   677 .RS 4n

   678 The IPS package repository from which to update the \fIsvcname\fR image. An example value is \fBsolaris=http://pkg.oracle.com/solaris/release/\fR.

   679 .sp

   680 If the \fB-p\fR option is not specified, the publisher used is the publisher that was used to create the image of the service for which \fIsvcname\fR is an alias. The following \fBpkg publisher\fR command shows how to display the \fIsvcname\fR publisher:

   681 .sp

   682 .in +2

   683 .nf

   684 $ \fBinstalladm list\fR

   685 Service Name     Alias Of          Status  Arch  Image Path

   686 ------------     --------          ------  ----  ----------

   687 default-i386     solaris11_1-i386  on      i386  /export/auto_install/solaris11_1-i386

   688 solaris11_1-i386 -                 on      i386  /export/auto_install/solaris11_1-i386

   689 $ \fBpkg -R /export/auto_install/solaris11_1-i386 publisher\fR

   690 PUBLISHER        TYPE     STATUS   URI

   691 solaris          origin   online   http://pkg.oracle.com/solaris/release/

   692 .fi

   693 .in -2

   694 .sp

   695 

   696 .RE

   697 

   698 .sp

   699 .ne 2

   700 .mk

   701 .na

   702 \fB\fB-s|--source \fIFMRI\fR\fR\fR

   703 .ad

   704 .sp .6

   705 .RS 4n

   706 The FMRI of the net image package for the update.

   707 .sp

   708 If the \fB-s\fR option is not specified, the newest available version of the \fBinstall-image/solaris-auto-install\fR package is used from the publisher specified in the description of the \fB-p\fR option.

   709 .RE

   710 

   711 .sp

   712 .ne 2

   713 .mk

   714 .na

   715 \fB\fB\fIsvcname\fR\fR\fR

   716 .ad

   717 .sp .6

   718 .RS 4n

   719 Required: Specifies the name of the install service being updated, which must be an alias of a service that was created using an IPS net image package.

   720 .RE

   721 

   722 .RE

   723 

   724 .sp

   725 .ne 2

   726 .mk

   727 .na

   728 \fB\fBinstalladm rename-service \fIsvcname\fR \fInewsvcname\fR\fR\fR

   729 .ad

   730 .sp .6

   731 .RS 4n

   732 Renames the install service \fIsvcname\fR to \fInewsvcname\fR. The \fInewsvcname\fR can consist of alphanumeric characters, underscores (\fB_\fR), and hyphens (\fB-\fR). The first character of \fInewsvcname\fR cannot be a hyphen. The length of the \fInewsvcname\fR cannot exceed 63 characters.

   733 .RE

   734 

   735 .sp

   736 .ne 2

   737 .mk

   738 .na

   739 \fB\fBinstalladm enable \fIsvcname\fR\fR\fR

   662 \fB\fBdisable \fIsvcname\fR\fR\fR

   750 \fB\fBinstalladm disable \fIsvcname\fR\fR\fR

   673 \fB\fBdelete-service [\fB-r\fR|\fB--autoremove\fR] [\fB-y\fR|\fB--noprompt\fR] \fIsvcname\fR\fR\fR

   761 \fB\fBinstalladm delete-service [-r|--autoremove] [-y|--noprompt]\fR\fR

   674 .ad

   762 .ad

   675 .sp .6

   763 .br

   676 .RS 4n

   764 .na

   677 Deletes an install service. Accomplishes the following:

   765 \fB\fB\fIsvcname\fR\fR\fR

   766 .ad

   767 .sp .6

   768 .RS 4n

   769 Deletes an install service.

   694 If the service is a default alias and a local ISC DHCP configuration exists, the bootfile associated with this service is removed from the ISC DHCP configuration.

   786 If the following conditions exist, the bootfile associated with this service is removed from the ISC DHCP configuration:

   695 .RE

   787 .RS +4

   696 .sp

   788 .TP

   697 .ne 2

   789 .ie t \(bu

   698 .mk

   790 .el o

   699 .na

   791 The service is a default alias.

   700 \fB\fB\fB-r\fR|\fB--autoremove\fR\fR\fR

   792 .RE

   793 .RS +4

   794 .TP

   795 .ie t \(bu

   796 .el o

   797 A local ISC DHCP configuration exists.

   798 .RE

   799 .RS +4

   800 .TP

   801 .ie t \(bu

   802 .el o

   803 The \fBall_services/manage_dhcp\fR property value is \fBtrue\fR.

   804 .RE

   805 .RE

   806 .sp

   807 .ne 2

   808 .mk

   809 .na

   810 \fB\fB-r|--autoremove\fR\fR

   711 \fB\fB\fB-y\fR|\fB--noprompt\fR\fR\fR

   821 \fB\fB-y|--noprompt\fR\fR

   735 \fB\fBlist [\fB-n\fR|\fB--service\fR \fIsvcname\fR] [\fB-c\fR|\fB--client\fR] [\fB-m\fR|\fB--manifest\fR] [\fB-p\fR|\fB--profile\fR]\fR\fR

   845 \fB\fBinstalladm list [-n|--service \fIsvcname\fR] [-c|--client]\fR\fR

   846 .ad

   847 .br

   848 .na

   849 \fB\fB[-m|--manifest] [-p|--profile]\fR\fR

   744 \fB\fB\fB-n\fR|\fB--service\fR \fIsvcname\fR\fR\fR

   858 \fB\fB-n|--service \fIsvcname\fR\fR\fR

   759 If the \fB-m\fR option is specified, lists the manifests and scripts associated with the install service.

   873 If the \fB-m\fR option is specified, lists the manifests and derived manifests scripts associated with the install service.

   773 \fB\fB\fB-c\fR|\fB--client\fR\fR\fR

   887 \fB\fB-c|--client\fR\fR

   784 \fB\fB\fB-m\fR|\fB--manifest\fR\fR\fR

   898 \fB\fB-m|--manifest\fR\fR

   785 .ad

   899 .ad

   786 .sp .6

   900 .sp .6

   787 .RS 4n

   901 .RS 4n

   788 Optional: Lists the manifests and scripts associated with the install services on a local server, including criteria for each manifest. Criteria associated with the default manifest for the service are labeled as ignored. Inactive manifests are labeled. Inactive manifests have no associated criteria and are not the default manifest for that service.

   902 Optional: Lists the manifests and derived manifests scripts associated with the install services on a local server, including criteria for each manifest. Criteria associated with the default manifest for the service are labeled as ignored. Inactive manifests are labeled. Inactive manifests have no associated criteria and are not the default manifest for that service.

   799 \fB\fB\fB-p\fR|\fB--profile\fR\fR\fR

   913 \fB\fB-p|--profile\fR\fR

   816 \fB\fBcreate-manifest \fB-n\fR|\fB--service\fR \fIsvcname\fR \fB-f\fR|\fB--file\fR \fImanifest_or_script_filename\fR [\fB-m\fR|\fB--manifest\fR \fImanifest_name\fR] [\fB-c\fR|\fB--criteria\fR \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR... | \fB-C\fR|\fB--criteria-file\fR \fIcriteriafile\fR] [\fB-d\fR|\fB--default\fR]\fR\fR

   930 \fB\fBinstalladm create-manifest -n|--service \fIsvcname\fR\fR\fR

   817 .ad

   931 .ad

   818 .sp .6

   932 .br

   819 .RS 4n

   933 .na

   820 Creates a manifest or script for a specific install service, thus making the manifest or script available on the network, independently from creating a service. A non-default manifest or script can be used (can be active) only when criteria are associated with it. Criteria can be entered on the command line (\fB-c\fR) or via a criteria XML file (\fB-C\fR). Any criteria specified along with the \fB-d\fR option are temporarily ignored until the manifest or script is no longer designated as the default.

   934 \fB\fB-f|--file \fIfilename\fR [-m|--manifest \fImanifest\fR]\fR\fR

   935 .ad

   936 .br

   937 .na

   938 \fB\fB[-c|--criteria \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR... |\fR\fR

   939 .ad

   940 .br

   941 .na

   942 \fB\fB-C|--criteria-file \fIcriteriafile\fR] [-d|--default]\fR\fR

   943 .ad

   944 .sp .6

   945 .RS 4n

   946 Creates a manifest or derived manifests script for a specific install service, thus making the manifest or script available on the network, independently from creating a service. A non-default manifest or script can be used (can be active) only when criteria are associated with it. Criteria can be entered on the command line (\fB-c\fR) or in a criteria XML file (\fB-C\fR). Any criteria specified along with the \fB-d\fR option are temporarily ignored until the manifest or script is no longer designated as the default.

   827 The \fImanifest_name\fR specified by the \fB-m\fR option, if present.

   953 The \fImanifest\fR name specified by the \fB-m\fR option, if present.

   837 The base name of the manifest or script file name.

   963 The base name of the \fIfilename\fR.

   838 .RE

   964 .RE

   839 .sp

   965 .sp

   840 .ne 2

   966 .ne 2

   841 .mk

   967 .mk

   842 .na

   968 .na

   843 \fB\fB\fB-n\fR|\fB--service\fR \fIsvcname\fR\fR\fR

   969 \fB\fB-n|--service \fIsvcname\fR\fR\fR

   854 \fB\fB\fB-f\fR|\fB--file\fR \fImanifest_or_script_filename\fR\fR\fR

   980 \fB\fB-f|--file \fIfilename\fR\fR\fR

   855 .ad

   981 .ad

   856 .sp .6

   982 .sp .6

   857 .RS 4n

   983 .RS 4n

   858 Required: Specifies the path name of the manifest or script to add.

   984 Required: Specifies the path name of the manifest or derived manifests script to add.

   859 .RE

   985 .RE

   860 

   986 

   861 .sp

   987 .sp

   862 .ne 2

   988 .ne 2

   863 .mk

   989 .mk

   864 .na

   990 .na

   865 \fB\fB\fB-m\fR|\fB--manifest\fR \fImanifest_name\fR\fR\fR

   991 \fB\fB-m|--manifest \fImanifest\fR\fR\fR

   866 .ad

   992 .ad

   867 .sp .6

   993 .sp .6

   868 .RS 4n

   994 .RS 4n

   869 Optional: Specifies the AI instance name of the manifest or script. Sets the \fBname\fR attribute of the \fBai_instance\fR element of the manifest to \fImanifest_name\fR. The manifest or script is referred to by \fImanifest_name\fR in subsequent \fBinstalladm\fR commands and \fBinstalladm list\fR output.

   995 Optional: Specifies the AI instance name of the manifest or derived manifests script. Sets the \fBname\fR attribute of the \fBai_instance\fR element of the manifest to \fImanifest\fR. The manifest or script is referred to as \fImanifest\fR in subsequent \fBinstalladm\fR commands and \fBinstalladm list\fR output.

   870 .RE

   996 .RE

   871 

   997 

   872 .sp

   998 .sp

   873 .ne 2

   999 .ne 2

   874 .mk

  1000 .mk

   875 .na

  1001 .na

   876 \fB\fB\fB-c\fR|\fB--criteria\fR \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR...\fR\fR

  1002 \fB\fB-c|--criteria \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR...\fR\fR

   887 \fB\fB\fB-C\fR|\fB--criteria-file\fR \fIcriteriafile\fR\fR\fR

  1013 \fB\fB-C|--criteria-file \fIcriteriafile\fR\fR\fR

   898 \fB\fB\fB-d\fR|\fB--default\fR\fR\fR

  1024 \fB\fB-d|--default\fR\fR

   911 \fB\fBupdate-manifest \fB-n\fR|\fB--service\fR \fIsvcname\fR \fB-f\fR|\fB--file\fR \fImanifest_or_script_filename\fR [\fB-m\fR|\fB--manifest\fR \fImanifest_name\fR]\fR\fR

  1037 \fB\fBinstalladm update-manifest -n|--service \fIsvcname\fR\fR\fR

   912 .ad

  1038 .ad

   913 .sp .6

  1039 .br

   914 .RS 4n

  1040 .na

   915 Updates the specific manifest or script from the \fIsvcname\fR install service. Replaces the specified manifest or script with the contents of \fImanifest_or_script_filename\fR. Any criteria or default status remain with the manifest or script following the update.

  1041 \fB\fB-f|--file \fIfilename\fR [-m|--manifest \fImanifest\fR]\fR\fR

  1042 .ad

  1043 .sp .6

  1044 .RS 4n

  1045 Updates the specific manifest or derived manifests script from the \fIsvcname\fR install service. Replaces the specified manifest or script with the contents of \fIfilename\fR. Any criteria or default status remain with the manifest or script following the update.

   922 The \fImanifest_name\fR specified by the \fB-m\fR option, if present.

  1052 The \fImanifest\fR specified by the \fB-m\fR option, if present.

   932 The base name of the manifest or script file name, if it matches the \fBai_instance\fR \fBname\fR attribute value in an existing manifest, or the name given by \fBinstalladm list\fR if it matches the name of an existing script.

  1062 The base name of the \fIfilename\fR, if it matches the \fBai_instance\fR \fBname\fR attribute value in an existing manifest, or the name given by \fBinstalladm list\fR if it matches the name of an existing script.

   933 .RE

  1063 .RE

   934 .sp

  1064 .sp

   935 .ne 2

  1065 .ne 2

   936 .mk

  1066 .mk

   937 .na

  1067 .na

   938 \fB\fB\fB-n\fR|\fB--service\fR \fIsvcname\fR\fR\fR

  1068 \fB\fB-n|--service \fIsvcname\fR\fR\fR

   939 .ad

  1069 .ad

   940 .sp .6

  1070 .sp .6

   941 .RS 4n

  1071 .RS 4n

   942 Required: Specifies the name of the install service this manifest or script is to be associated with.

  1072 Required: Specifies the name of the install service of the manifest or script being updated.

   943 .RE

  1073 .RE

   944 

  1074 

   945 .sp

  1075 .sp

   946 .ne 2

  1076 .ne 2

   947 .mk

  1077 .mk

   948 .na

  1078 .na

   949 \fB\fB\fB-f\fR|\fB--file\fR \fImanifest_or_script_filename\fR\fR\fR

  1079 \fB\fB-f|--file \fIfilename\fR\fR\fR

   950 .ad

  1080 .ad

   951 .sp .6

  1081 .sp .6

   952 .RS 4n

  1082 .RS 4n

   953 Required: Specifies the path name of the replacement manifest or script.

  1083 Required: Specifies the path name of the replacement manifest or derived manifests script.

   954 .RE

  1084 .RE

   955 

  1085 

   956 .sp

  1086 .sp

   957 .ne 2

  1087 .ne 2

   958 .mk

  1088 .mk

   959 .na

  1089 .na

   960 \fB\fB\fB-m\fR|\fB--manifest\fR \fImanifest_name\fR\fR\fR

  1090 \fB\fB-m|--manifest \fImanifest\fR\fR\fR

   973 \fB\fBdelete-manifest \fB-m\fR|\fB--manifest\fR \fImanifest_name\fR \fB-n\fR|\fB--service\fR \fIsvcname\fR\fR\fR

  1103 \fB\fBinstalladm delete-manifest -n|--service \fIsvcname\fR\fR\fR

   974 .ad

  1104 .ad

   975 .sp .6

  1105 .br

   976 .RS 4n

  1106 .na

   977 Deletes a manifest or script that was published with a specific install service. A default manifest or script cannot be deleted.

  1107 \fB\fB-m|--manifest \fImanifest\fR\fR\fR

   978 .sp

  1108 .ad

   979 .ne 2

  1109 .sp .6

   980 .mk

  1110 .RS 4n

   981 .na

  1111 Deletes a manifest or derived manifests script that was published with a specific install service. A default manifest or script cannot be deleted.

   982 \fB\fB\fB-m\fR|\fB--manifest\fR \fImanifest_name\fR\fR\fR

  1112 .sp

   983 .ad

  1113 .ne 2

   984 .sp .6

  1114 .mk

   985 .RS 4n

  1115 .na

   986 Required: Specifies the AI instance name of a manifest or script as output by \fBinstalladm list\fR with the \fB-n\fR option.

  1116 \fB\fB-n|--service \fIsvcname\fR\fR\fR

   987 .RE

  1117 .ad

   988 

  1118 .sp .6

   989 .sp

  1119 .RS 4n

   990 .ne 2

  1120 Required: Specifies the name of the install service of the manifest or script being deleted.

   991 .mk

  1121 .RE

   992 .na

  1122 

   993 \fB\fB\fB-n\fR|\fB--service\fR \fIsvcname\fR\fR\fR

  1123 .sp

   994 .ad

  1124 .ne 2

   995 .sp .6

  1125 .mk

   996 .RS 4n

  1126 .na

   997 Required: Specifies the name of the install service this manifest is associated with.

  1127 \fB\fB-m|--manifest \fImanifest\fR\fR\fR

   998 .RE

  1128 .ad

   999 

  1129 .sp .6

  1000 .RE

  1130 .RS 4n

  1001 

  1131 Required: Specifies the AI instance name of a manifest or derived manifests script as output by \fBinstalladm list\fR with the \fB-n\fR option.

  1002 .sp

  1132 .RE

  1003 .ne 2

  1133 

  1004 .mk

  1134 .RE

  1005 .na

  1135 

  1006 \fB\fBcreate-profile \fB-n\fR|\fB--service\fR \fIsvcname\fR \fB-f\fR|\fB--file\fR \fIprofile_filename\fR... [\fB-p\fR|\fB--profile\fR \fIprofile_name\fR] [\fB-c\fR|\fB--criteria\fR \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR... | \fB-C\fR|\fB--criteria-file\fR \fIcriteriafile\fR]\fR\fR

  1136 .sp

  1007 .ad

  1137 .ne 2

  1008 .sp .6

  1138 .mk

  1009 .RS 4n

  1139 .na

  1010 Creates profiles for a specific install service. Criteria can optionally be associated with a profile by either entering them on the command line (\fB-c\fR) or via a criteria XML file (\fB-C\fR). Profiles created without criteria are associated with all clients of the service.

  1140 \fB\fBinstalladm create-profile -n|--service \fIsvcname\fR\fR\fR

  1141 .ad

  1142 .br

  1143 .na

  1144 \fB\fB-f|--file \fIfilename\fR... [-p|--profile \fIprofile\fR]\fR\fR

  1145 .ad

  1146 .br

  1147 .na

  1148 \fB\fB[-c|--criteria \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR... |\fR\fR

  1149 .ad

  1150 .br

  1151 .na

  1152 \fB\fB-C|--criteria-file \fIcriteriafile\fR]\fR\fR

  1153 .ad

  1154 .sp .6

  1155 .RS 4n

  1156 Creates profiles for a specific install service. Criteria can optionally be associated with a profile by either entering them on the command line (\fB-c\fR) or in a criteria XML file (\fB-C\fR). Profiles created without criteria are associated with all clients of the service.

  1017 The \fIprofile_name\fR specified by the \fB-p\fR option, if present.

  1163 The \fIprofile\fR specified by the \fB-p\fR option, if present.

  1022 The base name of the profile file name.

  1168 The base name of the \fIfilename\fR.

  1029 \fB\fB\fB-n\fR|\fB--service\fR \fIsvcname\fR\fR\fR

  1175 \fB\fB-n|--service \fIsvcname\fR\fR\fR

  1040 \fB\fB\fB-f\fR|\fB--file\fR \fIprofile_filename\fR...\fR\fR

  1186 \fB\fB-f|--file \fIfilename\fR...\fR\fR

  1051 \fB\fB\fB-p\fR|\fB--profile\fR \fIprofile_name\fR\fR\fR

  1197 \fB\fB-p|--profile \fIprofile\fR\fR\fR

  1062 \fB\fB\fB-c\fR|\fB--criteria\fR \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR...\fR\fR

  1208 \fB\fB-c|--criteria \fIcriteria\fR=\fIvalue\fR|\fIlist\fR|\fIrange\fR...\fR\fR

  1073 \fB\fB\fB-C\fR|\fB--criteria-file\fR \fIcriteriafile\fR\fR\fR

  1219 \fB\fB-C|--criteria-file \fIcriteriafile\fR\fR\fR

  1086 \fB\fBupdate-profile -n|--service \fIsvcname\fR -f|--file \fIprofile_filename\fR [-p|--profile \fIprofile_name\fR]\fR\fR

  1232 \fB\fBinstalladm update-profile -n|--service \fIsvcname\fR\fR\fR

  1087 .ad

  1233 .ad

  1088 .sp .6

  1234 .br

  1089 .RS 4n

  1235 .na

  1090 Updates the specified profile from the \fIsvcname\fR install service. Replaces the specified profile with the contents of \fIprofile_filename\fR. Any criteria remain with the profile following the update.

  1236 \fB\fB-f|--file \fIfilename\fR [-p|--profile \fIprofile\fR]\fR\fR

  1237 .ad

  1238 .sp .6

  1239 .RS 4n

  1240 Updates the specified profile from the \fIsvcname\fR install service. Replaces the specified profile with the contents of \fIfilename\fR. Any criteria remain with the profile following the update.

  1097 The \fIprofile_name\fR specified by the \fB-p\fR option, if present.

  1247 The \fIprofile\fR specified by the \fB-p\fR option, if present.

  1102 The base name of \fIprofile_filename\fR.

  1252 The base name of the \fIfilename\fR.

  1103 .RE

  1253 .RE

  1104 .sp

  1254 .sp

  1105 .ne 2

  1255 .ne 2

  1106 .mk

  1256 .mk

  1107 .na

  1257 .na

  1108 \fB\fB\fB-n\fR|\fB--service\fR \fIsvcname\fR\fR\fR

  1258 \fB\fB-n|--service \fIsvcname\fR\fR\fR

  1119 \fB\fB\fB-f\fR|\fB--file\fR \fIprofile_filename\fR\fR\fR

  1269 \fB\fB-f|--file \fIfilename\fR\fR\fR

  1130 \fB\fB\fB-p\fR|\fB--profile\fR \fIprofile_name\fR\fR\fR

  1280 \fB\fB-p|--profile \fIprofile\fR\fR\fR

  1131 .ad

  1281 .ad

  1132 .sp .6

  1282 .sp .6

  1133 .RS 4n

  1283 .RS 4n

  1134 Optional: Specifies the name of the profile being updated. Use this option if the name of the profile to update is different from the base name of \fIprofile_filename\fR.