Restauración de los ejemplos en IBM® DB2 mediante un script

Puede utilizar scripts para restaurar archivos de copia de seguridad para bases de datos de ejemplo para DB2.

Para configurar la base de datos de ejemplo, debe extraer el archivo GS_DB tar.gz, personalizar un archivo de configuración y ejecutar el script de configuración.

Existen algunos requisitos previos para instalar la base de datos del ejemplo Viaje de Aventuras para DB2 en Linux, UNIX y Windows. Para poder instalar las bases de datos de ejemplo, primero debe verificar o configurar privilegios.

  1. Extraiga el archivo GS_DB.tar.gz y mantenga la estructura de directorios original. Si utiliza WinZip para extraer el archivo de movimiento de DB2 en el sistema operativo Microsoft Windows, asegúrese de que no esté seleccionada la opción de conversión de retornos de carro o avances de línea inteligente para archivos TAR.
  2. En los sistemas operativos Linux y UNIX, modifique los permisos del archivo setupGSDB.sh para establecerlo como ejecutable: chmod u+x setupGSDB.sh.
  3. Asegúrese de que el identificador de usuario utilizado para configurar la base de datos dispone de autoridad DBADM o de las autoridades siguientes en DB2:
    • CREATETAB
    • CREATE_NOT_FENCED_ROUTINE
    • LOAD

Opcional: edición del archivo de configuración

El archivo de configuración contiene las opciones de configuración predeterminadas que se utilizan al crear los datos VENTASVA. Los valores de configuración predeterminados son:

Tabla 1. Valores opcionales para restaurar los ejemplos en IBM DB2

Valor de configuración

Valor predeterminado

Descripción

GOSALES_INST

GS_DB

Se utiliza para configurar el nombre o el alias de la base de datos.

GOSALES_CREATEDB

 

Opcional: da lugar a la eliminación de una base de datos existente que tiene el mismo nombre.

GOSALES_DB_TERRITORY

US

Al crear una base de datos, es el territorio de la base de datos UTF-8 que se crea.

GOSALES_BP

GOSALES_TS

GOSALES_BP

GOSALES_TS

Opcional: especifique el nombre de la agrupación de búferes y del espacio de tabla, si el script ha de crearlos.

GOSALES_GRANTEES

GOSALES, DB2ADMIN

Especifique la lista de usuarios, grupos o PÚBLICO que dispondrán de permisos CONTROL para los esquemas GOSALES, GOSALESHR, GOSALESMR y GOSALESRT. Esta cadena debe seguir la sintaxis del comando GRANT.

GOSALESDW_GRANTEES

VENTASGADW

DB2ADMIN

Especifique la lista de usuarios, grupos o PÚBLICO que dispondrán de permisos CONTROL para el esquema GOSALESDW.

GOSALES_DPF

N

Cambiar a 'Y' si instala un entorno dividido de base de datos (DPF)

GOSALES_SCHEMA

GOSALESHR_SCHEMA

GOSALESMR_SCHEMA

GOSALESRT_SCHEMA

GOSALESDW_SCHEMA

VENTASVA

GOSALESHR

GOSALESMR

GOSALESRT

VENTASGADW

Especifique los nombres que han de utilizarse para cada esquema.

Puede personalizar el archivo de configuración de ejemplo para utilizar valores distintos de los valores predeterminados.

El script de configuración crea la base de datos GS_DB, los espacios de tabla, las tablas y las vistas, otorga privilegios y modifica los nombres de esquema para la base de datos de ejemplo. En la mayoría de las situaciones, puede aceptar las opciones predeterminadas. Si desea cambiar el nombre de la base de datos o modificar los usuarios o grupos que tienen permisos para los datos, debe actualizar el archivo de configuración GOSalesConfig.

Edite el archivo de configuración utilizando un editor de texto.

Nota: Si edita scripts de shell de UNIX en un entorno Windows, asegúrese de conservar los finales de línea de UNIX.

El archivo de configuración en Windows es GOSalesConfig.bat. El archivo de configuración en UNIX es GOSalesConfig.sh.

De forma predeterminada, se utiliza el nombre de base de datos GS_DB y se otorgan permisos a los usuarios DB2ADMIN (Linux, UNIX, Windows) y GOSALES.

Ejecución del script de configuración en modo interactivo

En el modo interactivo, el script setupGSDB le solicita que confirme o que proporcione información de configuración para la instalación de la base de datos GS_DB. Puede aceptar los valores predeterminados o proporcionar valores distintos que sustituyan a los valores predeterminados.

  • Ejecute el script de configuración para su sistema operativo.
