Upgrading to DataFlex 3.2: Difference between revisions
Lists
m (Heading) |
(Lists) |
||
| Line 594: | Line 594: | ||
In DataFlex 2.3b, many developers kept the runtime files in the same directory as the application files (i.e. data and .flx files). In order to successfully upgrade to DataFlex 3.2, or to run the two (or more) versions of DataFlex simultaneously, these files need to be separated. Runtime files from the two versions will interfere with each other. | In DataFlex 2.3b, many developers kept the runtime files in the same directory as the application files (i.e. data and .flx files). In order to successfully upgrade to DataFlex 3.2, or to run the two (or more) versions of DataFlex simultaneously, these files need to be separated. Runtime files from the two versions will interfere with each other. | ||
The Separation Process (a Step-by-Step Outline) | '''The Separation Process''' (a Step-by-Step Outline) | ||
The following steps will show you how to: Divide the source code and data files from your existing installation into separate areas. This makes maintenance easier and gets you ready to easily upgrade to DataFlex 3.2, as well as Visual DataFlex. | The following steps will show you how to: Divide the source code and data files from your existing installation into separate areas. This makes maintenance easier and gets you ready to easily upgrade to DataFlex 3.2, as well as Visual DataFlex. | ||
Keep one copy of the source code in the 2.3b area and another copy in the 3.2 area. | |||
This allows you to edit either version of the source code without affecting the other. | *Keep one copy of the source code in the 2.3b area and another copy in the 3.2 area. This allows you to edit either version of the source code without affecting the other. | ||
Create a shared data directory. | *Create a shared data directory. | ||
You can access your data files using programs compiled under DataFlex 2.3b and DataFlex 3.2 at the same time. (This works for other revisions, such as 3.1, as well.) | *You can access your data files using programs compiled under DataFlex 2.3b and DataFlex 3.2 at the same time. (This works for other revisions, such as 3.1, as well.) | ||
How to run DataFlex 3.2 and other (prior) revisions concurrently. | *How to run DataFlex 3.2 and other (prior) revisions concurrently. | ||
You can keep existing programs running in an older revision of DataFlex until you have all components working in DataFlex 3.2. | You can keep existing programs running in an older revision of DataFlex until you have all components working in DataFlex 3.2. | ||
1. Create separate directories for the runtime files and application files, and separate data and source code in the process. | 1. Create separate directories for the runtime files and application files, and separate data and source code in the process. | ||
| Line 619: | Line 621: | ||
Concurrently run DataFlex 2.3b and 3.2 (or just 3.2) | Concurrently run DataFlex 2.3b and 3.2 (or just 3.2) | ||
Have an existing directory structure to easily upgrade to Visual DataFlex | Have an existing directory structure to easily upgrade to Visual DataFlex | ||
A. Files to be moved into c:\app\data directory: | A. Files to be moved into c:\app\data directory: | ||
all data files for your application (*.dat, *.k*, *.tag, *.fd, *.def) | :all data files for your application (*.dat, *.k*, *.tag, *.fd, *.def) | ||
filelist.cfg | filelist.cfg | ||
B. Files to be copied into c:\app\src directory: | B. Files to be copied into c:\app\src directory: | ||
One copy of the source code can remain in \df23 for use with (and to keep up) currently running 2.3b applications, and one copy will go into this directory for use with the new 3.2 version. | One copy of the source code can remain in \df23 for use with (and to keep up) currently running 2.3b applications, and one copy will go into this directory for use with the new 3.2 version. | ||
all source code files (*.frm, *.src, *.inc, *.rpt, …) | :all source code files (*.frm, *.src, *.inc, *.rpt, …) | ||
C. Files to remain in c:\df23 (runtime) directory: | C. Files to remain in c:\df23 (runtime) directory: | ||
the most important are the executable files (*.exe) and termlist.cfg | the most important are the executable files (*.exe) and termlist.cfg | ||
see Appendix A for a complete list of files that are installed by a DataFlex 2.3b Development License – these are the files that should remain in the c:\df23 directory | see Appendix A for a complete list of files that are installed by a DataFlex 2.3b Development License – these are the files that should remain in the c:\df23 directory | ||
2. Install 3.2 into a separate directory and install your DataFlex 3.2 registration code | 2. Install 3.2 into a separate directory and install your DataFlex 3.2 registration code | ||
| Line 640: | Line 646: | ||
DOS/Windows: Remember to execute the c:\df32\usr\setpath.bat batch file before running DFSetup.exe to install your registration code. | DOS/Windows: Remember to execute the c:\df32\usr\setpath.bat batch file before running DFSetup.exe to install your registration code. | ||
Linux/Unix: Remember to execute the /usr/local/df32/usr/setpath script before running dfsetup to install your registration code. | Linux/Unix: Remember to execute the /usr/local/df32/usr/setpath script before running dfsetup to install your registration code. | ||
3. Concurrently Running DataFlex 2.3b and 3.2 | 3. Concurrently Running DataFlex 2.3b and 3.2 | ||
| Line 650: | Line 657: | ||
Before: | Before: | ||
dfpath=.;c:\df32\usr;c:\df32\usr\help;c:\df32\lib;c:\df32\bin; | dfpath=.;c:\df32\usr;c:\df32\usr\help;c:\df32\lib;c:\df32\bin;c:\df32\src\pkg;c:\df32\usr\examples\expense;c:\df32\usr\examples\dar;c:\df32\usr\examples\ordentry;c:\df32\usr\examples\big;c:\df32\usr\examples\report;c:\df32\usr\examples\data; | ||
c:\df32\src\pkg;c:\df32\usr\examples\expense; | |||
c:\df32\usr\examples\dar;c:\df32\usr\examples\ordentry; | |||
c:\df32\usr\examples\big;c:\df32\usr\examples\report; | |||
c:\df32\usr\examples\data; | |||
After: | After: | ||
dfpath=.;c:\app\data;c:\df32\usr;c:\df32\usr\help;c:\df32\lib; | dfpath=.;c:\app\data;c:\df32\usr;c:\df32\usr\help;c:\df32\lib;c:\df32\bin;c:\df32\src\pkg;c:\df32\usr\examples\expense;c:\df32\usr\examples\dar;c:\df32\usr\examples\ordentry;c:\df32\usr\examples\big;c:\df32\usr\examples\report;c:\df32\usr\examples\data; | ||
c:\df32\bin;c:\df32\src\pkg;c:\df32\usr\examples\expense; | |||
c:\df32\usr\examples\dar;c:\df32\usr\examples\ordentry; | |||
c:\df32\usr\examples\big;c:\df32\usr\examples\report; | |||
c:\df32\usr\examples\data; | |||
Note: the DFPath statements above may appear different depending on the software you use to view or print this document, but each DFPath statement is a single continuous statement. | Note: the DFPath statements above may appear different depending on the software you use to view or print this document, but each DFPath statement is a single continuous statement. | ||
| Line 674: | Line 673: | ||
B. Running DataFlex 2.3b | B. Running DataFlex 2.3b | ||
Switch to c:\df23 directory | *Switch to c:\df23 directory | ||
Set the DFPATH environment variable: | *Set the DFPATH environment variable: | ||
set DFPATH=.;c:\app\data | *set DFPATH=.;c:\app\data | ||
Make sure c:\df23 is in your PATH environment variable | *Make sure c:\df23 is in your PATH environment variable | ||
Run DataFlex (dfrun ProgramName, dfcomp, dfquery, etc.) | *Run DataFlex (dfrun ProgramName, dfcomp, dfquery, etc.) | ||
== Moving on to Visual DataFlex == | == Moving on to Visual DataFlex == | ||