title: Aranda Database Tools excerpt: “Inicio” permalink: / —

También conocida como DBTools o ADBT es una herramienta que permite descargar e instalar los paquetes de versiones de bases de datos necesarios para el
correcto funcionamiento de los productos Aranda versión 9. Además, permite modificar los archivos de configuración de las consolas y los servicios en
instalaciones on-premise. \n# Requisitos \n## Requisitos para la instalación — title: Requisitos para la instalación excerpt: “Requisitos” chapter: “requisitos” —

En el ordenador donde se instale DBTools v9 deben haberse instalado previamente las siguientes aplicaciones en este orden:

Aplicación Descripción Enlace para descarga

Instala archivos requeridos por Microsoft® ODBC Driver

Visual C++ 2017 redistributable https://aka.ms/vs/15/release/vc_redist.x64.exe
17 for SQL Server

Microsoft® ODBC Driver 17 for Librería requerida por Microsoft Command Line https://docs.microsoft.com/en-
SQL Server Utilities for SQL Server us/sql/connect/odbc/download-odbc-driver-for-sql-server

Microsoft Command Line Utilidad que permite ejecutar los despliegues y

https://docs.microsoft.com/en-us/sql/tools/sqlcmd-utility
Utilities for SQL Server actualizaciones de las bases de datos

\n## Requisitos en base de datos SQL

title: Requisitos en base de datos SQL excerpt: “Requisitos” chapter: “requisitos” —

La instancia de base de datos debe tener habilitada la característicaFull-Text and Semantic Extractions for Search. \n# Instalación \n## Instalación DBTools —
title: Instalación DBTools excerpt: “Instalación” chapter: “instalacion” —

Una vez cumpla con los requisitos de instalación, ejecute el instalador Aranda.ADBT siguiendo las instrucciones que aparecen en pantalla.

Al finalizar la instalación, proceda a abrir la aplicación que aparecerá con el nombre Aranda Database Tools.

\n# Módulos \n## Packages (paquetes) — title: Packages (paquetes) excerpt: “Módulos” chapter: “modulos” —

El esquema de creación y actualización de la base de datos se realiza a través de la distribución de paquetes por versión. El módulo de paquetes permite descargar
los paquetes de versiones de bases de datos a través de un servidor FTP o del sistema de archivo local (disco extraíble o memoria USB).

Para descargar paquetes siga los siguientes pasos:

1. En la parte superior de la pantalla, seleccione el proveedor de base de datos. Las opciones son:

SqlServer
Oracle
2. Seleccione el tipo de descarga. Las opciones son:

Incremental: obtiene los paquetes que hacen falta (nuevas versiones) o los que no estén disponibles en la ubicación donde se almacenan.
Total: sobrescribe los archivos existentes.

3. Seleccione el origen de los paquetes. Las opciones son:

Remote: la aplicación descarga los paquetes directamente de los servidores de Aranda. Si por políticas de red se requiere pasar por un proxy para tener salida
a internet, haga clic en el botón Configure y registre la información del proxy.

FileSystem: El usuario descarga manualmente los paquetes según sean para Oracle o SQL y los guarda localmente dentro de una carpeta que debe llamarse
SQL u ORACLE según corresponda.

Una vez descargados, usando el botón Browse (explorar), indique la ruta en donde se hizo la descarga.

4. Finalmente haga clic en el botón Download (descargar) para iniciar la descarga.

En el cuadro de descargas se puede observar el detalle del paquete con los siguientes datos: versión, proveedor, fecha de liberación, estado, dependencia, scripts
iniciales y scripts incrementales. Si el estado es Not found (no encontrado), el paquete no está disponible y debe volver a descargarse.

En la parte inferior se visualiza un registro de mensajes que indican las acciones que se están ejecutando o los errores que se pueden presentar durante la descarga.

\n## Connection String (cadena de conexión) — title: Connection String (cadena de conexión) excerpt: “Módulos” chapter: “modulos” —

Este módulo permite registrar las cadenas de conexión a la base de datos que posteriormente se utilizarán para el despliegue o actualización de una base de datos.

Para registrar una cadena de conexión siga los siguientes pasos:

1. En la parte superior de la pantalla, seleccione el proveedor de base de datos. Las opciones son:

SqlServer
Oracle
2. Asigne un nombre para identificar la conexión

3. Registre los datos de conexión (nombre de la base de datos o TNS, nombre del servidor o dirección IP, y si se requiere usuario y contraseña).

4. Haga clic en el botón Save (guardar).

Para probar la conexión y corroborar que sea correcta, haga clic en el botón Test, recibirá una alerta indicando si se pudo o no establecer la conexión.

Si luego de guardar desea editar o remover una cadena, haga clic derecho sobre el elemento en el listado y seleccione la opción que desee.

⚐ Nota:
- La base de datos debe existir, eso quiere decir que la base de datos debe crearse previamente en la instancia en la cual se va a desplegar.
- La aplicación se encarga solamente de crear y/o actualizar el esquema.

⚐ Nota: Si desea aplicar las cadenas a las aplicaciones instaladas, seleccione la cadena y haga clic en el botón Apply (aplicar) ubicado en la parte inferior
derecha o a través del menú contextual. Se abrirá un cuadro de diálogo con el listado de aplicaciones y servicios disponibles en ese ordenador.
Selecciónelos y haga clic en Apply (aplicar).

⚐ Nota: Si desea desplegar o actualizar las bases de datos, seleccione la cadena y haga clic en el botón Update (actualizar) ubicado en la parte inferior
derecha o a través del menú contextual.

Continúe con los siguientes pasos:

1. Seleccione la versión que desea desplegar o actualizar.

2. Haga clic en el botón Update (actualizar).

El registro de información de la actualización muestra paso por paso las acciones que se están ejecutando y los errores que se puedan presentar.

⚐ Nota: Todos los errores se guardan en el archivo ADBT.LOG ubicado en la carpeta de Logs dentro de la carpeta de instalación de la aplicación.

\n## Services (servicios)

title: Services (servicios) excerpt: “Módulos” chapter: “modulos” —

Este módulo permite administrar los servicios de Aranda que se encuentran instalados en la máquina local. Los íconos ubicados en la esquina superior izquierda le
permitirán realzar las siguientes acciones:

Actualizar lista de servicios

Iniciar servicio

Detener servicio

Iniciar todos los servicios

Detener todos los servicios

\n# Problemas \n## Descarga de paquetes — title: Descarga de paquetes excerpt: “Problemas” chapter: “problemas” —

No es posible descargar los paquetes

System.Net.WebException: Unable to connect to the remote server
Si presenta un error como el anterior.

1. Verifique si puede acceder desde un navegador a la URL donde se encuentran alojados los paqueteshttp://download.arandasoft.com/ADBT/V9.Si no tiene acceso
a internet puede hacer la implementacion de los paquetes manualmente, para eso dirijase a la sección Packages.

2. Si necesita acceder por medio de un proxy haga la respectiva configuracion enConfigure ubicado en el Tab de Package.

1. Es posible que el host para la descarga de paquetes no sea el correcto. Verifique la secciónRequestConfiguration que se encuentra en el archivo de configuración
Aranda.ADBT.Windows.Application.exe.config ubicado en la carpeta raíz de Aranda DB Tools. Compruebe que la URL del host sea
http://download.arandasoft.com/ADBT/V9.

\n## Despliegue de base de datos

title: Despliegue de base de datos excerpt: “Problemas” chapter: “problemas” —

Error al desplegar o actualizar una versión de la base de datos

System.ComponentModel.Win32Exception (0x80004005): The system cannot find the file specified

Si al momento de actualizar una base de datos el sistema arroja un error deWin32Exception con codigo 0x80004005, es posible que haga falta instalar el
SQLCommandLine en la maquina. Dirijase a la secciónRequisitos de instalacion e instale los programas necesarios. Para finalizar reinicie Aranda DB Tools.

Fallo al ejecutar el script

Aranda.ADBT.Exceptions.DatabaseToolsException: ScriptFail
Si ocurren errores durante la ejecución y arroja el sistema la excepción anterior, antes de continuar verifique que la estructura de la base de datos coincida con al
versión que va actualizar.

Paquetes faltantes
Aranda.ADBT.Exceptions.DatabaseToolsException: InvalidUpdate

Si va actualizar la base de datos (Ejemplo: De 9.5.0 a 9.5.6) tenga en cuenta que se necesitan las versiones intermedias, verifique que existan las demas versiones en
la carpeta, si no existen, dirijase a la sección de Packages y siga los pasos.

Paquete no encontrado
Aranda.ADBT.Exceptions.DatabaseToolsException: PackageNotFound —> System.IO.FileNotFoundException: Could not find file ‘…\Packages\SqlServer\9.X.X.zip’.

Verifique que en el Tab de Packages los paquetes tengan el estado Ok, si no es así, dirijase a la secciónPackages.