N1 Grid Service Provisioning System User's Guide and Release Notes for the OS Provisioning Plug-In 1.0

Appendix B Solaris Profile Component Variables

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

Basic OS Configuration Variables

base_config Variables

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

Table B–1 Component Variables for base_config Module

Variable name 

Description 

Default or Sample Value 

ClientArch_base_config

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

:[targetableComponent:kernel_arch]

(Default) 

ClientEther_base_config

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

:[targetableComponent:ethernet_mac_address] (Default)

ClientOS_base_config

Version of the OS to be provisioned 

Solaris9_u7_sparc (Example)

client_allocation_base_config

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.

 

products_base_config

JET modules to provision 

base_config spsra (Example)

sysidcfg_nameservice_base_config

Name service to configure at initial boot 

NIS (Default)

sysidcfg_network_interface_base_

Network interface to use at initial boot 

PRIMARY (Default)

sysidcfg_ip_address_base_config

IP address to use at initial boot. By default, this is set to the IP address of the targetable component 

:[targetableComponent:ethernet_ip_address](Default)

sysidcfg_netmask_base_config

Netmask to use at initial boot. By default, this is set to the netmask of the targetable component 

:[targetableComponent:ethernet_netmask](Default)

sysidcfg_root_password_base_conf

Encrypted root password 

boajrOmU7GFmY (Example)

sysidcfg_system_locale_base_conf

System locale to use at initial boot. 

en_US.ISO8859-1 (Example)

sysidcfg_timeserver_base_config

Where to get system time for initial boot. If blank, system time comes from the JET server. Alternatively, you can set to localhost to get the system time from the hardware clock on the client

 

sysidcfg_timezone_base_config

System time zone to use for initial boot. 

US/Pacific (Example)

sysidcfg_terminal_base_config

Terminal emulator to set at initial boot. 

vt100 (Default)

sysidcfg_security_policy_base_co

Kerberos security policy to use at initial boot. 

NONE (Default)

sysidcfg_protocol_ipv6_base_conf

Whether to use IPv6 protocol at initial boot. 

no (Default)

sysidcfg_default_route_base_conf

Default route to set for Solaris 9 or later environments. 

 

x86_nowin_base_config

For x86 systems, prevents Solaris from trying to run Windows during the install. 

yes (Default)

x86_console_base_config

For x86 systems, set the console to the correct tty port if you are not going to connect a keyboard and monitor to the client. Setting this variable enables you to perform installs via the serial port. For b1600, v20z, and v40z systems, use ttya. For lx50, v60x, and v65x systems, use ttyb.

 

x86_disable_acpi_base_config

For x86 systems, any value disables ACPI. Disabling ACPI might make the installation process proceed better due to how the interrupts are handled. 

 

x86_safetoreboot_base_config

For x86 systems, controls whether the system automatically reboots. If your PXE boot is a one time option, and the next reboot will attempt to boot from disk, you should set this option to yes.

 

profile_base_config

Create your own custom profile. Set this variable to reference a file relative to the Clients/ directory. Otherwise, set the following 21 profile_* variables and the plug-in will create the profile.

 

profile_cluster_base_config

Solaris software group package. SUNWCreq identifies the basic, required software. Other possibilities include: 

  • SUNWCuser — User package

  • SUNWCprog — User and developer packages

  • SUNWCall — All packages

  • SUNWCXall — All packages, including OEM packages (mandatory for E10K environments)

  • SUNWCrnet — Minimal package for Solaris 10 only

SUNWCreq (Default)

profile_usedisk_base_config

Defines the boot disks onto which the OS will be loaded. Use the format cntndn or the keyword rootdisk. If the value is rootdisk. , then the current boot disk will be used.

rootdisk (Default)

profile_dontuse_base_config

A comma-separated list of disks that should not be used. Use the format cntndn. This variable applies only if profile_usedisk_base_config is not set.

 

profile_root_base_config

Root space (free, or MB size) 

free (Default)

profile_swap_base_config

Swap space (MB size) 

256 (Default)

