Installing localupdate

This document describes how to install sup and depot on a new machine. This will generally be done shortly after installing the operating system.

Requirements

System requirements:

• A Unix workstation running a supported version of Unix (currently NetBSD, Digital Unix, and Solaris.)
• A TCP/IP network link to the Internet. The workstation's TCP/IP must be correctly configured.
• Sufficient disk space. This varies between systems; however, 100 Mb should be sufficient.

Human requirements:

• A system administrator who has root or sudo privileges on the workstation.

Current disk requirements:

These numbers are correct as of January 1996.

Installation

1. Login to the machine you are configuring and become root. If you do not have root access you must preceed all of the following commands with sudo.
2. Type mkdir /usr/local on a hard drive with sufficient free space (see the table above for how much space you will need). This directory might already exist.
3. Type mkdir /usr/local/depot directory and then CD into it.
4. FTP to sup.pps.pgh.pa.us.
5. CD into /depot/lib/[machinetype]Where machinetype is the type of machine you are setting up.
6. Get depot.cup, custom.depot sup, and depot from this directory. Put sup and depot in /tmp and the other two in /usr/local/depot.

   # cd /tmp
   # mkdir /usr/local
   # mkdir /usr/local/depot
   # cd /usr/local/depot
   # ftp sup.pps.pgh.pa.us
   Connected to sup.pps.pgh.pa.us.
   220 sup.pps.pgh.pa.us FTP server (Version 6.00) ready.
   Name (sup.pps.pgh.pa.us:bob): bob
   331 Password required for bob.
   Password: Bobs_Password
   230 User bob logged in.
   Remote system type is UNIX.
   Using binary mode to transfer files.
   ftp> cd /depot/lib/bsdi
   250 CWD command successful.
   ftp> binary
   200 Type set to I.
   ftp> get sup
   local: sup remote: sup
   200 PORT command successful.
   150 Opening BINARY mode data connection for 'sup' (57340 bytes).
   226 Transfer complete.
   57340 bytes received in 1.49 seconds (38572 bytes/s)
   ftp> get depot
   local: depot remote: depot
   200 PORT command successful.
   150 Opening BINARY mode data connection for 'depot' (106496 bytes).
   226 Transfer complete.
   106496 bytes received in 3.81 seconds (27963 bytes/s)
   ftp> get depot.sup
   local: depot.sup remote: depot.sup
   200 PORT command successful.
   150 Opening BINARY mode data connection for 'depot.sup' (57340 bytes).
   226 Transfer complete.
   57340 bytes received in 1.49 seconds (38572 bytes/s)
   ftp> get custom.depot
   local: custom.depot remote: custom.depot
   200 PORT command successful.
   150 Opening BINARY mode data connection for 'custom.depot' (106496 bytes).
   226 Transfer complete.
   106496 bytes received in 3.81 seconds (27963 bytes/s)
   ftp> quit
   221 Goodbye.
   #

7. You will now need to run sup in order to move all of the files to your local machine.
   Type sub -f depot.sup
   This will take anywhere from 30 minutes to a day, depending on the speed of your link.
8. Build the initial (empty) depot database by typing
   Type /tmp/depot -B
   Install the files for your architecture. This example assumes you are installing under BSDI.
   Type /tmp/depot -f netbsd.list
9. Install the standard (machine-independent) files.
   Type /tmp/depot -f std.list
10. You now have to create a subdirectory of /usr/local/depot called site. You will then have to create a file called localfiles. Do this by typing:
    mkdir site
    mkdir site/localfiles
    pico site.list (or vi or emacs, your choice for the editor)
    type (inside of the editor) "localfiles" and then save the file]
11. Copy any *.samp files from the /usr/local directories into the /usr/local/depot/site/localfiles directories (removing .samp ending as you do so). Customize them as necessary. Look in lib, sbin, and etc/httpd for .samp files. An example is below.

    # cd /usr/local/depot/site/localfiles
    # mkdir lib
    # cd lib
    # cp /usr/local/lib/*.samp .
    # ls
    account.conf.samp   smb.conf.samp
    # mv account.conf.samp account.conf
    # mv smb.conf.samp smb.conf
    # pico account.conf
    (Make any local changes)
    # pico smb.conf
    (Make any local changes)
    # 

12. Type localupdate. This will install the localfiles package and will make sure the system is functioning properly.

     

If this completed succesfully then you should now have a full installation of all the associated software packages for your machine type. If you run into problems with this please give the Technical Staff a call.

Return to Using SUP and Localupdate

Revision 2.0:April 26, 1996:CJR