Revised 01/12/00

PERVASIVE.SQL 7.0SERVICE PACK INSTALLATION GUIDE

For Novell NetWare

ebix.com makes every effort to verify that the information published in this guideis accurate. ebix.com reserves the right to modify or change the contents of thisguide at any time, without any obligation to notify any person or entity of suchchanges.

Page 2 of 26

TABLE OF CONTENTS

PRE-INSTALLATION CHECKLIST ................................................................................................ 4

PART I - PERVASIVE SERVICE PACK SERVER INSTALLATION.............................................. 5

PRE-INSTALLATION PROCEDURE...................................................................................................... 5STEP 1 .......................................................................................................................................... 5STEP 2 .......................................................................................................................................... 5STEP 3 .......................................................................................................................................... 5STEP 4 .......................................................................................................................................... 5STEP 5 .......................................................................................................................................... 5STEP 6 .......................................................................................................................................... 6STEP 7 .......................................................................................................................................... 6STEP 8 .......................................................................................................................................... 7STEP 9 .......................................................................................................................................... 8STEP 10 ........................................................................................................................................ 8

PART II - UPDATING FOLDERS ON SERVER.............................................................................. 9

STEP 1 .......................................................................................................................................... 9STEP 2 .......................................................................................................................................... 9STEP 3 ........................................................................................................................................ 10STEP 4 ........................................................................................................................................ 10

PART III - PERVASIVE SERVICE PACK CLIENT REQUESTER INSTALLATION .................... 11

STEP 1 ........................................................................................................................................ 11STEP 2 ........................................................................................................................................ 11STEP 3 ........................................................................................................................................ 11STEP 4 ........................................................................................................................................ 11STEP 5 ........................................................................................................................................ 12STEP 6 ........................................................................................................................................ 12STEP 7 ........................................................................................................................................ 13STEP 8 ........................................................................................................................................ 13

APPENDIX A: REMOVING OUTDATED VERSIONS OF BTRIEVE (VERSION 6.15 AND 6.10)15

APPENDIX B: HOW TO DETERMINE THE VERSION (BUILD NUMBER) OF THE EXISTINGPERVASIVE SERVICE PACK ...................................................................................................... 16

PART 1 - CHECKING THE VERSION OF PERVASIVE SERVICE PACK ON THE FILE SERVER ................... 16STEP1 ......................................................................................................................................... 16STEP2 ......................................................................................................................................... 16STEP3 ......................................................................................................................................... 16PART 2 - CHECKING THE VERSION OF PERVASIVE SERVICE PACK FOR THE CLIENT REQUESTER

(WINDOWS 95/98 WORKSTATION) ................................................................................................. 17STEP1 ......................................................................................................................................... 17STEP2 ......................................................................................................................................... 17STEP3 ......................................................................................................................................... 17

APPENDIX C: HOW TO STOP, RELOAD AND CHANGE FILE ATTRIBUTE OF PERVASIVE(BTRIEVE) AND SCALABLE SQL MODULES. ........................................................................... 18

PART 1 - STOPPING THE MODULES................................................................................................ 18STEP1 ......................................................................................................................................... 18STEP2 ......................................................................................................................................... 18PART 2 - RELOADING THE MODULES (AFTER APPLYING THE PATCHES)............................................ 18STEP1 ......................................................................................................................................... 18

Page 3 of 26

STEP2 ......................................................................................................................................... 18PART 3 – VERIFYING AND CHANGING (IF NEEDED) THE FILE ATTRIBUTE OF THE BTRIEVE AND SQLMODULES..................................................................................................................................... 19STEP 1 ........................................................................................................................................ 19STEP 2 ........................................................................................................................................ 19STEP 3 ........................................................................................................................................ 19STEP 4 ........................................................................................................................................ 19STEP 5 ........................................................................................................................................ 19

APPENDIX D: PERVASIVE SQL SERVICE PACK 3 SERVER INSTALLATION ....................... 20

STEP 1 ........................................................................................................................................ 20STEP 2 ........................................................................................................................................ 20STEP 3 ........................................................................................................................................ 20STEP 4 ........................................................................................................................................ 21STEP 5 ........................................................................................................................................ 21STEP 6 ........................................................................................................................................ 22STEP 7 ........................................................................................................................................ 23STEP 8 ........................................................................................................................................ 23

APPENDIX E: PERVASIVE SERVICE PACK 3 CLIENT REQUESTER INSTALLATION......... 24

STEP 1 ........................................................................................................................................ 24STEP 2 ........................................................................................................................................ 24STEP 3 ........................................................................................................................................ 24STEP 4 ........................................................................................................................................ 25STEP 5 ........................................................................................................................................ 25STEP 6 ........................................................................................................................................ 26STEP 7 ........................................................................................................................................ 26

