re-preinstall(1M)

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

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). 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 origi-
     nal 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  pro-
     cedure described in EXAMPLES.)

     re-preinstall creates a standard file system on  the  speci-
     fied 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 plat-
           form 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  subdirec-
           tory of a mounted Solaris CD or a Solaris CD copied to
           disk that re-preinstall uses to install the  JumpStart
           software.  The default is root (/), 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 on  a  System's
     Own Default Boot Disk

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

     1. From the ok prompt, boot  the  system  from  the  Solaris
        media CD or DVD in single-user mode:

        ok boot cdrom -s

     2. The following command installs the Jumpstart software  on
        the  System  default  boot  disk, c0t0d0s0 on a Solaris 9
        system:

        example# /usr/sbin/install.d/re-preinstall c0t0d0s1

     3. Reboot the slice:

        example# reboot disk:b

     Example 2: Installing the JumpStart Software on  a  System's
     Attached (non-boot) Disk

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

     1. Mount the Solaris CD or DVD if vold(1M) is not running or
        CD or DVD is not mounted.

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

     3. Use the uname(1) command (-i  option)  to  determine  the
        platform  name  of  the  system  that  will  use  the re-
        preinstalled disk

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

        The following command installs the JumpStart software  on
        the system's attached disk for a system with a Sun4u ker-
        nel architecture, and it  uses  the  Solaris  CD  or  DVD
        mounted with vold(1M) on a Solaris 9 system:

         example#  /cdrom/cdrom/s1/usr/bin/install.d/re-preinstall  -m
                   /cdrom/cdrom/s1 -k sun4u 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  attri-
     butes:

     ____________________________________________________________
   |        ATTRIBUTE TYPE       |        ATTRIBUTE VALUE      |
   | ____________________________|_____________________________|_
   |  Availability               |  SUNWcdrom   (Solaris    CD,|
   |                             |  SPARC Platform Edition)    |
   |_____________________________|_____________________________|

SEE ALSO

     uname(1),  eeprom(1M),  format(1M),   mount(1M),   vold(1M),
     attributes(5)

     Solaris 9 9/04 Installation Guide