Instalación Unix

ApplixWare tiene un interface de base de datos ODBC soportado en al menos varias plataformas. ApplixWare v4.4.1 ha sido probado bajo Linux con Postgres v6.4 usndo el driver psqlODBC contenido en la distribución Postgres.

Construyendo el Driver

Lo primero que debe saberse acerca del driver psqlODBC (o cualquier otro driver ODBC) es que debe existir un gestor de driver en el sistema donde va a usarse el driver ODBC. Existe un driver ODBCfreeware para Unix llamado iodbc que puede obtenerse en varios puntos de Internet, además de en AS200. Las instrucciones para instalar iodbc van más allá del objeto de este documento, pero hay un fichero README que puede encontrarse dentro del paquete iodbc .shar comprimido que debería explicar cómo realizar la instalación y puesta en marcha.

Una vez dicho esto, cualquier gestor de driver que encuentre para su plataforma debería poder manejar el driver psqlODBC o cualquier driver ODBC.

Los ficheros de configuración Unix para psqlODBC han sido remozados de forma intensiva recientemente para permitir una fácil construcción en las plataformas soportadas y para permitir el soporte de otras plataformas Unix en el futuro. Los nuevos ficheros de configuración y construcción para el driver deberían convertir el proceso de construcción en algo simple para las plataformas soportadas. Actualmente estas incluyen Linux y FreeBSD but we esperamos que otros usuarios contribuyan con la información necesaria para un rápido crecimiento del número de plataformas para las que puede ser construido el driver.

En la actualidad existen dos métodos distintos para la construcción del driver en función de cómo se haya recibido y sus diferencias se reducen a dónde y cómo ejecutar configure y make. El driver puede ser construido en modo de equipo aislado, instalación de sólo cliente, o como parte de la distribución Postgres. La instalación aislada es conveniente si usted tiene aplicaciones clientes de ODBC en plataformas múltiples y heterogéneas. La instalación integrada es conveniente cuando las plataformas cliente y servidora son las mismas, o cuando cliente y servidor tienen configuraciones de ejecución similares.

Específicamente si ha recibido el driverpsqlODBC como parte de la distribución Postgres (a partir de ahora se referenciará como "instalación integrada") entonces podrá configurar el driver ODBC desde el directorio principal de fuentes de la distribución Postgres junto con el resto de las librerías. Si lo recibió como un paquete aislado, entonces podrá ejecutar "configure" y "make" desde el directorio en el que desempaquetó los fuentes.

Instalación integrada

Este procedimiento es apropiado para la instalación integrada.

  1. Especificar el argumento--with-odbc en la línea de comandos para src/configure:

    % ./configure --with-odbc
    % make

  2. Reconstruir la distribución Postgres:

    % make install

Una vez configurado, el driver ODBC será construido e instalado dentro de las áreas definidas para otros componentes del sistema Postgres. El fichero de configuración de instalación ODBC será colocado en el directorio principal del árbol de destino Postgres (POSTGRESDIR). Esto puede ser cambiado en la línea de comandos de make como

% make ODBCINST=filename install

Instalación Integrada Pre-v6.4

Si usted tiene una instalación Postgres más antigua que la v6.4, tiene disponible el árbol de fuentes original, y desea usar la versión más actualizada del driver ODBC, entonces deseará esta modalidad de instalación.

  1. Copie el fichero tar de salida a su sistema y desempaquételo en un directorio vacío.

  2. Desde el directorio donde se encuentran los fuentes, teclee:

    % ./configure
    % make
    % make POSTGRESDIR=PostgresTopDir install

  3. Si desea instalar los componentes en diferentes árboles, entonces puede especificar varios destinos explícitamente:

    % make BINDIR=bindir  LIBDIR=libdir  HEADERDIR=headerdir ODBCINST=instfile install

Instalación Aislada

Una instalación aislada no está configurada en la distribución Postgres habitual. Debe realizarse un ajuste mejor para la construcción del driver ODBC para clientes múltiples y y heterogeneos que no tienen instalado un árbol de fuentes Postgres de forma local.

