infasetup 命令引用 > DefineDomain
  

DefineDomain

在当前计算机上创建域。 如果要在托管某个域的计算机上定义另一个域,则必须先在该计算机上停止 Informatica 服务。 infasetup 会删除现有的域和节点设置。 定义新域后,请重新启动 Informatica 服务。
要在 Windows 计算机上创建域,必须先打开主机端口或禁用防火墙。
请勿在 DefineDomain 命令中的选项 (-f) 之后添加任何字符。 如果添加其他字符,infasetup 可能会因发生意外错误而失败。
DefineDomain 命令使用以下语法:
DefineDomain

<<-DatabaseAddress|-da> database_hostname:database_port|

<-DatabaseConnectionString|-cs> database_connection_string>

[<-DatabaseUserName|-du> database_user_name]

[<-DatabasePassword|-dp> database_password]

<-DatabaseType|-dt> database_type ORACLE|DB2|MSSQLSERVER|SYBASE

[<-DatabaseServiceName|-ds> database_service_name]

[<-Tablespace|-ts> tablespace_name]

[<-SchemaName|-sc> schema_name (used for Microsoft SQL Server only)]

[<-DatabaseTlsEnabled|-dbtls> database_tls_enabled]

[<-DatabaseTruststorePassword|-dbtp> database_truststore_password]

<-DomainName|-dn> domain_name

[<-DomainDescription|-de> domain_description]

<-AdministratorName|-ad> administrator_name

[<-Password|-pd> password]

[<-LicenseName|-ln> license_name]

[<-LicenseKeyFile|-lf> license_key_file]

<-LogServiceDirectory|-ld> log_service_directory

<-NodeName|-nn> node_name

<-NodeAddress|-na> node_host:port

[<-ServiceManagerPort|-sp> service_manager_port]

[<-EnableTLS|-tls> enable_tls]

[<-NodeKeystore|-nk> node_keystore_directory]

[<-NodeKeystorePass|-nkp> node_keystore_password]

[<-NodeTruststore|-nt> node_truststore_directory]

[<-NodeTruststorePass|-ntp> node_truststore_password]

[<-EnableKerberos|-krb> enable_kerberos]

[<-ServiceRealmName|-srn> realm_name_of_node_spn]

[<-UserRealmName|-urn> realm_name_of_user_spn]

[<-KeysDirectory|-kd> Infa_keys_directory_location]

[<-SPNShareLevel|-spnSL> SPNShareLevel PROCESS|NODE]

[<-AdminconsolePort|-ap> admin_tool_port]

[<-HttpsPort|-hs> admin_tool_https_port]

[<-KeystoreFile|-kf> admin_tool_file_location]

[<-KeystorePass|-kp> admin_tool_keystore_password]

<-MinProcessPort|-mi> minimum_port

<-MaxProcessPort|-ma> maximum_port

[<-ServerPort|-sv> server_shutdown_port]

[<-AdminconsoleShutdownPort|-asp> admin_tool_shutdown_port]

[<-BackupDirectory|-bd> backup_directory]

[<-ServiceResilienceTimeout|-sr> timeout_period_in_seconds]

[<-ErrorLogLevel|-el> FATAL_ERROR_WARNING_INFO_TRACE_DEBUG]

<-ResourceFile|-rf> resource_file

[<-Timezone|-tz> log_service_timezone_GMT+00:00]

[<-Force|-f>]

[<-TrustedConnection|-tc> trusted_connection (used for Microsoft SQL Server only)]

[<-DatabaseTruststoreLocation|-dbtl> database_truststore_location]
下表介绍了 infasetup DefineDomain 选项和参数:
选项
参数
说明
-DatabaseAddress
-da
database_hostname:database_port
不使用 -DatabaseConnectionString (-cs) 选项时为必需。 托管域配置数据库的计算机的名称和端口号。
-DatabaseConnectionString
-cs
database_connection_string
不使用 -DatabaseAddress (-da) 和 -DatabaseServiceName (-ds) 选项时为必需。 用于连接到域配置数据库的连接字符串。 请将数据库主机、数据库端口和数据库服务名称指定为连接字符串的一部分。 用引号将连接字符串引起来。
-DatabaseUserName
-du
database_user_name
不使用 -TrustedConnection (-tc) 选项时为必需。 包含域配置信息的数据库的帐户。
-DatabasePassword
-dp
database_password
与数据库用户对应的域配置数据库密码。 如果忽略此选项,infasetup 会使用 INFA_DEFAULT_DATABASE_PASSWORD 环境变量中指定的密码。 如果该环境变量中未指定任何值,则必须使用此选项输入密码。
-DatabaseType
-dt
database_type
必需。 存储域配置元数据的数据库的类型。 数据库类型包括:
  • - db2
  • - oracle
  • - mssqlserver
  • - sybase
