A    Definitions of Installation CDF Attribute-Value Pairs

The attribute-value pairs within individual items differ as a result of the distribution method (CD-ROM or RIS) that was used to perform the initial Full Installation of the model system. This appendix describes the contents of the following items in the install.cdf file:

Caution

Only experienced system administrators should modify the attributes-value pairs in the install.cdf file. Typographical errors and inserting attribute-value pairs into the incorrect item may result in serious corruption on the cloned system and may render the system unusable.

In addition, attribute-value pairs cannot contain blank spaces because blank spaces cause data validation errors. Be very careful to remove all blank spaces especially at the end of a line. When you want to give an attribute a null value, make sure there is nothing (null) after the equal sign ( = ).

Do not modify or remove attributes that are prefixed with an underscore ( _ ). These attributes, for example _action=create, are internal variables required by the Full Installation and Installation Cloning processes.

A.1    Attributes in the Inst_islinfo Item

Table A-1 defines the attributes in the Inst_islinfo item in the CDF. The Inst_islinfo item is used to convey the system state before the start of the installation process.

Table A-1:  Attribute Definitions in the Initial Subset Load (Inst_islinfo) Item

Attribute Valid Values Definition
client=   Do not modify. This attribute is valid only for RIS Full Installations (not Installation Cloning) and specifies the RIS client name of the system that was cloned. The RIS client name is determined automatically as a result of the bootp request to the server.
clone=   Do not modify. This attribute is inserted automatically into the CDF as a result of the Installation Cloning process and is valid only during the Installation Cloning process.
force_ccii=

yes
no

Setting this attribute to yes invokes a text-based (character cell) installation user interface on systems that have graphics capabilities. The default value is Null, which corresponds to no.
media_type=

REMOTE
CDROM

This attribute is used by the Full Installation and Installation Cloning processes to indicate the type of distribution media for the current installation. This is the only required entry in the Inst_islinfo item. Edit this attribute when the type of distribution media used for the initial installation is different from the Installation Cloning that is to take place.
prompt=

yes
no

This attribute is used by the Installation Cloning process to indicate whether the start of the cloning requires a confirmation response from the user. This attribute must be entered manually into the CDF for an Installation Cloning process because the installation interfaces do not provide the ability to insert this attribute into the CDF.A value of yes indicates that the process should prompt for confirmation to use the CDF. A value of no indicates that the Installation Cloning process automatically should use this CDF and bypass the confirmation question. If this attribute is not included in the CDF, the default is prompt=yes. Setting the attribute to no should be used with caution because the Installation Cloning begins as soon as the installation process detects a CDF. If you wanted to boot the system from the distribution media and perform system management or disk maintenance tasks, for example, you would not want the Installation Cloning to begin immediately.
risdir=   Do not modify. This attribute is specific to RIS Full Installations and is set automatically to the base RIS directory of the product environment to which the client system is registered.
server=   Do not modify. This attribute is specific to RIS full and cloning installations and identifies the RIS server to which the client system is currently registered.
server_locality=   Do not modify. This attribute is specific to RIS Full Installations and specifies to the installation interfaces the current geographic location. This attribute is controlled by the locality= attribute in the Inst_cinstall item.
server_timezone=   Do not modify. This attribute is specific to RIS Full Installations and specifies to the installation interfaces the current geographic time zone. This value is set automatically during a RIS Full Installation.
srcloc=

/ALPHA/BASE 
RISserver:

This attribute is not used by either the Full Installation or Installation Cloning processes; it is used by the operating system for internal purposes. This attribute identifies the location of the software to load. For RIS installations, this value specifies the server name (appended with a colon). For CD-ROM installations, this value is the directory path /ALPHA/BASE. Do not modify this attribute unless the media_type attribute is changed because this value must be consistent with the value of media_type.
timeset=

0
1

