home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 13 / CDA13.ISO / DOC / HOWTO / MINI / ADSM_BAC < prev    next >
Encoding:
Text File  |  1996-02-11  |  4.5 KB  |  150 lines
  1.   Linux ADSM Mini-Howto
  2.   by Thomas Koenig, Thomas.Koenig@ciw.uni-karlsruhe.de
  3.   $Date: 1996/01/03 14:29:28 $
  4.  
  5.   This document describes how to install and use a client for the com-
  6.   mercial ADSM backup system for Linux.
  7.   ______________________________________________________________________
  8.  
  9.   Table of Contents:
  10.  
  11.   1.      Introduction
  12.  
  13.   2.      Installing the iBCS module
  14.  
  15.   3.      Installing the ADSM client
  16.  
  17.   4.      Running the client
  18.  
  19.   5.      Known Problems
  20.   ______________________________________________________________________
  21.  
  22.   1.  Introduction
  23.  
  24.   ADSM is a network-based backup system, sold by IBM, in use at many
  25.   organizations.  There are clients for a large variety of systems
  26.   (different UNIX brands, Windows, Novell, Mac, Windows NT).
  27.   Unfortunately, at the time of this writing, there is no native Linux
  28.   version.
  29.  
  30.   You will have to use the SCO binary, and install the iBCS2-emulator
  31.   for running ADSM.  This description is for ADSM v2r1.
  32.  
  33.   2.  Installing the iBCS module
  34.  
  35.   The iBCS2 module is available from
  36.   ftp://tsx-11.mit.edu/pub/linux/BETA/ibcs2.  Get the most recent
  37.   version by getting the file ibcs-1.2-950721.tar.gz, unpacking it and
  38.   applying the patches ibcs-1.2-950808.patch1 and
  39.   ibcs-1.2-950828.patch2.
  40.  
  41.   If you run 1.2.13, you can then type "make" and install the iBCS
  42.   modlue with "insmod".
  43.  
  44.   To compile the iBCS module under kernel version 1.3.37, you have to
  45.   change all occurrences in the source of "current->sigaction" to
  46.   "current->sig->action" before compiling.
  47.  
  48.   To compile the iBCS module under kernel version 1.3.45, compile your
  49.   kernel with "-DCONFIG_MODVERSIONS" enabled, and add
  50.   "-DCONFIG_MODVERSIONS -D__NO_VERSIONS__" to the CFLAGS variable in
  51.   iBCSemul/Makefile.
  52.  
  53.   If you don't have them already, create the needed device files by
  54.   executing
  55.  
  56.   # ln -s /dev/null /dev/XOR
  57.   # ln -s /dev/null /dev/X0R
  58.   # mknod /dev/socksys c 30 0
  59.   # mknod /dev/spx c 30 1
  60.  
  61.   3.  Installing the ADSM client
  62.  
  63.   The SCO binary is supplied as three tar files, or disks.  Change to
  64.   the root directory, set your umask according to your policies, and
  65.   unpack them from there (as root).  In your Directory /tmp, you will
  66.   find an installation script; execute that.
  67.  
  68.   You will then have to hand-edit /usr/adsm/dsm.sys and
  69.   /usr/adsm/dsm.opt.  In dsm.sys, important lines to specify are:
  70.  
  71.      Servername
  72.         The name of the server
  73.  
  74.      TCPServeraddress
  75.         The fully qualified host name of the server
  76.  
  77.      NODename
  78.         Your own hostname
  79.  
  80.   In dsm.opt, you will have to specify
  81.  
  82.      Server
  83.         As before
  84.  
  85.      Followsymbolic
  86.         Wether or not to follow symbolic links (not a good idea, in
  87.         general)
  88.  
  89.      SUbdir
  90.         Wether to back up subdirectories (you usually want that)
  91.  
  92.      domain
  93.         The file systems to back up
  94.  
  95.   You will then have to create a SCO-compatible /etc/mnttab from your
  96.   /etc/fstab.  You can use the following Perl script, fstab2mnttab, for
  97.   this.
  98.  
  99.        ______________________________________________________________________
  100.        #!/usr/bin/perl
  101.  
  102.        $mnttab_struct = "a32 a32 I L";
  103.  
  104.        open(MTAB, "/etc/mtab") || die "Cannot open /etc/mtab: $!\n";
  105.        open(MNTTAB, ">/etc/mnttab") || die "Cannot open /etc/mnttab: $!\n";
  106.  
  107.        while(<MTAB>) {
  108.            next if /pid/;
  109.            chop;
  110.            /^(\S*)\s(\S*)\s(\S*)\s.*$/;
  111.            $device = $1;
  112.            $mountpt = $2;
  113.            $fstype = $3;
  114.            if($fstype ne "nfs" && $fstype ne "proc") {
  115.                $mnttab_rec =
  116.                    pack($mnttab_struct, $device, $mountpt, 0x9d2f, time());
  117.                syswrite(MNTTAB, $mnttab_rec, 72);
  118.                print "Made entry for: $device $mountpt $fstype\n";
  119.            }
  120.        }
  121.  
  122.        close(MNTTAB);
  123.        exit 0;
  124.        ______________________________________________________________________
  125.  
  126.   You do not need to install any shared libraries for these clients;
  127.   everything is linked statically.
  128.  
  129.   4.  Running the client
  130.  
  131.   There are two clients, dsm, which is an X11 interface, and dsmc, a
  132.   command-line interface.  Your computer centre will tell you how to run
  133.   it.  Some startup script at boot, for example
  134.  
  135.   dsmc schedule -quiet 2>&1 >/dev/null &
  136.  
  137.   will probably be required.
  138.  
  139.   5.  Known Problems
  140.  
  141.   Unfortunately, SCO can only deal with hostnames no longer than eight
  142.   characters.  If your hostname is longer, or fully qualified, you may
  143.   need to specify your hostname on the NODename line in
  144.   /usr/adsm/dsm.sys.
  145.  
  146.   If you use the DISPLAY variable, you will have to supply the fully
  147.   qualified host name (i.e. DISPLAY=host.full.do.main:0 instead of
  148.   DISPLAY=host:0).
  149.  
  150.