-DatabaseServiceName
-ds
database_service_name
不使用 -DatabaseConnectionString (-cs) 选项时为必需。 数据库服务名称。 对 Oracle、IBM DB2 和 Microsoft SQL Server 数据库来说为必需。 请输入 Oracle 的 SID、IBM DB2 的服务名称或 Microsoft SQL Server 的数据库名称。
-Tablespace
-ts
tablespace_name
对 IBM DB2 数据库来说为必需。 域配置数据库表驻留的表空间的名称。
-SchemaName
-sc
schema_name
可选。 Microsoft SQL Server 架构的名称。 如果不使用默认架构,则输入一个架构名称。
-DatabaseTlsEnabled
-dbtls
database_tls_enabled
可选。 指示 Informatica 域数据库是否通过 TLS 或 SSL 保护安全。 将安全数据库的此选项设置为 True。 默认值为 false。如果没有为 ‑dbtls 选项指定值,则 Informatica 域对 Informatica 域数据库使用安全通信。
-DatabaseTruststorePassword
-dbtp
database_truststore_password
可选。 安全数据库的数据库信任库文件的密码。
-DomainName
-dn
domain_name
必需。 域名。 域名必须介于 1 到 79 个字符之间,并且不能包含空格或以下字符:/ * ? < > " |
-DomainDescription
-de
domain_description
可选。 域的说明。
-AdministratorName
-ad
administrator_name
必需。 域管理员用户名。
-Password
-pd
密码
Kerberos 域的可选选项。 域管理员密码。 可以使用 -pd 选项或环境变量 INFA_DEFAULT_DOMAIN_PASSWORD 设置密码。 如果使用这两种方法设置密码,则使用 -pd 选项设置的密码优先。
-LicenseName
-ln
license_name
可选。 许可证的名称。 名称不区分大小写,但在域中必须唯一。 名称长度不能超过 79 个字符,不能包含前导空格或结尾空格,也不能包含回车符、制表符或以下字符:
/ * ? < > " |
-LicenseKeyFile
-lf
license_key_file
可选。 指向许可证密钥文件的路径。
-LogServiceDirectory
-ld
log_service_directory
必需。 日志管理器用来存储日志事件文件的共享目录路径。
-NodeName
-nn
node_name
必需。 节点的名称。 节点名称必须介于 1 到 79 个字符之间,并且不能包含空格或以下字符:\ / * ? < > " |
-NodeAddress
-na
node_host:port
必需。 托管节点的计算机的主机名和端口号。 请选择可用的端口号。
-ServiceManagerPort
-sp
service_manager_port
可选。 服务管理器用来侦听传入连接请求的端口号。
-EnableTLS
-tls
enable_tls
可选。 在 Informatica 域的服务之间配置安全通信。
如果使用 Informatica 提供的默认 SSL 证书,则无需指定密钥库和信任库选项。 如果未使用默认 SSL 证书,则必须指定密钥库和信任库选项。 有效值为 true 或 false。 默认值为 false。如果没有为 -tls 选项指定值,则 Informatica 域在各服务之间使用安全通信。
要为关联的服务或 Web 应用程序(如管理员工具、Analyst 工具或 Web Services Hub)启用安全通信,请在这些应用程序中单独配置安全通信。
-NodeKeystore|-
-nk
node_keystore_directory
如果使用 Informatica 提供的默认 SSL 证书,则为可选选项。 如果使用自身的 SSL 证书,则为必需选项。 包含密钥库文件的目录。Informatica 域需要以 PEM 格式以及在 Java 密钥库 (JKS) 文件中提供 SSL 证书。 目录必须包含 PEM 和 JKS 格式的密钥库文件。
密钥库文件必须命名为 infa_keystore.jks 和 infa_keystore.pem。 如果从证书颁发机构 (CA) 接收的密钥库文件为其他名称,则必须将其重命名为 infa_keystore.jks 和 infa_keystore.pem。
必须对域中的所有节点使用相同的密钥库文件。
-NodeKeystorePass
-nkp
node_keystore_password
如果使用 Informatica 提供的默认 SSL 证书,则为可选选项。 如果使用自身的 SSL 证书,则为必需选项。 密钥库 infa_keystore.jks 文件的密码。
-NodeTruststore
-nt
node_truststore_directory
如果使用 Informatica 提供的默认 SSL 证书,则为可选选项。 包含信任库文件的目录。Informatica 域需要以 PEM 格式以及在 Java 密钥库 (JKS) 文件中提供 SSL 证书。 目录必须包含 PEM 和 JKS 格式的信任库文件。
信任库文件必须命名为 infa_truststore.jks 和 infa_truststore.pem。 如果从证书颁发机构 (CA) 接收的信任库文件为其他名称,则必须将其重命名为 infa_truststore.jks 和 infa_truststore.pem。
-NodeTruststorePass
-ntp
node_truststore_password
如果使用 Informatica 提供的默认 SSL 证书,则为可选选项。 如果使用自身的 SSL 证书,则为必需选项。 infa_truststore.jks 文件的密码。
-EnableKerberos
-krb
enable_kerberos
可选。 将 Informatica 域配置为使用 Kerberos 身份验证。 有效值为 true 或 false。 如果为 true,则该域使用 Kerberos 身份验证,以后将无法更改身份验证模式。 启用 Kerberos 身份验证后,将无法禁用。 默认值为 false。如果没有为 -krb 选项指定值,则 Informatica 域使用 Kerberos 身份验证。
-ServiceRealmName
-srn
realm_name_of_node_spn
可选。 Informatica 域服务所属的 Kerberos 域的名称。确保输入的值与 Kerberos 身份验证的 -urn 值相同。
-UserRealmName
-urn
realm_name_of_user_spn
可选。 Informatica 域用户所属的 Kerberos 域的名称。确保输入的值与 Kerberos 身份验证的 -srn 值相同。
-KeysDirectory
-kd
Infa_keys_directory_location
可选。 存储 Informatica 域的所有 keytab 文件和加密密钥的目录。 默认目录为 <InformaticaInstallationDir>/isp/config/keys
SPNShareLevel
-spnSL
SPNShareLevel
PROCESS|NODE]
可选。 为域指示服务主体级别。将属性设置为以下级别之一:
  • - 进程。域要求每一节点和节点上的每项服务具有唯一服务主体名称 (SPN) 和 keytab 文件。每一节点所需的 SPN 和 keytab 文件数量取决于节点上运行的服务进程数量。如果域不需要高级别安全性,请使用节点级别选项。
  • - 节点。域对节点和节点上运行的所有服务使用一个 SPN 和 keytab 文件。此选项针对节点上的所有 HTTP 进程也需要单独的 SPN 和 keytab 文件。
