Upgrading to DBISAM 3.19

These instructions describe how to upgrade the Rubicon 2.13 packages that were compiled with DBISAM 3.17 to the new DBISAM 3.19 packages under Delphi 5.  While the details may differ, the basic techniques described here can be applied to other versions of Delphi or C++ Builder, other versions of DBISAM, and other Rubicon drivers.  Steps shown in blue are only required for those packages such as DBISAM and FlashFiler which give each release a unique package name.

First, be sure Rubicon 2.13 and DBISAM 3.19 are installed.  Since Rubicon 2.13 was compiled with DBISAM 3.17, the Rubicon DBISAM drivers will not load correctly when Delphi 5 is started.  There are two ways to upgrade the Rubicon DBISAM drivers: with the Delphi IDE and with the Delphi command line compiler.

Delphi IDE

1. Start Delphi 5
2. If you get an error message about being unable to load rb20d50d.bpl, click 'No' so Delphi does not attempt to load it again next time
3. Click Tools | Environment Options | Library and check that 'BPL output directory' and 'DCP output directory' are blank.  This will force the package files about to be compiled to be placed in \rubicon2\d5 (overwriting the old versions).
4. Open \rubicon2\d5\rb20d50r.dpk
5. Ignore any error about the package being in an older format (you may press 'Yes' or 'No', it makes no difference)
6. Right click on the dialog box
7. Click on View Source
8. Find db317d5r and change it to db319d5r (the current package name)
9. Press Ctrl+S to save the changes
10. Return to the package dialog box
11. Press Compile
12. Press OK when done compiling
13. Open \rubicon2\d5\rb20d50d.dpk
14. Press Install
15. Press OK when done installing
16. Exit Delphi
17. Copy the new \rubicon2\d5\rb20d50r.bpl to your system directory.

Delphi Command Line Compiler

1. Exit Delphi 5
2. Open a Command Prompt or DOS Window
3. Change the directory to \rubicon2\d5
4. Open rb20d50r.dpk with Notepad
5. Change db317d5r to db319d5r (the current package name)
6. Save the changes and exit Notepad
7. Execute the following command to recompile the Rubicon DBISAM driver run time package (the path to dcc32.exe and the DBISAM library may vary):
   "c:\program files\borland\delphi5\bin\dcc32"
rb20d50r.dpk -Ud:\dbisam\d5\lib;..\
8. Execute the following command to recompile the Rubicon DBISAM driver design time package (the path to dcc32.exe and the DBISAM library may vary):
   "c:\program files\borland\delphi5\bin\dcc32"
rb20d50d.dpk -Ud:\dbisam\d5\lib;..\
9. Confirm that the new bpl and dcp files have been created in \rubicon2\d5.  If not, check to see if a different output directory is specified in \program files\borland\\delphi5 \bin\dcc32.cfg, and if so, remove it.
10. Copy rb20d50r.bpl to your system directory
11. Start Delphi 5
12. Click Component | Install Packages and make sure that the Rubicon DBISAM driver has a checkmark (This assumes that a prior version of the Rubicon driver was installed.  If not, then rb20d50d.bpl will have to be installed)

Troubleshooting

The most common problem that occurs during recompiling is that one or more out of date files are visible to the compiler.  Check your system for rb20d50?.*.  These files should only be in \rubicon2\d5 and your system directory.  In addition, you may have to delete the following from \rubicon2\d5: rb20d50?.dcp, rb20d50?.dof, rb20d50?.bpl, and rb20d50?.dcu (for C++ Builder also delete rb20d50?.lib, rb20d50?.obj, rb20d50?.tds, and rb20d50?.bpi).

If you are using the command line compiler, check that the path information in \program files\borland\\delphi5\bin\dcc32.cfg is correct.