distrib/notes/shark/install

   1 .\"     $NetBSD: install,v 1.4 2008/10/29 17:01:50 tsutsui Exp $
   2 .\"
   3 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .
  28 The steps taken for installing
  29 .Nx*M
  30 are different for diskless and hard disk configurations.
  31 .Ss2 Installation for diskless configurations
  32 This section assumes you know how to configure DHCP, TFTP,
  33 and NFS services on your server.
  34 .Pp
  35 .(enum
  36 Place the kernel into the TFTP server's download area.
  37 If the kernel has a
  38 .Dq .gz
  39 suffix, you must first uncompress it using the
  40 .Pa gunzip
  41 program.
  42 .Pp
  43 .Dl server# Ic cp netbsd-GENERIC /tftpboot/netbsd-shark
  44 .Pp
  45 Note that your DHCP server must be configured to specify
  46 this file as the boot file for the client.
  47 .It
  48 Unpack the distribution sets into the client's root directory
  49 on the server.
  50 .Pp
  51 .Dl server# Ic cd /export/client/shark
  52 .Dl server# Ic gzcat .../base.tgz | tar xvpf -
  53 .Dl server# Ic gzcat .../etc.tgz | tar xvpf -
  54 .Dl [ repeat for all sets you wish to unpack ]
  55 .It
  56 Load the kernel from the TFTP server.
  57 .Pp
  58 .Dl ok Ic boot net
  59 .enum)
  60 .Pp
  61 The installation of your diskless
  62 .Nx*M
  63 system is now complete!
  64 You may now skip ahead to any post-installation instructions.
  65 .
  66 .Ss2 Installation onto a hard disk
  67 To install or upgrade
  68 .Nx*M
  69 on a hard disk, you need to first boot the installation
  70 program and then interact with the screen-menu program
  71 .Ic sysinst .
  72 The installation program actually consists of the
  73 .Nx
  74 kernel plus an in-memory file system of utility programs.
  75 .Pp
  76 If you have an existing
  77 .Nx
  78 installation on your hard disk,
  79 you may copy the special installation kernel into your existing
  80 root file system.
  81 .Pp
  82 .Dl client# Ic gzcat .../shark/installation/instkernel/netbsd.gz \*[Gt] /netbsd.inst
  83 .Pp
  84 You may then boot the installation kernel.
  85 .Pp
  86 .Dl ok Ic boot disk netbsd.inst
  87 .Pp
  88 If you do not have an existing
  89 .Nx
  90 installation, then you must load the installation kernel over the network.
  91 You must configure a DHCP and TFTP server in order to do this.
  92 .Pp
  93 Place the installation kernel into the TFTP server's download area.
  94 .Pp
  95 .Dl server# Ic gzcat .../shark/installation/instkernel/netbsd.gz \*[Gt] /tftpboot/shark-inst
  96 .Pp
  97 Note that your DHCP server must be configured to specify
  98 this file as the boot file for the client.
  99 .Pp
 100 You may then boot the installation kernel.
 101 .Pp
 102 .Dl ok Ic boot net
 103 .Pp
 104 Once the installation kernel has loaded, the
 105 .Ic sysinst
 106 installation program should launch automatically.
 107 .
 108 .
 109 .Pp
 110 .so ../common/sysinst