home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / imgcpy.exe / IMGCPY.TXT < prev   
Text File  |  1995-07-12  |  6KB  |  149 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. TITLE:  Readme for image file copy utility
  4. README FOR:  IMGCPY.EXE
  5.  
  6. NOVELL PRODUCTS and VERSIONS:
  7. NetWare 3.12
  8. NetWare 4.1
  9.  
  10. ABSTRACT:
  11.  
  12. This file contains IMGCOPY.NLM.  Which is a NetWare Loadable
  13. Module that is used to copy a coredump image file residing on the
  14. file server's local drive to the SYS: volume while the server is
  15. running.
  16.  
  17.  
  18.  
  19.  
  20. -----------------------------------------------------------------
  21.  DISCLAIMER
  22.  THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO
  23. NOVELL.  NOVELL
  24.  MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. 
  25. HOWEVER, THE
  26.  INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION
  27. ONLY.  NOVELL
  28.  MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS
  29. INFORMATION.
  30.  
  31. -----------------------------------------------------------------
  32.  
  33.  
  34. ISSUE: 
  35.  
  36. After directing a core memory image to a local DOS device users
  37. are unable to copy the image while the server is running.
  38.  
  39.  Use IMGCOPY.NLM to copy the core memory image from the local DOS
  40. device to the NetWare SYS: volume after the server has been
  41. restarted.
  42.  
  43.  IMGCOPY.NLM is a NetWare Loadable Module that is used to copy a
  44. coredump image file residing on the file server's local drive to
  45. a network drive while the server is running.  IMGCOPY reduces
  46. file server down time by copying the image file to a network
  47. drive as a background process, allowing the server to be used for
  48. normal activities.
  49.  
  50. Self-Extracting File Name: imgcpy.exe
  51.  
  52. Files Included     Size     Date      Time
  53.  
  54. ..\
  55.       IMGCPY.TXT     (This file)
  56.      IMGCOPY.NLM            4775          9-4-91      8:35:54 am
  57.  
  58.  
  59. Installation Instructions:
  60.  
  61. IMGCOPY can either be run from a floppy drive or can be copied to
  62. SYS:SYSTEM. After an image file has been generated and the server
  63. brought back up, type the following at the file server console
  64. screen*:
  65.  
  66.  LOAD IMGCOPY <<S=source path> <D=destination path> <P=priority>>
  67.  
  68.  NOTE: For both 3.11 and 4.10 SFT III.  Load IMGCOPY in the
  69. Mirrored Server Engine.  Depending on how the parameter "MSEngine
  70. Use Primary Server For DOS I/O" is set will determine which
  71. machines' DOS hard drive will be used. You will need to either
  72. set this to on or off depending on where the image to be copied
  73. resides.
  74.  
  75.  where:
  76.  
  77.  SOURCE PATH   Full path (including file name) of the image file
  78. which resides on the local hard drive. If no source path is
  79. specified, the default is C:\COREDUMP.IMG.
  80.  
  81.  DESTINATION PATH   The location on the SYS: volume where the
  82. image file should be copied. This must be a complete NetWare path
  83. specification, including volume and file names. The default
  84. destination path is SYS:COREDUMP\COREDUMP.IMG. If the destination
  85. path does not already exist, IMGCOPY will attempt to create that
  86. directory on the network drive. If the file specified already
  87. exists, it will be overwritten without any warning to the user.
  88.  
  89.  PRIORITY   This parameter specifies what priority level is to be
  90. used when copying the image file. The valid options are LOW,
  91. MEDIUM, and HIGH. If no priority is given, MEDIUM is assumed.
  92. When running at LOW priority, IMGCOPY allows the file server to
  93. service user requests for longer intervals. LOW priority will
  94. exhibit the least amount of server degradation, but it will take
  95. much longer to complete the file transfer. At MEDIUM priority,
  96. there is no degradation of server functionality, although the
  97. transfer time is reduced considerably. At HIGH priority, the
  98. server will almost exclusively be processing transfer requests,
  99. thereby making it nearly impossible for the file server to
  100. perform other duties until the file has been transferred. This is
  101. the fastest transfer priority available.
  102.  
  103.  Note that all the above parameters are optional, and may be
  104. specified in any order.
  105.  
  106.  Once loaded, IMGCOPY will immediately begin to transfer the
  107. image file from the server's local DOS partition, to the network
  108. drive. A status screen will be displayed, showing the selected
  109. source and destination files, as well as the priority level.
  110. Also, a counter indicating the number of bytes successfully
  111. transferred will be display. The user can toggle out of the
  112. IMGCOPY screen by typing Alt + Esc.
  113.  
  114.  When the image file has been successfully transferred, IMGCOPY
  115. will display a message to the file server console and
  116. automatically unload itself. File server activity will then
  117. resume at normal operating levels. It is possible to abort the
  118. file transfer by unloading IMGCOPY while the transfer is taking
  119. place.
  120.  
  121.  A note about Real and Protected mode:
  122.  During normal operation, the file server runs in protected mode.
  123. However, in order to access the local DOS partition to read the
  124. image file, the file server must switch to real mode each time a
  125. read request is processed. While in real mode, all normal file
  126. server activity ceases. Due to this frequent state switching,
  127. users may experience loss of keystrokes at the file server
  128. console if a key was pressed while the server was in real mode.
  129. These keystrokes are stored in a real mode buffer and will not be
  130. seen at the file server console. The higher the priority level,
  131. the more apparent this will become.  At the MEDIUM and HIGH
  132. priority settings, users may not be able to toggle between
  133. screens easily or type anything at the server console.  This
  134. condition will disappear as soon as the file has been transferred
  135. and IMGCOPY has been unloaded.
  136.  
  137.  
  138.  
  139.  
  140. -----------------------------------------------------------------
  141.  Any trademarks referenced in this document are the property of
  142. their
  143.  respective owners.  Consult your product manuals for complete
  144. trademark
  145.  information.
  146.  
  147. -----------------------------------------------------------------
  148.  
  149.