Citrix ADC

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. La adición de un nuevo archivo de ubicación anula el archivo existente. La cantidad de entradas en la base de datos de proximidad estática está limitada 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 de IP siguientes. Se trata de 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 cuanto a los detalles que proporcionan. No hay 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 la representación de las direcciones IP en las ubicaciones.

El parámetro format describe la estructura del archivo para el dispositivo Citrix ADC. Si se especifica un valor incorrecto para la opción de formato, se pueden 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 haber una copia idéntica del archivo en la misma ubicación en ambos dispositivos Citrix ADC.
  • Si el archivo de ubicaciones se almacena en una ubicación que no sea la predeterminada, especifique la ruta del archivo de ubicaciones.
  • Para particiones de administración, la ruta predeterminada es: /var/partitions/<partitionName>/netscaler/locdb.
  • Algunas bases de datos proporcionan nombres cortos de países de acuerdo con la norma ISO-3166 y también nombres de países largos. Citrix ADC utiliza nombres cortos al almacenar y hacer coincidir los calificadores.
  • Para crear una base de datos de proximidad estática, inicie sesión en el shell de UNIX del dispositivo Citrix ADC y use un editor para crear un archivo con los detalles de la ubicación en uno de los formatos compatibles con Citrix ADC.
  • El dispositivo Citrix ADC se entrega con la base de datos GeoLite2 (IPv4 e IPv6), pero Citrix no mantiene ni actualiza la base de datos GeoLite2 de MaxMind con regularidad. Si es necesario, puede obtener la base de datos GeoLite2 de www.maxmind.com y convertirla al formato de base de datos Citrix ADC. Para obtener más información, consulte Script para convertir el formato de base de datos de MaxMind GeoLite2 al formato de base de datos 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
<!--NeedCopy-->

Ejemplo:

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

show locationFile
Location File: /var/netscaler/locdb/nsgeo1.0
Format: netscaler
 Done
>
<!--NeedCopy-->

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
<!--NeedCopy-->

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ática.

Puede ver una base de datos de archivos de ubicación importada mediante el cuadro de diálogo Ver base de datos en la utilidad de configuración. No hay un equivalente en 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 en el formato Citrix ADC.

Para convertir el formato de base de datos estática, en el indicador de la CLI, escriba el siguiente comando:

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

Ejemplo:

 nsmap -f ip-country-region-city -o nsfile.ns ip-country-region-city.csv
<!--NeedCopy-->

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

La base de datos GeoIP de MaxMind no se puede usar directamente en Citrix ADC. La base de datos GeoIP de MaxMind debe convertirse al formato Citrix ADC y, a continuación, 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 un script para convertir el formato de base de datos GeoLite2 al formato de base de datos de Citrix ADC. Este script se puede utilizar para convertir archivos IPv4 e IPv6. El guion 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 de 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

    Diversas 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 una 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 los archivos de entrada en consecuencia tal como se enumeran.

    • -b <filename> nombre del archivo de bloque IPv4 que se va a convertir. Nombre de archivo por defecto: GeoLite2-City-Blocks-IPv4.csv
    • -i <filename> nombre del archivo de bloque IPv6 que se va a convertir. Nombre de archivo por defecto: GeoLite2-City-Blocks-IPv6.csv
    • -l <filename> nombre del archivo de ubicación que se va a convertir. Nombre de archivo por defecto: GeoLite2-City-Locations-en.csv

    Ejemplo:

    perl Convert_GeoIPDB_To_Netscaler_Format.pl -b GeoLite2-Country-Blocks-IPv4.csv -i GeoLite2-Country-Blocks-IPv6.csv -l  GeoLite2-Country-Locations-en.csv
    <!--NeedCopy-->
    

    A continuación se muestran 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 complete la conversión de la base de datos al formato Citrix ADC, use el siguiente comando para comenzar a usarla.

    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 ubicaciones 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 este comando para agregar un archivo de ubicación estática:

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

    show location parameter
    <!--NeedCopy-->
    

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

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

    show gslb service
    <!--NeedCopy-->
    

    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
    <!--NeedCopy-->
    
Agregar un archivo de ubicación para crear una base de datos de proximidad estática