Tabla 2. Ejecución del script de restauración de ejemplos

Sistema operativo

Comando

Microsoft Windows

En una ventana de comandos de DB2, cambie al directorio GS_DB/win y ejecute el script setupGSDB.bat.

UNIX

Desde un indicador de shell, tomando como origen db2profile, cambie al directorio GS_DB/unix y ejecute el script setupGSDB.sh.

  • Pulse Intro para continuar. El script visualiza un resumen de las selecciones que ha realizado antes de que confirme los cambios para su entorno. Si aprueba las selecciones, pulse Intro y el script realizará los cambios. Por ejemplo:
Please confirm the following settings:
Database Name: GS_DB
Drop and Recreate Database: Y
DPF environment: N
Create a 16k Bufferpool named: GOSALES_BP
Create a 16k Tablespace named: GOSALES_TS
GOSALES Grant users/groups: GOSALES, DB2ADMIN
GOSALESDW Grant users/groups: GOSALESDW, DB2ADMIN
Administration User Name: db2admin
Import the sample data to the following schemas:
GOSALES
GOSALESHR
GOSALESMR
GOSALESRT
GOSALESDW
WARNING: If the database GS_DB already exists it will be dropped
Continue creating the sample data with these settings? (Y/N) Default=Y:

La base de datos GS_DB se configura.

Ejecución del script de configuración con opciones de línea de comandos

El script setupGSDB le permite proporcionar información en la línea de comandos para reducir el número de solicitudes del script.

Desde una línea de comandos, ejecute el script para su sistema operativo. En Windows, utilice setupGSDB.bat. En sistemas operativos UNIX o Linux, utilice setupGSDB.sh.

Puede ejecutar el script setupGSDB con las opciones siguientes:

Tabla 3. Opciones de setupGSDB para IBM DB2

Opción

Descripción

-createdb

Crea la base de datos. Esta opción elimina las bases de datos existentes que tienen el mismo nombre. Crea la agrupación de búferes y el espacio de tabla necesarios.

-database nombre_base_datos

Especifica el nombre de la base de datos. Este valor reemplaza el valor predeterminado de GS_DB.

-userid ID_usuario_administración

Especifica el nombre del identificador de usuario del administrador de DB2 que se utiliza para crear la base de datos.

-password ID_usuario_administración

Especifica la contraseña del identificador de usuario del administrador de DB2.

-noprompt

Indica que no se visualizará ninguna solicitud. Esta opción ejecuta el script en modo silencioso. Si falta información, el script no se ejecutará correctamente. No se le solicitará ninguna confirmación.

Ejemplo 1: Es un administrador de DB2 y desea crear la base de datos GS_DB predeterminada en el nodo local. Ejecute el comando siguiente:

setupGSDB -createDB -noprompt

Ejemplo 2: Desea crear las tablas en una base de datos existente denominada GSDBY y desea utilizar el ID de usuario del administrador db2admin. Ejecute el comando siguiente:

setupGSDB -database GSDBY -userid db2admin

El script le solicita la contraseña cuando se conecta con GSDBY. Este script sustituirá las tablas que ya existen en la base de datos GSDBY, a menos que opte por eliminar la base de datos.

Opcional: instalación de los datos de ejemplo en un servidor remoto

Si la base de datos de ejemplo GS_DB se ha instalado en un servidor remoto de su entorno, puede enlazar a ésta catalogando la base de datos remota en el sistema local y ejecutando a continuación el script de configuración localmente.

  • Si la base de datos de ejemplo no existe todavía en el servidor remoto, créela con el comando CREATE DATABASE. La base de datos necesita un conjunto de códigos UTF-8 y un espacio de tabla predeterminado con un tamaño de página de 16 KB como mínimo. Por ejemplo, en el servidor remoto, cree la base de datos ejecutando el comando siguiente:
    CREATE
    DATABASE GS_DB USING CODESET UTF-8 TERRITORY US PAGESIZE 16k
  • En el sistema local, catalogue la base de datos remota:
    db2
    catalog tcpip node nodename remote ipaddr server port_number
    db2 catalog database GS_DB as GS_DB at node nodename
  • En el sistema local, ejecute el script:
    setupGSDB
    -database GS_DB -userid administration_user_ID

Se le solicitará una contraseña para la conexión con la base de datos.