- Adding a Location File to Create a Static Proximity Database
- Adding Custom Entries to a Static Proximity Database
- Setting the Location Qualifiers
- Specifying the Proximity Method
- Synchronizing GSLB Static Proximity Database
A static proximity database is a UNIX-based ASCII file. Entries added to this database from a location file are called static entries. Only one location file can be loaded on a NetScaler appliance. Adding a new location file overrides the existing file. The number of entries in the static proximity database is limited by the configured memory in the NetScaler appliance.
The static proximity database can be created in the default format or in a format derived from commercially configured third party databases (such as www.maxmind.com and www.ip2location.com).
The NetScaler ADC includes an IP geolocation database, GeoLite2 (published by MaxMind). The database is available in a format supported by NetScaler ADC at: /var/netscaler/inbuilt_db/Citrix_Netscaler_InBuilt_GeoIP_DB.csv. You can use this IP geolocation database as the location file for the static proximity based GSLB method or in location based policies.
Note: The ADC includes the GeoLite2 database available from http://www.maxmind.com.
These databases vary in the details they provide. There is no strict enforcement of the database file format, except that the default file has format tags. The database files are ASCII files that use a comma as the field delimiter. There are differences in the structure of fields and the representation of IP addresses in the locations.
The format parameter describes the structure of the file to the NetScaler appliance. Specifying an incorrect value for the format option can corrupt the internal data.
To create a static proximity database, log on to the UNIX shell of the NetScaler appliance and use an editor to create a file with the location details in one of the NetScaler-supported formats.
At the command prompt, type:
> add locationFile /var/nsmap/locdb/nsgeo1.0 -format netscaler Done > show locationFile Location File: /var/nsmap/locdb/nsgeo1.0 Format: netscaler Done >
You can view an imported location file database by using the View Database dialog box in the configuration utility. There is no NetScaler command line equivalent.
By default, when you add a location file, it is saved in the netscaler format. You can convert a location file of other formats into the netscaler format.
To convert the static database format, at the NetScaler command prompt, type the following command:
nsmap -f ip-country-region-city -o nsfile.ns ip-country-region-city.csv