Installing and Using the V8DD7 Patch - for Version 8.2
INTRODUCTION:
=============
This KBase entry describes HOW TO install and use V8DD7 patch with
the 32-bit version of Progress (8.2). It is a SUPPLEMENT to the
README.DOC that comes with the V8DD7 patch and CAN be used IN LIEU of
the README.DOC. There is a separate Knowledgebase entry for (#15615)
for using v8dd7 with version 8.1 of Progress.
WHY YOU NEED TO KNOW THIS:
==========================
Some of our Users have failed to review the README.DOC or have had a
problem following the instructions in the README.DOC. The purpose of
this Kbase is to clarify the installation of and use of the V8DD7
patch.
PROCEDURAL APPROACH:
====================
Purpose of the V8DD7 patch.
---------------------------
The .r code within this patch will enable users who have V8 clients to
update a database that is running under a V7 server. The .r code that
has been provided in the patch has been generated from the version 7
dictionary code and was compiled using a V8 client.
Installation:
-------------
Make a directory in which these files should be installed and cd to
that directory:
Example: mkdir \v8dd7
cd \v8dd7
Uncompress the files: pkunzip -d a:v8dd7.zip
Steps to Use: NOTE: Examples use default C:\DLC directory.
-------------
1) The .r code that is provided must be copied into a separate
directory structure from the current V8 installed code.
2) COPY the PROGRESS.INI file from the DLC\BIN directory to the V8DD7
directory. There should now be TWO PROGRESS.INI files on the system.
One should be in the V8DD7 directory, the other in the DCL\BIN dir.
3. Modify the PROPATH statement in the [Startup] section of the
PROGRESS.INI file located in the V8DD7 directory to include the
C:\V8DD7\gui directory.
NOTE: The C:\V8DD7\gui entry in the PROPATH statement should be the
FIRST entry in the PROPATH statement. Do NOT modify the
PROGRESS.INI file in the DLC\BIN directory. The INTENT is to use
PROGRESS.INI file in the V8DD7 directory with the V8DD7 .r files,
and the PROGRESS.INI file in the DLC\BIN directory with the .r code
that was installed with the V8 Progress install program ( DLC dir.)
4. Within Windows, create a Program Item that executes the following
command line:
C:\DLC\BIN\PROWIN32.EXE -basekey "INI"
-ininame C:\V8DD7\PROGRESS.INI dbname -N <protocol> -S servicename
-p _DICT.P
Note: This should all be typed on one line. The database
connection parameters must be included. They could also be put
in a pf file.
This will execute the Data Dictionary code. If the users needs to
use the database administration tool then they should execute the
following command line:
C:\DLC\BIN\PROWIN32.EXE -basekey "INI"
-ininame C:\V8DD7\PROGRESS.INI dbname -N <protocol> -S servicename
-p _ADMIN.P
Note: This should all be typed on one line. The database
connection parameters must be included. They could also be put
in a pf file.
Issues/Notes:
-------------
1. The database create menu option has been disabled in both the
dictionary and administartive tools.
FOR EXAMPLE: If the user executes the _DICT.P code as above, they
will only be able to select "CONNECT TO EXISTING DATABASE".
RECOMMEND that users execute the _DICT.P code as above to ensure
the V8DD7 patch installation is setup correctly.
2. Users should ONLY access dictionary and administrative tools with
this .r code. All other tools, although accessible, should not be
used in this mode as their behavior is unknown.
3. Users can connect to a V8 database using this .r code however,
they will not be able to make modifications to the database.
4. Version 8 HELP Information will appear when help is asked for using
this patch. The V8 HELP may contain additional information that
does not apply to V7 dictionary and administration tools.
5. If you do not include database connection parameters on the command
line, you will get a connection dialog box, but it will not work.
Refereneces.
------------
See following Kbase entry for additional information:
15546 Cannot Use V8 Data Dictionary for V7 Database Schema Changes
Progress Software Technical Support Note # 15615