Go to main content

Automatically Installing Oracle® Solaris 11.4 Systems

Exit Print View

Updated: July 2019
 
 

Client Boot Errors

This section describes errors that might occur during booting. The errors are further sorted according to platforms.

Boot Disk Not Found

If the boot disk is not found during an automated installation, verify the book disk and modify the AI manifest.

  1. Select the boot device explicitly in SPARC OBP or in the x86 BIOS.

  2. Reboot the system.

  3. Log in to the system being installed.

  4. Identify the device to be used during the installation. The device is can be identified by the SYS/HDD* receptacle name or the CTD disk name as displayed in the format command.

  5. Modify the /system/volatile/ai.xml manifest and replace the "boot_disk" value. For example:

    <disk_keyword key="SYS/HDD1" name_type="receptacle"/>  
      
    <disk_keyword key="c0t5000CCA012B2A254d0" name_type="ctd"/> 
      
  6. Refresh the installation service.

    # svcadm clear auto-installer 
      

Related to this issue, when you are installing in UEFI mode, the boot disk cannot be located even if a disk is specified in the AI manifest's target boot_disk section. This limitation in UEFI installation means that if nothing is installed on the system yet, you cannot use the boot_disk section in the manifest to identify a boot disk. As a workaround, use a derived manifest specify an alternative installation target disk.

SPARC Network Booting Errors and Possible Causes

Timed out Waiting for BOOTP/DHCP Reply

If a DHCP server is not responding to a SPARC client's request, the following messages display:

   ...
   OpenBoot 4.23.4, 8184 MB memory available, Serial #69329298.
   Ethernet address 0:14:4f:21:e1:92, Host ID: 8421e192.
   Rebooting with command: boot net:dhcp - install
   Boot device: /pci@7c0/pci@0/network@4:dhcp  File and args: 
   1000 Mbps FDX Link up
   Timed out waiting for BOOTP/DHCP reply
   Timed out waiting for BOOTP/DHCP reply
   Timed out waiting for BOOTP/DHCP reply
   Timed out waiting for BOOTP/DHCP reply

The timeout message indicates that the client is sending a DHCP request and no response has been made to that request. This error is probably caused by a DHCP configuration problem. Check whether your client is configured correctly in the DHCP server.

Boot Load Failed

If the client starts downloading the boot_archive, but then fails with the error, "Boot load failed", that indicates that the client DHCP information is configured incorrectly.

Rebooting with command: boot net:dhcp - install
   Boot device: /pci@7c0/pci@0/network@4:dhcp  File and args: 
   1000 Mbps FDX Link up
   HTTP: Bad Response: 500 Internal Server Error
   Evaluating: 

   Boot load failed

This error could happen if another DHCP server is responding to the client. Check the DHCP configuration for this client. If the configuration appears to be correct, determine whether another DHCP server is in the subnet.

Internal Server Error or WAN Boot Alert

    After the client has obtained the IP address and initial parameters to start downloading the boot archive, the client might be unable to find or download the boot_archive.

  • If the client cannot find the boot_archive, the following error is displayed:

    Rebooting with command: boot net:dhcp - install
          Boot device: /pci@7c0/pci@0/network@4:dhcp  File and args: 
          1000 Mbps FDX Link up
          <time unavailable> wanboot info: WAN boot messages->console
          <time unavailable> wanboot info: Starting DHCP configuration
          <time unavailable> wanboot info: DHCP configuration succeeded
          <time unavailable> wanboot progress: wanbootfs: Read 366 of 366 kB (100%)
          <time unavailable> wanboot info: wanbootfs: Download complete
          Mon Aug  5 20:46:43 wanboot alert: miniinfo: Request returned code 500
          Mon Aug  5 20:46:44 wanboot alert: Internal Server Error \
    (root filesystem image missing)
  • If the client finds the boot_archive file but cannot access the file, then the following error is displayed:

    Rebooting with command: boot net:dhcp - install
          Boot device: /pci@7c0/pci@0/network@4:dhcp  File and args: 
          1000 Mbps FDX Link up
          <time unavailable> wanboot info: WAN boot messages->console
          <time unavailable> wanboot info: Starting DHCP configuration
          <time unavailable> wanboot info: DHCP configuration succeeded
          <time unavailable> wanboot progress: wanbootfs: Read 366 of 366 kB (100%)
          <time unavailable> wanboot info: wanbootfs: Download complete
          Mon Aug  5 20:53:02 wanboot alert: miniroot: Request returned code 403
          Mon Aug  5 20:53:03 wanboot alert: Forbidden

