Example: Creating a Custom Install Client

The following example illustrates a specific case where you set up an x86 client that references a specific install service name and a specific source image location.

Use the following example command.

# installadm create-client -b "console=ttya" -e 0:e0:81:5d:bf:e0 \
-t /export/aiserver/osol-0906-ai-x86 -n 0906x86

The terminal displays the following output:

Setting up X86 client...
Service discovery fallback mechanism set up

Detected that DHCP is not set up on this server.
If not already configured, please create a DHCP macro
named 0100E0815DBFE0 with:
   Boot server IP (BootSrvA) : 10.6.68.29
   Boot file      (BootFile) : 0100E0815DBFE0
If you are running Sun's DHCP server, use the following
command to add the DHCP macro, 0100E0815DBFE0:
   /usr/sbin/dhtadm -g -A -m 0100E0815DBFE0 -d \
:BootSrvA=10.6.68.29:BootFile=0100E0815DBFE0:GrubMenu=menu.lst.0100E0815DBFE0:

Note: Be sure to assign client IP address(es) if needed
(e.g., if running Sun's DHCP server, run pntadm(1M)).

Using the -b option, the command sets the console value, console=ttya, in the client-specific menu.lst file in /tftpboot.
Using the -e option, the command specifies the MAC address, 0:e0:81:5d:bf:e0, of a particular client that you want to customize.
Using the -n option, the command specifies an install service name, 0906x86, that you want the client to use for installation.
Using the -t option, the command specifies the path, /export/aiserver/osol-0906-ai-x86, for a net image that you want to be used for the installation.

Note - This net image was created when you set up an install service by using the installadm create-service command.

You can view the DHCP configuration results in the DHCP table in the DHCP Manager by using the /usr/sadm/admin/bin/dhcpmgr utility.

Go to the /tftpboot directory and view the results of the command as follows.

# cd /tftpboot
# ls -l
lrwxrwxrwx  13:23 0100E0815DBFE0 -> pxegrub.I86PC.OpenSolaris-1
drwxr-xr-x  13:26 I86PC.OpenSolaris-1
-rw-r--r--  13:23 menu.lst.0100E0815DBFE0
-rwxr-xr-x  13:23 pxegrub.I86PC.OpenSolaris-1
-rw-r--r--  13:23 rm.0100E0815DBFE0

# cat menu.lst.0100E0815DBFE0
default=0
timeout=30
min_mem64=1536
title OpenSolaris 0906x86
        kernel /I86PC.OpenSolaris-1/platform/i86pc/kernel/unix -B 
console=ttya,install_media=http://135.134.0.10.:5555:/export/aiserver/osol-0906-ai-x86,
install_boot=http://135.134.0.10.:555:/export/aiserver/osol-0906-ai-x86/boot,
install_service=0906x86,livemode=text
       module /I86PC.OpenSolaris-1/x86.microroot

See the following additional examples about how to set up custom x86 and SPARC clients: