Agregar un archivo de ubicación para crear una base de datos de proximidad estática

Una base de datos de proximidad estática es un archivo ASCII basado en UNIX. Las entradas agregadas a esta base de datos desde un archivo de ubicación se denominan entradas estáticas. Solo se puede cargar un archivo de ubicación en un dispositivo Citrix ADC. Agregar un nuevo archivo de ubicación anula el archivo existente. El número de entradas en la base de datos de proximidad estática está limitado por la memoria configurada en el dispositivo Citrix ADC.

La base de datos de proximidad estática se puede crear en el formato predeterminado o en un formato derivado de bases de datos de terceros configuradas comercialmente (como www.maxmind.com y www.ip2location.com).

El dispositivo Citrix ADC incluye los dos archivos de base de datos de geolocalización IP siguientes. Estos son archivos GeoLite2, publicados por MaxMind.

  • Citrix_Netscaler_InBuilt_GeoIP_DB_IPv4
  • Citrix_Netscaler_InBuilt_GeoIP_DB_IPv6

Estos archivos de base de datos están disponibles en un formato compatible con el dispositivo Citrix ADC en el directorio /var/netscaler/inbuilt_db.

Puede utilizar estas bases de datos de geolocalización IP como archivo de ubicación para el método GSLB basado en proximidad estática o en directivas basadas en ubicación.

Estas bases de datos varían en los detalles que proporcionan. No existe una aplicación estricta del formato de archivo de base de datos, excepto que el archivo predeterminado tiene etiquetas de formato. Los archivos de base de datos son archivos ASCII que utilizan una coma como delimitador de campo. Existen diferencias en la estructura de los campos y en la representación de las direcciones IP en las ubicaciones.

El parámetro format describe la estructura del archivo para el dispositivo Citrix ADC. Especificar un valor incorrecto para la opción de formato puede dañar los datos internos.

Nota

  • Después de una actualización, si el directorio /var/netscaler/inbuilt_db/ contiene el archivo de base de datos (Citrix_NetScaler_inbuilt_geoip_db.csv) de las versiones anteriores del software Citrix ADC, el archivo se conserva.
  • La ubicación predeterminada del archivo de base de datos es /var/netscaler/locdb y, en una configuración de alta disponibilidad (HA), debe estar presente una copia idéntica del archivo en la misma ubicación en ambos dispositivos Citrix ADC.
  • Si el archivo de ubicación se almacena en una ubicación distinta de la predeterminada, especifique la ruta de acceso del archivo de ubicación.
  • Para particiones admin, la ruta predeterminada es: /var/partitions/<partitionName>/netscaler/locdb.
  • Algunas bases de datos proporcionan nombres de países cortos según la norma ISO-3166 y nombres de países largos también. El Citrix ADC utiliza nombres cortos al almacenar y cotejar calificadores.
  • Para crear una base de datos de proximidad estática, inicie sesión en el shell UNIX del dispositivo Citrix ADC y utilice un editor para crear un archivo con los detalles de ubicación en uno de los formatos compatibles con Citrix ADC.

Para agregar un archivo de ubicación estática mediante la CLI

En el símbolo del sistema, escriba:

add locationFile <locationFile> [-format <format>]
-  show locationFile

Ejemplo:

add locationFile /var/netscaler/locdb/nsgeo1.0 -format netscaler
Done

show locationFile
Location File: /var/netscaler/locdb/nsgeo1.0
Format: netscaler
 Done
>

Ejemplo:

add locationFile /var/netscaler/inbuilt_db/Citrix_Netscaler_InBuilt_GeoIP_DB_IPv4 -format netscaler

add locationFile6 /var/netscaler/inbuilt_db/Citrix_Netscaler_InBuilt_GeoIP_DB_IPv6 -format netscaler

Para agregar un archivo de ubicación estática mediante la GUI:

  1. Vaya a AppExpert > Ubicación, haga clic en la ficha Base de datos estática.
  2. Haga clic en Agregar para agregar un archivo de ubicación estático.

Puede ver una base de datos de archivos de ubicación importada mediante el cuadro de diálogo Ver base de datos de la utilidad de configuración. No existe un equivalente de CLI.

Para ver un archivo de ubicación estática mediante la GUI:

  1. Vaya a AppExpert > Ubicación, haga clic en la ficha Base de datos estática.
  2. Seleccione un archivo de ubicación estática y, en la lista Acción, haga clic en Ver base de datos.

Para convertir un archivo de ubicación al formato Citrix ADC:

De forma predeterminada, cuando agrega un archivo de ubicación, se guarda en el formato Citrix ADC. Puede convertir un archivo de ubicación de otros formatos al formato Citrix ADC.

Nota: Solo se puede acceder a la opción nsmap desde la interfaz de línea de comandos. La conversión solo es posible al formato Citrix ADC.

Para convertir el formato de base de datos estática, en el símbolo del sistema CLI, escriba el siguiente comando:

nsmap -f <inputFileFormat> -o <outputFileName> <inputFileName>

Ejemplo:

 nsmap -f ip-country-region-city -o nsfile.ns ip-country-region-city.csv

Script para convertir el formato de base de datos Maxmind GeoLite2 al formato de base de datos Citrix ADC

