Maintenance Commands                            re-preinstall(1M)

NAME
     re-preinstall - installs the JumpStart software on a system

SYNOPSIS
     cdrom-mnt-pt/Solaris_2.6/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.

     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.   (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).
     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. (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

SunOS 5.8           Last change: 13 May 1997                    1

Maintenance Commands                            re-preinstall(1M)

           system's platform name.)

     -m Solaris_boot_dir
           Absolute path to the  Solaris_2.6/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
           /cdrom/Solaris_2.6/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:

     1. From the "ok" prompt, boot the system from the Solaris CD
        (local or remote) in single-user mode:

        ok boot cdrom -s

     2. 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 from. (The system's default boot disk
        is probably where the current root  (/)  file  system  is
        located, which can be determined with the format(1M) com-
        mand.)

        For example, the following command installs the JumpStart
        software on the system's default boot disk, c0t3d0s0:

        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):

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

SunOS 5.8           Last change: 13 May 1997                    2

Maintenance Commands                            re-preinstall(1M)

     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 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):

        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  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 8 Advanced Installation Guide

SunOS 5.8           Last change: 13 May 1997                    3