Sun N1 Service Provisioning System User's Guide for OS Provisioning Plug-In 3.0

Appendix C RedHat Linux Profile Component Variables

The RedHat Linux Profile component includes variables for each JET module. These variables are separated into the following categories:

Basic RedHat OS Configuration Variables

Component Variables for `base_config` Module

The variables described in the following list provide basic operating system configuration. These variables directly equate to the JET base_config module. In the list you see several variables that use the value of the targetable component. For purposes of the RedHat Linux Profile variables, the targetable component is the target host.

ClientArch_base_config

Description: Kernel architecture, such as x86. By default, this is set to the kernel architecture of the targetable component.

Default value: :[targetableComponent:kernel_arch]

ClientEther_base_config

Description: Ethernet MAC address. By default, this is set to the Ethernet MAC address of the targetable component.

Default value: :[targetableComponent:ethernet_mac_address]

ClientOSName_base_config

Description: Name of the OS to be provisioned.

Example: redhat

ClientOS_base_config

Description: Version of the OS to be provisioned.

Example: LinuxRedHat3.0_x86

products_base_config

Description: JET modules to provision.

Example: base_config spsra

client_allocation_base_config

Description: The mechanism used to build this client. By default, the options listed in /opt/jet/etc/jumpstart.conf are used. Leave the value blank unless you need to do something different from the default for this specific client.

productdir_base_config

Description: Path to the RedHat Linux distribution. To use the information from the jumpstart.conf file and the IP address of the JET server, leave this value blank. If your package files are not stored on the JET server, then provide an NFS-style path to the location of the packages.

patchdir_base_config

Description: Path to the patches you want to apply. To use the information from the jumpstart.conf file and the IP address of the JET server, leave this value blank. If your patches are not stored on the JET server, then provide an NFS-style path to the location of the patches.

kickstart_media_base_config

Description: Location of the RedHat Linux product media.

pxelinux_console_base_config

Description: Console parameters that are passed to the PXE boot environment.

Default value: ttyS0,9600

lang_base_config

Description:Languages to install on the target host.

Example: en_US

lang_additional_base_conf

Description: Additional languages to install on the target host.

Example: fr_FR

keyboard_base_conf

Description: Keyboard mapping to use on the target host.

Default value: us

mouse_base_config

Description: Mouse type for the target host.

Default value: generic3

auth_md5_base_config

Description: Specifies whether to use MD5 authentication..

Default value: yes

auth_shadow_base_config

Description: Specifies whether to use the shadow password.

Default value: yes

auth_cache_base_config

Description: Specifies whether to use the authentication cache.

Default value: no

auth_nis_enable_base_config

Description: Specifies whether to enable NIS (yes/no).

auth_nis_server_base_config

Description: Name of the NIS server, if auth_nis_enable_base_config is set to yes.

Example: nis-1.west.example.com

auth_nis_domain_base_config

Description: Name of the NIS domain..

Example: west.example.com

auth_ldap_enable_base_config

Description: Specifies whether to enable LDAP (yes/no).

auth_ldap_enable_auth_base_config

Description: Specifies whether to use LDAP for user authentication (yes/no).

auth_ldap_server_base_config

Description: Name of the LDAP server.

Example: ldap.west.example.com.

auth_ldap_basedn_base_config

Description: Base domain name for the LDAP server.

Example: west.example.com.

auth_ldap_tls_base_config

Description: Specifies whether to use the Transport Layer Security protocol (TLS) for LDAP (yes/no).

auth_kerberos5_kdcs_base_config

Description: List of Kerberos key distribution centers (KDCs). Include entries in a space separated list.

auth_kerberos5_realm_base_config

Description: Name of the Kerberos default realm.

auth_kerberos5_adminserver_base_config

Description: Name of the Kerberos administration server.

auth_hesiod_enabled_base_config

Description: Specifies whether to enable the Hesiod name service (yes/no).

auth_hesiod_right_side_base_config

Description: Specifies whether to use the Hesiod right side option, set in /etc/hesiod.conf(yes/no).

