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 NetScaler. 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 NetScaler.

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 NetScaler 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 NetScaler 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 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 NetScaler. 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 NetScaler, 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 NetScaler.
  • 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. NetScaler 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 NetScaler y use un editor para crear un archivo con los detalles de la ubicación en uno de los formatos compatibles con NetScaler.
  • El dispositivo NetScaler se suministra con la base de datos GeoLite2 (IPv4 e IPv6), pero NetScaler no mantiene ni actualiza la base de datos MaxMind GeoLite2 con regularidad. Si es necesario, puede obtener la base de datos GeoLite2 de www.maxmind.com y convertirla al formato de base de datos NetScaler. 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 NetScaler.

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

En la línea de comandos, 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 NetScaler:

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

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 NetScaler.

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 NetScaler

La base de datos GeoIP de MaxMind no se puede usar directamente en NetScaler. La base de datos GeoIP de MaxMind debe convertirse al formato NetScaler 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 NetScaler. 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 NetScaler

  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 NetScaler (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 NetScaler.

    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 NetScaler, 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 NetScaler

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

  1. Obtenga el archivo de base de datos de ubicaciones de un proveedor externo, como www.maxmind.com.

    Nota:

    Si descarga el archivo de base de datos de ubicaciones de www.maxmind.com, puede usar el script disponible para convertirlo al formato de base de datos NetScaler. Para obtener información sobre el uso del script, consulte Script para convertir el formato de base de datos MaxMind GeoLite2 al formato de base de datos NetScaler.

    Para las bases de datos de ubicación descargadas de otros proveedores de terceros, debe convertirlas al formato de base de datos NetScaler antes de agregarlas a un dispositivo NetScaler.

  2. Ejecute este comando para agregar un archivo de ubicación estática:

    add location file <locationfile Name>
    <!--NeedCopy-->
    

    Nota:

    • Si el archivo de base de datos de ubicaciones no se coloca en la ubicación predeterminada /var/netscaler/locdb, <locationfile Name> debe contener la ubicación del archivo junto con el nombre del archivo.
    • Antes de ejecutar el comando add location file <locationfile Name>:
      • Make sure that the location database file is present in one of the directories of the NetScaler appliance.
      • Run the sync HA files command on the high availability setup and the sync cluster files command in a cluster setup. These commands ensure that the location database file is copied to the secondary appliance of the high availability pair and peer nodes of the cluster.
  3. 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. Se puede cargar un máximo de 3 M-1 (3 millones menos uno) de entradas. Cuando la carga de la base de datos está en curso, aparece el comando Loading: In progress. Una vez finalizada la carga, aparece el comando Loading: Idle. Si la base de datos no se carga correctamente, este comando también muestra un mensaje de error.

  4. 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 no se encuentra ninguna coincidencia para una dirección IP entrante, la solicitud se procesa mediante el método Round Robin.
  5. 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