Do not modify. This attribute applies to Full Installations and indicates to the installation interfaces whether the date and time on the target system have been set successfully and whether the date and time can be displayed during the installation. If the date and time have not been set and will not be displayed during the installation process, this attribute is set to 0. If the date and time have been set successfully and will be displayed during the installation process, this attribute is set to 1. If you modify this entry, it will revert back to its original setting because it is controlled by internal installation processes.

A.2    Attributes in the Inst_filesystem Item

Table A-2 defines the attributes in the Inst_filesystem item in the CDF. The Inst_filesystem item conveys information about the number and type of file systems that are to be created on the cloned system. At a minimum, there must be at least four file system items to describe the /, /usr, and /var file systems and one swap area. Except where noted, you can modify all attribute-value pairs in this item, although it is not recommended.

Table A-2:  Attribute Definitions in the File System (Inst_filesystem) Item

Attribute Valid Values Definition
name=

root
usr
var
i18n
swap1
swap2

Required. Specifies the name of the file system to be made. There can only be one item each for /, usr, var, i18n, swap1, and swap2.
file_system_type=

ufs
advfs
swap

Required. Specifies the file system type to be created for the named file system. If the value of the name= attribute is swap1 or swap2, the value of this attribute must be swap. The value swap is not allowed as a value for any other name= attributes.

Caution: Be aware that changing this value from ufs to advfs may cause errors on the cloned system because the software subsets necessary to support an Advanced File System (AdvFS) may not be defined in the CDF and will not be installed on the cloned system. Therefore, the file system will be unreadable.

Do not change this value to advfs unless other file systems have been set by the installation process to advfs or the required AdvFS software subsets are present in the ss_names= attribute in the Inst_subsets item. Subset descriptions are documented in the Installation Guide.

disk_name= dskn Required. Specifies the disk name for the named file system as it is known to the operating system (for example, dsk0). The value in this attribute must be consistent with the value in the disk_type= attribute. If you change this attribute, you must validate the change with respect to the disk_type= attribute. Enter the following command to determine the disk type:
    disklabel dskn|grep disk
    For example, if you change this value to disk_name=dsk1, you must determine the type of disk at dsk1. If it is an RZ58 type of disk, make sure the value of the disk_type= attribute is RZ58.
disk_number= n This attribute is set by the Full Installation process and is not used by the cloning process.
disk_type=

RZnn[n][A-Z]
RAnn
HSZnn

Required. Indicates the type of disk for the specified disk_name (for example RZ26). The value in this attribute must be consistent with the disk_name= attribute. Refer to the disk_name= attribute for more information.
partition= [a-h]

Required. Specifies the disk partition on which the named file system will be created. Valid values are the letters a through h inclusive. The / (root) file system must always be located on partition a.

Caution

If you change the value in this attribute for any file system other than /, make sure the partition you choose does not overlap another partition that contains an active file system.

controller_type=   This attribute identifies the controller type to which the specified disk for the named file system is connected. During a Full Installation, this value is provided automatically for informational purposes. During an Installation Cloning process this attribute is not used, and can be omitted from the CDF.
controller_number=   This attribute identifies the controller number to which the specified disk for the named file system is connected. During a Full Installation, this value is automatically provided for informational purposes. During an Installation Cloning process this attribute is not used, and can be omitted from the CDF.

A.3    Attributes in the Inst_disklabel Item

Table A-3 defines the attributes in the Inst_disklabel item in the CDF. The Inst_disklabel item conveys the size and offset of each partition to be created on the cloned system. An Inst_disklabel item is created for each disk on which you installed a file system or swap area. For example, if you installed / on dsk0, and /usr on dsk1, an Inst_disklabel item will be created for dsk0 and dsk1. All other disks on the target system will be unaffected during cloning.

Table A-3:  Attribute Definitions in the Disklabel (Inst_disklabel) Item

Attribute Valid Values Definition
name=

dskn
in usr_domain
in usr