profile_s3_mtpt_base_config

Mount path to the slice 3 partition.  

If you are using VxVM and you want your boot disk to look like the mirror, then leave slices 3 and 4 empty. 

 

profile_s3_size_base_config

Size of the slice 3 partition. 

 

profile_s4_mtpt_base_config

Mount path to the slice 4 partition.  

 

profile_s4_size_base_config

Size of the slice 4 partition. 

 

profile_s5_mtpt_base_config

Mount path to the slice 5 partition.  

/var (Default)

profile_s5_size_base_config

Size of the slice 5 partition. 

 

profile_s6_mtpt_base_config

Mount path to the slice 6 partition.  

/usr (Default)

profile_s6_size_base_config

Size of the slice 6 partition. 

 

profile_s7_mtpt_base_config

Mount path to the slice 7 partition. If you are using Solaris Volume Manager (SVM), the default behavior is to use slice 7 as a location for metastate databases. If you are using the SVM default configuration, do not use slice 7 for data. 

/opt (Default)

profile_s7_size_base_config

Size of the slice 7 partition. 

 

profile_additional_disks_base_co

A comma-separated list of additional disks to use and configure. Use the format cntndn. For each disk listed, define sets of variables for each slice to identify the mount point and the size. Use a colon to separate the variables.

 

profile_add_locales_base_config

Comma-separated list of locales to add.  

fr_FR, ja_JP.UTF-8 (Example)

profile_del_locales_base_config

Comma-separated list of locales to delete. 

 

profile_add_geos_base_config

Comma-separated list of geographical regions to add.  

N_Europe, C_Europe (Example)

profile_del_geos_base_config

Comma-separated list of geographical regions to delete. 

 

ufs_logging_filesys_base_config

For Solaris 7 and later systems, a space-separated list of mount points to use for logging. To enable logging on all UFS file systems, use the keyword all. Solaris 9 09/04 enables logging by default.

To disable logging on a specific file system, put a hyphen in front of the mount point. To disable logging on all file systems, use the keyword none.

You cannot mix keywords and mount points. You can specify the root file system (/), although the root file system is included as part of the all and none keywords.

all (Default)

profile_add_packages_base_config

Space-separated list of packages to add. 

 

profile_del_packages_base_config

Space-separated list of packages to remove. 

 

profile_add_clusters_base_config

Space-separated list of cluster packages to add. 

 

profile_del_clusters_base_config

Space-separated list of cluster packages to remove. 

SUNWCpm SUNWCpmx SUNWCdial SUNWCdialx (Example)

nfs_mounts_base_config

Space-separated list of remote NFS mount points. Use ? to separate the mount source from the mount target, as shown in the example. 

fs?1.1.1.1:/fs (Example)

nodename_base_config

Value to use for /etc/nodename if not the default hostname.

 

defaultrouter_base_config

Value to use for /etc/defaultrouter.

 

notrouter_base_config

If set to y, then disable IPv4 forwarding and create /etc/notrouter file.

 

dns_domain_base_config

DNS domain entry for /etc/resolv.conf file.

 

dns_nameservers_base_config

Space-separated list of IP addresses to use for DNS nameserver entries in /etc/resolv.conf file.

 

dns_searchpath_base_config

List of entries to go in the DNS search line in /etc/resolv.conf file.

 

dns_disableforbuild_base_config

Delay DNS configuration until later. If DNS is not available in the build environment, set this variable to yes.

 

ntp_servers_base_config

Space-separated list of names or IP addresses for the NTP servers. The first server will be given a 'prefer' tag. This section only place lines of the form: server [prefer] into the /etc/inet/ntp.conf file. For additional NTP control, use the custom module to deploy your own custom ntp.conf file.

 

networkifs_base_config

Space-separated list of interfaces to be defined. For logical interfaces, use underscores (_) rather than colons (:). Use the format cntndn. For each interface listed, define sets of variables to provide the netname, netmask, hostname, and IP address for the interface. Use a colon to separate the variables.

le0 hme0 (Example)

