使用 wsadmin 命令来设置条目映射存储库、属性扩展存储库或定制注册数据库存储库

可以使用 wsadmin 命令来设置条目映射存储库、属性扩展存储库或定制注册数据库存储库。

开始之前

如果要设置条目映射存储库,请从在联合存储库配置中配置条目映射存储库中所述的步骤开始。

如果要设置属性扩展存储库,请从在联合存储库配置中配置属性扩展存储库中所述的步骤开始。

关于此任务

创建存储库时,请使用适当的 wsadmin 命令定义数据库模式并填充数据库属性定义。

过程

  1. 创建数据库。 可使用任何关系数据库产品。以下示例将提供针对特定供应商的技巧。
    1. 对于 DB2®,打开 DB2 命令窗口或命令中心并输入以下内容:
      db2 create database <name> using codeset UTF-8 territory US
      输入以下数据库调整命令:
      db2 update database configuration for <name> using applheapsz 1024
      db2 update database configuration for <name> using stmtheap 4096 
      db2 update database configuration for <name> using app_ctl_heap_sz 2048
      db2 update database configuration for <name> using locklist 1024
      db2 update database configuration for <name> using indexrec RESTART 
      db2 update database configuration for <name> using logfilsiz 1000 
      db2 update database configuration for <name> using logprimary 12 
      db2 update database configuration for <name> using logsecond 10 
      db2 update db cfg for <name> using sheapthres_shr MANUAL
      db2 update database configuration for <name> using sortheap 2048
    2. 可选: 对于使用 dbaccessInformix® 数据库,使用以下命令:
      CREATE DATABASE <name> WITH BUFFERED LOG
    3. 可选: 对于 Oracle 数据库,在安装 Oracle 期间数据库应该已经存在(如 orcl)。
  2. 通过完成以下操作来运行 setupIdMgrEntryMappingRepositoryTables 命令、setupIdMgrPropertyExtensionRepositoryTables 命令或 setupIdMgrDBTables 命令(对于定制注册表存储库):
    1. 启动 WebSphere® Application Server。
    2. 打开命令窗口并转至 <WAS>/Profiles/<PROFILE_NAME>bin 目录。
    3. 启动 wsadmin。
    4. 输入必需的命令,如下一节中所述。

下一步做什么

通过使用这些命令,您可以:
  • 指定命令行上的自变量。
  • 指定文件中的自变量。

-file 选项使您能够指定某个文件,其中的一些或所有参数已指定。要在命令行上使用 -file 自变量,请输入该文件的完整路径。必须在 key=value 对中指定该文件中的参数,并且每个参数都必须在它本身的目标行上。如果在命令行和该文件中指定了同一参数,那么以命令行上的值为准。

诊断自变量错误的技巧:

  • 如果在命令行或文件中未正确指定某个自变量,那么会返回一条消息,指出该自变量未正确指定。这可能意味着根本未指定该自变量,或者对于指定的配置,它是必需自变量但是未指定。
  • 如果根本未指定该自变量,请检查在命令行或文件中是否指定了它、其拼写是否正确以及大小写情况是否匹配。
  • 如果该自变量对于指定的配置来说是必需的,但是未指定,那么值可能不单是命令所必需的,而且是要设置的数据库和设置类型所必需的。

    例如,如果设置了 dnwasAdminIdwasAdminPassword 参数,那么还必须指定 dbDriver 参数。

    另外,如果指定了 dnwasAdminIdwasAdminPassword 参数且 databaseType 不是 Apache Derby V10.2 数据库,那么还必须指定 dbAdminIddbAdminPassword 参数。