Required. Do not modify. This attribute specifies the disk associated with the size and offset definitions within the Inst_disklabel item. An Inst_disklabel attribute is created for each disk configured in the model system. A value of in usr_domain means that the var and i18n directories with an AdvFS file system type are in the usr_domain. A value of in usr means that the var and i18n directories with a UFS file system type are in the /usr file system.
[a-h]_size= n (blocks) Required. Do not modify. This attribute specifies the size of every partition on configured disks. All partitions are defined, whether or not they are used for a file system. The Inst_filesystem item defines the file systems.
[a-h]_offset= n (blocks) Required. Do not modify. This attribute specifies the offset of every partition on configured disks. All partitions are defined, whether or not they are used for a file system. The Inst_filesystem item defines the file systems.

A.4    Attributes in the Inst_lsm_global Item

Table A-4 defines the attributes in the Inst_lsm_global item in the CDF. The Inst_lsm_global item conveys the size of the Logical Storage Manager (LSM) private region to be created on all configured disks and defines an LSM host name. The Inst_lsm_global item is created only if you chose to install into LSM volumes.

Table A-4:  Attribute Definitions in the LSM Global (Inst_lsm_global) Item

Attribute Valid Values Definition
priv_reg_size= n (blocks) Do not modify. This attribute conveys the size of the LSM private region to be created on all configured disks in the target system.
lsm_hostname=

nnnnn:hh:mm:ss
existing host name

This attribute defines the host name that LSM uses when defining the rootdg disk group. LSM host names must be unique for systems that exist on the same network. If a host name cannot be determined from an existing LSM configuration or LSM does not exist on the system, the Full Installation process generates an LSM host name in the format of a five-digit number followed by a time stamp (hour;minutes;seconds). It is recommended that when you modify the hostname= attribute in the Inst_cinstall item, you make the same change here as well so that your system maintains a unique identity on the network but has the same host name and LSM host name.

A.5    Attributes in the Inst_lsm_disks Item

Table A-5 defines the attributes in the Inst_lsm_disks item in the CDF. The Inst_lsm_disks item conveys the private region partition and disk information. An Inst_lsm_disks attribute is created for each configured disk. The Inst_lsm_disks item is created only if you chose to use LSM.

Table A-5:  Attribute Definitions in the LSM Disks (Inst_lsm_disks) Item

Attribute Valid Values Definition
name= dskn Do not modify. This attribute specifies the disk associated with the LSM private region partition information. An Inst_lsm_disks attribute is created for each disk configured in the model system.
priv_reg_part= [a-h] Do not modify. This attribute conveys the partition on which the LSM private region is to be created for the disk defined by the name= attribute.

A.6    Attributes in the Inst_subsets Item

Table A-6 defines the attributes in the Inst_subsets item in the CDF. The Inst_subsets item is used to convey information to the Installation Cloning process about the base operating system software subsets that are to be installed on the system to be cloned. One Inst_subsets item always will exist for the base operating system software. There can be up to two additional Inst_subsets items for WLS software.

Table A-6:  Attribute Definitions in the Software Subsets Load (Inst_subsets) Item

Attribute Valid Values Definition
advflag= 1 Do not modify. This attribute informs the subset load procedure, the setld utility, that this is a Full Installation (as opposed to an Update Installation or after the installation). It is always set to 1 by the Full Installation process.
name=

BASE
WLS
[Footnote 6]
 

Required. Do not modify. This attribute specifies the name of the product associated with the subsets listed in the ss_names attribute. There will be a name attribute defined for each product installed. BASE represents the base operating system; WLS represents Worldwide Language Support software.
ss_names=

List of subset 
names

Required. This attribute specifies the list of base operating system and worldwide language support software subsets to be installed. Each software subset name is separated by a comma (,) and must be on one continuous line (let the line wrap). If you add software subset names to this attribute, you must consider available disk space and dependencies upon other software subsets. Refer to the Installation Guide for software subset dependency information, and refer to the Release Notes for software subset size information.
volume_name=

