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