Revision History

Date	Version	Description	Author
04/02/2002	1.0	Created	VS
04/03/2002	1.1	Revised	YB
04/10/2002	1.2	Revised	VS

Table of Contents

2. Requirements and resources. 4

3. Active Perl Installation. 4

4. GD library Installation. 4

5. “GIF”-extension handler Installation. 5

6. Checking the installation. 9

Data Charts Maps Installation Notes

1. Introduction

This document describes a step-by-step installation of the "GIF", “HTML”, “HTM”, and “CHARTDAT”-extensions handler for Internet Information Services (IIS) under Windows 2000 operation system.

2. Requirements and resources

1. Internet Information Services 5.0;

2. Active Perl 5.6 (standard Perl installation);

3. Perl GD package (Perl graphic library);

4. gif2png.exe (a converter from GIF to PNG graphical format);

5. handler.pl (GIF, HTML, HTM, and CHARTDAT extensions handler).

3. Active Perl Installation

1. Download the latest version of Active Perl from http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl
(the direct link currently is: http://downloads.activestate.com/ActivePerl/Windows/5.6/ActivePerl-5.6.1.631-MSWin32-x86.msi , about 8.1 Mb).

2. Install Active Perl.
(Active Perl installation notes can be found at http://www.activestate.com/Products/Download/Get.plex?id=ActivePerl).

NOTE: This document is prepared with an assumption that Active Perl is installed into C:\Perl\ directory. If you install Active Perl to another location, additional configuration is required.

4. GD library Installation

1. To install the graphic library, run C:\Perl\bin\ppm.bat.

2. Type ‘install GD’ in the black window with ‘PPM>’ prompt and hit ‘ENTER’:

3. The program should ask you ‘Install package 'GD?' (y/N):’. Type ‘y’ and hit ‘ENTER’.

4. The program should automatically install the GD library:

5. Type ‘exit’ and hit ‘ENTER’ to exit the PPM utility.

5. “GIF”, “HTML”, “HTM”, and “CHARTDAT”-extensions handler Installation

1. Create folder ‘C:\Perl\Handlers’.
(Start Windows Explorer, go to My Computer -> C: -> Perl, right-click within the Perl folder, choose New -> Folder, type in ‘Handlers’, and hit ‘ENTER’.)

2. Create directory ‘C:\Perl\Handlers\Temp’. All cached HTML and PNG-files will be stored here.

3. Copy gif2png.exe and handler.pl files to C:\Perl\Handlers folder.
NOTE: The files can be found in executables.zip archive coming along with the document.

4.       Skip this step if you installed Active Perl into C:\Perl, created C:\Perl\Handlers folder, and copied executables into the folder.

Open handler.pl file in a text editor and change this line to the real location of gif2png.exe:
       my $gif2png = 'C:\Perl\Handlers\gif2png.exe';
Change the following line also (if required):
       my $temp_handler_dir = 'c:\Perl\Handlers\Temp';

5. Check the following line in the handler.pl if you have another web server root directory (which is accessible at http://[domain-name]/ ):
my $web_server_root_dir = ' c:\websites\wizkid-trading.com';

6. Open ‘Control Panel’ (Start->Settings->Control Panel).

7. Go to Administrative tools () -> Internet Services Manager () section.

8. Select your Web site from the left-side Internet Information Services Panel, right-click on the Web Site, and choose Properties from the context-menu.

9. Select Home directory panel in the Web Site Properties window:

10. Set Execute Permissions to ‘Scripts only‘, or to ‘Scripts and Executables’.

11. Click Configuration button on this panel. This window should appear:

12. Click Add button in the Application Configuration panel.

13. Fill in the fields in the following way:

a. Executable -> ‘C:\Perl\bin\Perl.exe C:\Perl\Handlers\handler.pl "%s" %s’;

b. Extension -> ‘.gif’;

c. Verbs -> Limit To -> ‘GET,HEAD,POST’;

d. Script Engine -> keep checked;

e. Check that file exists -> check the checkbox:

14. Click OK button in the Add/Edit Application Extension Mapping window.

15. Click Add button in the Application Configuration panel.

16. Fill in the fields in the following way:

a. Executable -> ‘C:\Perl\bin\Perl.exe C:\Perl\Handlers\handler.pl "%s" %s’;

b. Extension -> ‘.chartdat’;

c. Verbs -> Limit To -> ‘GET,HEAD,POST’;

d. Script Engine -> keep checked;

e. Check that file exists -> check the checkbox:

17. Click OK button in the Add/Edit Application Extension Mapping window.

18. Click OK button in the Application Configuration window.

19. Click OK button in the Web Site Properties window.

20. Select the directory on your web-site, which will contain the HTML-files with chart pictures to be parsed by the handler. You can select the directory from the left-side Internet Information Services Panel, then right-click on the directory name, and choose Properties from the context-menu. (for example, we use a directory named Test):

21. Click Create button in the Directory Properties panel. The Configuration button will be enabled

22. Click Configuration button in the Directory Properties panel.

23. Click Add button in the Application Configuration panel.

24. Fill in the fields in the following way:

a. Executable -> ‘C:\Perl\bin\Perl.exe C:\Perl\Handlers\handler.pl "%s" %s’;

b. Extension -> ‘.html’;

c. Verbs -> Limit To -> ‘GET,HEAD,POST’;

d. Script Engine -> keep checked;

e. Check that file exists -> check the checkbox:

25. Click OK button in the Add/Edit Application Extension Mapping window.

26. Click Add button in the Application Configuration panel.

27. Fill in the fields in the following way:

a. Executable -> ‘C:\Perl\bin\Perl.exe C:\Perl\Handlers\handler.pl "%s" %s’;

b. Extension -> ‘.htm’;

c. Verbs -> Limit To -> ‘GET,HEAD,POST’;

d. Script Engine -> keep checked;

e. Check that file exists -> check the checkbox:

28. Click OK button in the Add/Edit Application Extension Mapping window.

29. Click OK button in the Application Configuration window.

30. Click OK button in the Directory Properties window.

31. Close Internet Information Services window.

6. Checking the installation

1. Copy testChart.gif, testChart.html, and testChart.chartdat files to your charts’ images folder (e.g. c:\websites\wizkid-trading.com\Test\).
NOTE: The files can be found in test.zip archive coming along with the document.

2. Make sure your web-server is started.

3. Access the testChart.gif via HTTP at the location where you’ve placed it (e.g. at http://[your-domain-name]/data/testChart.gif).

4. Access the testChart.html via HTTP at the location where you’ve placed it (e.g. at http://[your-domain-name]/data/testChart.html).

5. Access the testChart.chartdat via HTTP at the location where you’ve placed it (e.g. at http://[your-domain-name]/data/testChart.chardat).