默认为进程。
-AdminconsolePort
-ap
admin_tool_port
用于访问 Informatica Administrator 的端口。
-HttpsPort
-hs
admin_tool_https_port
可选。 用于保护与 Administrator 工具的连接的端口号。 如果要为节点配置 HTTPS,请设置此端口号。
-KeystoreFile
-kf
admin_tool_file_location
可选。 包含使用 SSL 安全协议时所需的密钥和证书的密钥库文件。
-KeystorePass
-kp
admin_tool_keystore_password
可选。 密钥库文件的纯文本密码。 可以使用 -kp 选项或环境变量 INFA_PASSWORD 设置密码。 如果同时使用这两种方法设置了密码,则使用 -kp 选项设置的密码将具有较高优先级。
-MinProcessPort
-mi
minimum_port
必需。 在节点上运行的应用程序服务进程的最小端口号。
-MaxProcessPort
-ma
maximum_port
必需。 在节点上运行的应用程序服务进程的最大端口号。
-ServerPort
-sv
server_shutdown_port
可选。 服务管理器所使用的 TCP/IP 端口号。 服务管理器通过此端口侦听来自域组件的关闭命令。 如果一台计算机上具有多个节点,或者默认端口号已在使用中,请设置此端口号。 默认值为节点端口号加一。
-AdminconsoleShutdownPort
-asp
admin_tool_shutdown_port
控制 Informatica Administrator 关闭的端口号。
-BackupDirectory
-bd
backup_directory
可选。 用于存储存储库备份文件的目录。 此目录必须可供该节点访问。
-ServiceResilienceTimeout
-sr
timeout_period_in_seconds
可选。 infasetup 尝试建立或重新建立与本地域的连接所持续的时间(以秒为单位)。 如果忽略此选项,infasetup 会使用 INFA_CLIENT_RESILIENCE_TIMEOUT 环境变量中指定的超时值。 如果在该环境变量中未指定任何值,则使用默认值 180 秒。
-ErrorLogLevel
-el
致命
错误
警告
信息
跟踪
调试
可选。 域日志中的日志事件的严重级别。 默认值为 info。
-ResourceFile
-rf
resource_file
必需。 包含节点可用资源列表的文件。 请使用位于以下位置的 nodeoptions.xml 文件:<INFA_HOME>/isp/bin
-TimeZone
-tz
log_service_timezone_GMT+00:00
可选。 日志管理器生成日志事件文件时所使用的时区。 默认值为 GMT+00:00。 按以下格式配置时区:
GMT(+/-)hh:mm
-Force
-f
-
可选。 如果具有相同名称的数据库已存在,则覆盖该数据库。 请勿在此选项之后添加任何字符。
-TrustedConnection
-tc
-
可选。 通过受信任连接连接到 Microsoft SQL Server 数据库。 受信任身份验证将使用当前用户的 Windows 安全凭据连接到 Micrsoft SQL Server。
注: 如果要使用受信任连接,请配置 DatabaseConnectionString 选项。
-DatabaseTruststoreLocation
-dbtl
database_truststore_location
安全域存储库数据库的信任库文件的路径和文件名。如果为域配置安全域存储库数据库,则为必选项。
如果在当前正托管某个域的节点上运行 DefineDomain,请重新配置以下域属性:
如果更改网关节点主机名或端口号,则还必须使用 infacmd AddDomainNode 命令将每个节点添加到域。