JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Hardware Installation Assistant 2.5 User's Guide for x86 Servers
search filter icon
search icon

Document Information

Using This Documentation

Product Downloads

Documentation and Feedback

About This Documentation

Contributors

Change History

Overview of the Oracle Hardware Installation Assistant User's Guide

Getting Started With Oracle Hardware Installation Assistant

What is Oracle Hardware Installation Assistant?

Features and Benefits

Supported Provisioning Tasks List

Media Availability

Supported Operating Systems

Product Documentation Library

Launching the Application and Performing Provisioning Tasks

Local and Remote Media Launch Options for Sun Fire and Sun Blade Servers

How to Perform Provisioning Tasks

Configuring RAID

RAID Support

How to Create a RAID Volume

How to Delete a RAID Volume

Installing Windows

How to Install Windows Using Local or Remote Media

Installing Linux

How to Install Linux Using Local or Remote Media

Updating System and Component Firmware

How to Update the System BIOS and Oracle ILOM Firmware

How to Update Expander Firmware

How to Update HBA Firmware

Recovering a Service Processor

How to Recover a Service Processor

Configuring Service Processor Settings

How to Configure Service Processor Identification Information Settings

How to Configure Network Information Settings

How to Manage Oracle ILOM User Accounts

How to Set the System Clock

Configuring BIOS Boot Device Settings

How to Set the Boot Device Order

How to Set the Boot Device for the Next Boot

Setting Up PXE-Based Oracle Hardware Installation Assistant

How to Set Up the PXE Infrastructure

Preparing the Oracle Hardware Installation Assistant PXE Image Files

Launching an Attended PXE-Based Session

Attended PXE-Based Session Overview

How to Create the Image for a PXE-Based Session

How to Launch an Attended Installation From a PXE Server

Performing Unattended PXE-Based Provisioning Tasks

Unattended PXE-Based Provisioning Tasks Requirements

Creating a State File for Unattended Installation

How to View the Contents of the Oracle Hardware Installation Assistant State File

Oracle Hardware Installation Assistant State File Variable List

Considerations for Creating a State File

Sample State Files

Sample Oracle Hardware Installation Assistant State File for Linux

Sample Oracle Hardware Installation Assistant State File for Windows

Sample Oracle Hardware Installation Assistant State File for Firmware Updates

How to Create an Unattended Oracle Hardware Installation Assistant State File

How to Prepare for an Unattended Installation of Linux

How to Prepare for an Unattended Installation of Windows Server

How to Prepare for an Unattended Firmware Update

How to Create the Application Image and Prepare for a PXE-Based Launch

How to Launch an Unattended Session From a PXE-Based Server

Observing Unattended PXE-Based Provisioning Tasks

Establishing a Viewing Connection Using a Virtual Console or Secure Shell (SSH) Connection

How to Set Up Root and VNC Passwords

How to Establish a Connection Using a VNC Viewer

How to Establish a Connection Using a Serial Console

Troubleshooting Oracle Hardware Installation Assistant

No Driver Found Message Appears During Oracle VM 2.2.1 Server Installation

Oracle Hardware Installation Assistant Can Go Into a Loop at Last OS Install Screen

Oracle Hardware Installation Assistant Error Messages

How to View the Application Log File

How to Debug a PXE Image That Does Not Boot

Launching Oracle Hardware Installation Assistant Using a USB Flash Drive

Requirements

How to Get the Syslinux and Oracle Hardware Installation Assistant Software

Creating an Oracle Hardware Installation Assistant USB Flash Drive

How to Boot the USB Flash Drive and Launch Oracle Hardware Installation Assistant

Installing Service Tags

How to Install Service Tags in Linux

How to Install Service Tags in Windows

Index

Oracle Hardware Installation Assistant State File Variable List

The following table describes the state file variables for the automated tasks that can be performed.


Note - Each variable with its value must be on a separate line in the state file without line breaks. Due to width restrictions in the table below, some examples might show variables breaking across multiple lines.


Table 1 Oracle Hardware Installation Assistant State File Variables

Variable
Description (Defaults in Bold)
Required for Windows Install
Required for Linux Install
Required for Firmware update
apit.unattended
Tells Oracle Hardware Installation Assistant to run in unattended mode. Values supported: true | false

Example: apit.unattended=true

X
X
X
apit.welcome.acceptlicense
Accepts the Oracle Hardware Installation Assistant license agreement. Values supported: true | false

Example: apit.welcome.acceptlicense=true

X
X
X
apit.remoteUpdate
Tells Oracle Hardware Installation Assistant to look for Oracle Hardware Installation Assistant updates. You should always perform an update to ensure you install the latest software and firmware. Values supported: true | false