[z/OS]要点: 要使用 Apache Derby V10.2 作为存储库,您必须运行 Apache Derby 网络服务器框架。此框架支持该数据库有多个并行 JVM 连接,而嵌入式框架仅使用单个 JVM,这不能满足大多数工作负载均衡需求。运行 Apache Derby V10.2 的 Network Server 框架需要 Derby 客户机驱动程序文件和类。

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 对中。每对都必须单独出现在一行上。
[z/OS]tablesBufferPool(字符串)
[z/OS]DB2 for z/OS 中缺省表的缓冲池变量。缺省值为 BP0。
[z/OS]LOBtablesBufferPool(字符串)
[z/OS]DB2 for z/OS 中辅助 LOB 表的缓冲池变量。缺省值为 BP0。
[z/OS]indextablesBufferPool(字符串)
[z/OS]DB2 for z/OS 中唯一索引表的缓冲池变量。缺省值为 BP0。
[AIX Solaris HP-UX Linux Windows][IBM i]dbSchema(字符串)
[AIX Solaris HP-UX Linux Windows][IBM i]您要在其中创建联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]dbSchema(字符串)
[z/OS]您要在其中创建联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]tablespacePrefix(字符串)
[z/OS]表空间前缀。此字符串允许的最大长度是 3 个字符。使用 dbSchema 参数时,tablespacePrefix 参数的值是必需的。此参数仅适用于 DB2 for z/OS,对于所有其他数据库类型,将忽略此参数。
注: 如果指定 wasAdminId/wasAdminPassword 参数,那么会在存储库中创建新用户。 请确保所指定的值不与另一个存储库中的现有用户重复。

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 对中。每对都必须单独出现在一行上。
[AIX Solaris HP-UX Linux Windows][IBM i]dbSchema(字符串)
[AIX Solaris HP-UX Linux Windows][IBM i]要从中删除联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]dbSchema(字符串)
[z/OS]要从中删除联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]tablespacePrefix(字符串)
[z/OS]表空间前缀。此字符串允许的最大长度是 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 对中。每对都必须单独出现在一行上。
[z/OS]tablesBufferPool(字符串)
[z/OS]DB2 for z/OS 中缺省表的缓冲池变量。缺省值为 BP0。
[z/OS]LOBtablesBufferPool(字符串)
[z/OS]DB2 for z/OS 中辅助 LOB 表的缓冲池变量。缺省值为 BP0。
[z/OS]indextablesBufferPool(字符串)
[z/OS]DB2 for z/OS 中唯一索引表的缓冲池变量。缺省值为 BP0。
[AIX Solaris HP-UX Linux Windows][IBM i]dbSchema(字符串)
[AIX Solaris HP-UX Linux Windows][IBM i]您要在其中创建联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。通常,缺省模式是当前数据库用户的名称空间。
[z/OS]dbSchema(字符串)
[z/OS]您要在其中创建联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]tablespacePrefix(字符串)
[z/OS]表空间前缀。此字符串允许的最大长度是 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 对中。每对都必须单独出现在一行上。
[AIX Solaris HP-UX Linux Windows][IBM i]dbSchema(字符串)
[AIX Solaris HP-UX Linux Windows][IBM i]要从中删除联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]dbSchema(字符串)
[z/OS]要从中删除联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]tablespacePrefix(字符串)
[z/OS]表空间前缀。此字符串允许的最大长度是 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 对中。每对都必须单独出现在一行上。
[z/OS]tablesBufferPool(字符串)
[z/OS]DB2 for z/OS 中缺省表的缓冲池变量。缺省值为 BP0。
[AIX Solaris HP-UX Linux Windows][IBM i]dbSchema(字符串)
[AIX Solaris HP-UX Linux Windows][IBM i]您要在其中创建联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。通常,缺省模式是当前数据库用户的名称空间。
[z/OS]dbSchema(字符串)
[z/OS]您要在其中创建联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]tablespacePrefix(字符串)
[z/OS]表空间前缀。此字符串允许的最大长度是 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 对中。每对都必须单独出现在一行上。
[AIX Solaris HP-UX Linux Windows][IBM i]dbSchema(字符串)
[AIX Solaris HP-UX Linux Windows][IBM i]要从中删除联合存储库表的数据库模式。该模式应该存在于数据库中。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]dbSchema(字符串)
[z/OS]要从中删除联合存储库表的数据库模式。缺省值为视数据库类型而定的数据库缺省模式。 通常,缺省模式是当前数据库用户的名称空间。
[z/OS]tablespacePrefix(字符串)
[z/OS]表空间前缀。此字符串允许的最大长度是 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 用法示例:

要在使用 params.txt 示例文件的情况下通过 -file 选项设置数据库,请输入以下行:
$AdminTask setupIdMgrDBTables {–file C:/params.txt -dbPropXML 
"C:/OverrideDBPropParam/wimdbproperties.xml"}
Params.txt
schemaLocation=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
要仅通过某个文件来在使用 -file 选项的情况下设置数据库,请输入以下命令:
$AdminTask setupIdMgrDBTables {-file C:/params.txt}
注: 仅当 -file 是命令行上指定的唯一参数时,使用文件才能起作用。如果指定了其他参数,那么该文件被完全忽略且仅命令行上的那些参数才用来执行命令。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twim_fedmap_wsadmin
文件名:twim_fedmap_wsadmin.html