For both of these problems, fix the boot_archive file configured for this client. Check the pathname and permissions of the boot_archive at $IMAGE/boot/boot_archive.

ERROR 403: Forbidden or ERROR 404: Not Found

The messages ERROR 403: Forbidden and ERROR 404: Not Found are displayed if the client successfully downloads the boot_archive and boots the Oracle Solaris kernel but fails to get one of the image archives. An error message is displayed indicating which file is causing the problem. For example, in the following output on a SPARC client, the solaris.zlib file does not exist or is not accessible at the specified location:

<time unavailable> wanboot info: Starting DHCP configuration
<time unavailable> wanboot info: DHCP configuration succeeded
<time unavailable> wanboot progress: wanbootfs: Read 368 of 368 kB (100%)
<time unavailable> wanboot info: wanbootfs: Download complete
Mon May  5 18:57:36 wanboot progress: miniroot: Read 235737 of 235737 kB (100%)
Mon May  5 18:57:36 wanboot info: miniroot: Download complete
SunOS Release 5.11 Version 11.4 64-bit
Copyright (c) 1983, 2015, Oracle and/or its affiliates. All rights reserved.
Remounting root read/write
Probing for device nodes ...
Preparing network image for use
Downloading solaris.zlib
--2015-05-05 18:52:30--  http://203.0.113.67:5555/export/auto_install/11_4_sparc/solaris.zlib
Connecting to 203.0.113.67:5555... connected.
HTTP request sent, awaiting response... 404 Not Found
2015-05-05 18:52:30 ERROR 404: Not Found.

Could not obtain http://203.0.113.67:5555/export/auto_install/11_4_sparc/solaris.zlib from install server
Please verify that the install server is correctly configured and reachable from the AI client

    This problem can be caused by one of the following conditions:

  • The image path configured in WAN boot is not correct.

  • The image path does not exist or is incomplete.

  • Access is denied due to permission issues.

Check your DHCP configuration or the contents of the net image you specified when you ran installadm create-service. Check your WAN boot configuration.

Automated Installer Not Started

When installing Oracle Solaris on your client, you need to include the install argument when you boot in order to initiate an installation:

ok boot net:dhcp - install

If you boot without the install boot argument, the SPARC client boots into the automated installer boot image but the installation does not start. See Starting an Automated Installation from the Command Line for instructions about how to start an automated installation from this point.

Invalid HMAC Value

    If you see the message Invalid HMAC value on the SPARC console shortly after booting a SPARC client, and the system returns to the ok prompt, one of the following conditions caused the problem:

  • The client is secured by authentication, but you have not set the OBP keys. The solution is to set the OBP keys in the client firmware. For information about authentication, see Overview of Securing Automated Installations.

  • The client's install service has a policy requiring client authentication, but no credentials applicable to the client have been assigned. Be sure that there are credentials available for all clients of services with policy require-client-auth.

The following steps show how to identify the problem.

  1. Verify that security hasn't been disabled for the AI server. Use installadm list -sv to see if security is enabled.

  2. Verify that security hasn't been disabled for the client's install service. Use installadm list -vn svcname to see if security not disabled.

  3. If the client is using custom credentials, use installadm list -ve macaddr to obtain the firmware key values.

  4. If the client is not a custom client, use installadm list -vn default-sparc to see if there are any firmware keys defined for the default-sparc service.

  5. Check the policy of the client's service with installadm list -vn svcname.

  6. If there are no credentials for the default-sparc service, look for default client credentials using the installadm list -sv command. If there are default client credentials, then use the firmware keys listed for the default client.

  7. If there are no default client credentials, use installadm list -vn default-sparc to see if the service policy is set to require-server-auth. If so, use the firmware keys listed for the default client in installadm list -sv.

x86 Network Booting Errors and Possible Causes

X86 System Will Not Boot After Install

The UEFI specification forbids EFI protective MBR partition from being marked as active, but your BIOS implementation requires that at least one hard disk have at least one MBR partition that's marked as bootable/active to boot in BIOS mode. Use the fdisk utility to set the partition's status to be "ACTIVE".

No DHCP or ProxyDHCP Offers Were Received

If a DHCP server is not responding to an x86 client's request, you see the following messages:

