home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / libup5.exe / INSTALL.DOC < prev    next >
Text File  |  1993-11-10  |  19KB  |  416 lines
  1.                          
  2.                                 
  3.                                 NOVELL
  4.                           Server Library Update
  5.  
  6.          The Server Library Update package provides a convenient and 
  7.     effective method for NetWare system administrators to install updated 
  8.     server libraries.  It is Novell's desire to provide its customers with 
  9.     server library updates in the most convenient and efficient manner 
  10.     possible.  With this in mind, INSTALL.EXE was designed emphasizing  
  11.     ease-of-use and operating system integrity.  As a result, INSTALL.EXE 
  12.     supports several important features and is capable of
  13.  
  14.           *  Installing upgraded NetWare NLMs automatically
  15.  
  16.           *  Creating a log file to capture system messages
  17.  
  18.           *  Uninstalling the upgrades and returning the 
  19.              system to its original condition
  20.  
  21.           *  Testing the system upgrade procedure before 
  22.              attempting the actual installation
  23.  
  24.           *  Using command line parameters to help customize 
  25.              the utility to meet individual needs
  26.  
  27.    
  28.          This document contains five main sections:
  29.  
  30.           *  Directory structure
  31.                 This is a brief description of the directory 
  32.                 structure created on the workstation during 
  33.                 the extraction process.
  34.  
  35.           *  Installation utility
  36.                 This section describes the function of INSTALL.EXE.
  37.  
  38.           *  Command line parameters
  39.                 This section contains an explanation of the command 
  40.                 line parameters supported by INSTALL.EXE.
  41.  
  42.           *  Syntax
  43.                 This is an explanation of the INSTALL command syntax.
  44.  
  45.           *  Error messages
  46.                 This section contains an alphabetical list of the 
  47.                 error messages generated by INSTALL.EXE.
  48.  
  49.  
  50. Directory Structure
  51. -------------------
  52.  
  53.          A directory structure similar to the one below should have been
  54.     created in your workstation's current directory as a result of 
  55.     extracting the update package.  At least one of the directories (3.x,
  56.     4.x or COMMON) will exist and will contain files that need to be
  57.     installed.
  58.     
  59.                 /<Current Directory>
  60.                         <Current Directory> / 3.x
  61.                         <Current Directory> / 4.x
  62.                         <Current Directory> / COMMON
  63.  
  64.          The current directory contains the installation utility 
  65.     (INSTALL.EXE) and the corresponding documentation (INSTALL.TXT).  The 3.x 
  66.     directory contains all the files specific to NetWare versions 3.11 and 
  67.     3.12.  The 4.x directory contains those files specific to NetWare versions 
  68.     4.0 and later.  Files which will be installed on all versions of NetWare 
  69.     are contained in the COMMON directory.
  70.  
  71.  
  72.   
  73. Installation Utility
  74. --------------------
  75.  
  76.  
  77.     The installation program supplied with this update (INSTALL.EXE) is a
  78.     DOS command line utility which installs the updated NLMs on to one or
  79.     more Novell NetWare servers.  INSTALL.EXE performs three major tasks:
  80.  
  81.     1.  Analyzes all of the modules residing in subdirectories 3.x, 4.x 
  82.         and COMMON.
  83.  
  84.     2.  Gathers information such as NetWare version and available disk space 
  85.         for all the NetWare servers into which the workstation is currently 
  86.         logged.
  87.         
  88.     3.  Performs a systematic update of each qualifying NetWare server with
  89.     the option of user prompts.
  90.  
  91.  
  92.  
  93. Command Line Parameters
  94. -----------------------
  95.  
  96.  
  97.     The installation utility INSTALL.EXE supports the following command
  98.     line parameters:
  99.  
  100.     /a      Append output to INSTALL.LOG
  101.             The installation utility creates a log file (INSTALL.LOG)
  102.             which contains messages relating to the installation procedure.
  103.             By default, INSTALL.LOG is overwritten if it exists.  This 
  104.             switch will cause the messages to be appended to the existing
  105.             INSTALL.LOG.
  106.  
  107.     /l#     Set log file level 
  108.                 /l0     Turn OFF the log file.
  109.                 /l1     Turn ON the log file (default).
  110.                 /l2     Turn ON the log file and disable the console.
  111.                         Installation messages will go to the log file 
  112.                         instead of the console.
  113.  
  114.     /n      Set "no action" mode
  115.                 Run the update procedure without actually performing the
  116.                 update. All prompt and log level switches are honored.
  117.             This is useful for verifying the installation actions before
  118.         installing.
  119.  
  120.     /p#     Set prompt level 
  121.                 /p0     Do not prompt before updating.
  122.                 /p1     Prompt before updating any server (default).
  123.                 /p2     Prompt before updating any server or file.
  124.  
  125.     /u      Uninstall the candidates from an NCP Server
  126.                 This switch can be used with all of the other switches, 
  127.                 including /n.  It provides a quick way to back out the updated
  128.                 NLMs and restore the original files should the need arise.
  129.                                                                      
  130.     /v#     Set verbose mode.  
  131.                 /v0     Sets verbose mode to low, disabling most of the
  132.                         messages.
  133.                 /v1     Sets verbose mode to high, enabling all messages 
  134.                         (default).
  135.  
  136.  
  137.              
  138.     NOTE:  These command line parameters make it possible to test the 
  139.     installation utility on a specific system before performing the 
  140.     installation.  For example, the command 
  141.     
  142.                 F:\UPDATE>INSTALL /n /p0 /l2 
  143.                         
  144.     will create a log file containing all of the update information which 
  145.     would have been performed without pausing for user prompts.
  146.  
  147.  
  148.  
  149. Syntax
  150. ------
  151.  
  152.  
  153.     The command line switches may be specified in any order and may be
  154.     concatenated together without switch character delimiters.  The switches
  155.     are not case sensitive.  The following four commands are equivalent.
  156.  
  157.             F:\UPDATE> install /p0 /l2 /v0 /n
  158.             F:\UPDATE> install /p0l2v0n
  159.             F:\UPDATE> install /P0 /L2 /V0 /N
  160.             F:\UPDATE> install /V0N /P0L2
  161.  
  162.     The switch character "/" may be changed by setting the SWITCHAR 
  163.     environment variable.  For example, the command
  164.  
  165.             F:\UPDATE> set SWITCHAR=-
  166.  
  167.     sets the switch character to the hyphen "-" symbol.
  168.  
  169.  
  170.  
  171. Error Messages
  172. --------------
  173.  
  174.  
  175.     This section describes the various error messages displayed by the 
  176.     INSTALL utility.
  177.  
  178.     Candidate <FILENAME> is not installed in SYS:SYSTEM
  179.                         INSTALL cannot find the candidate <FILENAME>
  180.                         on the server.
  181.  
  182.     Cannot backout <FILENAME> because <FILENAME.BAK> does not exist
  183.                         INSTALL cannot back out <FILENAME> because the
  184.                         original file was not found. During the update
  185.                         process, INSTALL renames the original file with 
  186.                         a .BAK extension.  Without this .BAK file, INSTALL 
  187.                         is unable to restore the original file.
  188.  
  189.     Copy failed because of Ctrl-C key sequence
  190.                         Ctrl-C was pressed during the file copy.
  191.  
  192.     Copy failed because of destination close failure 
  193.                         INSTALL could not close the destination file.
  194.  
  195.     Copy failed because of destination open failure 
  196.                         INSTALL could not open the destination file.
  197.  
  198.     Copy failed because of read failure
  199.                         An error was encountered while reading the source
  200.                         file.
  201.  
  202.     Copy failed because of source close failure
  203.                         INSTALL could not close the source file.
  204.  
  205.     Copy failed because of source open failure
  206.                         INSTALL could not open the source file.
  207.  
  208.     Copy failed because of unknown error code
  209.                         An unanticipated internal error occurred.
  210.  
  211.     Copy failed because of write failure.
  212.                         An error was encountered while writing the 
  213.                         destination file.
  214.  
  215.     Failed loading information about candidates
  216.                         Either an out-of-memory condition while processing 
  217.                         the candidate files, or invalid NLM header information 
  218.                         was encountered in one or more of the candidates.  
  219.                         Try freeing additional memory by unloading unnecessary 
  220.                         TSRs.
  221.  
  222.     Failed removing file <FILENAME>
  223.                         An error was encountered while attempting to erase
  224.                         <FILENAME>.  This may be caused by insufficient 
  225.                         rights to the SYS:SYSTEM directory.
  226.  
  227.     Failed renaming <FILENAME> to *.BAK
  228.                         An error was encountered while attempting to rename
  229.                         <FILENAME> to <FILENAME.BAK>.  This may be caused by
  230.                         insufficient rights to the SYS:SYSTEM directory.
  231.  
  232.     Failed renaming <FILENAME> to *.QRM
  233.                         INSTALL was unable to rename the updated NLM with
  234.                         a .QRM extension.  This may be caused by insufficient
  235.                         rights to the SYS:SYSTEM directory.
  236.  
  237.     Failed renaming <FILENAME1> to <FILENAME2>
  238.                         An error was encountered while attempting to rename
  239.                         <FILENAME1> to <FILENAME2>.  This may be caused by
  240.                         insufficient rights to the SYS:SYSTEM directory.
  241.  
  242.     Failed resetting attributes of <FILENAME> 
  243.                         The attempt to clear the attributes of <FILENAME>
  244.                         failed.  This may be due to insufficient rights in
  245.                         the SYS:SYSTEM directory.
  246.  
  247.     <FILENAME> is currently installed in SYS:SYSTEM
  248.                         INSTALL discovered that <FILENAME> is currently 
  249.                         installed on the server and is attempting to
  250.                         restore the original NLM.
  251.  
  252.     <FILENAME> not currently installed in SYS:SYSTEM
  253.                         No matching NLM was found in the NetWare server's
  254.                         SYS:SYSTEM directory.  This message will be displayed
  255.                         when a specific NLM is loaded for the first time or 
  256.                         if a specific NLM is not loaded in the SYS:SYSTEM
  257.                         directory.
  258.  
  259.                         NOTE:  If any of the NLMs being updated are loaded 
  260.                         from the server's DOS partition, they must be copied
  261.                         back to the DOS partition manually after the update.
  262.                         INSTALL does not support copying NLMs to a server's 
  263.                         DOS partition.  RCONSOLE may be used for this purpose.
  264.  
  265.     <FILENAME> uninstall completed successfully
  266.                         The NLM <FILENAME> was successfully backed out and 
  267.                         the original NLM was restored.
  268.  
  269.     <FILENAME> update completed
  270.                         The candidate file <FILENAME> has been fully 
  271.                         processed.
  272.  
  273.     Installation is terminating
  274.                         INSTALL has terminated abnormally.
  275.  
  276.     Marking <FILENAME.BAK> as Read-Only...
  277.                         INSTALL has set the Read-Only attribute of a 
  278.                         candidate file after that file has been successfully
  279.                         installed.
  280.  
  281.     NCP Server <SERVERNAME> can't be updated because the file has an invalid 
  282.     NLM header
  283.                         The specified NLM update candidate has in invalid
  284.                         header.
  285.  
  286.     NCP Server <SERVERNAME> can't be updated because the ID for volume SYS: 
  287.     is unavailable
  288.                         INSTALL is unable to obtain the volume ID for SYS:.
  289.  
  290.     NCP Server <SERVERNAME> can't be updated because the NLM version 
  291.     information is unavailable
  292.                         INSTALL is unable to obtain the NLM version 
  293.                         information on an update candidate.
  294.  
  295.     NCP Server <SERVERNAME> can't be updated because the server information 
  296.     is unavailable
  297.                         INSTALL is unable to obtain server-specific 
  298.                         information.
  299.  
  300.     NCP Server <SERVERNAME> can't be updated because the volume information 
  301.     is unavailable.
  302.                         INSTALL is unable to obtain the volume information for
  303.                         SYS:.
  304.  
  305.     NCP Server <SERVERNAME> can't be updated because you have insufficient
  306.     rights
  307.                         You have inadequate rights to run INSTALL on volume
  308.                         SYS:SYSTEM.  You need read, write, create, erase and
  309.             access control to SYS:SYSTEM in order to run INSTALL.
  310.  
  311.     NCP Server <SERVERNAME> can't be updated because you need NetWare 3.11
  312.     or later
  313.                         The updated modules are intended only for NetWare
  314.                         versions 3.11 and up.
  315.  
  316.     NCP Server <SERVERNAME> can't be updated because of unknown error code
  317.                         An internal error occurred in the INSTALL program.
  318.    
  319.     NCP Server <SERVERNAME> should be upgraded to 4.01
  320.                         <SERVERNAME> is running NetWare version 4.0 and 
  321.                         should be upgraded to version 4.01.
  322.  
  323.     NCP Server <SERVERNAME> uninstall is complete.
  324.                         The uninstall process of server <SERVERNAME> is
  325.                         complete.
  326.  
  327.     NetWare Requester or Shell is not loaded
  328.                         INSTALL requires the use of either the NetWare DOS
  329.                         Requester (VLM.EXE) or the NetWare Shell (NETX.EXE).
  330.                         One of these two files must be loaded before INSTALL
  331.                         can function.
  332.  
  333.     No files were found to update
  334.                         No files were found in the 3.x, 4.x or COMMON 
  335.                         subdirectories.  Make sure these directories were
  336.                         created during the extraction of the update package.
  337.  
  338.     Not enough disk space to install <FILENAME>
  339.                         Volume SYS: does not have enough space available to
  340.                         install <FILENAME>.  Create more available space on
  341.                         volume SYS: and rerun the INSTALL utility.
  342.  
  343.     Note:  Unable to build complete list of connections due to out of memory 
  344.     condition.  Proceeding with partial update of NCP Servers.
  345.                         An out-of-memory condition was encountered while
  346.                         building the connection information list.
  347.  
  348.                         NOTE:  INSTALL will continue the update procedure, but
  349.                         will not process all of the connections.  After 
  350.                         completing the initial run, log out of the updated 
  351.                         servers and rerun INSTALL to complete the update.  It
  352.                         may be advisable to free additional memory by 
  353.                         unloading unnecessary TSRs.
  354.  
  355.     Out of memory building connection tables
  356.                         INSTALL has encountered an out-of-memory condition.
  357.                         Free additional memory by unloading unnecessary TSRs.
  358.  
  359.     Program name must be [?:\path\] INSTALL.EXE
  360.                         The INSTALL utility as distributed by NOVELL is named
  361.                         INSTALL.EXE.  If this message is displayed, the update
  362.                         you received may not be authentic.
  363.  
  364.     Removing SYS:SYSTEM/<FILENAME>.BAK...
  365.                         INSTALL is removing an NLM file with the extension 
  366.                         .BAK from SYS:SYSTEM.  When an update candidate is 
  367.                         installed, the original file is renamed with a .BAK
  368.                         file extension.  If a file with that name already 
  369.                         exists, INSTALL will remove it before updating the NLM.
  370.  
  371.     Renaming <FILENAME.QRM> to <FILENAME.NLM>
  372.                         INSTALL is renaming the candidate NLM to its original
  373.                         distribution name.  In order to minimize the chance of
  374.                         a partial update, INSTALL transfers candidate files 
  375.                         with a .QRM extension.  When the transfer is complete, 
  376.                         INSTALL renames the existing file to have a .BAK 
  377.                         extension and renames the candidate file to have a .NLM 
  378.                         extension.
  379.  
  380.     Renaming SYS:SYSTEM/<FILENAME> to SYS:SYSTEM/<FILENAME>.BAK...
  381.                         INSTALL is renaming the current NLM with a .BAK
  382.                         extension.  This is done so that a specific candidate
  383.                         may be easily backed out should the need arise.
  384.  
  385.     Resetting attributes of SYS:SYSTEM/<FILENAME>
  386.                         INSTALL is resetting file attributes, making it 
  387.                         possible to rename or remove the file <FILENAME>.
  388.  
  389.     Transferring <FILENAME.NLM> to <FILENAME.QRM>
  390.                         INSTALL is transferring the candidate file 
  391.                         <FILENAME.NLM> as <FILENAME.QRM>.  When the transfer
  392.                         is complete, INSTALL renames the existing file to have
  393.                         a .BAK extension and renames the candidate file to 
  394.                         have a .NLM extension.  This method reduces the chance 
  395.                         of having a partial upgrade.
  396.  
  397.     Unable to uninstall file <FILENAME>
  398.                         INSTALL was unable to uninstall <FILENAME>.  The 
  399.                         previous message in the log file INSTALL.LOG will
  400.                         indicate the reason for the failure.
  401.  
  402.     Unknown error processing SYS:SYSTEM/<FILENAME>
  403.                         INSTALL encountered an unknown error trying to access
  404.                         NLM version information from <FILENAME>.  This error
  405.                         may be due to an invalid or corrupt header.
  406.  
  407.     Warning: Failed setting attributes of <FILENAME>
  408.                         INSTALL encountered an error while trying to set the
  409.                         attributes of <FILENAME> to read-only.  This may be
  410.                         caused by insufficient rights to the SYS:SYSTEM
  411.                         directory.
  412.                     
  413.  
  414.  
  415.  
  416.