This option is used by the Hesiod library to determine the name to search DNS for when looking up information, similar to LDAP's use of a base domain name.

auth_hesiod_left_side_base_config

Description: Specifies whether to use the Hesiod left side option, set in /etc/hesiod.conf(yes/no).

This option is used by the Hesiod library to determine the name to search DNS for when looking up information, similar to LDAP's use of a base domain name.

auth_smb_servers_base_config

Description: Name of the Server Message Block server. SMB is is a protocol for sharing files, printers, serial ports, and communications abstractions such as named pipes and mail slots between computers.

auth_smb_workgroup_base_config

Description: Name of the SMB workgroup.

root_password_encrypted_base_config

Description: Specifies whether the root password for the target host is encrypted in the root_password_base_config variable (yes/no).

Default value: no

root_password_base_config

Description: Root password for the target host. If the root_password_encrypted_base_config variable is set to yes, set this value to the encrypted password.

Default value: newroot

timezone_base_config

Description: Time zone for the target host.

Default value: US/Pacific

timezone_utc_base_config

Description: Specifies whether the time zone is set in Coordinated Universal Time (yes/no).

Default value: no

firewall_base_config

Description: Specifies whether to enable a firewall on the target host (enabled/disabled).

Default value: disabled

firewall_trusted_base_config

Description: Space-separated list of network interfaces for which all traffic is allowed to pass through the firewall.

Example: eth0 eth1

firewall_incoming_base_config

Description: Space-separated list of port numbers and services, such as ssh, http, dhcp, telnet, smtp, or ftp. You can also specify service types and the associated protocol in the format service:protocol.

Example: imap:tcp 1234:udp ssh ftp

bootloader_name_base_config

Description: Name of the bootloader to boot and install the target host (grub/lilo).

Default value: grub

bootloader_location_base_config

Description: Location of the bootloader.

Default value: mbr

bootloader_append_base_config

Description: Space-separated list of kernel parameters for the bootloader to pass to the kernel.

Example: hdd=ide-scsi ide=nodma

bootloader_lilo_lba32_base_config

Description: If the bootloader_name_base_config variable is set to lilo, this variable specifies whether the bootloader should use lba32.

Default value: yes

bootloader_lilo_linear_base_config

Description: If the bootloader_name_base_config variable is set to lilo, this variable specifies whether the bootloader should use linnear.

Default value: yes

bootloader_grub_password_encrypted_base_config

Description: If the bootloader_name_base_config variable is set to grub, this variable specifies whether the GRUB root password is encrypted in the root_password_base_config variable (yes/no).

Example: no

bootloader_grub_password_base_config

Description: GRUB root password for the target host. If the bootloader_grub_password_encrypted_base_config variable is set to yes, set this value to the encrypted password.

xconfig_card_base_config

Description: Video card for the target host.

xconfig_videoram_base_config

Description: Video RAM on the target host.

xconfig_monitor_base_config

Description: Monitor model for the target host.

xconfig_resolution_base_config

Description: Resolution of the monitor on the target host.

xconfig_depth_base_config

Description: Color depth of the monitor on the target host.

xconfig_desktop_base_config

Description: Specifies the desktop software to use on the target host.

bootproto_base_config

Description: Boot protocol for the target host.

Default value: dhcp

network_interface_base_config

Description: Network interface to use during provisioning.

Default value: :[targetableComponent:linux_network_interface]

ip_base_config

Description: IP address of the target host.

Default value: :[targetableComponent:ethernet_ip_address]

hostname_base_config

Description: Host name of the target host.

Default value: :[targetableComponent:installPath]

netmask_base_config

Description: Netmask to use during provisioning.

Default value: :[targetableComponent:ethernet_netmask]

gateway_base_config

Description: Gateway to use during provisioning.

Default value: :[targetableComponent:default_router]

nameservers_base_config

Description: Space-separated list of name servers to use during provisioning.

networkifs_base_config

Description: Specifies additional network interfaces to configure. This variable value is derived from the target host variable networkifs_redhat_base_config.

Example: l eth1!--ip 1.2.3.4 --netmask 255.255.255.0 --bootproto static

