README.TXT for installation of RAVEN-SB (updated 10/28/2005)

This file contains information pertaining to the installation of the RAVEN-SB 2.x software product. 

-----------------
TABLE OF CONTENTS
-----------------
Section 1: Minimum System Requirements
Section 2: Setting up the RAVEN-SB software for Windows 95/98/NT/2000/XP
Section 3: Installing RAVEN-SB on a network
Section 4: Logging in for the first time
Section 5: Multi-user operation
Section 6: Printing of SB-MDS Forms
Section 7: Uninstalling RAVEN-SB

---------------------------
MINIMUM SYSTEM REQUIREMENTS
---------------------------
To operate the software, you will need the following MINIMUM hardware/software:

- IBM-compatible PC with Pentium 200 Mhz or higher processor

- VGA-compatible display monitor with minimum 800x600 resolution

- Microsoft Windows 95, Windows 98, Windows NT, Windows 2000 or Windows XP

- Microsoft-compatible mouse or pointing device

- Hard disk with a minimum of 40 megabytes of space

- Sixteen megabytes of RAM (32 are recommended for Windows 95/98/NT/2000/XP)


For printing the SB-MDS Forms, you will also need:

- Adobe Acrobat Reader, version 3.01 or higher

- Laser printer.


---------------------------------------------------------
SETTING UP THE RAVEN-SB SOFTWARE FOR WINDOWS 95/98/NT/2000/XP
---------------------------------------------------------
Here are the steps for installing the RAVEN-SB software
under Windows 95/98/NT/2000/XP 

1.  	Download the SETUPRAVENSB.ZIP.

	Click on the Web page link to download the file SETUPRAVENSB.ZIP to your computer.  
	This file is a compressed file that contains the complete software
	package.  It is	recommended that the file be saved to a temporary directory on your 
	computer (e.g., C:\TEMP\).
	
2.	Decompress the SETUPRAVENSB.ZIP files.

	Use an unzipping utility such as PKUNZIP or WINZIP to extract all of the
	installation files into C:\TEMP.

3.	Run the SETUP.EXE.

	First, close all other running applications.  Then, choose "Run" from the 
	Start menu and type C:\TEMP\SETUP in the Command Line text box, then click on the <OK> 
	button.  This action will start the RAVEN-SB software installation program.
	
4.	Follow the installation program instructions.

5.	Run the RAVEN-SB software.

	When the setup is complete, it will create the "SB-MDS RAVEN-SB System" submenu
	under the Start/Programs menu.  From this submenu, click on the "RAVEN-SB System"
	menu item.  This action will start the RAVEN-SB software program.

----------------------------------------------------
INSTALLING RAVEN-SB ON A NETWORK
----------------------------------------------------

RAVEN-SB 1.x has two network configuration possibilities.  Configuration 1 has the 
advantage that the RAVEN software is only installed to one location.  Configuration 2 offers the 
best multi-user performance, since the SWB.MDB, SWBDICT.MDB and SWBTRACK.MDB
are the only databases accessed by multiple users.

Configuration 1:  All RAVEN-SB application files on the network

Here are the steps to follow in setting up this RAVEN configuration on a network:

1.  	Create or designate a network volume (storage space on a network drive) to 
	which all RAVEN-SB users will have read-write access.

2.  	Establish a drive mapping for each user to this network volume (e.g., G:\, for the 
    	purposes of these instructions).  For Novell users, this mapping could be part of a 
	system or user login script.  For Windows NT network users, it could be a permanent 
	drive mapping that can be established using Windows Explorer or File Manager 
	(depending on the Windows version).

3.  	For each client machine, install the software, specifying g:\swb for the directory 
	instead of the default c:\swb.  

4.  	The administrator should then set up facility and employee information in RAVEN-SB.  The 
    	administrator may want to add the residents as well.

5.  	RAVEN-SB may now be used to create and enter assessment data.

Configuration 2:  RAVEN-SB data entry databases on the network; all other files local

Here are the steps to follow in setting up this RAVEN-SB configuration on a network:

1.  	Create or designate a network volume (storage space on a network drive) to which all 
    	RAVEN-SB users will have read-write access.

2.  	Establish a drive mapping for each user to this network volume (e.g., G:\, for the 
    	purposes of these instructions).  For Novell users, this mapping could be part of a 
	system or user login script.  For Windows NT network users, it could be a permanent 
	drive mapping that can be established using Windows Explorer or File Manager 
	(depending on the Windows version).

3.  	For each client machine, install the software to a local directory (e.g., C:\SWB).  
	After installation is complete, copy SWB.MDB and SWBTRACK.MDB to the desired network 
	drive/path.  It may also be a good idea to copy the repair and resetflags utilities to the 
        network drive/path as well in case of a corrupt database. Then run RAVEN-SB and click 
        Administration |Preferences menu item.  Select the Location tab.  Enter the network 
        drive/path to the SWB.MDB and SWBTRACK MDBs on the resulting screen. Exit RAVEN-SB, 
	then run RAVEN-SB again to put the network path into effect.

