re-preinstall(1M)

NAME

re-preinstall − installs the JumpStart software on a system

SYNOPSIS

cdrom-mnt-pt/export/exec/arch.release/sbin/install.d/re-preinstall

[ −m cdrom-mnt-pt ] [ −k platform_name ] target-slice

AVAILABILITY

SUNWcdrom (Solaris CD).

DESCRIPTION

re-preinstall installs the JumpStart software (Preinstall Boot Image) on a system, so you can power-on the system and have it automatically install the Solaris software (perform a JumpStart installation on the system). Some new systems have the JumpStart software already preinstalled.

There are two ways to use the re-preinstall command. The most common way is to run re-preinstall on a system to install the JumpStart software on its own default boot disk. This is useful if you want to restore a system to its original factory conditions.

You can also run re-preinstall on a system to install JumpStart software on any attached disk. Once you install the JumpStart software on a disk, you can move the disk to a different system and perform a JumpStart installation on the different system. NOTE: While the command is valid for x86 systems, it is not useful because you cannot reboot with arguments.

re-preinstall creates a standard file system on the specified target-slice (usually slice 0), and re-preinstall makes sure there is enough space on the target-slice for the JumpStart software, which usually requires 26 Mbytes. If sufficient space is not available, re-preinstall fails with the following message:

re-preinstall: target-slice is less than 26 Megabytes, please reformat it.

You can use the format(1M) command to create sufficient space on the target-slice for the JumpStart software.

OPTIONS

The following options are supported:

−m cdrom-mnt-pt Absolute path, or mount point, to the Solaris CD. The default is /cdrom.

−k platform_name Platform name of the system that will use the disk with the JumpStart software. The default is the platform name of the system running re-preinstall. (Use the uname −i command to determine a system’s platform name.)

OPERANDS

The following operand is supported:

target-slice Device name of the disk slice where the JumpStart software will be installed (usually slice 0). For example, c0t3d0s0.

EXAMPLES

re-preinstall on a system and install the JumpStart software on its own default boot disk:

1. Boot the system from the Solaris CD in single-user mode at the "ok" prompt.

ok boot cdrom -s

2. When the system is in single-user mode, use the eeprom(1M) command to determine the system’s default boot disk. If no slice is specified for the system’s default boot disk, the system boots from slice 0 of the specified disk, by default.

Note that when you turn on a re-preinstalled system, the system looks for the JumpStart software on the disk slice that it boots from.

3. Run the re-preinstall command with only the target-slice argument; target-slice must be the device name of the disk you determined in Step 2. For example, the following command installs the JumpStart software on the system’s default boot disk, c0t3d0s0:

example# /cdrom/export/exec/sparc.Solaris_2.4/sbin/install.d/re-preinstall\
c0t3d0s0

EXIT STATUS

The following exit values are returned:

0 success

1 an error has occurred.

Museum

Related Articles