La ubicación por defecto para las librerías y ficheros de cabecera y para la instalación aislada es /usr/local/lib y /usr/local/include/iodbc, respectivamente. Existe otro fichero de configuración de sistema que se instala como /share/odbcinst.ini (si /share exists) o como /etc/odbcinst.ini (si /share no existe).

Nota

La instalación de ficheros en /share o /etc requiere privilegios de root. Muchas etapas de la instalación de Postgres no necesitan de este requerimiento, y usted puede elegir otra ubicación en que su cuenta de superusuario Postgres tenga permisos de escritura.

  1. La instalación de la distribución aislada puede realizarse desde la distribución Postgres o puede ser obtenida a través de Insight Distributors, los mantenedores actuales para distribuciones no Unix.

    Copie el fichero zip o el fichero tar comprimido en un directorio vacío. Si usa el paquete zip, descomprímalo con el comando

    % unzip -a packagename
    La opción -a es necesaria para deshacerse de los pares CR/LF de DOS en los ficheros fuente

    Si tiene el paquete tar comprimido, simplemente ejecute

    tar -xzf packagename

    1. Para crear un fichero tar para una instalación aislada completa desde el árbol principal de fuentes de Postgres:

  2. Configure la distribución principal Postgres.

  3. Cree el fichero tar:

    % cd interfaces/odbc
    % make standalone

  4. Copie el fichero tar de salida al sistema de destino. Asegúrese de transferirlo como un fichero binario usando ftp.

  5. Desempaquete el fichero tar en un directorio vacío.

  6. Configure la instalación aislada:

    % ./configure

    La configuración puede realizarse con las opciones:

    % ./configure --prefix=rootdir --with-odbc=inidir
    donde --prefix instala las bibliotecas y ficheros de cabecera en los directorios rootdir/lib y rootdir/include/iodbc, y --with-odbc instala odbcinst.ini en el directorio especificado.

    Nótese que ambas opciones se pueden usar desde la construcción integrada pero tenga en cuenta que cuando se usan en la construcción integrada --prefix también se aplicará al resto de su instalación Postgres. --with-odbc se aplica sólo al fichero de configuración odbcinst.ini.

  7. Compile and link the source code:

    % make ODBCINST=instdir

    También puede obviar la ubicación por defecto en la instalación en la línea de comandos de 'make'. Esto sólo se aplica a la instalación de las librerías y los ficheros de cabecera. Desde que el driver necesita saber la ubicación del fichero odbcinst.ini el intento de sustituir la variable de que especifica el directorio de instalación probablemente le causará quebraderos de cabeza. Es más seguro y simple permitir al driver que instale el fichero odbcinst.ini en el directorio por defecto o el directorio especificado por usted en en la línea de comandos de la orden './configure' con --with-odbc.

  8. Instala el código fuente:

    % make POSTGRESDIR=targettree install

    Para sustituir la librería y los directorios principales de instalación por separado necesita pasar las variables de instalación correctas en la línea de argumentos make install. Estas variables son LIBDIR, HEADERDIR and ODBCINST. Sustituyendo POSTGRESDIR en la línea de argumentos de make se originará que LIBDIR y HEADERDIR puedan ser ubicados en el nuevo directorio que usted especifique. ODBCINST es independiente de POSTGRESDIR.

    Aquí es donde usted podrían especificar varios destinos explícitamente:

    % make BINDIR=bindir LIBDIR=libdir HEADERDIR=headerdir install

    Por ejemplo, tecleando

    % make POSTGRESDIR=/opt/psqlodbc install
    (después de haber usado ./configure y make) tendrá como consecuencia que las bibliotecas y ficheros de cabecera sean instalados en los directorios /opt/psqlodbc/lib y /opt/psqlodbc/include/iodbc respectivamente.

    El comando

    % make POSTGRESDIR=/opt/psqlodbc HEADERDIR=/usr/local install
    ocasionará que las bibliotecas sean instaladas en /opt/psqlodbc/lib y los ficheros de cabecera en /usr/local/include/iodbc. Si esto no funciona como se espera por favor contacte con los mantenedores.