partition_clear_base_config

Description: Specifies partitions to clear during provisioning.

Example: all

partition_zerombr_base_config

Description: Specifies whether to clear the master boot record (MBR).

Default value: yes

partition_1_disk_base_config

Description: Specifies the device for the first partition.

Default value: sda

Note –

Be sure to define the partition variables sequentially, starting with partition 1. If you do not start with partition 1, the installation switches to interactive mode.

partition_1_mountpoint_base_config

Description: Specifies the mount point for the first partition.

Default value: /diag

partition_1_fstype_base_config

Description: Specifies the file system type for the first partition.

Default value: vfat

partition_1_size_base_config

Description: Specifies the size in MB for the first partition.

Default value: 60

partition_1_maxsize_base_config

Description: Specifies the maximum size in MB for the first partition.

partition_1_grow_base_config

Description: Specifies whether to allow the partition to grow (yes/no).

partition_1_primary_base_config

Description: Specifies whether to force a primary partition (yes/no).

Default value: yes

partition_2_disk_base_config

Description: Specifies the device for the second partition.

Default value: sda

partition_2_mountpoint_base_config

Description: Specifies the mount point for the second partition.

Default value: /boot

partition_2_fstype_base_config

Description: Specifies the file system type for the second partition.

Default value: ext3

partition_2_size_base_config

Description: Specifies the size in MB for the second partition.

Default value: 100

partition_2_maxsize_base_config

Description: Specifies the maximum size in MB for the second partition.

partition_2_grow_base_config

Description: Specifies whether to allow the partition to grow (yes/no).

partition_2_primary_base_config

Description: Specifies whether to force a primary partition (yes/no).

Default value: yes

partition_3_disk_base_config

Description: Specifies the device for the third partition.

Default value: sda

partition_3_mountpoint_base_config

Description: Specifies the mount point for the third partition.

Default value: /

partition_3_fstype_base_config

Description: Specifies the file system type for the third partition.

Default value: ext3

partition_3_size_base_config

Description: Specifies the size in MB for the third partition.

Default value: 10000

partition_3_maxsize_base_config

Description: Specifies the maximum size in MB for the first partition.

partition_3_grow_base_config

Description: Specifies whether to allow the partition to grow (yes/no).

partition_3_primary_base_config

Description: Specifies whether to force a primary partition (yes/no).

partition_4_disk_base_config

Description: Specifies the device for the fourth partition.

Default value: sda

partition_4_mountpoint_base_config

Description: Specifies the mount point for the fourth partition.

Default value: swap

partition_4_fstype_base_config

Description: Specifies the file system type for the fourth partition.

Default value: swap

partition_4_size_base_config

Description: Specifies the size in MB for the fourth partition.

Default value: 1024

partition_4_maxsize_base_config

Description: Specifies the maximum size in MB for the fourth partition.

partition_1_grow_base_config

Description: Specifies whether to allow the partition to grow (yes/no).

partition_4_primary_base_config

Description: Specifies whether to force a primary partition (yes/no).

partition_5_disk_base_config

Description: Specifies the device for the fifth partition.

partition_5_mountpoint_base_config

Description: Specifies the mount point for the fifth partition.

partition_5_fstype_base_config

Description: Specifies the file system type for the fifth partition.

partition_5_size_base_config

Description: Specifies the size in MB for the fifth partition.

partition_5_maxsize_base_config

Description: Specifies the maximum size in MB for the fifth partition.

partition_5_grow_base_config

Description: Specifies whether to allow the partition to grow (yes/no).

partition_5_primary_base_config

Description: Specifies whether to force a primary partition (yes/no).

partition_6_disk_base_config

Description: Specifies the device for the sixth partition.

partition_6_mountpoint_base_config

Description: Specifies the mount point for the sixth partition.

partition_6_fstype_base_config

Description: Specifies the file system type for the sixth partition.

partition_6_size_base_config

Description: Specifies the size in MB for the sixth partition.

partition_6_maxsize_base_config

Description: Specifies the maximum size in MB for the sixth partition.

