home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / netbck01.zip / READ.ME < prev   
Text File  |  1994-05-20  |  8KB  |  185 lines
  1.  
  2. This package is an OS/2 v2.x REXX based script to support Lan server
  3. PEER backups from a server using Sytos for OS/2.
  4.  
  5.    ------------------------------------------------------------------
  6.  
  7.   NOTE: I make no claims that this code will work for you as is. Its in use
  8.         in three of our LAN sites and works.  Feel free to modify
  9.         the exec in eny way you want.. You're on your own.
  10.         I'm no LAN guru so be gentle if you find glaring 'silly stuff' in 
  11.         this code..
  12.  
  13.         For those who want, I can be reached at:
  14.             
  15.             Compu$erve: 73677,1167
  16.             Internet:   Larry.Kalyniak@WPCUsrGrp.MB.CA
  17.  
  18.    ---------------------------------------------------------------------     
  19.  
  20. Files included should be:
  21.       NETBACK  DAT       89   5-18-94   2:32p
  22.       NETBACK  CMD    28718   5-18-94   2:28p
  23.       NEWTAPE  MAC      291   4-11-94   9:38a
  24.       APPEND   MAC      294   4-11-94   9:39a
  25.       READ     ME
  26.  
  27.    ---------------------------------------------------------------------
  28.  
  29. Required for operation:
  30.  
  31.    - SYTOS for OS/2
  32.    - IBM LAN Server 2.x/3.x
  33.    - PEER services installed on the required workstations.
  34.  
  35.    ---------------------------------------------------------------------
  36. Installation:
  37.  
  38.    1) Copy the NETBACK.CMD file into the SYPLUS directory.
  39.    2) Copy the NEWTAPE.MAC and  APPEND.MAC Sytos macros into
  40.       the SYPLUS\MAC subdirectory.
  41.    3) Edit the NETBACK.CMD REXX file and customize the 4 lines
  42.       (delimited by comment blocks at the start of the file)
  43.       to specify your disk drive, Sytos directory,admin ID
  44.       and admin password used for your PEER backups.
  45.    4) Create a backup schedule file (in the same directory)
  46.       indicating users to be backed up. (file: NETBACK.DAT)
  47.    5) Add the NETBACK cmd file to some form of execution scheduler
  48.       which allows VIO windowed apps.
  49.  
  50.    ---------------------------------------------------------------------
  51.                             Notes
  52.    ---------------------------------------------------------------------
  53.  
  54.    Theory of operation:
  55.  
  56.         NETBACK.CMD builds a list of scheduled users to backup
  57.     based on the NETBACK.DAT file. The network is then queried
  58.       if these users are currently available (workstation up and
  59.     running peer services.). All available workstations are then
  60.     queried for defined PEER disks.  These disks are then
  61.     added to a final PENDING backup list.  During this time
  62.     users are sent warning messages indicating that a backup is about
  63.     to take place.
  64.  
  65.       At this point NETBACK accesses the FIRST user's first disk
  66.     waiting for backup and links to them under the define 'RemoteDiskId'.
  67.     A copy of the NEWTAPE.MAC is made (named CURRENT.MAC). Into this
  68.     copy is written the user ID and DISK designation for this
  69.     backup set.  The disk is then backed up using the UNATTENDED
  70.     backup mode of SYTOS using the CURRENT.MAC.
  71.  
  72.         The same procedure is followed for all subsequent pending 
  73.     user/disk backup combinations.  The only difference is that 
  74.     after the first backup onto the tape, NETBACK uses the APPEND.MAC
  75.     which is defined to APPEND backup sets to the current tape.
  76.  
  77.         As each user is successfully backed up, NETBACK then sends
  78.     a net msg to each indicating when it is safe to shutdown.
  79.  
  80.         On completion, NETBACK logs off the specified ADMIN ID.
  81.  
  82.    ---------------------------------------------------------------------
  83.  
  84.    Comments:
  85.  
  86.       During operation, NETBACK.CMD maintains a log/history
  87.    of who was backed up, what drives were backed up and the
  88.    START/END times of each backup.  
  89.  
  90.       All LAN cmds are called via cmdline NET.EXE with the output
  91.    spooled to, and read from, a QUEUE.  It is NOT a private
  92.    QUEUE so if you have other REXX apps running using QUEUES, you may have
  93.    to change this to prevent data corruption.
  94.  
  95.    ---------------------------------------------------------------------
  96.  
  97.    KNOWN PROBLEMS:
  98.  
  99.     *  On occation SYTOS will be in the middle of a backup and it
  100.    will just freeze, waiting..(forever) It 'appears' as if the connection
  101.    to the PEER drive has been disconnected for some reason.  SYTOS never
  102.    receives the error and just sits waiting for the drive data.
  103.       I still haven't figured out exactly what the problem is because it
  104.    occurs at random. (At least appears to.) Note that our server(s) are
  105.    also running LTLW, DBM/RDS, and as a NN for APPC/CPI-C apps so its
  106.    possible that we're being effected from 'outside' the Lan server/SYTOS
  107.    system.
  108.  
  109.     *  For whatever reason, I can't get reliable backups if I define
  110.     the NEWTAPE.MAC/APPEND.MAC to use SYTOS's QFA (Quick File Access)
  111.     during the backup.  
  112.       I'm guilty of having read in some FIDO notes that other folks had 
  113.     problems with QFA, so I haven't tried very hard once it failed for me 
  114.     the first few times.
  115.  
  116.     *  I can't/don't check for TAPE FULL conditions simply because it has
  117.     never been an issue. (Our LANs are have 10-15 workstations and a 4G DAT
  118.     tape on the server. There also isn't anyone around at night to change
  119.     tapes if required.<g>)  
  120.        If you need/add this feature, drop me a line.. The Schedule/Group ID
  121.     does allow you to 'stagger' the backups. (Backup different groups on
  122.     different nights)
  123.  
  124.    ---------------------------------------------------------------------
  125.  
  126.  Format of the NETBACK.DAT schedule file:
  127.  
  128.      *  One line per user
  129.      *  1st word: (blank delimited):  Schedule group id.
  130.         2nd word: User LOGON ID
  131.         3rd word: Requester ID/Workstation ID
  132.         4th word: Nickname used for messages
  133.  
  134.    ---------------------------------------------------------------------
  135.    ie:
  136.        1 LSMITH VAN1R00E Lenny
  137.        9 TJONES VAN1R003 Tommy
  138.    ---------------------------------------------------------------------
  139.  
  140.    Schedule      Netback accepts a single cmdline parameter.
  141.    group ID:     This is a NUMBER indicating which group within
  142.                  the NETBACK.DAT schedule should now be backed up.
  143.                  When NETBACK reads in the NETBACK.DAT backup
  144.                  schedule, it does one of two things:
  145.  
  146.                  NO CMDLINE GroupNumber passed:  Use entire
  147.                                                  backup list.
  148.  
  149.                  CMDLINE GroupNumber passed: Only backup users with
  150.                                              a matching group number.
  151.  
  152.    ---------------------------------------------------------------------
  153.  LAN Server AT.EXE: LAN Server has a scheduler called
  154.                     AT.EXE. This package *WILL NOT* work with this
  155.                     scheduler. AT runs fully disconnected.. No 
  156.                     access to SCREEN, KEYBOARD resources. => SYTOS
  157.                     will not run under it..
  158.  
  159.    ---------------------------------------------------------------------
  160.  Installing PEER services on requesters: See your LAN manuals. Just
  161.                make sure you give Read,Write,Create, Attbribute and
  162.                Permissions rights to the ID you define on the requester
  163.                which under which the backup system will gain access
  164.                to your drives.
  165.  
  166.                (Don't forget to SHARE the drives once PEER is
  167.                 installed on the workstation.. Add that to the
  168.                 user's STARTUP.CMD..)
  169.  
  170.   -----------------------------------------------------------------------
  171.   Hints:
  172.           * I tend to let the lan admin workstation be the LAST entry
  173.             in the NETBACK.DAT backup schedule. When this person
  174.             gets in, he/she can immed. tell if the Lan backup was successfull
  175.             simply by checking if he/she received the SUCCESSFULL
  176.             backup msg for their own workstation.
  177.  
  178.           * Checking the time difference between the STARTING BACKUP msg
  179.             and the COMPLETED BACKUP msg can give an indication as to
  180.             the success of the backup.  
  181.  
  182.             
  183.  
  184. <EOF>
  185.