使用 wsadmin 命令来设置条目映射存储库、属性扩展存储库或定制注册数据库存储库
可以使用 wsadmin 命令来设置条目映射存储库、属性扩展存储库或定制注册数据库存储库。
关于此任务
创建存储库时,请使用适当的 wsadmin 命令定义数据库模式并填充数据库属性定义。
过程
下一步做什么
- 指定命令行上的自变量。
- 指定文件中的自变量。
-file 选项使您能够指定某个文件,其中的一些或所有参数已指定。要在命令行上使用 -file 自变量,请输入该文件的完整路径。必须在 key=value 对中指定该文件中的参数,并且每个参数都必须在它本身的目标行上。如果在命令行和该文件中指定了同一参数,那么以命令行上的值为准。
诊断自变量错误的技巧:
- 如果在命令行或文件中未正确指定某个自变量,那么会返回一条消息,指出该自变量未正确指定。这可能意味着根本未指定该自变量,或者对于指定的配置,它是必需自变量但是未指定。
- 如果根本未指定该自变量,请检查在命令行或文件中是否指定了它、其拼写是否正确以及大小写情况是否匹配。
- 如果该自变量对于指定的配置来说是必需的,但是未指定,那么值可能不单是命令所必需的,而且是要设置的数据库和设置类型所必需的。
例如,如果设置了 dn、wasAdminId 或 wasAdminPassword 参数,那么还必须指定 dbDriver 参数。
另外,如果指定了 dn、wasAdminId 或 wasAdminPassword 参数且 databaseType 不是 Apache Derby V10.2 数据库,那么还必须指定 dbAdminId 和 dbAdminPassword 参数。
![[z/OS]](../images/ngzos.gif)
setupIdMgrDBTables 命令:
setupIdMgrDBTables 命令会创建数据库表,以及填充您先前创建的数据库表。在命令行和文件中,自变量都区分大小写。
- schemaLocation(字符串,必需)
- <WAS>/etc/wim/setup 目录的位置。
- dbPropXML (字符串)
- 数据库存储库属性定义 XML 文件的位置。
- databaseType(字符串,必需)
- 数据库类型。受支持的数据库是 db2、oracle、informix、derby、sqlserver、db2zos 和 db2iseries。
- dbURL(字符串,必需)
- 直接访问方式的数据库 URL。例如:jdbc:db2:wim。
- dbDriver (字符串)
- 数据库驱动程序的名称。例如:com.ibm.db2.jcc.DB2Driver。
- dbAdminId (字符串)
- 直接访问方式的数据库管理员标识。例如:db2admin。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminId 不是必需的。
- dbAdminPassword (字符串)
- 与 dbAdminId 相关联的密码。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminPassword 不是必需的。
- dn (字符串)
- 要替换的缺省组织唯一名称。例如:o=yourco。如果未设置此项,那么会使用 o=Default Organization。
- wasAdminId (字符串)
- WebSphere Application Server 管理员用户标识。该标识应该是短名称而不是唯一名称。例如:wasadmin。在创建后,唯一名称是 uid=wasadmin, <defaultOrg>。
- wasAdminPassword (字符串)
- WebSphere Application Server 管理员用户密码。如果设置了 wasAdminId,那么此参数是必需的。
- saltLength (Integer)
- 为按散列法分散密码而随机生成的 salt 的长度。
- encryptionKey (字符串)
- 密码加密密钥。请设置密码加密密钥,以使它与存储库的 wimconfig.xml 文件中的加密密钥匹配。如果未设置加密密钥,请使用缺省值。
- derbySystemHome (字符串)
- 在设置 Apache Derby V10.2 数据库时,Apache Derby V10.2 系统的起始位置。
- reportSqlError (字符串)
- 指定在设置数据库时是否报告 SQL 错误。
- file (字符串)
- 包含输入参数的文件的完整路径。每个输入参数都必须与相应参数匹配,原因是将在命令行上输入它并且它必须位于 key=value 对中。每对都必须单独出现在一行上。
tablesBufferPool(字符串)
DB2 for z/OS 中缺省表的缓冲池变量。缺省值为 BP0。
LOBtablesBufferPool(字符串)
DB2 for z/OS 中辅助 LOB 表的缓冲池变量。缺省值为 BP0。
indextablesBufferPool(字符串)
DB2 for z/OS 中唯一索引表的缓冲池变量。缺省值为 BP0。
dbSchema(字符串)
您要在其中创建联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
dbSchema(字符串)
您要在其中创建联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
tablespacePrefix(字符串)
表空间前缀。此字符串允许的最大长度是 3 个字符。使用 dbSchema 参数时,tablespacePrefix 参数的值是必需的。此参数仅适用于 DB2 for z/OS,对于所有其他数据库类型,将忽略此参数。
deleteIdMgrDBTables 命令:
deleteIdMgrDBTables 命令用于删除数据库中的表。
- schemaLocation(字符串,必需)
- <WAS>/etc/wim/setup 目录的位置。
- databaseType(字符串,必需)
- 数据库类型。受支持的数据库是 db2、oracle、informix、derby、sqlserver、db2zos 和 db2iseries。
- dbURL(字符串,必需)
- 直接访问方式的数据库 URL。例如:jdbc:db2:wim。
- dbDriver (字符串)
- 数据库驱动程序的名称。例如:com.ibm.db2.jcc.DB2Driver。
- dbAdminId (字符串)
- 直接访问方式的数据库管理员标识。例如:db2admin。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminId 不是必需的。
- dbAdminPassword (字符串)
- 与 dbAdminId 相关联的密码。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminPassword 不是必需的。
- derbySystemHome (字符串)
- 在设置 Apache Derby V10.2 数据库时,Apache Derby V10.2 系统的起始位置。
- reportSqlError (字符串)
- 指定在设置数据库时是否报告 SQL 错误。
- file (字符串)
- 包含输入参数的文件的完整路径。每个输入参数都必须与相应参数匹配,原因是将在命令行上输入它并且它必须位于 key=value 对中。每对都必须单独出现在一行上。
dbSchema(字符串)
要从中删除联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
dbSchema(字符串)
要从中删除联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
tablespacePrefix(字符串)
表空间前缀。此字符串允许的最大长度是 3 个字符。使用 dbSchema 参数时,tablespacePrefix 参数的值是必需的。此参数仅适用于 DB2 for z/OS,对于所有其他数据库类型,将忽略此参数。
setupIdMgrPropertyExtensionRepositoryTables 命令:
setupIdMgrPropertyExtensionRepositoryTables 命令设置属性扩展存储库。缺省行为包括在数据库中创建和填充表。
在已连接或本地模式下,可以使用此命令。
- schemaLocation(字符串,必需)
- app_server_root/etc/wim/setup 目录的位置。
- laPropXML (字符串)
- 属性扩展存储库定义 XML 文件的位置。
- databaseType(字符串,必需)
- 数据库类型。受支持的数据库是 db2、oracle、informix、derby、sqlserver、db2zos 和 db2iseries。
- dbURL(字符串,必需)
- 直接访问方式的数据库 URL。例如:jdbc:db2:wim。
- dbAdminId (字符串)
- 直接访问方式的数据库管理员标识。例如:db2admin。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminId 不是必需的。
- dbAdminPassword (字符串)
- 与 dbAdminId 相关联的密码。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminPassword 不是必需的。
- derbySystemHome (字符串)
- 在设置 Apache Derby V10.2 数据库时,Apache Derby V10.2 系统的起始位置。
- reportSqlError (字符串)
- 指定在设置数据库时是否报告 SQL 错误。
- skipDBCreation(布尔值)
- 指定是否在属性扩展存储库中创建表。
如果将此参数值设置为 false 或不指定值,那么该命令将遵循在数据库中创建和填充表的缺省行为。
如果将此参数值设置为 true,请在运行此命令之前,先手动设置属性扩展存储库以填充表。有关此手动过程的更多信息,请参阅关于为数据库手动设置属性扩展存储库的相应主题。
- file (字符串)
- 包含输入参数的文件的完整路径。每个输入参数都必须与相应参数匹配,原因是将在命令行上输入它并且它必须位于 key=value 对中。每对都必须单独出现在一行上。
tablesBufferPool(字符串)
DB2 for z/OS 中缺省表的缓冲池变量。缺省值为 BP0。
LOBtablesBufferPool(字符串)
DB2 for z/OS 中辅助 LOB 表的缓冲池变量。缺省值为 BP0。
indextablesBufferPool(字符串)
DB2 for z/OS 中唯一索引表的缓冲池变量。缺省值为 BP0。
dbSchema(字符串)
您要在其中创建联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。通常,缺省模式是当前数据库用户的名称空间。
dbSchema(字符串)
您要在其中创建联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
tablespacePrefix(字符串)
表空间前缀。此字符串允许的最大长度是 3 个字符。使用 dbSchema 参数时,tablespacePrefix 参数的值是必需的。此参数仅适用于 DB2 for z/OS,对于所有其他数据库类型,将忽略此参数。
deleteIdMgrPropertyExtensionRepositoryTables 命令:
deleteIdMgrPropertyExtensionRepositoryTables 命令用于删除属性扩展数据库中的表。
在已连接或本地模式下,可以使用此命令。
- schemaLocation(字符串,必需)
- <WAS>/etc/wim/setup 目录的位置。
- databaseType(字符串,必需)
- 数据库类型。受支持的数据库是 db2、oracle、informix、derby、sqlserver、db2zos 和 db2iseries。
- dbURL(字符串,必需)
- 直接访问方式的数据库 URL。例如:jdbc:db2:wim。
- dbDriver (字符串)
- 数据库驱动程序的名称。例如:com.ibm.db2.jcc.DB2Driver。
- dbAdminId (字符串)
- 直接访问方式的数据库管理员标识。例如:db2admin。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminId 不是必需的。
- dbAdminPassword (字符串)
- 与 dbAdminId 相关联的密码。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminPassword 不是必需的。
- derbySystemHome (字符串)
- 在设置 Apache Derby V10.2 数据库时,Apache Derby V10.2 系统的起始位置。
- reportSqlError (字符串)
- 指定在设置数据库时是否报告 SQL 错误。
- file (字符串)
- 包含输入参数的文件的完整路径。每个输入参数都必须与相应参数匹配,原因是将在命令行上输入它并且它必须位于 key=value 对中。每对都必须单独出现在一行上。
dbSchema(字符串)
要从中删除联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
dbSchema(字符串)
要从中删除联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
tablespacePrefix(字符串)
表空间前缀。此字符串允许的最大长度是 3 个字符。使用 dbSchema 参数时,tablespacePrefix 参数的值是必需的。此参数仅适用于 DB2 for z/OS,对于所有其他数据库类型,将忽略此参数。
setupIdMgrEntryMappingRepositoryTables 命令:
setupIdMgrEntryMappingRepositoryTables 命令用于设置条目映射存储库,包括创建并填充存储库中的表。
- schemaLocation(字符串,必需)
- <WAS>/etc/wim/setup 目录的位置。
- databaseType(字符串,必需)
- 数据库类型。受支持的数据库是 db2、oracle、informix、derby、sqlserver、db2zos 和 db2iseries。
- dbURL(字符串,必需)
- 直接访问方式的数据库 URL。例如:jdbc:db2:wim。
- dbDriver (字符串)
- 数据库驱动程序的名称。例如:com.ibm.db2.jcc.DB2Driver。
- dbAdminId (字符串)
- 直接访问方式的数据库管理员标识。例如:db2admin。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminId 不是必需的。
- dbAdminPassword (字符串)
- 与 dbAdminId 相关联的密码。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminPassword 不是必需的。
- derbySystemHome (字符串)
- 在设置 Apache Derby V10.2 数据库时,Apache Derby V10.2 系统的起始位置。
- reportSqlError (字符串)
- 指定在设置数据库时是否报告 SQL 错误。
- file (字符串)
- 包含输入参数的文件的完整路径。每个输入参数都必须与相应参数匹配,原因是将在命令行上输入它并且它必须位于 key=value 对中。每对都必须单独出现在一行上。
tablesBufferPool(字符串)
DB2 for z/OS 中缺省表的缓冲池变量。缺省值为 BP0。
dbSchema(字符串)
您要在其中创建联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。通常,缺省模式是当前数据库用户的名称空间。
dbSchema(字符串)
您要在其中创建联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
tablespacePrefix(字符串)
表空间前缀。此字符串允许的最大长度是 3 个字符。使用 dbSchema 参数时,tablespacePrefix 参数的值是必需的。此参数仅适用于 DB2 for z/OS,对于所有其他数据库类型,将忽略此参数。
deleteIdMgrEntryMappingRepositoryTables 命令:
deleteIdMgrEntryMappingRepositoryTables 命令用于删除条目映射存储库中的表。
- schemaLocation(字符串,必需)
- <WAS>/etc/wim/setup 目录的位置。
- databaseType(字符串,必需)
- 数据库类型。受支持的数据库是 db2、oracle、informix、derby、sqlserver、db2zos 和 db2iseries。
- dbURL(字符串,必需)
- 直接访问方式的数据库 URL。例如:jdbc:db2:wim。
- dbDriver (字符串)
- 数据库驱动程序的名称。例如:com.ibm.db2.jcc.DB2Driver。
- dbAdminId (字符串)
- 直接访问方式的数据库管理员标识。例如:db2admin。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminId 不是必需的。
- dbAdminPassword (字符串)
- 与 dbAdminId 相关联的密码。注: 对于 Apache Derby V10.2 嵌入式数据库,dbAdminPassword 不是必需的。
- derbySystemHome (字符串)
- 在设置 Apache Derby V10.2 数据库时,Apache Derby V10.2 系统的起始位置。
- reportSqlError (字符串)
- 指定在设置数据库时是否报告 SQL 错误。
- file (字符串)
- 包含输入参数的文件的完整路径。每个输入参数都必须与相应参数匹配,原因是将在命令行上输入它并且它必须位于 key=value 对中。每对都必须单独出现在一行上。
dbSchema(字符串)
要从中删除联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
dbSchema(字符串)
要从中删除联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
tablespacePrefix(字符串)
表空间前缀。此字符串允许的最大长度是 3 个字符。使用 dbSchema 参数时,tablespacePrefix 参数的值是必需的。此参数仅适用于 DB2 for z/OS,对于所有其他数据库类型,将忽略此参数。
命令行用法示例:
$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}
使用 -file 选项时的 CLI 用法示例:
$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}