next up previous contents
Next: Installing an SGI client Up: Appendix: Athena Installation Instructions Previous: Installing a Sun client

Configuring a Sun install server

Note: A mkserv script has been written for this procedure.

[July 1993]
[Revised Oct 1993]
[Revised Dec 1993 - add warning about wildcard in /etc/bootparams]
[Revised Jan 1994 - fix typos, clarify]
[Revised Oct 1994 - to start from 7.7I base local on server]
[Revised Jun 1995 - adding left out instructions]
[Revised Nov 1995 - added CellServDB instructions]
These instructions are for configuring a Solaris "install server". All
necessary files are in this directory.

In particular:
	- Sparc classics that are to be installed (from an install
	  server) do not need to listed explicitly in the hosts
	  and bootparams files. However, ipx's and 4c's do need
	  to listed explicitly.
	- Keep the files hosts.short and bootparams.short
	  up-to-date. Do not edit locally on the install server.
	  For changes and additions, edit here, then copy locally to
	  the install server. (That way, we maintain up-to-date copies
	  in afs, where they get backed up.)

1) Install Athena software on the install server itself. Note: The install
   server itself must be a Sun.

2) Since we don't have 'mkserv ops' yet, do a few things to allow remote
   access: 

  a) edit /etc/athena/inetd.conf to make klogin and eklogin unswitched
  b) kill and restart /etc/athena/inetd
  c) edit a .klogin file.
  d) get a srvtab.
  e) edit /etc/athena/rc.conf
      set PUBLIC = false
      set AUTOUPDATE = false
  g) change root passwd using /bin/passwd and cp the /etc/{passwd,shadow}
	files to the {local,std} ones
2a)  We have mkserv ops for Solaris so section 2 is obsolete.

3) Check that /var has at least 20Mb free

4) Set up the install areas:
	- make directories /var/ops/new
			   /var/ops/new4c
			   /var/ops/exec
			   /tftpboot
	- chmod them all to 755

4.5) At this point, you should reboot and make sure the following things
	work. If they work, you can do the rest remotely.
		- console login
		- root login
		- make sure root password is what you set it to
		- authenticated remote klogin

5) Kinit and 'attach bootkit'

   - Set up for installing Sparc classic's:
	cd /var/ops/new
	cp /mit/bootkit/netboot/solaris/tar.4m.Z .
	uncompress tar.4m.Z && tar xf tar.4m
	(if everything looks ok, rm tar.4m)

   - Set up for installing ipx's and 4c's:
	cd /var/ops/new4c
	cp /mit/bootkit/netboot/solaris/tar.4c.Z .
	uncompress tar.4c.Z && tar xf tar.4c
	(if everything looks ok, rm tar.4c)

   - Set up the exec directory:
	cd /var/ops/exec
	cp /mit/bootkit/netboot/solaris/tar.exec .
	tar xf tar.exec
	(if everything looks ok, rm tar.exec)
5a)

   Check that /var/ops/new*/afsin has an uptodate CellServDB and SUIDCells
  (check against /afs/athena/service files )

6) Edit /var/ops/new/etc/vfstab and /var/ops/new4c/etc/vfstab to reflect
   the new server and right filesytem.
	Example: These are the current [July 7 1993] files on solar:
	solar# more /var/ops/new/etc/vfstab
	solar:/var/ops/new      -       /       nfs     -       -       rw
	solar:/var/ops/exec/Solaris_2.3_sparc.all/usr   -       /usr    nfs     -       -       ro
	/proc   -       /proc   proc    -       no      -
	swap    -       /tmp    tmpfs   -       yes     -

	solar# more /var/ops/new4c/etc/vfstab
	solar:/var/ops/new4c    -       /       nfs     -       -       rw
	solar:/var/ops/exec/Solaris_2.3_sparc.all/usr   -       /usr    nfs     -       -       ro
	/proc   -       /proc   proc    -       no      -
	swap    -       /tmp    tmpfs   -       no      -

7) Create an appropriate /etc/dfs/dfstab:
	cd /etc/dfs
	cp /mit/bootkit/netboot/solaris/dfstab dfstab.new
	(edit the dfstab.new file, then when it looks ok rename it to dfstab)
	Example: This is from the current dfstab file on solar:
	share -F nfs -o ro  /var/ops/exec/Solaris_2.3_sparc.all/usr
	share -F nfs -o ro /var/ops/new
	share -F nfs -o ro /var/ops/new4c
        cd /etc/dfs
        cp /mit/bootkit/netboot/solaris/sharetab sharetab.new
       (edit the sharetab.new file, then when it looks ok rename it to sharetab)
        Example: This is from the current sharetab file on solar:
        /var/ops/exec/Solaris_2.3_sparc.all/usr -       nfs     ro
        /var/ops/new    -       nfs     ro
        /var/ops/new4c  -       nfs     ro

8) Get a hosts file. This file must contain two lines for the install server
   itself, and a line for each ipx or 4c that will be installed from it.
	cd /etc/inet
	cp -p /mit/bootkit/netboot/solaris/hosts.short hosts
   	Example: These are from solar:/etc/hosts:
		127.0.0.1       localhost
		18.159.0.28     solar
		18.172.0.202    jfk
		
	Note: The file needs to have localhost, the sunboot servers, and
	      the list of all ipx's we know about.  If adding another
              server other than Solar and Solar2 you need to have the
              host name and IP address in the /etc/hosts file.

8.5) Check that /var/ops/{new,new4c}/etc/hosts are linked to /etc/inet/hosts

9) Get a bootparams file. This file must contain a line for each
   ipx or 4c that will be installed (the same ones that must be listed in
   /etc/hosts), and a single line for all Sparc classics.
	cd /etc
	cp -p /mit/bootkit/netboot/solaris/bootparams.short bootparams
	Example: These are from solar:/etc/bootparams:
		jfk     root=solar:/var/ops/new4c swap=: dump=:
		*       root=solar:/var/ops/new swap=:  dump=:
	NOTE: DO NOT USE "*" wildcard unless the server is on a subnet with
	no non-Athena Sun workstations. For example, do not use on a server
	on 18.172. It will interfere with the normal booting of those 
	non-Athena Suns.

10)  In order to make NFS start up on the sun do the following:
	% mv /etc/rc3.d/s15nfs.server /etc/rc3.d/S15nfs.server
	% reboot
     Make sure that after rebooting ('ps -ef'):
   	- rpc.bootparamd , nfsd and mountd are running
	  (To get debug messages from rpc.bootparamd,
	    kill rpc.bootparamd and restart /usr/sbin/rpc.bootparamd -d)

11) Check that remote klogins work. 

12) To test that a machine with hostname bar is going to install properly,
    login on the install server and run:
	/sbin/hostconfig -n -v -f bar -p bootparams 
    This should return :
		From [x.x.x.x]: hostname = bar
                ypdomain =
                router = 18.172.0.1 (or 0.0.0.0)

13) Verify that the /var/ops/{new,new4c}/sbin/athenainstall files are correct.

14) Verify the links pointing from /var/ops/{new,new4c}/srvd point to the
	right pack. E.g.:
		/afs/athena/system/sun4c_53/srvd.77

15) Now, after all that, are you feeling lucky? 8-) Install an Athena Sun
	workstation using your new sun install server!

16) Update this README file if there are any changes!

					Miki Lusztig
					(edited by Anne Salemme)
                                        (updated by Brian Melanson 10.05.93)
					(updated by Anne Salemme 01.26.94)
					(updated by Miki and Anne 10.18.94)
                                        (updated by Brian Melanson 06.28.95)



Team Athena