JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Sun Installation Assistant 2.2 User's Guide for the Sun Fire X4640 Server     Sun Fire X4640 Server Documentation Library
search filter icon
search icon

Document Information

Preface

Product Information Web Site

Related Books

About This Documentation (PDF and HTML)

We Welcome Your Comments

Change History

Introduction to Sun Installation Assistant

Getting Started With Sun Installation Assistant 2.2

SIA Version 2.2 Features and Benefits

SIA Task List

Server Support and SIA Media Availability

Supported Operating Systems

Starting SIA and Preparing for Deployment or Recovery Tasks

Local and Remote Media Options

Mouse Settings When Using SIA with ILOM Remote Console

How to Start SIA and Prepare for Tasks Using Local or Remote Media

Installing Linux With SIA

How to Install Linux With SIA Using Local or Remote Media

Using SIA to Upgrade System Firmware

How to Upgrade the System BIOS and ILOM Firmware

How to Upgrade HBA Firmware

Performing an SIA PXE-Based Attended Installation

How to Create the SIA Image and Prepare for PXE Boot

How to Boot SIA From a PXE Server for an Attended Installation

Performing an SIA PXE-Based Unattended Installation

Contents of the SIA State File

Preparing for an Unattended SIA Installation of Linux

Preparing for an Unattended SIA Firmware Upgrade

How to Create the SIA Image and Prepare for PXE Boot

How to Boot SIA From a PXE Server and Perform an Unattended Installation

Observing an SIA PXE-Based Unattended Installation

Set Up Passwords for Root and Virtual Access

Using a System Console

Using a Virtual Console or Secure Shell (SSH) Connection

Using a VNC Viewer

Using a Serial Console

Troubleshooting SIA

SIA Error Messages

SIA Installation Log File

ILOM Remote Console Mouse Issue With SIA

Debugging Unattended Installation Problems

Creating a Bootable SIA USB Flash Drive

Requirements

Getting the Software

Preparing the USB Flash Drive

Setting BIOS Parameters and Booting Off the SIA USB Flash Drive

Index

Contents of the SIA State File

The SIA state file provides the scripting variables required for carrying out an unattended session of SIA and performing the specified SIA tasks automatically without user intervention. A copy of the state file with all of the possible parameters can be found at the root level on the SIA CD and is accessible by command prompt during an SIA session.

To access the command prompt from SIA, do the following:

  1. Boot SIA (locally or through the remote console).

  2. At the first screen, press Ctrl-Alt-F2.

    A command prompt will be displayed.

  3. At the command prompt enter the command:

    # cd /root# ls

    Look for the externalStateVariables.txt file.

    The following table describes the state file variables for the automated tasks that may 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 may show variables breaking across multiple lines.


Table 1 SIA State File Variables

Variable
Description (Defaults in Bold)
Required for Linux Install
Required for Firmware Upgrade
apit.unattended
Tells SIA to run in unattended mode. Values supported: true | false

Example: apit.unattended=true

X
X
apit.welcome.acceptlicense
Accepts the SIA license agreement. Values supported: true | false

Example: apit.welcome.acceptlicense=true

X
X
apit.remoteUpdate
Tells SIA to look for SIA software updates. Sun highly recommends performing a remote update to ensure you always install the latest software and firmware. Values supported: true | false

Example: apit.remoteUpdate=true

X
X
apit.remoteUpdateURL
If you specified “true” for remoteUpdate, tells SIA where to look for SIA software updates. Values supported: Any URL with updated SIA content files. You only need to specify this variable if you are not using the default url.

Default url: http://sia-updates.sun.com/remoteUpdate

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 SIA it has permission to work over the network. If true, SIA will configure network settings based on networkconfig variables. Values supported: true | false

Example: apit.networking=true

X
X
apit.networkconfig.needNetwork
If you specified “true” for network, tells SIA 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)
apit.networkconfig.activeNic
If you specified “true” for network, tells SIA which network interface is connected to the active network. Values supported: eth0 | eth1 | eth2 | eth3 ... etc.

Example: apit.networkconfig.activeNic=eth0

X (if networking is true)
X (if networking is true)
apit.networkconfig.NetworkType
If you specified “true” for network, tells SIA 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)
apit.networkconfig.useDHCP
If you selected “dhcp” as the NetworkType, tells SIA 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)
apit.networkconfig.ipfield
If you selected “static” as the NetworkType, tells SIA 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)
apit.networkconfig.gatewayField
If you selected “static” as the NetworkType, tells SIA 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)
apit.networkconfig.netmaskedField
If you selected “static” as the NetworkType, tells SIA 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)
apit.http_proxy
If, for example, you specified “true” for remoteUpdate, tells SIA 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)
apit.taskList.selectedTask
Tells SIA 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 | Operating System Installation | HBA Firmware Upgrade | Expander Firmware Upgrade | SP Recovery

Example: apit.taskList.selectedTask=Operating System Installation

X
X
apit.osid.installLoc
Tells SIA where the network image of the Linux operating system 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 SIA where the CD or .iso file for the OS installation software is located. Values supported: cdrom | networkLinux

Example: apit.osid.installMedia=cdrom

X
apit.osid.installMethod
Tells SIA which file transfer protocol to use during the installation. Values supported: http | ftp | nfs

Example: apit.osid.installMethod=http

X
apit.osid.kickstart
Tells SIA 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

apit.osid.kickstart=nfs://url_to_kickstart

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 SIA to enable or disable its firmware update function. Values supported: true | false

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

apit.firmware.spIP
Part of a firmware upgrade task. Tells SIA 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 SIA the password of the server’s service processor.

Example: apit.firmware.spIP=changeme

X
apit.done.notifyUrl
Tells SIA to access the specified URL following the completion of enabled SIA tasks. This is currently only supported for Sun N1 System Manager.

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