Microsoft Internet Information Services

Using the PopChart ISAPI redirector, you can use HTTP redirection with Microsoft's Internet Information Services (IIS). ISAPI (Internet Server Application Program Interface) is an API created by Microsoft that allows its Internet Information Server (IIS) to communicate with other applications. The PopChart Server ISAPI module integrates PopChart with IIS by allowing IIS to server requests for PopCharts to PopChart Server instead of requiring PopChart Server to receive these requests directly.

To set up the PopChart ISAPI Redirector

1. Copy the popchart.dll and popchart.cfg files from your dev_tools/ISAPI_redirector folder to the \Inetpub\Scripts directory.

2. If you are running PopChart Server on a machine other than the one running IIS, or on a port other than the default (2001), modify the port and address in the popchart.cfg file.

The popchart.cfg file tells the redirector where PopChart Server is located. It consists of just one line, in the following format:

-port popchart.image.server:port

You should replace popchart.image.server with the name or IP address of the computer on which PopChart Server is running. You should replace port with the port on which PopChart Server is running. For example, if PopChart Server is running on port 8080 on a computer with the IP address 12.0.8.10, the popchart.cfg file should contain the following line:

-port 12.0.8.10:8080

Note that this address must be accessible to the computer running IIS, but does not need to be visible to the client requesting the PopChart.

Note: If you change this file after you have already attempted to use the redirector, you will need to restart IIS so that it can update the settings.

You may also need to change the permissions on the popchart.dll file so that web clients are able to access it. For instructions on how to do this, refer to your IIS documentation.

3. Web clients will now be able to request images from popchart.dll on your web server.

For example, if your web server is running at http://www.mycompany.com, clients will access PopChart Server through the PopChart redirector at http://www.mycompany.com/scripts/popchart.dll.

You should modify your PopChart Embedder code or HTTP requests to PopChart Server so that they use the address of the redirector instead of the address of PopChart Server, as described in "Using HTTP Redirection" in Chapter 12.