DISC1
DISC2

Required. Do not modify. This attribute specifies the distribution on which the product defined by the name= attribute resides. For example, the base operating system CD-ROM has a volume_name value of DISC1; the CD-ROM containing the WLS software has a volume name value of DISC2.

A.7    Attributes in the Inst_cinstall Item

Table A-7 defines the attributes in the Inst_cinstall item in the CDF. The Inst_cinstall item is used to convey target system configuration information to the Installation Cloning process. All of the attributes specified in the installation configuration item are optional. If values are not provided for these attributes, the installation process becomes interactive to request this information during the system configuration phase.

To use a single CDF to clone many systems, consider leaving the system-specific attributes such as host name and password null, but provide attributes for site-specific attributes such as kernel option, time zone, geographic location, and date and time.

Table A-7:  Attribute Definitions in the Installation Configuration (Inst_cinstall) Item

Attribute Valid Values Definition
hostname=   This attribute specifies the target system's host name to the installation process. Host names for target systems that exist on the same network must be unique. Refer to the Installation Guide for guidelines on choosing a proper host name. During a RIS Installation Cloning process, this value is set automatically to the host name of the target system. For CD-ROM installations, make sure this value is set correctly or is null. A null value means that the installation process becomes interactive during the system configuration phase to request a host name.
kernel_option=

mandatory
all
interactive

This attribute specifies to the installation process whether the tailored kernel build should be interactive or non-interactive. If you want the Installation Cloning process to run without user intervention, do not set this attribute value to interactive.
    In an interactive kernel build session, a kernel components menu is presented that allows the user to select optional kernel components to build into the kernel. It is important to know that the kernel build on the target system does not automatically include optional kernel components that were on the model system unless the kernel option type is set to interactive and the user intentionally selects the optional kernel components.
    The mandatory value builds a kernel with the kernel components that are mandatory for the installed software. The all value builds a kernel with all mandatory and all optional kernel components. Setting this attribute to mandatory or all builds the tailored kernel without any user intervention.
lang_env See the i18n_intro(5) reference page This attribute sets the language environment. Valid values are the same as the LANG environment variable. The default is United States English.
locality= See the /etc/zoneinfo directory This attribute specifies the geographic location of the target system. During a RIS Installation Cloning process, this value is set automatically to the geographic location of the RIS server. A null value means that the installation process becomes interactive during the system configuration phase to request a geographic location.
password=   Do not modify. This attribute specifies to the installation process the encrypted root password for the target system. The presence of a value here means that all cloned systems and the model system share the same root password. A null value means that the installation process becomes interactive during the system configuration phase to request a password. Because this entry is encrypted, either leave it alone or make it null. If you insert a value, you will set a password that you will not be able to decipher.
    Once the target system is cloned, you should change this password for security reasons.
timeset=

yes
no

This attribute specifies to the installation process the status of the system date and time on the target system. In the case of a RIS Full Installation or RIS Installation Cloning, this value is always set to yes, which means that the system date and time have been set (because it comes from the RIS server).
    If this value is set to no, it means that the system date and time have not been set. The installation process becomes interactive to request the date and time.
    For CD-ROM installations, the installation process becomes interactive to request the date and time.
timezone= See the /etc/zoneinfo directory This attribute specifies the time zone within a specific geographic location (if applicable). During a RIS Installation Cloning process, this value is set automatically to the time zone of the RIS server. The value of timezone must be a valid time zone for the geographic location defined in the locality= attribute. For example, if locality=US, only time zones in the United States are valid. If the geographic location does not have a time zone, leave this value null. The installation process recognizes geographic locations that do not have time zones, and will not request a time zone during the configuration phase.
    If the geographic location has valid time zones, a null value means that the installation process becomes interactive during the system configuration phase to request a time zone.