partition_6_grow_base_config

Description: Specifies whether to allow the partition to grow (yes/no).

partition_6_primary_base_config

Description: Specifies whether to force a primary partition (yes/no).

partition_7_disk_base_config

Description: Specifies the device for the seventh partition.

partition_7_mountpoint_base_config

Description: Specifies the mount point for the seventh partition.

partition_7_fstype_base_config

Description: Specifies the file system type for the seventh partition.

partition_7_size_base_config

Description: Specifies the size in MB for the seventh partition.

partition_7_maxsize_base_config

Description: Specifies the maximum size in MB for the seventh partition.

partition_7_grow_base_config

Description: Specifies whether to allow the partition to grow (yes/no).

partition_7_primary_base_config

Description: Specifies whether to force a primary partition (yes/no).

partition_8_disk_base_config

Description: Specifies the device for the eighth partition.

partition_8_mountpoint_base_config

Description: Specifies the mount point for the eighth partition.

partition_8_fstype_base_config

Description: Specifies the file system type for the eighth partition.

partition_8_size_base_config

Description: Specifies the size in MB for the eighth partition.

partition_8_maxsize_base_config

Description: Specifies the maximum size in MB for the eighth partition.

partition_8_grow_base_config

Description: Specifies whether to allow the partition to grow (yes/no).

partition_8_primary_base_config

Description: Specifies whether to force a primary partition (yes/no).

raid_1_device_base_config

Description: Specifies the name of the RAID device to use (such as md0 or md1). RAID devices range from md0 to md7, and each may only be used once.

Example: md0

raid_1_level_base_config

Description: Specifies the level (0,1, or 5) for the first RAID device.

Example: 1

raid_1_mountpoint_base_config

Description: Specifies the mount point of the first RAID device.

Example: raid.01

raid_1_meta_devices_base_config

Description: Space-separated list of metadevices for the first RAID device. These metadevices are created in the partition_ variables by specifying raid.number for the partition _n_mountpoint_base_config variable, for example, partition_1_mountpoint_base_config=raid.01

The raid.01 and raid.02 partition names are partition names which can be created with the JET base_config module. If you set the RAID level to 1 with the raid_1_level_base_config variable, you must to specify a minimum of two partitions of equal size. If you set the RAID level to 5 with the raid_1_level_base_config variable, you must to specify a minimum of three partitions of equal size.

raid_2_device_base_config

Description: Specifies the name of the RAID device to use (such as md0 or md1). RAID devices range from md0 to md7, and each may only be used once.

Example: md1

raid_2_level_base_config

Description: Specifies the level (0, 1, or 5) for the second RAID device.

Example: 1

raid_2_mountpoint_base_config

Description: Specifies the mount point of the second RAID device.

Example: raid.02

raid_2_meta_devices_base_config

Description: Space-separated list of metadevices for the second RAID device. These metadevices are created in the partition_ variables by specifying raid.number for the partition _n_mountpoint_base_config variable, for example, partition_2_mountpoint_base_config=raid.02

append_kernel_cmdline_base_config

Description: Additional command line options for the kernel at PXE boot time.

clusters_base_config

Description: Specifies the package groups to install.

Default value: Everything

packages_add_base_config

Description: Space-separated list that includes additional packages to install on the target host.

packages_remove_base_config

Description: Space-separated list that includes additional packages to remove from the target host.

packages_resolvedeps_base_config

Description: Specifies whether to resolve package dependencies during provisioning (yes/no).

packages_ignoredeps_base_config

Description: Specifies whether to ignore package dependencies during provisioning (yes/no).

packages_ignoremissing_base_config

Description: Specifies whether to ignore missing packages and continue provisioning (yes/no).

enable_services_base_config

Description: Space-separated list of Xinetd services to enable on the target host.

postscript_chroot_base_config

Description: Specifies whether to run JET postscripts in a different root directory (yes/no).

bootloader_grub_redirect_fix_base_config

Description: Specifies whether to redirect installation output to the console instead of a serial console(yes/no).