Intel(R) Boot Agent PXE Base Code (PXE-2.1 build 0.86)
   Copyright(C) 1997-2007, Intel Corporation

   CLIENT MAC ADDR 00 14 4F 29 04 12 GUID FF2000008 FFFF FFFF FFFF 7BDA264F1400
   DHCP......... No DHCP or ProxyDHCP offers were received
   PXE-MOF: Exiting Intel Boot Agent

The timeout message indicates that the client is sending a DHCP request and not getting a response. This issue is probably due to an error in the DHCP configuration. Check whether your client is configured correctly in the DHCP server.

TFTP Error or System Hangs After GATEWAY Message

    The DHCP server provides an IP address and a location of the initial boot program as part of the DHCP response.

  • If the boot program does not exist, then the client boot cannot proceed. The following message is displayed:

    Intel(R) Boot Agent PXE Base Code (PXE-2.1 build 0.86)
         Copyright(C) 1997-2007, Intel Corporation
    
         CLIENT MAC ADDR 00 14 4F 29 04 12 GUID FF2000008 FFFF FFFF FFFF 7BDA264F1400
         CLIENT IP: 203.0.113.0/24   MASK: 198.51.100.0/24    DHCP IP:  203.0.113.0/24
         GATEWAY:203.0.113.0/24     TFTP.
         PXE-T02:    Access Violation
         PXE-E3C: TFTP Error - Access violation
         PXE-MOF: Exiting Intel Boot Agent
  • If the boot program exists but it is an incorrect program, the client hangs after displaying this message:

    Intel(R) Boot Agent PXE Base Code (PXE-2.1 build 0.86)
         Copyright(C) 1997-2007, Intel Corporation
    
         CLIENT MAC ADDR 00 14 4F 29 04 12 GUID FF2000008 FFFF FFFF FFFF 7BDA264F1400
         CLIENT IP: 198.51.100.0/24   MASK: 198.51.100.0/24    DHCP IP:  203.0.113.0/24
         GATEWAY: 203.0.113.0/24

System Hangs After GRUB Menu Entry is Selected

If the client is able to do the initial boot but the kernel cannot be booted, the system hangs after you select the entry from the GRUB menu.

On the AI server, check whether the grub.cfg file or the menu.lst file for this client is pointing to a valid boot archive. The boot directory of the image on the AI server should be loopback-mounted under the /etc/netboot directory as shown in this sample excerpt from df -k for the image path shown by installadm list:

Filesystem      1K-blocks      Used Available Use% Mounted on
/export/auto_install/solaris11_4-i386
                 92052473  36629085  55423388  40% /etc/netboot/default-i386
/export/auto_install/solaris11_4-i386
                 92052473  36629085  55423388  40% /etc/netboot/solaris11_4-i386

HTTP Request Sent Results in 403 Forbidden or 404 Not Found

On the AI server, if one of the install programs is inaccessible or does not exist in the location specified in the grub.cfg file or the menu.lst file under /etc/netboot, then the client is able to boot, but is not able to download that file. An error message is displayed indicating which file is causing the problem. For example, in the following output on an x86 client, the solaris.zlib file does not exist at the specified location:

SunOS Release 5.11 Version 11.4 64-bit
Copyright (c) 1983, 2015, Oracle and/or its affiliates. All rights reserved.
Remounting root read/write
Probing for device nodes ...
Preparing network image for use
Downloading solaris.zlib
--2015-05-05 20:02:26--  http://203.0.113.0/24/export/auto_install/solaris11_4-i386/solaris.zlib
Connecting to 203.0.113.66:5555... connected.
HTTP request sent, awaiting response... 404 Not Found
2015-05-05 20:02:26 ERROR 404: Not Found.

Could not obtain http://203.0.113.0/24/export/auto_install/solaris11_4-i386/solaris.zlib from install server
Please verify that the install server is correctly configured and reachable from the client

Requesting System Maintenance Mode
(See /lib/svc/share/README for more information.)
Console login service(s) cannot run

Check the contents of the target directory that you specified when you ran the installadm create-service command.

Automated Installer Not Started

When installing Oracle Solaris on x86 systems for installations that boot over the network, you must select the second entry in the GRUB boot menu to initiate an automated installation. Typically, the menu entries display as follows:

Oracle Solaris 11.4 Text Installer and command line
Oracle Solaris 11.4 Automated Install

If you selected the first GRUB menu entry or allowed the prompt to time out, the system boots into the automated install boot image but the installation does not start. See Starting an Automated Installation from the Command Line for instructions about how to start an automated installation from this point.