SunOS man pages


	www.sun.com	docs.sun.com \| \| \|

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

System Administration Commands

re-preinstall(1M)

DESCRIPTION
OPTIONS
OPERANDS
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

NAME

re-preinstall - installs the JumpStart software on a system

SYNOPSIS

cdrom-mnt-pt/Solaris_XX/Tools/Boot/usr/sbin/install.d/re-preinstall [-m Solaris_boot_dir] [-k platform_name] target-slice

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). When you turn on a re-preinstalled system, the system looks for the JumpStart software on the system's default boot disk. All new SPARC systems have the JumpStart software already preinstalled. The XX in Solaris_XX is the version number of the Solaris release being used.

You can use the re-preinstall command in several ways. 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. (See the first procedure described in EXAMPLES.)

You can also run re-preinstall on a system to install JumpStart software on any attached disk (non-boot disk). After 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. (See the second procedure described in EXAMPLES.)

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

re-preinstall: target-slice too small xx Megabytes required

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:

-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(1) command (-i option) to determine a system's platform name.)
-m Solaris_boot_dir: Absolute path to the Solaris_XX/Tools/Boot subdirectory of a mounted Solaris CD or a Solaris CD copied to disk that re-preinstall uses to install the JumpStart software. The default is /cdrom/Solaris_XX/Tools/Boot, which is where the Solaris CD is mounted in single-user mode.

OPERANDS

The following operands are supported:

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

EXAMPLES

Example 1. Installing the JumpStart Software

The following procedure installs the JumpStart software on a system's own default boot disk:

From the ok prompt, boot the system from the Solaris CD (local or remote) in single-user mode:
ok boot cdrom -s
With the re-preinstall command, install the JumpStart software on the system's default boot disk, which is a slice on the disk (usually slice 0) where the system automatically boots. (The system's default boot disk is probably where the current root (/) file system is located, which can be determined with the format(1M) command.)
For example, the following command installs the JumpStart software on the system's default boot disk, c0t3d0s0 on a Solaris 2.6 system:
example# /cdrom/Solaris_2.6/Tools/Boot/usr/sbin/install.d\ /re-preinstall c0t3d0s0

The following procedure installs the JumpStart software on a system's attached disk (non-boot disk):

Mount the Solaris CD if vold(1M) is not running or CD is not mounted.
Use the format(1M) command to determine the target-slice where JumpStart will be installed.
Use the uname(1) command (-i option) to determine the platform name of the system that will use the re-preinstalled disk

Run re-preinstall with the -m Solaris_boot_dir option if the Solaris CD is not mounted on /cdrom.

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 with vold(1M) on a Solaris 2.6 system:

example# /cdrom/cdrom0/s0/Solaris_2.6/Tools/Boot/usr/bin\ 
               /install.d/re-preinstall\ 
               -m /cdrom/cdrom0/s0/Solaris_2.6/Tools/Boot\ 
               -k sun4c c0t2d0s0

EXIT STATUS

The following exit values are returned:

0: Successful completion.
1: An error has occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcdrom (Solaris CD, SPARC Platform Edition)