On certain hardware, the installer does not correctly set the serial or console display in the bootloader. If your hardware does not properly set the console redirection in the GRUB bootloader, set this value to yes.

no_autoreboot_base_config

Description: Specifies whether to reboot after the installation (yes/no).

If you set this value to no, any postinstall scripts are not run until the system is rebooted.

script_1_pre_base_config

Description: Specifies the location of a preinstall script on the JET server.

script_1_pre_interpreter_base_config

Description: Specifies the interpreter for the preinstall script.

script_1_post_base_config

Description: Specifies the location of a postinstall script on the JET server.

script_1_post_interpreter_base_config

Description: Specifies the interpreter for the postinstall script.

script_1_post_nochroot_base_config

Description: Specifies whether to run the postinstall script in a jail in an alternate root directory.

partitionadd_base_config

Description: Adds partitions to the target host, starting with partition 9. The variable value requires the following syntax.

n!disk!mountpoint!fstype!size!maxsize!grow!primary

The previous summary includes the following elements.

n specifies the partition number.

disk specifies the device for the partition.

mountpoint specifies the mount point for the partition.

fstype specifies the file system type for the partition.

size specifies the size in MBs of the partition.

maxsize specifies the maximum size for the partition.

grow specifies whether to enable the partition to grow.

primary specifies whether to force this partition as a primary partition.

Include the information for all the additional partitions you want to create in the variable value. For example, if you want to create a ninth and tenth partition, set this variable to a value similar to this example.

9!sda!/export1!ext3!1000!!!!|10!sda!/export10!jfs!100!2000!yes!!

This value creates the following variable set.

base_config_partition_9_disk=sda
base_config_partition_9_mountpoint=/export1
base_config_partition_9_fstype=ext3
base_config_partition_9_size=1000
base_config_partition_9_maxsize=
base_config_partition_9_grow=
base_config_partition_9_primary=

base_config_partition_10_disk=sda
base_config_partition_10_mountpoint=/export10
base_config_partition_10_fstype=jfs
base_config_partition_10_size=100
base_config_partition_10_maxsize=2000
base_config_partition_10_grow=yes
base_config_partition_10_primary=

raidadd_base_config

Description: Adds RAID devices to the target host, starting with device 3. The variable value requires the following syntax.

n!device!level!mountpoint!metadevices

The previous summary includes the following elements.

n specifies the RAID volume number.

device specifies the device for the RAID volume.

level specifies the RAID level for the volume.

mountpoint specifies the mount point for the RAID volume.

metadevices specifies metadevices to create for the RAID volume.

Include the information for all the additional partitions you want to create in the variable value. The raidadd_base_config variable uses the same basic syntax as the partitionadd_base_config variable.

scriptpreadd_base_config

Description: Adds additional preinstall scripts to the OS provisioning profile, starting with the number 2. The variable value requires the following syntax.

n!pre!pre_interpreter

The previous summary includes the following elements.

n specifies the preinstall script number.

pre specifies the name of the preinstall script.

pre_interpreter specifies the interpreter to use with the preinstall script.

Include the information for all the additional preinstall scripts you want to use in the variable value. The scriptpreadd_base_config variable uses the same basic syntax as the partitionadd_base_config variable.

scriptpostadd_base_config

Description: Adds additional postinstall scripts to the OS provisioning profile, starting with the number 2. The variable value requires the following syntax.

n!post!post_interpreter!post_nochroot

The previous summary includes the following elements.

n specifies the postinstall script number.

post specifies the name of the postinstall script.

post_interpreter specifies the interpreter to use with the postinstall script.

post_nochroot specifies whether to run the postinstall script in a jail in an alternate root directory (yes/no).

Include the information for all the additional postinstall scripts you want to use in the variable value. The scriptpostadd_base_config variable uses the same basic syntax as the partitionadd_base_config variable.

Component Variables for RedHat Remote Agents

The variables described in the following list provide Remote Agent (RA) configuration for the N1 SPS software. These variables directly equate to the JET spsra module.

install_spsra

Description: Whether to install the N1 SPS RA software.

Default value: y

