Installing NetWare Btrieve
This section discusses the following topics:
System Requirements for Installation
Make sure your system has the following:
- NetWare® 4 or later
Running Btrieve 6.1x in a NetWare 3.11 or 3.12 environment requires the AFTER311.NLM, which Btrieve loads automatically.
- Adequate memory at the server to load the Btrieve NLM (approximately 528 KB) and the appropriate communications modules
The memory required for the communications modules varies, depending on the values you specify for the Largest Record Size and Number of Remote Sessions configuration options.
- Adequate memory for the Btrieve Requester at each workstation
Memory requirements vary, depending on the parameters you specify when you load the requester. Following are the default requester parameters:
- The DOS Requester requires approximately 29 KB (34 KB for BREQUEST 6.10e).
- The OS/2 Requester requires approximately 40 KB.
- The MS Windows Requester requires approximately 30 KB. (To use the MS Windows Requester, you must also have the DOS Requester loaded.)
If you have an earlier version of NetWare Btrieve loaded on your system, unload it before you install NetWare Btrieve 6.1x, as described in Unloading an Earlier Version of NetWare Btrieve.
NetWare Btrieve 6.1x Program Files
This section provides information about the files that comprise NetWare Btrieve. The 6.1x program files can be categorized as follows:
Following are brief definitions of the files installed by the NetWare INSTALL utility (described on Using the NetWare INSTALL Utility). Some file, such as the utilities, the requesters, and the communications-related files, are discussed in more detail in this and subsequent chapters.
Files Related to the NetWare 3 Environment
The following files are related to Btrieve operations carried out in a NetWare 3 environment:
- AFTER311.NLM---NLM that NetWare Btrieve v6.1x requires in a NetWare 3 environment.
- CLIB.NLM---C Library for the NetWare 3 environment.
- NWLOCALE.DLL---National Language Support DLL for the NetWare 3 environment. The /PUBLIC/WIN and /PUBLIC/OS2 directories each contain a different NWLOCALE.DLL.
- NWSNUT.NLM---Graphics User Interface (GUI) NLM for the NetWare 3 environment.
File Related to the NetWare 4 Environment
The following file is related to Btrieve operations performed in a NetWare 4 environment:
- CLIB.NLM---C Library for the NetWare 4 environment.
Files Related to Server Operations
The following files are related to Btrieve operations performed on a NetWare server:
- BDIRECT.NLM---Directory Services utility that allows you to install or remove a Btrieve server object in a NetWare 4 environment.
- BDIRECT.MSG---Message file for BDIRECT.NLM (for the NetWare 4 environment).
- BDROUTER.NLM---NLM that provides Directory Services support in a NetWare 4 environment.
- BDROUTER.MSG---Message file for BDROUTER.NLM (for the NetWare 4 environment).
- BREBUILD.NLM---Rebuild utility that lets you convert existing NetWare Btrieve v5.x files to NetWare Btrieve v6.1 format.
- BREBUILD.MSG---Message file for BREBUILD.NLM.
- BROUTER.NLM---NLM that allows server-based NetWare Btrieve applications to access Btrieve databases on remote servers.
- BROUTER.MSG---Message file for BROUTER.NLM.
- BSETUP.NLM---Btrieve installation and configuration utility.
- BSETUP.MSG---Message file for BSETUP.NLM.
- BSETUP.HLP---Help file for BSETUP.NLM.
- BSPXCOM.NLM---SPX communications agent.
- BSPXCOM.MSG---Message file for BSPXCOM.NLM.
- BSPXSTUB.NLM ---NLM that allows you to use the Btrieve Monitor utility (BTRMON.NLM) when BSPXCOM.NLM is not loaded.
- BSPXSTUB.MSG---Message file for BSPXSTUB.NLM.
- BSTART.NCF---Batch file executed to start NetWare Btrieve. This file also loads BSPXCOM.NLM and BROUTER.NLM (if NetWare Btrieve is configured to do so).
- BSTOP.NCF---Batch file executed to stop NetWare Btrieve. This file also unloads BSPXCOM.NLM and BROUTER.NLM (if they are loaded).
- BTRIEVE.NLM---NetWare Btrieve Record Manager (database engine).
- BTRIEVE.MSG---Message file for BTRIEVE.NLM.
- BTRMON.NLM---Btrieve Monitor utility that lets you monitor the activity of Btrieve files, users, and communications resources.
- BTRMON.MSG---Message file for BTRMON.NLM.
- BTRMON.HLP---Help file for BTRMON.NLM.
- BTRVSTUB.NLM---NLM that BROUTER.NLM requires and that provides NetWare Btrieve support for NLMs that need to run in the IOEngine of a NetWare SFT III server.
- BUTIL.NLM---Btrieve Maintenance utility, which is a command line utility that allows you to create, manipulate, and recover Btrieve data files.
- BUTIL.MSG---Message file for BUTIL.NLM.
- RSPXSTUB.NLM---Module that resolves external references for the Btrieve Monitor utility (BTRMON.NLM) when BSPXCOM.NLM is not loaded. If you want to use BTRMON to monitor outgoing requests generated by the NetWare Btrieve Message Router (BROUTER.NLM) to another server and you do not want to load BSPXCOM.NLM, load RSPXSTUB.NLM (instead of BSPXSTUB.NLM) at the server.
- RSPXSTUB.MSG---Message file for RSPXSTUB.NLM.
Files Related to DOS Workstation Operations
The following files are related to Btrieve operations performed on a DOS workstation:
- BREQUEST.EXE---Btrieve Requester for DOS.
- BREQUEST.MSG---Message file for BREQUEST.EXE.
- BREQUTIL.EXE---Btrieve Requester utility that allows you to stop the Requester and to obtain the Requester's version number at a DOS workstation.
- BREQUTIL.MSG---Message file for BREQUTIL.EXE.
- BROLLFWD.EXE---Roll Forward utility for the DOS operating environment. This utility recovers changes made to a Btrieve file between the time of the last backup and a system failure.
- BROLLFWD.MSG---Message file for BROLLFWD.EXE.
Files Related to MS Windows Workstation Operations
The following files are related to Btrieve operations performed on an MS Windows workstation:
- WBROLL.EXE---Roll Forward utility for the Windows operating environment. This utility recovers changes made to a Btrieve file between the time of the last backup and a system failure.
- WBROLLRS.DLL---Resource file for WBROLL.EXE.
- WBTRCALL.DLL---Btrieve Requester for MS Windows.
- WBTRVRES.DLL---Resource file for the Btrieve MS Windows Requester.
- WNDBCNVT.EXE---MS Windows Conversion utility that converts the client-based Btrieve DLL (WBTRCALL.DLL) to WBTRLOCL.DLL.
- NOVDB.INI---Btrieve initialization file for the Btrieve MS Windows Requester.
Files Related to OS/2 Workstation Operations
The following files are related to Btrieve operations performed on an OS/2 workstation:
- PBROLL.EXE---Roll Forward utility for the OS/2 operating environment. This utility recovers changes made to a Btrieve file between the time of the last backup and a system failure.
- PBTRVRES.DLL---Resource file for PBROLL.EXE.
- BTRCALLS.DLL---Btrieve Requester for OS/2.
- NDBCOMM.DLL---Communications handler for the Btrieve Requester for OS/2.
- NDBCNVT.EXE---OS/2 Conversion utility that converts the client-based Btrieve DLL (BTRCALLS.DLL) to BTRLOCL.DLL.
Using the NetWare INSTALL Utility
The NetWare INSTALL utility lets you load the Btrieve program files automatically at the server. For more information on using the NetWare INSTALL utility, refer to your NetWare documentation.
WARNING: In a NetWare 4 environment, NetWare Btrieve 6.1x runs at the highest privilege level (domain 0), with direct access to the NetWare operating system. You cannot run NetWare Btrieve 6.1x in protected mode (domain 1, 2, or 3).
After loading NetWare Btrieve with the INSTALL utility, you can perform one or all of the following procedures, depending on the needs of your installation:
Previous | Next