Documentación de productos
ADC
14.1 - Current Release 13.1 13.0 12.1
Ver PDF

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

October 12, 2023
Contribución de: 
C

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 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 NetScaler 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 NetScaler 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 NetScaler 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 NetScaler ADC. Si se especifica un valor incorrecto para la opción de formato, se pueden dañar los datos internos.

Notas:

  • 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 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 NetScaler 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. NetScaler 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 NetScaler ADC y use un editor para crear un archivo con los detalles de la ubicación en uno de los formatos compatibles con NetScaler ADC.
  • El dispositivo NetScaler 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 NetScaler 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 NetScaler 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 NetScaler ADC:

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

Nota:

Solo se puede acceder a la nsmap opción desde la interfaz de línea de comandos. La conversión solo es posible en el formato NetScaler 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 NetScaler ADC

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

Realice los siguientes pasos para agregar un archivo de base de datos estática de terceros en un dispositivo NetScaler 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 NetScaler 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 locationParameter
<!--NeedCopy-->

    Este comando muestra los parámetros de ubicación relacionados con el balanceo de carga estático basado en la proximidad. 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.

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

    show gslb service
<!--NeedCopy-->

    Notas:

    • 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
October 12, 2023
Contribución de: 
C
October 12, 2023
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.