Required permissions

Using the CountryHawk ActiveX or .NET components under Windows NT/2000/XP requires adequate permissions on certain CountryHawk files. Otherwise the instantiation of the component may fail or result in an error message stating that permissions are inadequate. This section provides details on which permissions are required. Note if you are running Windows 9x/Me this section does not apply.

Setting required permissions

Before making any permission changes it is recommended that you first try to use the CountryHawk component from your application or web scripts. If it works as expected then your server’s default security settings are adequate to run CountryHawk without setting permissions on your own.

At installation, CountryHawk sets the Everyone account to have full permissions on your target installation directory (\Program Files\cyScape\CountryHawk by default). Generally you would not have any sensitive information stored in that directory and its subdirectories, and this permission level makes it very likely you can use CountryHawk "out of the box" without having to set permissions. If you wish to tighten security on this folder, just change the permissions as discussed below to the minimum required permissions.

If when creating an instance of the CountryHawk ActiveX/COM component you receive a message stating "ActiveX component can’t create object" or any error message from CountryHawk about inadequate permissions, follow the instructions in this section to resolve the issue.

Assuming you are using Microsoft Internet Information Server (IIS), the IUSR_xxxxx account requires Read permissions on the following CountryHawk files:

·  cyCountry.dll (located in your system directory) for CountryHawk ActiveX/COM, and/or CountryHawk.dll for CountryHawk .NET. Note that only one of these files may be present, depending on your installation options. For example if you elected to install CountryHawk .NET component but not the ActiveX/COM component, then you would not have a cyCountry.dll file.

·  countries.cdd

·  countries.properties

·  countrynames.properties

·  regions.properties

·  ch_evalkey.lic or your purchased license key, in the format of ch_your_name.lic

Also assuming you are using Microsoft Internet Information Server (IIS), the IUSR_xxxxx account requires Read and Write permissions on the following CountryHawk files:

·  countrystats.properties – This is required if you plan to use the PersistToFile method. See the note in the Properties and Methods Guide for more information.

If you are using CountryHawk from web scripts or applications which run under an account other than the IUSR IIS account, then you must give these same permissions for the above files to the account(s) which the scripts or applications that use CountryHawk run under.

See Also:

About the installation guide

System requirements

Launching the installation program

Installation options

Importing your license key

Running the samples

Installing manually

Uninstalling CountryHawk