Password protection for your Madge Smart Ringnode
=================================================
                                               LSS 5.0(0), August 1996
                                               -----------------------
1 Introduction
--------------
You  can  password  protect  any  Madge Ringnode or Bridgenode that is 
software configurable and/or that has a smartrom fitted.  By  default, 
neither the Ringnode nor the Smartrom are protected.

Once   you   have  password  protected  a  Ringnode  and/or  Smartrom, 
Madge Wizard,  TRCFGC.EXE,  SMARTROM.EXE and ATPMODE.EXE  will  prompt
for the password before they make any changes to the configuration.

2 Generating a Master Key
-------------------------
Before  you  can  run  PWSET.EXE  or  PWRESCUE.EXE you must generate a 
master key.  This master key is stored on the ringnode along with  the 
password.  A  Ringnode's password cannot be changed by a copy of PWSET 
or PWRESCUE that has a different master key from the Ringnode.

To  generate a Master Key:

1. Copy PWSET and PWRESCUE from the Madge release onto a disk.    Then
   run  PWSET from the new disk by typing PWSET /MASTER [ENTER].  This
   generates a unique  master key which is embedded into the copies of
   PWSET and PWRESCUE that are on the floppy disk you are using.

2. Create one or more Working Copies of PWSET.  To do this, copy PWSET 
   (but not PWRESCUE) from the Master Disk onto another floppy.  These 
   copies  all  share  the  same  Master  Key.   Store the Master Disk 
   securely as it  will  be  required  if  a  password  is  forgotten. 

3. Run  PWSET  from  the  new  floppy  disk on a computer containing a 
   Ringnode that you want to protect with a password. The  first  time 
   you  protect  any  Ringnode  by using PWSET, the program writes the 
   Master Key to the Ringnode.  Subsequently, only copies of PWSET (or 
   PWRESCUE) that have this Master Key, will enable you to re-set that 
   Ringnode's password.    

3 Setting a password using PWSET.EXE
------------------------------------
To set a password, using a working copy of PWSET, type:

    PWSET [options] [ENTER]

If  the Ringnode does not already have a password, the program prompts 
you for one and then asks you to confirm it.

If the Ringnode already has a password the program prompts you for the 
existing password, then prompts you to type a  new  one  and  then  to 
confirm the new one.

You can use the following command-line options with PWSET.EXE:

   /?           - Print help.

   /ver         - Print version.

   /io=<hhhh>   - I/O location of Ringnode (h = hex digit) eg io=0a20. 
          If  this  option is not used then a list of adapters 
          is displayed and you are prompted to choose one.

   /clear       - Remove password protection.  This will mean that the 
                  configuration utilities will no longer prompt for  a 
                  password before making any changes.  Note that the
                  Master Key is not removed.

   /not_rom     - Update  the  password  on  a  software  programmable 
                  ringnode's configuration, but not on  the  Smartrom.  
                  This  should be used if there is no rom fitted or if 
                  it is not wished to password protect the rom.

   /master      - Create a Master Key (see above).
   
Note that ':' can be substituted for '=' for use in batch files.


4 Clearing a forgotten password using PWRESCUE.EXE
--------------------------------------------------
PWRESCUE clears the password on a Ringnode without prompting  you  for 
the existing password.

**********************************************************************
Note: It is important that  access  to  PWRESCUE  be  restricted:  any 
      person  running  PWRESCUE  does  not  need  to  know the current 
      password in order to clear that password.
**********************************************************************

To clear a forgotten password, run PWRESCUE from the Master Disk  that 
was  used to create the working copy of PWSET that set the password on 
the Ringnode (ie the copy of PWRESCUE that has the same master key).

Type  PWRESCUE  [ENTER]  and choose the Ringnode on which to clear the 
password, if prompted.  This will clear the password  and  the  master 
key on the Ringnode.

If  PWRESCUE's  master key does not match that on the Ringnode it will 
not allow the password to be cleared.

The command line options /?, /ver, /io= and /no_rom are  the  same  as 
for PWSET.EXE (see Section 3 above).


5 Information specific to software programmable Ringnodes
---------------------------------------------------------

PWSET.EXE and  PWRESCUE.EXE  assume,  by  default,  that  there  is  a 
Smartrom  fitted.   If  they  can't find one they assume that a memory 
manager is using the upper memory block required by the Smartrom.   If 
so,  run  the utilities without a memory manager present. If you don't 
have a Smartrom fitted or you do not  wish  to  password  protect  the 
Smartrom, then  run  the  utility  again  specifying  'not_rom' on the 
command line.

Because the Smartrom on some Ringnodes is  removable,  it is  possible
that  the  password on the configuration software may become different
from that on the Smartrom.  If this happens, use PWRESCUE.EXE to clear
both, then set them again using PWSET.EXE.


6 Information specific to non-software programmable Ringnodes
-------------------------------------------------------------
When password protecting these adapters ensure that  the  Smartrom  is 
enabled.

                    ******* End of PWSET.TXT *******