Page 4 of 26

PRE-INSTALLATION CHECKLIST

• Important - Perform a complete backup of your server prior toinstalling the Pervasive Service Pack on the NetWare server.

• Check if you have the latest NetWare Support Pack installed. You may download theSupport Pack from the Novell web site. (http://support.novell.com/misc/patlst.htm)A qualified Novell administrator or engineer should do this.

• The Pervasive Service pack installation will require a CD-ROM drive on theadministrative workstation.

• Determine where the Pervasive installation directories (BIN / Clients / Doc…etc) arecurrently located on the server drive. The Pervasive installation directories areinstalled under PVSW by default (Example F:\PVSW). You should have only onePVSW folder on the NetWare file server. If you have installed Pervasive SQL 7 to theserver more than once, you may have a duplicate PVSW folder perhaps on adifferent server drive. It is recommended that you remove any duplicate PVSWfolders on the same server. You may find PVSW on your local workstation(C:\PVSW). This is the default folder for the Pervasive client.

If you have a BTI folder on the server (Example F:\BTI), chances are you still haveBtrieve version 6.15 installed. It is recommended that you remove all the old Btrievefiles from both the file server and the workstations. (See APPENDIX A)

• Determine the version (build number) of Pervasive Service Pack currently installedon the server. (See Part 1 of APPENDIX B)

Note: If the current Pervasive Service Pack build number is 152, you have the finalPervasive Service Pack for SQL 7 installed. You do not need to apply any PervasiveService Packs on the file server. However, you may still need to apply the PervasiveClient Service Pack on the workstations. (See Part 2 of APPENDIX B)

Note:Pervasive Service Pack 3 includes Pervasive Service Pack 1 and Service Pack 2.Pervasive Service Pack 5 includes Pervasive Service Pack 4.

• Check and make sure the file attribute of the Pervasive modules (NLMs) is not read-only. (See Part 3 of APPENDIX C)

• For ebix.com technical support, pcANYWHERE32 Version 8.0 or later is required. Itmust be installed and tested on the administrative workstation. A 56k modem isrequired on the administrative workstation.

Page 5 of 26

PART I - PERVASIVE SERVICE PACK SERVER INSTALLATION

Pre-installation procedure• Stop the Btrieve and Scalable SQL modules. (See Part 1 of APPENDIX C)

Note: The rest of the steps in PART I must be done at the administrative workstation.• If you have not already done so, check and make sure that the file attribute of the

Pervasive modules is not read-only. (See Part 3 of APPENDIX C)

Step 1• Have all users log out of ebix.one (cd.one) completely.• Log onto the network as an Administrator or someone with Supervisor RIGHTS.• Place the ebix.com QMR Q4-99 disc in CD-ROM drive.

Step 2• Click on Start and select Run. Click on the BROWSE button to locate the CD-ROM

drive. Expand the Pervasive Service Packs folder. Expand the Novell folder. Doubleclick on the Client folder.

• Copy SP3CLIENT.EXE and SP5CLNT.EXE to the PVSW folder on the Server.

Step 3Note: You should have already determined the Service Pack version (build number)installed on the file server. (See PRE-INSTALLATION CHECKLIST)

• If the current Service Pack build number is 112 or 132 go to Step 4 now.• If the current Service Pack build number is less than 112, you must install Pervasive

Service Pack 3 (See APPENDIX D) prior to installing Service Pack 5 for the server.

Step 4• Locate SP5NW_CI.EXE on the CD-ROM drive under

Pervasive Service Packs \ Novell \ Server folder.• Double click on SP5NW_CI.EXE

Step 5Click on Setup.

Page 6 of 26

Step 6Click on Next.

Step 7Check and verify if the Pervasive installation path (PVSW) on the server is correct. Itshould be F:\PVSW. If not click on Browse to change it to the “Client Path”.

Page 7 of 26

Step 8Click on next.

Note: This is a reminder to stop Pervasive modules. (See Part 1 of APPENDIX C) Clickon next to continue.

Page 8 of 26

Step 9Click on next.

Step 10Click Finish. Viewing the Report is usually not required unless there is a large number ofWarnings (over five). Call ebix.one support if you do have a large number of Warnings.

Page 9 of 26

PART II - UPDATING FOLDERS ON SERVER

Note: The steps in PART II must be done at the administrative workstation.

Step 1Open the Microsoft Explorer (Right click on My Computer. Select Explore).• Browse and expand the PVSW folder on the server (F:\PVSW).• Hold down the Ctrl key then highlight Demodata and Sample folders in the Contents

window.

Step 2Click on Edit and select Copy.

Page 10 of 26

Step 3Expand the Clients folder under PVSW then double click the Win32 folder.

Step 4Click on Edit and then select Paste. Click on View and select Refresh. You should nowfind Demodata and Samples folders under the Win32 folder.

Page 11 of 26

PART III - PERVASIVE SERVICE PACK CLIENT REQUESTERINSTALLATION

Note: PART III must be done at EACH workstation.

Step 1

• Exit all Window programs before applying Pervasive Service Pack.• At the workstation, click on Start. Select Run. Browse, locate and click the PVSW

folder on the server (F:\PVSW).

Step 2

• Determine the Pervasive Service Pack version (build number) on the workstation.(See Part 2 of APPENDIX B)

• If the current Service Pack build number is 112 or 132 go to Step 3 now.• If the current Service Pack build number is less than 112, you must install Pervasive

Service Pack 3 Client Requester prior installing Service Pack 5 Client Requester.(See APPENDIX E)

Step 3Double click on SP5CLNT.EXE found under the PVSW folder on the server. Click onSetup.

Step 4Click on Next.

Page 12 of 26

Step 5Click on Next.

Step 6Click on Next.

Page 13 of 26

Step 7Click on Next.

Step 8Click Finish. Viewing the Report is usually not required unless there is a large number ofWarnings (over five). Call ebix.one support if you do have a large number of Warnings.

Page 14 of 26

Page 15 of 26

APPENDIX A: REMOVING OUTDATED VERSIONS OF BTRIEVE(VERSION 6.15 AND 6.10)

Note: There is no uninstall program to uninstall Btrieve 6.10 or 6.15. The outdated fileshave to be removed manually.

From the workstation, locate and delete the BTI folder on the file server. (F:\BTI)

Use the Find utility to search for files listed below. (Click on Start. Select Find, then goto Files or Folders.)

Remove all the following files on the file server’s PUBLIC folder (F:\PUBLIC). Also findand remove any of those files found on the workstation’s C:\WINDOWS folder.

BREQNT.EXEBREQUEST.EXEBREQUTIL.EXEBROLLFWD.EXEDBU_UI.DLLNWIPXSPX.DLLNWLOCALE.DLL

PBROLL.EXEW16NR.DLLW32BTICM.DLLW32NR.DLLW32RQCFG.EXEWBROLL.EXEWBROLLRS.DLL

WBTICOMM.DLLWBTRCALL.DLLWBTRTHNK.DLLWBTRV32.DLLWBTRVRES.DLL

Note: Many, if not all, of these files are found in your C:\WINDOWS\SYSTEM folder.DO NOT REMOVE THEM from C:\WINDOWS\SYSTEM folder

If you are currently using Version 6.10 you will need to perform these additional steps:

a) Use Microsoft Explorer to browse your C:\WINDOWS folder.b) Locate Winstart.bat. Highlight this file.c) Right click on Winstart.bat and choose edit.d) Delete the line(s) containing brequest.exe.e) From the File menu select Save.f) From the File menu select Exit.

