home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / NETUPD.ZIP / NETUPD.TXT < prev   
Text File  |  1991-05-11  |  7KB  |  153 lines
  1.                              NETUPD
  2.  
  3. The netupd program was designed to allow a network/PC administrator
  4. to easily update files on user workstations (without having to
  5. physically visit each location).  It is designed to replace files
  6. that already exist on the PC in question.  It will not attempt to
  7. place a file on a disk where it didn't previously exist.  The
  8. program is not designed to update multi-file applications, but it
  9. can do so if necessary by listing each file separately.
  10.  
  11.  
  12.                           Program Setup
  13.  
  14. The program is designed to be invoked from a network login script. 
  15. It requires that several parameters be passed that inform it as to
  16. the locations of files that it maintains, as well as the location
  17. of files to be updated.  It is required that there be at least 1
  18. directory where the user has complete read/write privileges.  This
  19. is the location where the error log for the application resides,
  20. and the user status files (for those people with registered
  21. copies).  There should also be 1 or more directories where the user
  22. has read-only privileges, where the files to be updated will reside
  23. (It is important that these directories be read-only to prevent
  24. someone from replacing the update file with some other program,
  25. such as a virus).  System options are entered on the command line
  26. by preceding them with a '/', or a '-' character (For Example
  27. '/?').  When an options requires a parameter, it should follow the
  28. option with no intervening spaces (For example '/DN:\tmp').  The
  29. system options are:
  30.  
  31. ?-   Provide a short system help screen.  If the '?' is followed by
  32.      another letter, the system will provide detailed help on that
  33.      option.
  34. A-   This option should be followed by a quoted string that
  35.      contains a line of text that is displayed giving the user
  36.      information on who to contact with questions regarding the
  37.      program.  
  38. D-   This option should be followed by the name of the directory to
  39.      store the user data files.  All users must have complete
  40.      read/write permissions in this directory.
  41. E-   This option should be followed by the name of the environment
  42.      variable that contains a unique identifier for the
  43.      workstation/user who is executing the program.  Ideally, this
  44.      should identify the workstation, since a user might log in and
  45.      execute this program from more than 1 workstation.  The
  46.      default that the system uses if this is not specified is
  47.      'USER'.  Note that the '/U' option bypasses this check.
  48. F-   This option should be followed by the name of an update list
  49.      file.  As with the normal update files, this should be located
  50.      in a directory where the user has read-only privileges.
  51. I-   This option forces the system to ignore the users update file,
  52.      and perform all currently defined updates.
  53. L-   This option should be followed by the name of a directory to
  54.      store the system error log file.  All users must have complete
  55.      read/write permissions in this directory.  The file is named
  56.      'netupd.log'.
  57. P-   This option activates a prompting function that queries the
  58.      user if they wish a file to be replaced.
  59. U-   This option should be followed by the users name/machine ID. 
  60.      It overrides the '/E' option or the system default.
  61.  
  62.  
  63.                       Replacement Criteria
  64.  
  65. This program currently uses a simple comparison of the date, time,
  66. file size, and files CRC16 value to determine if the update should
  67. take place.  If any of these values are not the same, then the
  68. replacement will be performed.
  69.  
  70.  
  71.                              User ID
  72.  
  73. The system will attempt to read an environment variable called
  74. 'USER' (or whatever was specified by the '/E' option), and will use
  75. this as the user ID for this execution of the program.  This can be
  76. overridden by using the '/U' option, and specifying the actual user
  77. ID.  The ID is truncated to 8 character since it is used as a file
  78. name.  (8 is the least common denominator, so that is what you
  79. get.)
  80.  
  81.  
  82.                         User Update File
  83.  
  84. Each user of the system has a file that contains information
  85. concerning which files that have already been updated.  This
  86. information is checked to prevent a file from being updated every
  87. time the user logs into the system.  
  88.  
  89. If an actual logon ID is used for this identifier then a problem
  90. could occur if the user logs in on more then 1 machine.  The
  91. program will see the second login, will check the users data file,
  92. and will say that all of the files have already been updated. 
  93. Therefore, the second machine would not be updated (see /I option). 
  94. This problem can be avoided if every machine is assigned a unique
  95. ID which is used instead of the users login ID (see /E option). 
  96. This could be implemented by using the network ID of each
  97. workstation if this is available (and unique).  In this case it
  98. would have to be truncated to 8 characters (See User ID text).
  99.  
  100. NOTE:     This option has been disabled in non-registered copies of
  101.           the program.  This doesn't prevent the program from
  102.           operating, it just makes it slower to complete, since it
  103.           must do all updates every time the user logs in.
  104.  
  105.  
  106.                            File Lists
  107.  
  108. The system can read the names of the files to be updated from an
  109. ASCII text file that contains the fully qualified names of each
  110. file to be updated.Each file name should be on a line by itself.
  111.  
  112.  
  113.                           On-line Help
  114.  
  115. This program implements an on-line help system.  This help is
  116. oriented towards the systems administrator, and provides
  117. information on each of the command line options.  This help is
  118. accessed by typing 'netupd /?x' where 'x' is the option you want
  119. help on.  Typing 'netupd' by itself will provide an general title
  120. and help screen.
  121.  
  122.  
  123.                        Future Enhancements
  124.  
  125. The following are possible future enhancements to this product.
  126.  
  127. 1.   Make the date/time comparison smarter, such that if the local
  128.      copy of the file is more recent, it prompts the user about the
  129.      replacement (with an appropriate warning).  It would also log
  130.      that a more recent copy existed on that users workstation in
  131.      the system error log.
  132.  
  133. 2.   Add a comment field to the update file description (both for
  134.      the command line and file specification) that would be
  135.      displayed if the system was running in the prompt first mode. 
  136.      this could give general information such as the version number
  137.      of the replacement file, or descriptions of who should not
  138.      perform the update.
  139.  
  140. 3.   Add an exclude drive/directory mode.  Another possibility
  141.      would be to create a user profile file that contains this type
  142.      of information plus other similar parameters.
  143.  
  144. 4.   Make the /E parameter treat the following text as a semi-colon
  145.      delimited list of environment variables to use to derive the
  146.      user ID.  This list could be searched until the first defined
  147.      variable was found, or could concatenate the contents until
  148.      the complete ID size was exceeded.
  149.  
  150. 5.   Make the truncation size for the User ID field a parameter. 
  151.      This would allow longer ID's for those systems that support
  152.      them.
  153.