La base de datos MaxMind GeoIP no se puede utilizar directamente en Citrix ADC. La base de datos MaxMind GeoIP debe convertirse al formato Citrix ADC y luego cargarse para la detección de ubicación IP en el método de proximidad estática GSLB y otras funciones como directivas. Puede utilizar una script para convertir el formato de base de datos GeoLite2 al formato de base de datos Citrix ADC. Este script se puede utilizar para convertir archivos IPv4 e IPv6. El script está disponible en la ubicación: https://github.com/citrix/MaxMind-GeoIP-Database-Conversion-Citrix-ADC-Format

Pasos para convertir la base de datos GeoIP2 al formato Citrix ADC

  1. Descargue la base de datos GeoLite2 City o GeoLite2 Country en formato.csv desde https://dev.maxmind.com/geoip/geoip2/geolite2/.

  2. Copie el archivo en un directorio Citrix ADC (por ejemplo, /var). Descomprima el archivo con el siguiente comando de shell, que crearía un directorio con el mismo nombre.

    tar -xf <filename>

  3. Descargue el script Convert_GeoIPDB_To_Netscaler_Format.pl desde https://github.com/citrix/MaxMind-GeoIP-Database-Conversion-Citrix-ADC-Format y cópielo en el directorio creado en el paso #2.

  4. Para comprobar las opciones aceptables para la ejecución del script, ejecute el siguiente comando:

    perl Convert_GeoIPDB_To_Netscaler_Format.pl –help

    Varias opciones disponibles son:

    • <filename> Archivo de salida IPv4. Nombre de archivo de salida predeterminado: NetScaler_MaxMind_GeoIP_DB_IPV4.csv

    • -p <filename> Archivo de salida IPv6. Nombre de archivo de salida predeterminado: NetScaler_MaxMind_GeoIP_DB_IPV6.csv

    • -logfile <filename> Archivo que contiene la lista de eventos/mensajes

    • -debug Imprime todos los mensajes en STDOUT

  5. Ejecute el siguiente comando para convertir el formato de base de datos GeoLite2 al formato de base de datos Citrix ADC.

    perl Convert_GeoIPDB_To_Netscaler_Format.pl

    Nota: La operación puede tardar hasta 5 minutos.

    Los nombres de archivo predeterminados utilizados en el script son los de la base de datos basada en Maxmind GeoLite2 City. Si ha descargado la base de datos GeoLite2 Country, debe proporcionar los nombres de archivo de entrada según se indica.

    • -b <filename> nombre del archivo de bloque IPv4 que se va a convertir. Nombre de archivo predeterminado: Geolite2-City-Blocks-IPV4.csv
    • -i <filename> nombre del archivo de bloque IPv6 que se va a convertir. Nombre de archivo predeterminado: Geolite2-City-Blocks-IPV6.csv
    • -l <filename> nombre del archivo de ubicación que se va a convertir. Nombre de archivo predeterminado: Geolite2-City-Locations-es.csv

    Ejemplo:

    perl Convert_GeoIPDB_To_Netscaler_Format -b GeoLite2-Country-Blocks-IPv4.csv -i GeoLite2-Country-Blocks-IPv6.csv -l  GeoLite2-Country-Locations-en.cs
    

    Los siguientes son los archivos de salida generados después de ejecutar el script.

    • Netscaler_Maxmind_GeoIP_DB_IPv4.csv
    • Netscaler_Maxmind_GeoIP_DB_IPv6.csv
  6. Una vez que se haya completado la conversión de la base de datos al formato Citrix ADC, utilice el siguiente comando para comenzar a usarlo.

    add locationFile <locationFile>

Agregar un archivo de base de datos estática de terceros en un dispositivo Citrix ADC

Realice los siguientes pasos para agregar un archivo de base de datos estática de terceros en un dispositivo Citrix ADC.

  1. Obtenga el archivo de base de datos de ubicaciones de un proveedor externo, como www.maxmind.com o www.ip2location.com.
  2. Copie el archivo de base de datos de ubicación en el dispositivo Citrix ADC mediante la utilidad WinSCP.

    Nota

    La ubicación predeterminada del archivo de base de datos en el dispositivo es /var/netscaler/locdb.

  3. Ejecute el siguiente comando para agregar un archivo de ubicación estático:

    add location file <locationfile Name> -format LocationFormat
    
  4. Ejecute el siguiente comando para asegurarse de que se carga la base de datos de ubicación:

    show location parameter
    

    Este comando muestra los parámetros, como el número de entradas estáticas. Si la base de datos no está cargada correctamente, este comando también muestra un mensaje de error. Se puede cargar un máximo de 3M-1 (3 millones menos uno) entradas.

  5. Ejecute el siguiente comando para ver la ubicación del sitio GSLB:

    show gslb service
    

    Nota

     -  Si la base de datos se carga correctamente, la ubicación de los sitios GSLB se rellena automáticamente en la base de datos.  -  Solo puede especificar un archivo de ubicación en la configuración del dispositivo.  -  Si los dispositivos están en una configuración de alta disponibilidad, un dispositivo debe copiar la base de datos del otro dispositivo.  -  Si no se encuentra ninguna coincidencia para una dirección IP entrante, la solicitud se procesa mediante el método Round Robin.
    
  6. Ejecute el siguiente comando para configurar el método GSLB en el dispositivo:

    set gslb vserver GSLBVserverName -lbMethod MethodType