N o d e B r a i n   0.6.5

========================================================================

File:        nb-0.6.5-win-x86.msi.exe 

Title:       Windows binary release file using Windows Installer (*.msi)

Package:     NodeBrain (nb)

Version:     0.6 - Knucklehead

Release:     0.6.5

Date:        April, 2006

Reference:   http://www.nodebrain.org

               1) Online documentation

               2) Signatures to verify release file integrity

             See NEWS.txt for a list of changes in this release.

======================================================================== 

This README applies to the Windows binary release file using the Windows
Installer (*.msi).
   

OS        Status
--------  -------------------------------------------------
XP        Compiled this release (0.6.5)
2003      Not tested
2000      Not tested
NT        Not tested
98        No longer supported.
95        No longer supported.



NodeBrain Installation Instructions for Windows
-----------------------------------------------

You will need administrator permissions to install the agent.  If you
do not have administrator permissions you will be able to install the
shell and/or source code only.

1) Obtain the release file from www.nodebrain.org/downloads and place
   it in a working directory.
   
     Example:    c:\Install\nb-0.6.5-win-x86.msi.exe

2) Double click on the file to extract into a directory of the same
   name (less .exe) in your working directory.

     Example:    c:\Install\nb-0.6.5-win-x86.msi\

3) In this extracted directory, double click on the msi file

     NodeBrain.msi

4) Select from options presented by the Windows Installer (*.msi). 
   You have three basic options. 
   
     o Typical  - Shell only
     o Custom   - Select shell, agent and/or source code
     o Complete - Shell, agent and source code

   The NodeBrain interpreter (nb.exe) and distributed skill modules
   are installed with all options

5) To check out the install, click on the NodeBrain Shell icon on your
   desktop and verify that NodeBrain displays a heading and a prompt.
   You can type "quit" at the prompt.


Sample Agent Configuration Instructions
---------------------------------------

If you requested a full install or a custom install including the
agent, you should find a "NodeBrain Sample Agent" service listed by
the "Services" dialog (under Administrative Tools).

The agent is configured to do some trivial monitoring for services
starting and stopping.  The sample code illustrates two different
approaches: 1) monitoring the event logs, and 2) polling the service
table.

To enable notification via the "net send" command, follow these steps.

1) Start the "Messenger" service if it is not running.

2) Edit c:\program files\nodebrain\service\nodebrain.nb and replace
   "nobody" with your username (in quotes).

3) Restart the NodeBrain Sample Agent using the Services dialog.

4) You may be notified that NodeBrain entered a running state.  To test,
   stop another service that you are comfortable stopping and wait up
   to 30 seconds for two alarms (NBK002 and NBK001) via a "net send"
   popup.

To enable client communication with your agent follow these steps.

1) Copy private.nb from the \Application Data\nodebrain directory in
   in your profile directory to folder
 
     c:\program files\NodeBrain\Service\Nodebrain\  

   Make sure this file is only readable by the administrator (you) because
   because it contains a secret key that was generated at install time.

2) Edit c:\program files\nodebrain\service\nodebrain.nb and uncomment
   the "listener" line.

3) Restart the NodeBrain Sample Agent using the Services dialog.

4) Click on the NodeBrain Client icon on your desktop.  At the prompt
   type "show -r".  You should get a rule listing in response.

5) Enter "quit" at the next prompt to leave the client window.

In step 2 above you may change the port number if you want to use a
different port for client to agent communication.  However, you will
also have to change the port number in the client configuration file.

  c:\program files\NodeBrain\service\nodebrain\client.nb

In step 2 above you may also remove the address parameter on the 
listener definition.  This will enable a properly configured remote
client to communicate with your agent.  Configuration of a remote client
can be as simple as copying the key file, private.nb, to the remote system
after you install the client.  However, this is not the recommended approach.
It is better to generate a unique identity for each agent and each user and
place the public key of the agents in the users profile (private.nb) and the
public key of authorized users in the agent profile (private.nb).  If you
have a need for this, reference the NodeBrain User Guide.  You may also
reference the IDENTIFY and RANK commands in the NodeBrain Language Reference.


Windows Uninstall Instructions
-------------------------------

Use the ADD/REMOVE Programs tool in the Control Panel to uninstall
NodeBrain.

 
======================================================================== 

Copyright (C) 1998-2006 The Boeing Company
                        Ed Trettevik 

NodeBrain is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Software License:  See COPYING (also LICENSE.txt) and COPYING.lib