Updating from previous Versions
Web Connection is updated frequently and so you'll often have to update an existing installation with the core files from a new version. This topic refers to same version updates (ie. 6.10 -> 6.15 for example).
To update an existing installation with the new Web Connection installation you can install the new version on top of the old one. Simply unzip the new files into your old installation directory.
Note that if you've modified any of the samples files, or any of the framework files you won't want to update the existing installation or at least make sure you do a backup prior to installation of the new version. In general doing a back up of the old install is probably a good idea.
After you've installed the new files over the existing installation, make sure you:
- Delete all FXP files in the project directories
- Recompile all PRG and VCX files
- Update DLLs in production apps
- Update the Web specific files (Script Handlers,CSS)
To recompile all code files to the latest version is necessary to ensure that both the FXP files as well as your project is recompiled. You can do the following from the VFP Command Window in the Web Connection startup directory:
CLOSE ALL CLEAR ALL DELETE FILE classes\*.fxp DELETE FILE *.fxp COMPILE classes\*.prg COMPILE CLASS CLASSES\*.vcx
Web Connection uses a number of DLL files that are distributed in the Web Connection root folder. These files are required in deployed applications and should match the versions that you are running during development.
The DLLs in questions include:
- dzip.dll, dunzip.dll
Of these files wwIPStuff.dll, wwDotnetBridge.dll and zlib1.dll are core dependencies that have to be present as they are used internally in Web Connection.
The remainder of files are specific use cases but I recommend you copy and update them nevertheless.
We recommend you copy all the DLLs from the Web Connection install folder to your live application deploy folder. You can also use the build.bat file in Web Connection projects to create a
Buildfolder that includes your binary files along with the Web Connection required dlls in the
templates\scripts\webconnectionmodule.dll -> Web Dir\bin\webconnection.dll templates\scripts\wc.dll -> Web Dir\bin\wc.dll templates\ProjectTemplate\Web\scripts -> Web Dir\scripts templates\ProjectTemplate\Web\css -> Web Dir\css templates\ProjectTemplate\Web\admin -> Web Dir\admin
Important: If you've modified any of the files, they will be overwritten. Especially make sure that you rename
application.cssin your application to something that is specific to your own application or only overrides styles in application.css.
When you create a new project Web Connection generates a number of files which is a one time process. These files are generated from templates and these templates occasionally change, so from time to time it's a good idea to check and see what has changed.
A good recommendation if you would like to update these files is:
If you have older projects and you want to update to the latest support files I recommend:
- Create a new project into a new folder
- Use BeyondCompare or similar to compare files
You'll want to compare at the following files:
In addition you'll probably want to update your
web\lib folder if there are changes.
Always back up or commit your changes to source control before making changes like this so you can roll back if necessary.
+++ Rick ---
Comment or report problem with topic