Web Connection Installation

Please read this document if you're installing Web Connection for the first time or even if you are doing an update installation. It contains important information that might save you some trouble during installation especially during updates.

Requirements

  • Windows 10, 8, 7, Vista, 2012, 2008, 2003
  • Windows Web Server IIS 7 or later, IIS Express, IIS 6 or Apache 2
  • Visual FoxPro 9.0

Extracting the Self Extracting Zip Archive

You can download the shareware version of Web Connection from a public link, while the full version download link is provided to you via a registration email. The shareware version is named wconnect.exe, the registered version is named WebConnection-<version>.exe.

These files are self-executing Zip archives and can be executed as an EXE with prompts where to install. Alternately, the EXE can be opened with your favorite Zip utility (ie. 7zip, WinZip and WinRar) and extracted using your tool or pick out individual files.

Self Extractor Failures

Should you run into extractor errors when updating an existing installation due to locked or hidden/system files, we recommend you open the EXE with your favorite Zip utility and manually extract all files into your installation folder.

Running Setup.exe

Open up Explorer in c:\wconnect (or whereever extracted to) and execute Setup.exe, which installs or updates Web Connection. If you are updating from an existing version you can decide whether to re-run setup to configure and update the samples, or simply unzip the Exe file directly into the existing installation.

IIS has to be already installed

If you plan to use IIS for development, IIS has to be installed and properly configured before you install Web Connection. IIS is an optional Windows component and you have to explicitly install it. There are detailed instructions on how to configure IIS in the documentation. Optionally you can also use IIS Express which does not require any explicit configuration or Admin rights to run.

First Time or Update Installation

Please run Setup.exe from the install directory and just accept all the prompts. There are detailed instructions on what the Setup program does and how to get started. This will install the sample Web folders, set permissions and get the samples ready for you to play and check out Web Connection in operation.

No FoxPro Runtimes?

If you do not have the VFP runtime files installed you can also run the appropriate Setup.exe file from within Visual FoxPro. Start Visual FoxPro and CD then DO SETUP.exe to launch setup from within VFP. Make sure you use Run As Administrator as configuration features require full admin access.

Updating an existing Installation

If you are updating an existing installation, running the above setup is optional, but still recommended. You'll want to re-run setup on your existing installation on major updates to insure the latest example files are installed and hooked up. If you do it's recommended you choose the same setup directories as in the previous installation. NOTE: If you changed any of the sample files the changes will be overwritten. Hopefully you wrote code in your own files and classes.

Upgrading from the Shareware Version

To upgrade you can simply install Web Connection either to a new directory or on top of your shareware installation. If you install on top of an existing installation simply unzip the distribution files into the original directory. Make sure you delete WCONNECT.APP to remove the compiled shareware file and recompile all files of your project to remove any shareware limitations from your installation. Recompile your classes! If you are updating an existing install or are not installing under VFP 9.0 you should first recompile all of the Web Connection classes to ensure you get the latest code and properly compiled compiled code for your version of FoxPro. To do so, start Web Connection in its install directory and do:

COMPILE CLASSES\*.prg
COMPILE CLASSLIB CLASSES\*.vcx

What's installed

The installed folder contains the base Web Connection installation which contains the Console application and sample server and Web sample pages that demonstrate how Web Connection works.

The Console application is the hub for Web Connection's administration features that allow you to create new projects or add functionality to existing projects as well as add new features and functionality. The bulk of the files installed are templates base files that are used to create new projects or new files.

The install also creates a sample Web Connection server and a number of corresponding Web samples which you can run and examine to see how Web Connection works.

There's a feature sample that shows many of the core features of Web Connection in very simple task based examples. Then there are a host of example applications that demonstrate a number of different approaches to building more complex Web Connection applications. The examples include a Weblog, a Message Board, a AngularJS client side AlbumViewer example.

If you get stuck

If you run into problems with your installation or getting started there are a few resources available.

Documentation

The online documentation is extensive and provides a lot of useful information. Most tasks have walk throughs that you can check out to understand a feature or process. The documentation is available both online as well as in the Help File. Both are searchable so you can find what you're looking for.

West Wind Message Board Support Forum

We have a message board that you can use to post questions and get answers to in a timely manner from the authors or from the community. For any support issues - bugs, comments and suggestions - the message board is the place to go. We answer all questions within a day, and most questions within a much shorter time frame. This is the best place to have a discussion about issues and problems or simply to ask questions if you get stuck.

We also offer paid support if you feel you need more complex support or are dealing with company specific or sensitive sensitive issues.


© West Wind Technologies, 1996-2016 • Updated: 04/15/16
Comment or report problem with topic