Page 16 of 26

APPENDIX B: HOW TO DETERMINE THE VERSION (BUILDNUMBER) OF THE EXISTING PERVASIVE SERVICE PACK

Part 1 - Checking the version of Pervasive Service Pack on the file Server

Step1Go to the file server or use RCONSOLE to access the server’s System Console prompt.

Step2At the System Console prompt, type the following then press Enter:

load butil –ver /s

Look for Build number to the right of BTUIL.NLM v7.0.0You should see something similar to the following.

Step3Use the following guideline for interpreting the most recent service pack installed

Build 76 means the original install - No Service Pack installed.Build 92 means Service Pack 1 is installed (on the server).Build104 means Service Pack 2 is installed (on the server).Build 112 means Service Pack 3 is installed (on the server).Build 132 means Service Pack 4 is installed (on the server).Build 152 means Service Pack 5 is installed (on the server).

Note: If the build number is 152, you do not need to apply any Pervasive Service Packfor the server.

Page 17 of 26

Part 2 - Checking the version of Pervasive Service Pack for the ClientRequester (Windows 95/98 workstation)

Step1 At the workstation, click on Start. Select Programs. Select MS-DOS Prompt.

Step2At the DOS prompt type the following then press Enter.

BUTIL –VER

The build number is on the upper right. You should see something similar to thefollowing:

Step3Use the following guideline for interpreting the most recent service pack installed

Build 76 means the original install - No Service Pack installed.Build 92 means Service Pack 1 is installed (on the workstation).Build104 means Service Pack 2 is installed (on the workstation).Build 112 means Service Pack 3 is installed (on the workstation).Build 132 means Service Pack 4 is installed (on the workstation).Build 152 means Service Pack 5 is installed (on the workstation).