product_version_spsra

Description: Version of RA to install.

Default value: 5.2

If you are using the N1 SPS 5.1 release to provision with the OS Provisioning Plug-In 3.0, set this variable value to 5.1.

basedir_spsra

Description: Base directory in which RA files are installed.

Default value: /opt/SUNWn1sps

username_spsra

Description: When using the RA installer, specify user name to own the RA filesystem.

Example: jdoe

groupname_spsra

Description: When using the RA installer, specify group name to own the RA filesystem.

Example: staff

setup_user_acct_spsra

Description: Determines whether to set up user and group account for username_spsra and groupname_spsra.

Note –

If the user account is not available to the target after provisioning, set this variable value to y to start an N1 SPS Remote Agent on the target host on reboot after provisioning.

Default value: n

user_passwd_spsra

Description: Encrypted password for username_spsra.

Example: 6GR9gOi1vRVFw shows the encrypted value for the password “n1spspwd.”

userid_spsra

Description: User account ID for username_spsra.

Example: 505

groupid_spsra

Description: Group account ID for groupname_spsra.

Example: 505

homedir_spsra

Description: Home directory for RA files.

Default value: /opt/SUNWn1sps

jre_path_spsra

Description: Path to the Java runtime environment. If no value is provided, use the path suggested by the installer. If a path is given, the JRE must be installed at that path or the installation fails.

setuid_spsra

Description: Enable RA root access.

Default value: y

host_spsra

Description: Host name or IP address of the Remote Agent.

Default value: :[targetableComponent:sps_ra_host]

conn_spsra

Description: Determines method to use for connecting to RA. By default, uses the connection method defined for the targetable component.

Default value: :[targetableComponent:sps_ra_conn]

ssl_auth_spsra

Description: SSL authorization to use for network connection.

Default value: :[targetableComponent:sps_ra_ssl_auth]

port_spsra

Description: Port to use for network connection. By default, uses the port defined for the targetable component.

Note –

To use an SSH connection, set the port number to 70000.

Default value: :[targetableComponent:sps_ra_port]

adv_params_spsra

Description: Advanced parameters to use for network connection. By default, uses the advanced parameters defined for the targetable component.

Default value: :[targetableComponent:sps_ra_adv_parms]

General RedHat Linux OS Provisioning Plug-In Variables

The variables in the following list are general variables that the OS provisioning plug-in requires. They are not technically part of the JET modules, but are required for the OS provisioning plug-in to interface between JET and the N1 SPS software.

installPath

Description: Jumpstart Enterprise Toolkit (JET) virtual host.

Example: myhost-jet

osp_target_host

Description: Target host name.

Default value: :[targetableComponent:installPath]

osp_profile_control_service

Description: Whether to call the OSP Control Service, which automates power off, reboot, and power on functions (True, False).

Default value: :[targetableComponent:osp_control_service]

osp_jet_server

Description: Host name of the JET server.

Example: myserver

osp_profile_architecture

Description: Target host architecture (x86).

Default value: :[targetableComponent:architecture]

osp_profile_min_disk_size

Description: Minimum disk size.

Example: 5GB

osp_profile_description

Description: Profile description.

osp_profile_boot_server_name

Description: RedHat Linux boot server name.

Default value: :[osp_jet_server]

osp_profile_BS_subnet_address

Description: Subnet served by boot server.

osp_profile_BS_subnet_ip_address

Description: IP address of boot server on this subnet.

Example: 199.199.8.6

osp_profile_product_ip_address

Description: IP address of RedHat Linux image server.

Example: 199.199.8.6

osp_profile_product_directory

Description: Path to image directory on image server.

Example: /osp_image/RedHat/RHEL3-U4

osp_profile_boot_ip_address

Description: IP address of RedHat Linux boot server.

Example: 199.199.8.6

Appendix C RedHat Linux Profile Component Variables

Basic RedHat OS Configuration Variables

Component Variables for base_config Module

Component Variables for RedHat Remote Agents

General RedHat Linux OS Provisioning Plug-In Variables

Component Variables for `base_config` Module