4.  	The administrator should then set up facility and employee information in RAVEN-SB.
	The administrator may want to add the residents as well.  In order to ensure that 
	preference options are the same for all client PCs, the administrator should set 
	these options and (a) distribute the resulting SWBDICT.MDB to the application 
	directory on each client PC, and (b) distribute the resulting SWB.INI to the
	WINDOWS\SWBPRINT directory of each client PC.

5.  	RAVEN-SB may now be used to create and enter assessment data.

		
NOTE TO WINDOWS NT USERS:  Do not install RAVEN-SB on a Windows NT Server from the server itself
and then map the client workstations to the NT server directory.  RAVEN-SB expects the actual 
installation path to be available at several places in the software.  Therefore, if RAVEN-SB is 
installed using Configuration 1 to D:\SWB_NT (for example) on the NT server, but the clients 
map their logical F: drive to this directory, the software will expect to locate data files at 
D:\SWB_NT on the CLIENT machine!  This problem can be avoided by installing RAVEN on the NT 
Server from a client PC (similar to the Novell method).  The administrator should pick a 
logical drive that all clients will use and install to a subdirectory of it (e.g., F:\SWB_NT).  
DO NOT INSTALL RAVEN TO THE ROOT OF A LOGICAL DRIVE (e.g., F:\); users have reported 
operational problems with this installation method.
		
-----------------------------
LOGGING IN FOR THE FIRST TIME
-----------------------------
When the RAVEN-SB program is launched, a login screen appears.  Type SWB for both the user ID 
and password, then click on the OK button.  Note that the user SWB has administrator rights;
therefore, it is then possible to set up facility, employee and resident information - 
necessary steps before entering assessments.

--------------------
MULTI-USER OPERATION
--------------------
When operating RAVEN-SB in a multi-user (i.e., networked) configuration, it is possible to
refresh the resident and assessment information on the RAVEN-SB Management screen.  This 
capability is useful in determining if residents have been added or if assessments have 
been opened recently.  To refresh both the resident and assessment lists from the RAVEN-SB 
Management screen, press the F5 key.  To refresh only the assessment list for the currently 
selected resident, press the Shift+F5 keys simultaneously.

-----------------------------
PRINTING OF SB-MDS FORMS
-----------------------------
In order to print the SB-MDS Forms, Adobe Acrobat Reader 3.x or higher must be installed 
on the user PC.  Installation files for 32-bit versions of Acrobat Reader 
are available on the CD in the subdirectory ACROBAT.  Acrobat Reader can also be downloaded 
from the Adobe web site (www.adobe.com).

In addition, the Systems Administrator must go to the Preferences menu, select the Paths item
and provide the path/file name to the Acrobat Reader executable.  If this path/file name is 
NOT provided, printing of SB-MDS Forms is automatically disabled.

Note that when the Acrobat Reader path/file name is entered on the Preferences window, the 
application creates a SWBPRINT directory on the user's system directory (e.g., c:\WINDOWS) 
and a SWB.INI file to reside there.  The SWBPRINT directory contains the PDF files 
representing the various SB-MDS assessments.  The SWB.INI stores the Acrobat Reader path/file name
as well as paths for the backup, import, export, reports and print from file functions.

When the user prints an assessment, the system checks whether a valid Adobe Acrobat Reader 
path and file name are specified.  If so, then the application creates the assessment data 
overlay (FDF) file, which is called ACROFU.FDF.  This file is created in the SWBPRINT 
directory.  The applications then checks whether the appropriate PDF file already exists in 
the SWBPRINT directory.  If not, the application copies the PDF file to the SWBPRINT directory.  
Finally, Adobe Acrobat Reader is launched with appropriate command line parameters.  Note that 
these command line parameters are documented by Adobe but not (!) officially supported.

If printing problems occur, the user can attempt to print the form manually. Exit RAVEN-SB, 
go to the SWBPRINT directory, and execute one of the following commands from
a DOS Window, a Command Prompt or the Run option on the Windows 95/98/NT/2000/XP Start Menu:

ACRORD32 /p ACROFU.FDF (for 32-bit Acrobat Reader)

If the printing problems persist, it is likely that the cause is related to the specific PC
system configuration.  Adobe technical support is available at www.adobe.com.  While Adobe
does not officially support these command line parameters, a user discussion group is
available and this topic is discussed often.

-----------------------------
UNINSTALLING RAVEN-SB
-----------------------------
In order to uninstall RAVEN-SB, click the Uninstall RAVEN-SB icon in the RAVEN-SB System group.   
NOTE!!!  The uninstall procedure will not remove the databases (the user must delete them 
manually, if desired).

Note that the uninstall does not delete the following types of files:

	.LDB files (which are automatically created when a database is opened)

	.ZIP files (if compression is enabled for RAVEN-SB backups)
	
	SWB.INI in the WINDOWS\SWBPRINT directory (this file is also created by RAVEN-SB)

Therefore, if the above files exist, the uninstall procedure will not be able to delete
the installation directory (e.g., C:\SWB).  The remaining files can be deleted via Windows
Explorer or File Manager, if desired.



Updated 10/28/2005