Note: If the build number is 152, you do not need to apply any Pervasive Service Packfor this workstation.

Page 18 of 26

APPENDIX C: HOW TO STOP, RELOAD AND CHANGE FILEATTRIBUTE OF PERVASIVE (BTRIEVE) AND SCALABLE SQLMODULES.

Part 1 - Stopping the modules

Step1Go to the file server or use RCONSOLE to access the server’s System Console prompt.

Step2At the System Console prompt type the following:SQLSTOP (press Enter)BSTOP (press Enter)You should see something similar to the following.

Part 2 - Reloading the modules (after applying the patches)

Step1Go to the file server or use RCONSOLE to access the server’s System Console prompt.

Step2At the System Console prompt type the following:SQLSTART (press Enter)

Note: You do not need to type BSTART, the BSTART command is included inSQLSTART command.

Page 19 of 26

Part 3 – Verifying and changing (if needed) the file attribute of the Btrieveand SQL modules

Step 1At the workstation, log onto the network as an Administrator or someone with SupervisorRIGHTS.

Step 2Click on Start. Select Programs. Select MS-DOS Prompt.

Step 3At the DOS prompt, type F: (Press Enter) then type CD\SYSTEM (Press Enter)

Step 4Type FLAG BTRIEVE.NLM (Press Enter)If you see “Ro” (readonly) in the square bracket [Ro], go to step 5.If you see “Rw” (readwrite) in the square bracket [Rw], skip step 5.

Step 5Type FLAG BTRIEVE.NLM +RW SUB (Press Enter)Repeat step 5 with rest of the NLMs listed below – substitute BTRIEVE.NLM with theones listed below.BREBUILD.NLMBROUTER.NLMBSPXCOM.NLMBSTART.NCFBSTOP.NCFBTCPCOM.NLMBTIMSG.NLMBUTIL.NLMNWBSRVCM.NLMNWINSEP.NLMNWINSIB.NLMNWINSS2.NLMNWMKDE.NLMNWSSRVCM.NLMNWUCINIT.NLMNWUCMGR.NLMNWUCUTIL.NLMRIUTIL.NLMSQLSTART.NCFSQLSTOP.NCFSQLUTIL.NLMSSPXCOM.NLMSSQL.NLMSTCPCOM.NLM

Page 20 of 26

APPENDIX D: PERVASIVE SQL SERVICE PACK 3 SERVERINSTALLATION

Step 1

• Have all users log out of ebix.one (cd.one)

• Stop the Pervasive (Btrieve) and Scalable SQL modules on the server .(See Part 1 of APPENDIX C)

• If you have not already done so, check and make sure that the file attribute of thePervasive modules is not read-only. (See Part 3 of APPENDIX C)

Step 2

• Place the ebix.com QMR Q4-99 disc in CD-ROM drive.

• Click on Start and select Run. Click on the BROWSE button to locate the CD-ROMdrive. Expand Pervasive Service Packs folder. Expand the Novell folder.

• Click on the Server folder.

• Double click on SP3NW_CI.EXE

Step 3

Click on Setup.

Page 21 of 26

Step 4Click on Next.

Step 5Verify the Clients path for the existing Pervasive installation on the Novell server iscorrect. It should be F:\PVSW. If not click on Browse to change it to the correct path.Click on Next.

Page 22 of 26

Step 6Click on Next.

Note: This is a reminder to stop Pervasive modules. (See Part 1 of APPENDIX C) Clickon next to continue.

Page 23 of 26

Step 7Click Next.

Step 8Click Finish. Viewing the Report is usually not required unless there is a large number ofWarnings (over five). Call ebix.one support if you do have a large number of Warnings.

Page 24 of 26

APPENDIX E: PERVASIVE SERVICE PACK 3 CLIENTREQUESTER INSTALLATION

Note: Apply the Pervasive Service Pack 3 Client Requester only if the current ServicePack build number on the workstation is less than 112. (See Part 2 of APPENDIX B)

If you have not installed the Pervasive Service Pack 3 for the server, you mustinstall it prior to installing the Pervasive Service Pack 3 client requester.

Step 1• Exit all Window programs prior to applying Pervasive Service Pack.• At the workstation, click Start. Select Run. Browse and locate the PVSW folder on

the server (F:\PVSW).• Double click on SP3CLIENT.EXE under the PVSW folder on the server.

Step 2Click on Setup.

Step 3Click on Next.

Page 25 of 26

Step 4Click on Next

Step 5Click on Next

Page 26 of 26

Step 6Click on Next

Step 7Click Finish. Viewing the Report is usually not required unless there is a large number ofWarnings (over five). Call ebix.one support if you do have a large number of Warnings.