Example: apit.remoteUpdate=true

X
X
X
apit.remoteUpdateURL
If you specified “true” for apit.remoteUpdate, tells Oracle Hardware Installation Assistant where to look for Oracle Hardware Installation Assistant software updates. Values supported: Any URL with updated Oracle Hardware Installation Assistant content files. You only need to specify this variable if you are not using the default URL.
X (if remote Update is true and default URL is not used)
X (if remote Update is true and default URL is not used)
X (if remote Update is true and default URL is not used)
apit.networking
Tells Oracle Hardware Installation Assistant it has permission to work over the network. If true, Oracle Hardware Installation Assistant configures network settings based on networkconfig variables. Values supported: true | false

Example: apit.networking=true

X
X
X
apit.networkconfig.needNetwork
If you specified “true” for network, tells Oracle Hardware Installation Assistant whether network access is required for a particular task. Values supported: true | false

Example: apit.networkconfig.needNetwork=true

X (if networking is true)
X (if networking is true)
X (if networking is true)
apit.networkconfig.activeNic
If you specified “true” for network, tells Oracle Hardware Installation Assistant which network interface is connected to the active network. Values supported: eth0 | eth1 | eth2 | eth3 ....

Example: apit.networkconfig.activeNic=eth0

X (if networking is true)
X (if networking is true)
X (if networking is true)
apit.networkconfig.NetworkType
If you specified “true” for network, tells Oracle Hardware Installation Assistant the configuration of the active network interface. Values supported: static | dhcp

Example: apit.networkconfig.NetworkType=dhcp

X (if networking is true)
X (if networking is true)
X (if networking is true)
apit.networkconfig.useDHCP
If you selected “dhcp” as the NetworkType, tells Oracle Hardware Installation Assistant to obtain the server’s address from the DHCP server. Values supported: true | false

Example: apit.networkconfig.useDHCP=true

X (if networking is true)
X (if networking is true)
X (if networking is true)
apit.networkconfig.ipfield
If you selected “static” as the NetworkType, tells Oracle Hardware Installation Assistant to use the server’s IP address value you provide.

Example: apit.networkconfig.ipfield=n.n.n.n

X (if static IP is used)
X (if static IP is used)
X (if static IP is used)
apit.networkconfig.gatewayField
If you selected “static” as the NetworkType, tells Oracle Hardware Installation Assistant to use the IP address value you provide.

Example: apit.networkconfig.gatewayfield=n.n.n.n

X (if static IP is used)
X (if static IP is used)
X (if static IP is used)
apit.networkconfig.netmaskedField
If you selected “static” as the NetworkType, tells Oracle Hardware Installation Assistant to use the IP address value you provide.

Example: apit.networkconfig.ipfield=n.n.n.n

X (if static IP is used)
X (if static IP is used)
X (if static IP is used)
apit.http_proxy
If, for example, you specified “true” for remoteUpdate, tells Oracle Hardware Installation Assistant to use a proxy server for internet access.

Examples:

apit.http_proxy=n.n.n.n (IP address)

apit.http_proxy=file://web-proxy-configfile

apit.http_proxy=http://web-proxy-server

apit.http_proxy=http://internal-host:portnumber

X (if proxy used)
X (if proxy used)
X (if proxy used)
apit.taskList.selectedTask
Tells Oracle Hardware Installation Assistant which task to perform (only one task can be run per unattended session). This variable is required in the state file. Values supported: SP/Bios Firmware Upgrade | OS Installation | HBA Firmware Upgrade | Expander Firmware Upgrade | SP Recovery

Example: apit.taskList.selectedTask=OS Installation

X
X
X
apit.osid.installLoc
Tells Oracle Hardware Installation Assistant where the network image of the Linux OS to be installed is located. The path is to the directory containing the image (ISO or extracted ISO), not the image itself. The directory cannot contain more than one image.

Example: apit.osid.installLoc=http://path_to_imagedirectory

X
apit.osid.installMedia
Tells Oracle Hardware Installation Assistant where the CD or .iso file for the OS installation software is located. Values supported: cdrom | networkLinux | networkWindows

Example: apit.osid.installMedia=cdrom

X
X
apit.osid.installMethod
Tells Oracle Hardware Installation Assistant which file transfer protocol to use during the installation. Values supported: http | ftp

Example: apit.osid.installMethod=http

X
X
apit.osid.kickstart
Tells Oracle Hardware Installation Assistant where the kickstart file is located for a Linux installation. This could be the URL to the Red Hat kickstart file or the SUSE autoyast file.

Examples:

apit.osid.kickstart=http://url_to_kickstart

apit.osid.kickstart=ftp://url_to_kickstart

X
apit.windows2008.imageName
Specifies the version of Windows Server 2008 to be installed. Values determine whether this is a full or core–only Windows installation. Core installations allow you to install Windows with only the components needed to run a small set of core network roles. Supported values:
  • WINDOWS LONGHORN [R2] SERVERSTANDARD

  • WINDOWS LONGHORN [R2] SERVERENTERPRISE

  • WINDOWS LONGHORN [R2] SERVERDATACENTER

  • WINDOWS LONGHORN R2 SERVERWEB

  • WINDOWS LONGHORN [R2] SERVERSTANDARDCORE

  • WINDOWS LONGHORN [R2] SERVERENTERPRISECORE

  • WINDOWS LONGHORN [R2] SERVERDATACENTERCORE

  • WINDOWS LONGHORN R2 SERVERWEBCORE

Note: The R2 value is only required for Windows Server 2008 R2. Windows Server 2008 SERVERWEB/CORE is only supported with R2.

Example for pre-R2:

apit.windows2008.imageName=WINDOWS LOGHORN SERVERENTERPRISE

Example for R2:

apit.windows2008.imageName=WINDOWS LONGHORN R2 SERVERENTERPRISE

X (2008 only)
apit.osid.windows.iso.url1
Based on the installMethod you choose (http or ftp), tells Oracle Hardware Installation Assistant where the location of the first Windows OS install disk .iso image file is located.

Examples:

apit.osid.windows.iso.url1=http://path_to_disk1.iso

apit.osid.windows.iso.url1=ftp://path_to_disk1.iso

X
apit.osid.windows.iso.url2
Based on the installMethod you chose (http or ftp), tells Oracle Hardware Installation Assistant where the location of the second Windows OS install disk .iso image file is located (if on two disks).

Examples:

apit.osid.windows.iso.url2=http://path_to_disk2.iso

apit.osid.windows.iso.url2=ftp://path_to_disk2.iso

X
apit.enclosureID.oldEnclosureID
Used as part of a two-step process that allows you to replace a Sun Blade 6000 disk module. The value for this variable must be the old enclosure ID number (also called WWN) that can be found on the circuit board of the blade being replaced.
apit.enclosureID.newEnclosureID
Used as part of a two-step process that allows you to replace a Sun Blade 6000 disk module. This value for this variable must be the new enclosure ID number (also called WWN) that can be found on the circuit board of the replacement blade.
apit.firmware.enabled
Tells Oracle Hardware Installation Assistant to enable or disable its firmware update function. Values supported: true | false

Typically used in a test environment, this variable is not required to update firmware.

apit.firmware.spIP
Part of a firmware upgrade task. Tells Oracle Hardware Installation Assistant the IP address of the server’s service processor.

Example: apit.firmware.spIP=n.n.n.n

X
apit.firmware.spPasswd
Part of a firmware upgrade task. Tells Oracle Hardware Installation Assistant the password of the server’s service processor.

Example: apit.firmware.spIP=changeme

X
apit.windows.acceptEula
Tells Oracle Hardware Installation Assistant to accept the EULA (End User License Agreement), as required when installing the Windows OS.

Example: apit.windows.acceptEula

X (2003 only)
apit.windows.adminPasswd
Tells Oracle Hardware Installation Assistant the password you wish to use for the administrator account set up during the installation of the Windows OS. Password must comply with Windows password standards.

Example: apit.windows.adminPasswd=myadminpassword

X (2003 only)
apit.windows.computerName
Tells Oracle Hardware Installation Assistant the computer name you wish to use for the server set up during the installation of the Windows OS.

Example: apit.windows.computerName=mycomputername

X (2003 only)
apit.windows.key
Tells Oracle Hardware Installation Assistant the product key for your retail copy of the Windows OS. Required during Windows installation.

Example: apit.windows.key=XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

X (2003 only)
apit.windows.orgName
Tells Oracle Hardware Installation Assistant the organization name you wish to use for the server set up during the installation of the Windows OS.

Example: apit.windows.orgName=myorganization

X (2003 only)
apit.windows.userName
Tells Oracle Hardware Installation Assistant the user name you wish to use for the initial user account set up during the installation of the Windows OS.

Example: apit.windows.userName=myusername

X (2003 only)
apit.done.notifyUrl
Tells Oracle Hardware Installation Assistant to access the specified URL following the completion of enabled Oracle Hardware Installation Assistant tasks. This is currently only supported for Sun N1 System Manager.

Example: apit.done.notifyUrl=http://my_destination_url

See Also: