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= |
|
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= |
|
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= |
|
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= |
|
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= |
|
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= |
|
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= |
|
Required.
Specifies the file system type to be created for the named file system.
If the value of the
Caution:
Be aware that changing this value from
Do not change
this value to
|
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= |
|
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
|
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= |
|
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
|
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= |
|
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
|
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= |
|
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= |
|
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= |
|
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. |