re-preinstall(1M)

NAME

re-preinstall − installs the JumpStart software on a system

SYNOPSIS

/usr/sbin/install.d/re-preinstall target-slice

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

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

AVAILABILITY

re-preinstall exists only on the 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.

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 16 Mbytes. If sufficient space is not available, re-preinstall fails with the following message:

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

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

OPTIONS

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

−k karch Kernel architecture of the system that will use the disk with the JumpStart software. The default is the kernel architecture of the system running re-preinstall. (Use the uname −m command to determine a system’s kernel architecture.)

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# /usr/sbin/install.d/re-preinstall c0t3d0s0

Perform the following steps to run re-preinstall on a system and install the JumpStart software on an attached disk for another system:

1. Mount the Solaris CD.

2. Use the format(1M) command to determine the target-slice where JumpStart will be installed.

3. Determine the kernel architecture of the system that will use the re-preinstalled disk.

4. Run re-preinstall with the −m cdrom-mnt-pt option if the Solaris CD is not mounted on the /cdrom directory.

For example, the following command installs the JumpStart software on the system’s attached disk for a system with a sun4c kernel architecture, and it uses the Solaris CD mounted on the /mnt directory:

example# /cdrom/export/exec/sparc.Solaris_2.4/sbin/install.d/re-preinstall \
−m /mnt −k sun4c c0t2d0s0

Museum

Related Articles