The AFP is now correctly installed, but how does it interact with the Web server? In this section we will demonstrate the integration in the Microsoft Internet Information Services (IIS) by way of an example. Active FoxPro Pages functions in conjunction mit ISAPI-compatible Web servers including Apache 2.0.x or higher, VisNetic WebSite (former O’Reilly Web server) and others.

In case you made a recommended or full installation AFP is now interacting with the Web server identified by it. In an advanced installation you had the opportunity to decide for yourself whether integration was to be done automatically or not.

Let us look at the details or review them. The setup modifies the MetaBase of IIS to the effect that the configuration of the WWW service for the use of AFP is modified – not, however, the configuration of the individual virtual Websites. This can't be completed successfully unless there is no pre-existing configuration. This is of particular importance for upgrades from v. 2.4 to v. 3.0. The configuration should be done such that the file extension .AFP is mapped to AFP3.DLL (including complete path).

To configure individual (virtual) Web directories, open Default Website Properties and go to the tab Home Directory:

Click Configuration to edit the existing script extension. Most likely there are a number of file extensions already set up; add the AFP to your list, if it isn't already on it. Once this is done IIS will know how to handle AFP pages and will hand the request to AFP3.DLL.

We have noticed that there may be problems with the application assignments if long directory names or directory names containing blanks are used. In cases like these, convert the path info to its short form. The invocation will then function properly.

Confirm the open dialogues by clicking the OK buttons and re-start the AFP-activated Web directory. The re-start isn't really mandatory, although it won't do any damage, and we recommend it – just to be on the safe side.

If you run Apache HTTP Server version 2.0.x or higher, the AFP setup will have copied a file named httpd.afp.conf to the directory conf. Please have a look at it and note the differences to your existing file. With the help of this template you should be able get the Apache familiarized with the AFP. We are already working on improvements in this area. These are complex configurations where intervention is touchy; this is why we don't want to use the auto configuration at this stage. We hope you agree.