ipmp_networkifs_base_config

Space-separated list of interfaces to be defined under IPMP control. For each interface listed, define sets of variables to provide the netgroup, mode, test1, test2, netmask, hostname, log-ip, hostname2, and log-ip2 for the interface. Use a colon to separate the variables.  

qfe0_qfe4 qfe1_qfe5 (Example)

update_terminal_base_config

If set, put the sysidcfg terminal type into inittab.

yes (Default)

enable_savecore_base_config

If set to any value, enable save core for Solaris 2.6 systems. 

yes (Default)

dumpadm_minfree_base_config

Set a limit so that crash dumps do not fill up the dump filesystem. See dumpadm(1M) -m option for possible values.

20000k (Example)

noautoshutdown_base_config

If set to any value, disable power management. 

pm_disabled (Default)

enable_rootlogin_base_config

If set to any value, enable network root login from both telnet/rsh and ssh. 

 

enable_rootftp_base_config

If set to any value, enable root FTP access. 

 

shutup_sendmail_base_config

If set, create an alias hostname to shut up sendmail. 

yes (Default)

poweroff_afterbuild_base_config

If set, shut down the machine once the build completes. 

 

dedicated_dump_device_base_confi

If set, the dumpadm utility configures the partition as a Dedicated Dump Device. See dumpadm(1M) for supported Operating Environments.

 

enable_altbreak_base_config

If set, enable alternate break sequence. 

 

disable_sysid_probe_base_config

If set, skip the sysid stuff on the first reboot. This can significantly increase provisioning efficiency on systems that have many unused network adapters.

yes (Default)

nfsv4_domain_base_config

Set up the NFSv4 domain to prevent being prompted at first reboot. If not set, look first for the entry in dns_domain_base_config, and second for the domain value in /etc/default/nfs

 

productdir_base_config

Path to the products. If blank, use information from the jumpstart.conf file and the IP address of the JET server. 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

Path to the patches. If blank, use information from the jumpstart.conf file and the IP address of the JET server. If your patch files are not stored on the JET server, then provide an NFS-style path to the location of the patches.

 

Configuring Additional Slices

The profile_additional_disks_base_co variable provides a list of additional slices to configure and use. Use the format cntndn to identify each slice. For each slice, you provide a pair of variables that defines the mount point and size of the slice. Use a colon to separate the variables.

The following example shows the content of the profile_additional_disks_base_co variable to define two additional slices.

c0t0d0s3 /export/mydisk1:50MB 
c0t1d1s3 /export/mydisk2:100MB

Configuring Network Interfaces

The networkifs_base_config variable provides a list of network interfaces to use. For logical interfaces, use underscores (_) rather than colons (:). For each interface listed, you provide a group of four variables that defines the netname, netmask, hostname, and IP address for the interface. Use a colon to separate the variables.

The following example shows the content of the networkifs_base_config variable to define two interfaces.

le0 bkp:255.255.255.0:me-bkp:192.168.1.0
hme0 bkp2:255.255.255.0:me-bkp2:192.168.2.0

Configuring IP Network Multipathing (IPMP)

For general information about IPMP, see the IP Network Multipathing Administration Guide.

The default mode for IP multipathing in Solaris 8 or later environments is automatic failback. To change this mode, edit the /etc/default/mpathd file.

You can only set up an IPMP group with pairs of interfaces in one of the following configurations:

The ipmp_networkifs_base_config variable defines a list of interfaces to be defined under IPMP control. For each interface, a set of variables must be included to defined additional interface parameters. The following lists the parameters that you need to define:

The following example shows the content of the ipmp_networkifs_base_config variable to define one IPMP interface.

qfe0_qfe1 database-net:l:10.0.0.1:10.0.0.2:24:oracle-db:10.0.0.3:apache:10.0.0.4

Variables for N1 Grid SPS Remote Agents

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

Table B–2 Component Variables for spsra Module

Variable name 

Description 

Example or Default 

install_spsra

Whether to install the N1 Grid SPS RA software. 

y (Default)

