Configuración de un depósito de correlación de entradas, un depósito de extensiones de propiedades o un depósito de base de datos de registro personalizado utilizando mandatos wsadmin
Puede configurar un depósito de correlación de entradas, un depósito de extensiones de propiedades o un depósito de base de datos de registro personalizado utilizando mandatos wsadmin.
Antes de empezar
Si está configurando un repositorio de correlación de entradas, empiece por los pasos que se describen en Configuración de repositorios de correlación de entradas en configuraciones de repositorios de federados.
Si está configurando un repositorio de extensiones de propiedades, empiece por los pasos que se describen en Configuración de repositorios de extensiones de propiedades en configuraciones de repositorios de federados.
Acerca de esta tarea
Cuando cree un repositorio, utilice los mandatos wsadmin adecuados para definir el esquema de base de datos y para rellenar las definiciones de propiedades de base de datos.
Procedimiento
Qué hacer a continuación
- Especificar los argumentos en la línea de mandatos.
- Especificar los argumentos en un archivo.
La opción -file permite especificar un archivo en el que se han especificado algunos o todos los parámetros. Para utilizar el argumento -file en la línea de mandatos, entre la vía de acceso completa del archivo. Los parámetros en el archivo se deben especificar en pares de clave=valor y cada uno debe estar en su propia línea. Si se especifica un parámetro en la línea de mandatos y en el archivo, el valor en la línea de mandatos tiene prioridad.
Sugerencias para diagnosticar errores de argumento:
- Si no se especifica correctamente un argumento en la línea de mandatos o en el archivo, se devuelve un mensaje que indica que el argumento no se ha especificado correctamente. Esto puede significar que el argumento no se ha especificado en absoluto, o que era necesario para una determinada configuración, pero no se ha especificado.
- Si el argumento no se ha especificado en absoluto, compruebe que el parámetro se haya especificado en la línea de mandatos o en el archivo, y que está bien escrito y con las mayúsculas y minúsculas correctas.
- Si el argumento era necesario para una determinada configuración,
pero no se ha especificado, es posible que el mandato no necesite exclusivamente un
valor, pero que sea necesario para el tipo de base de datos y configuración que esté
estableciendo.
Por ejemplo, si establece los parámetros dn, wasAdminId o wasAdminPassword, debe especificar también el parámetro dbDriver.
Asimismo, si se especifican los parámetros dn, wasAdminId o wasAdminPassword, y el databaseType no es una base de datos Apache Derby versión 10.2, también se deben especificar los parámetros dbAdminId y dbAdminPassword.
![[z/OS]](../images/ngzos.gif)
El mandato setupIdMgrDBTables:
El mandato setupIdMgrDBTables crea y llena las tablas de la base de datos que ha creado anteriormente. Los argumentos son sensibles a las mayúsculas y minúsculas, en la línea de mandatos y en el archivo.
- schemaLocation (String, obligatorio)
- La ubicación del directorio <WAS>/etc/wim/setup.
- dbPropXML (String)
- La ubicación del archivo XML de definición de propiedades de repositorio de base de datos.
- databaseType (String, necesario)
- El tipo de base de datos. Las bases de datos soportadas son db2, oracle, informix, derby, sqlserver, db2zos y db2iseries.
- dbURL (String, necesario)
- El URL de base de datos para la modalidad de acceso directo. Por ejemplo: jdbc:db2:wim.
- dbDriver (String)
- El nombre del controlador de base de datos. Por ejemplo: com.ibm.db2.jcc.DB2Driver.
- dbAdminId (String)
- El ID de administrador de base de datos para la modalidad de acceso directo. Por
ejemplo: db2admin.Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminId.
- dbAdminPassword (String)
- La contraseña asociada con dbAdminId. Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminPassword.
- dn (String)
- El uniqueName de organización por omisión para la sustitución. Por ejemplo: o=yourco. Si no se establece, se utiliza o=Default Organization.
- wasAdminId (String)
- El ID de usuario de administración de WebSphere Application Server. El ID debe ser un nombre abreviado, no un uniqueName. Por ejemplo: wasadmin. Después de la creación, el uniqueName (nombre exclusivo) es uid=wasadmin, <defaultOrg>.
- wasAdminPassword (String)
- La contraseña de usuario de administración de WebSphere Application Server. Si se establece wasAdminId, este parámetro es obligatorio.
- saltLength (Integer)
- La longitud salt del salt generado de forma aleatoria para el hash de contraseña.
- encryptionKey (String)
- La clave de cifrado de la contraseña. Establezca la clave de cifrado de la contraseña para que coincida con la clave de cifrado en el archivo wimconfig.xml del repositorio. Si no se establece la clave de cifrado, se utiliza el valor por omisión.
- derbySystemHome (String)
- La ubicación de inicio del sistema Apache Derby Versión 10.2, si está configurando una base de datos Apache Derby Versión 10.2.
- reportSqlError (String)
- Especifica si debe notificar errores SQL mientras configura bases de datos.
- file (String)
- La vía de acceso completa de un archivo que contiene los parámetros de entrada. Cada parámetro de entrada debe coincidir con un parámetro correspondiente tal como se escribiría en la línea de mandatos, y se debe colocar en un par de clave=valor. Cada par debe ir en una línea aparte.
tablesBufferPool (String)
La variable de la agrupación de almacenamientos intermedios de tablas predeterminadas en DB2 para z/OS. El valor predeterminado es BP0.
LOBtablesBufferPool (String)
La variable de la agrupación de almacenamientos intermedios de tablas LOB auxiliares en DB2 para z/OS. El valor predeterminado es BP0.
indextablesBufferPool (String)
La variable de la agrupación de almacenamientos intermedios de tablas de índice exclusivas en DB2 para z/OS. El valor predeterminado es BP0.
dbSchema (String)
El esquema donde desea crear las tablas de repositorios federados. El esquema debe existir en la base de datos. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
dbSchema (String)
El esquema donde desea crear las tablas de repositorios federados. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
tablespacePrefix (String)
El prefijo del espacio de tabla. La longitud máxima permitida para este serie es de 3 caracteres. El valor de parámetro tablespacePrefix es necesario cuando se utiliza el parámetro dbSchema. Es específico de DB2 para z/OS y se omitirá para cualquier otro tipo de base de datos.
El mandato deleteIdMgrDBTables:
El mandato deleteIdMgrDBTables suprime las tablas en la base de datos.
- schemaLocation (String, necesario)
- La ubicación del directorio <WAS>/etc/wim/setup.
- databaseType (String, necesario)
- El tipo de base de datos. Las bases de datos soportadas son db2, oracle, informix, derby, sqlserver, db2zos y db2iseries.
- dbURL (String, necesario)
- El URL de base de datos para la modalidad de acceso directo. Por ejemplo: jdbc:db2:wim.
- dbDriver (String)
- El nombre del controlador de base de datos. Por ejemplo: com.ibm.db2.jcc.DB2Driver.
- dbAdminId (String)
- El ID de administrador de base de datos para la modalidad de acceso directo. Por
ejemplo: db2admin.Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminId.
- dbAdminPassword (String)
- La contraseña asociada con dbAdminId. Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminPassword.
- derbySystemHome (String)
- La ubicación de inicio del sistema Apache Derby Versión 10.2, si está configurando una base de datos Apache Derby Versión 10.2.
- reportSqlError (String)
- Especifica si debe notificar errores SQL mientras configura bases de datos.
- file (String)
- La vía de acceso completa de un archivo que contiene los parámetros de entrada. Cada parámetro de entrada debe coincidir con un parámetro correspondiente tal como se escribiría en la línea de mandatos, y se debe colocar en un par de clave=valor. Cada par debe ir en una línea aparte.
dbSchema (String)
El esquema de base de datos del que desea suprimir las tablas de repositorios federados. El esquema debe existir en la base de datos. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
dbSchema (String)
El esquema de base de datos del que desea suprimir las tablas de repositorios federados. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
tablespacePrefix (String)
El prefijo del espacio de tabla. La longitud máxima permitida para este serie es de 3 caracteres. El valor de parámetro tablespacePrefix es necesario cuando se utiliza el parámetro dbSchema. Es específico de DB2 para z/OS y se omitirá para cualquier otro tipo de base de datos.
El mandato setupIdMgrPropertyExtensionRepositoryTables:
El mandato setupIdMgrPropertyExtensionRepositoryTables configura el repositorio de extensiones de propiedades. El comportamiento predeterminado incluye la creación y cumplimentación de las tablas de la base de datos.
Este mandato está disponible en modalidad conectada o local.
- schemaLocation (String, necesario)
- La ubicación del directorio raíz_servidor_aplic/etc/wim/setup.
- laPropXML (String)
- La ubicación del archivo XML de definición del repositorio de extensiones de propiedades.
- databaseType (String, necesario)
- El tipo de base de datos. Las bases de datos soportadas son db2, oracle, informix, derby, sqlserver, db2zos y db2iseries.
- dbURL (String, necesario)
- El URL de base de datos para la modalidad de acceso directo. Por ejemplo: jdbc:db2:wim.
- dbAdminId (String)
- El ID de administrador de base de datos para la modalidad de acceso directo. Por
ejemplo: db2admin.Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminId.
- dbAdminPassword (String)
- La contraseña asociada con dbAdminId. Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminPassword.
- derbySystemHome (String)
- La ubicación de inicio del sistema Apache Derby Versión 10.2, si está configurando una base de datos Apache Derby Versión 10.2.
- reportSqlError (String)
- Especifica si debe notificar errores SQL mientras configura bases de datos.
- skipDBCreation (Boolean)
- Especifica si se van a crear las tablas en el repositorio de extensiones de
propiedades.
Si establece este valor de parámetro en false o no especifica ningún valor, el mandato sigue el comportamiento predeterminado de creación y rellenado de las tablas en la base de datos.
Si establece este valor de parámetro en true, configure manualmente el repositorio de extensiones de propiedades antes de ejecutar este mandato para que las tablas se rellenen. Para obtener más información acerca de este proceso manual, consulte el tema correspondiente sobre la configuración manual del repositorio de extensiones de propiedades para la base de datos.
- file (String)
- La vía de acceso completa de un archivo que contiene los parámetros de entrada. Cada parámetro de entrada debe coincidir con un parámetro correspondiente tal como se escribiría en la línea de mandatos, y se debe colocar en un par de clave=valor. Cada par debe ir en una línea aparte.
tablesBufferPool (String)
La variable de la agrupación de almacenamientos intermedios de tablas predeterminadas en DB2 para z/OS. El valor predeterminado es BP0.
LOBtablesBufferPool (String)
La variable de la agrupación de almacenamientos intermedios de tablas LOB auxiliares en DB2 para z/OS. El valor predeterminado es BP0.
indextablesBufferPool (String)
La variable de la agrupación de almacenamientos intermedios de tablas de índice exclusivas en DB2 para z/OS. El valor predeterminado es BP0.
dbSchema (String)
El esquema donde desea crear las tablas de repositorios federados. El esquema debe existir en la base de datos. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
dbSchema (String)
El esquema donde desea crear las tablas de repositorios federados. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
tablespacePrefix (String)
El prefijo del espacio de tabla. La longitud máxima permitida para este serie es de 3 caracteres. El valor de parámetro tablespacePrefix es necesario cuando se utiliza el parámetro dbSchema. Es específico de DB2 para z/OS y se omitirá para cualquier otro tipo de base de datos.
El mandato deleteIdMgrPropertyExtensionRepositoryTables:
El mandato deleteIdMgrPropertyExtensionRepositoryTables suprime las tablas en la base de datos de extensiones de propiedades.
Este mandato está disponible en modalidad local o conectada.
- schemaLocation (String, necesario)
- La ubicación del directorio <WAS>/etc/wim/setup.
- databaseType (String, necesario)
- El tipo de base de datos. Las bases de datos soportadas son db2, oracle, informix, derby, sqlserver, db2zos y db2iseries.
- dbURL (String, necesario)
- El URL de base de datos para la modalidad de acceso directo. Por ejemplo: jdbc:db2:wim.
- dbDriver (String)
- El nombre del controlador de base de datos. Por ejemplo: com.ibm.db2.jcc.DB2Driver.
- dbAdminId (String)
- El ID de administrador de base de datos para la modalidad de acceso directo. Por
ejemplo: db2admin.Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminId.
- dbAdminPassword (String)
- La contraseña asociada con dbAdminId. Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminPassword.
- derbySystemHome (String)
- La ubicación de inicio del sistema Apache Derby Versión 10.2, si está configurando una base de datos Apache Derby Versión 10.2.
- reportSqlError (String)
- Especifica si debe notificar errores SQL mientras configura bases de datos.
- file (String)
- La vía de acceso completa de un archivo que contiene los parámetros de entrada. Cada parámetro de entrada debe coincidir con un parámetro correspondiente tal como se escribiría en la línea de mandatos, y se debe colocar en un par de clave=valor. Cada par debe ir en una línea aparte.
dbSchema (String)
El esquema de base de datos del que desea suprimir las tablas de repositorios federados. El esquema debe existir en la base de datos. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
dbSchema (String)
El esquema de base de datos del que desea suprimir las tablas de repositorios federados. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
tablespacePrefix (String)
El prefijo del espacio de tabla. La longitud máxima permitida para este serie es de 3 caracteres. El valor de parámetro tablespacePrefix es necesario cuando se utiliza el parámetro dbSchema. Es específico de DB2 para z/OS y se omitirá para cualquier otro tipo de base de datos.
El mandato setupIdMgrEntryMappingRepositoryTables:
El mandato setupIdMgrEntryMappingRepositoryTables configura el repositorio de correlación de entradas, lo que incluye la creación y el rellenado de las tablas del repositorio.
- schemaLocation (String, necesario)
- La ubicación del directorio <WAS>/etc/wim/setup.
- databaseType (String, necesario)
- El tipo de base de datos. Las bases de datos soportadas son db2, oracle, informix, derby, sqlserver, db2zos y db2iseries.
- dbURL (String, necesario)
- El URL de base de datos para la modalidad de acceso directo. Por ejemplo: jdbc:db2:wim.
- dbDriver (String)
- El nombre del controlador de base de datos. Por ejemplo: com.ibm.db2.jcc.DB2Driver.
- dbAdminId (String)
- El ID de administrador de base de datos para la modalidad de acceso directo. Por
ejemplo: db2admin.Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminId.
- dbAdminPassword (String)
- La contraseña asociada con dbAdminId. Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminPassword.
- derbySystemHome (String)
- La ubicación de inicio del sistema Apache Derby Versión 10.2, si está configurando una base de datos Apache Derby Versión 10.2.
- reportSqlError (String)
- Especifica si debe notificar errores SQL mientras configura bases de datos.
- file (String)
- La vía de acceso completa de un archivo que contiene los parámetros de entrada. Cada parámetro de entrada debe coincidir con un parámetro correspondiente tal como se escribiría en la línea de mandatos, y se debe colocar en un par de clave=valor. Cada par debe ir en una línea aparte.
tablesBufferPool (String)
La variable de la agrupación de almacenamientos intermedios de tablas predeterminadas en DB2 para z/OS. El valor predeterminado es BP0.
dbSchema (String)
El esquema donde desea crear las tablas de repositorios federados. El esquema debe existir en la base de datos. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
dbSchema (String)
El esquema donde desea crear las tablas de repositorios federados. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
tablespacePrefix (String)
El prefijo del espacio de tabla. La longitud máxima permitida para este serie es de 3 caracteres. El valor de parámetro tablespacePrefix es necesario cuando se utiliza el parámetro dbSchema. Es específico de DB2 para z/OS y se omitirá para cualquier otro tipo de base de datos.
El mandato deleteIdMgrEntryMappingRepositoryTables:
El mandato deleteIdMgrEntryMappingRepositoryTables suprime las tablas en el repositorio de correlación de entradas.
- schemaLocation (String, necesario)
- La ubicación del directorio <WAS>/etc/wim/setup.
- databaseType (String, necesario)
- El tipo de base de datos. Las bases de datos soportadas son db2, oracle, informix, derby, sqlserver, db2zos y db2iseries.
- dbURL (String, necesario)
- El URL de base de datos para la modalidad de acceso directo. Por ejemplo: jdbc:db2:wim.
- dbDriver (String)
- El nombre del controlador de base de datos. Por ejemplo: com.ibm.db2.jcc.DB2Driver.
- dbAdminId (String)
- El ID de administrador de base de datos para la modalidad de acceso directo. Por
ejemplo: db2admin.Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminId.
- dbAdminPassword (String)
- La contraseña asociada con dbAdminId. Nota: Para una base de datos Apache Derby Versión 10.2 incorporada, no se necesita dbAdminPassword.
- derbySystemHome (String)
- La ubicación de inicio del sistema Apache Derby Versión 10.2, si está configurando una base de datos Apache Derby Versión 10.2.
- reportSqlError (String)
- Especifica si debe notificar errores SQL mientras configura bases de datos.
- file (String)
- La vía de acceso completa de un archivo que contiene los parámetros de entrada. Cada parámetro de entrada debe coincidir con un parámetro correspondiente tal como se escribiría en la línea de mandatos, y se debe colocar en un par de clave=valor. Cada par debe ir en una línea aparte.
dbSchema (String)
El esquema de base de datos del que desea suprimir las tablas de repositorios federados. El esquema debe existir en la base de datos. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
dbSchema (String)
El esquema de base de datos del que desea suprimir las tablas de repositorios federados. El valor predeterminado es el esquema predeterminado de la base de datos según el tipo de base de datos. Normalmente, el esquema predeterminado es el espacio de nombres del usuario de base de datos actual.
tablespacePrefix (String)
El prefijo del espacio de tabla. La longitud máxima permitida para este serie es de 3 caracteres. El valor de parámetro tablespacePrefix es necesario cuando se utiliza el parámetro dbSchema. Es específico de DB2 para z/OS y se omitirá para cualquier otro tipo de base de datos.
Uso de ejemplo de la línea de mandatos:
$AdminTask setupIdMgrDBTables {-schemaLocation "C:/WAS/etc/wim/setup" -dbPropXML
"C:/WAS/etc/wim/setup/wimdbproperties.xml" -databaseType db2
-dbURL jdbc:db2:wim -dbAdminId db2admin
-dbDriver com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd
-reportSqlError true}
$AdminTask deleteIdMgrDBTables {-schemaLocation "C:/WAS/etc/wim/setup"
-databaseType db2 -dbURL jdbc:db2:wim -dbAdminId db2admin
-dbDriver com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd
-reportSqlError true}
$AdminTask setupIdMgrPropertyExtensionRepositoryTables {-schemaLocation
"C:/WAS/etc/wim/setup"
-laPropXML "C:/WAS/etc/wim/setup/wimlaproperties.xml" -databaseType db2
-dbURL jdbc:db2:wim -dbAdminId db2admin -dbDriver com.ibm.db2.jcc.DB2Driver
-dbAdminPassword db2adminPwd -reportSqlError true}
$AdminTask deleteIdMgrPropertyExtensionRepositoryTables {-schemaLocation "C:/WAS/etc/wim/setup "
-databaseType db2 -dbURL jdbc:db2:wim -dbAdminId db2admin -dbDriver
com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd -reportSqlError true}
$AdminTask setupIdMgrEntryMappingRepositoryTables {-schemaLocation "C:/WAS/etc/wim/setup"
-databaseType db2 -dbURL jdbc:db2:wim -dbAdminId db2admin -dbDriver
com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd -reportSqlError true}
$AdminTask deleteIdMgrEntryMappingRepositoryTables {-schemaLocation "C:/WAS/etc/wim/setup"
-databaseType db2 -dbURL jdbc:db2:wim -dbAdminId db2admin -dbDriver
com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd -reportSqlError true}
Uso de ejemplo de CLI utilizan do la opción -file:
$AdminTask setupIdMgrDBTables {–file C:/params.txt -dbPropXML
"C:/OverrideDBPropParam/wimdbproperties.xml"}
Params.txtschemaLocation=C:/WAS/etc/wim/setup
dbPropXML=C:/Program Files/IBM/WebSphere/AppServer/profiles/default
/config/cells/mycell/wim/config/wimdbproperties.xml
laPropXML=C:/Program Files/IBM/WebSphere/AppServer/profiles/default
/config/cells/mycell/wim/config/wimlaproperties.xml
databaseType=db2
dbURL=jdbc:db2:wim
dbDriver=com.ibm.db2.jcc.DB2Driver
reportSqlError=true
dn=o=db.com
dbAdminId=db2admin
dbAdminPassword=dbPassword
wasAdminId=wasadmin
wasAdminPassword=wasadmin1
$AdminTask setupIdMgrDBTables {-file C:/params.txt}