product_version_spsra

Version of RA to install. 

5.0 (Default)

basedir_spsra

Base directory in which RA files are installed. 

/opt/SUNWn1sps (Default)

install_ra_from_snapshot_spsra

Determines where to get RA files. When you install the JET server or attach the JET server, a snapshot of the RA on the JET server is taken automatically. As a result, this variable defaults to y. Set the variable to n for a cross architecture install. In this case, you need to import the product media for the JET module by using the Manage link in the JET Solaris Image Servers section of the OS Provisioning common tasks page.

y (Default)

username_spsra

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

jdoe (Example)

groupname_spsra

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

staff (Example)

setup_user_acct_spsra

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

.  

n (Default)

user_passwd_spsra

Encrypted password for username_spsra

6GR9gOi1vRVFw (Example)

userid_spsra

User account ID for username_spsra.

505 (Example)

groupid_spsra

Group account ID for groupname_spsra.

505 (Example)

homedir_spsra

Home directory for RA files. 

/opt/SUNWn1sps (Default)

jre_path_spsra

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

Enable RA root access. 

y (Default)

conn_spsra

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

:[targetableComponent:sps_ra_conn] (Default)

ssl_auth_spsra

SSL authorization to use for network connection.  

1 (Default)

port_spsra

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

:[targetableComponent:sps_ra_port] (Default)

adv_params_spsra

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

:[targetableComponent:sps_ra_adv_parms] (Default)

General OS Provisioning Plug-In Variables

The variables listed in the following table 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 Grid SPS software.

Table B–3 General OS Provisioning Component Variables

Variable name 

Description 

Example or Default 

installPath

Jumpstart Enterprise Toolkit (JET) virtual host 

myhost-jet (Example)

osp_target_host

Target host name 

:[targetableComponent:installPath] (Default)

osp_profile_control_service

OS provisioning control server (TRUE, FALSE) 

:[targetableComponent:osp_control_service] (Default)

sps_ra_parent_host

Host name of the N1 Grid SPS RA parent 

:[targetableComponent:sps_ra_parent] (Default)

sps_ra_parent_host_type

Host type of the N1 Grid SPS RA parent (MS or LD) 

:[targetableComponent:sps_ra_parent_type] (Default)

osp_jet_server

Host name of the JET server 

myserver (Example)

osp_profile_architecture

Target host architecture (sun4u, x86) 

:[targetableComponent:architecture] (Default)

osp_profile_min_disk_size

Minimum disk size 

5GB (Example)

osp_profile_description

Profile description 

 

osp_profile_monitor_install

OS provisioning monitor (TRUE, FALSE) 

FALSE (Default)

osp_profile_boot_server_name

Solaris boot server name 

:[osp_jet_server] (Default)

osp_profile_BS_subnet_address

Subnet served by boot server 

 

osp_profile_BS_subnet_ip_address

IP address of boot server on this subnet 

199.199.8.6 (Example)

osp_profile_product_ip_address

IP address of Solaris image server 

199.199.8.6 (Example)

osp_profile_product_directory

Path to image directory on image server 

/osp_image/Solaris9_u7_sparc (Example)

osp_profile_boot_ip_address

IP address of Solaris boot server 

199.199.8.6 (Example)

osp_profile_boot_directory

Solaris boot directory 

/osp_image/Solaris9_u7_sparc/Solaris_9/Tools/Boot (Default)

osp_profile_sysidcfg_ip_address

IP address of system ID configuration 

199.199.8.6 (Example)

osp_profile_sysidcfg_directory

Directory of system ID configuration 

/opt/SUNWjet/Clients/:[osp_target_host] (Default)

osp_profile_jumpstart_ip_address

Jumpstart IP address 

199.199.8.6 (Example)

osp_profile_jumpstart_directory

Jumpstart directory 

/opt/SUNWjet (Default)

osp_profile_boot_file_name

Solaris boot file name 

:[osp_target_host] (Default)

osp_profile_nbp_boot_file_name

Network boot file name 

:[osp_target_host] (Default)