db2icrt - 创建实例命令

创建 Db2® 实例，包括 Db2 pureScale® 实例。此命令还可用于在创建 Db2 pureScale 实例的过程中创建多达 8 Db2 成员和 2 集群高速缓存工具。

在 Linux® 和 UNIX 操作系统上， db2icrt 位于 DB2DIR/instance 中，其中 DB2DIR 表示安装 Db2 数据库系统的安装目录。在 Windows 操作系统上， db2icrt 位于 DB2PATH\bin中，其中 DB2PATH 是 Db2 副本的安装目录。

db2icrt 命令在实例所有者的主目录中创建 Db2 实例。对于每个 Db2 pureScale 环境，只能创建一个 Db2 pureScale 实例。

权限

在 Linux 和 UNIX 操作系统上需要 root 用户或非 root 用户权限。在 Windows 操作系统上需要本地管理员权限。

命令语法

For root installation on Linux and UNIX operating systems

InstType

Db2 pureScale options

Db2 Text Search options

Notes:

¹ If the instance type is not specified with -s, the default instance type that is created for the server image is the Db2 Enterprise Server Edition (ese) instance type. The default instance type for the other images and Db2 Connect) are the Db2 Workgroup Server Edition (wse) instance type.
² When you create client instances, -u FencedID is not a valid option.
³ The MemberHostName:MemberNetname format was deprecated for the -m option, and might be discontinued in the future. The new format, with both -m and -mnet options, is required for IPv6 support with Db2 pureScale Feature.
⁴ The CFHostName:CFNetames format was deprecated for the -cf option, and might be discontinued in the future. The new format, with both -cf and -cfnet options, is required for IPv6 support with Db2 pureScale Feature.
⁵ On Linux/Unix, InstName must belong to primary group name which does not exceed 8 characters and cannot contain spaces.

For a non-root thin server instance on Linux and AIX® operating systems

For root installation on Windows operating systems

InstType

Db2 文本搜索选项

注意：

¹ 如果未使用 -s指定实例类型，那么缺省实例类型为 Db2 Workgroup Server Edition (wse) 实例类型，而不考虑产品版本。

命令参数

For root installation on Linux and UNIX operating systems

-?: 显示用法信息。

-h

显示用法信息。

-d

开启调试方式。将 /tmp 中具有缺省名称的跟踪文件另存为 db2icrt.trc.ProcessID。仅当 Db2 数据库支持人员指示时才使用此选项

-a AuthType

指定实例的认证类型（SERVER、CLIENT 或者 SERVER_ENCRYPT）。缺省值为 SERVER。

-j "TEXT_SEARCH"

使用为服务名称和 TCP/IP 端口号生成的缺省值配置 Db2 Text Search 服务器。如果实例类型为 CLIENT，那么无法使用此参数。

-j "TEXT_SEARCH,servicename": 使用提供的服务名称和自动生成的端口号配置 Db2 Text Search 服务器。如果服务名称具有在 services 文件中分配的端口号，那么它将使用分配的端口号。
-j "TEXT_SEARCH,servicename,portnumber": 使用提供的服务名称和端口号配置 Db2 Text Search 服务器。
-j "TEXT_SEARCH,portnumber": 使用缺省服务名称和提供的端口号配置 Db2 Text Search 服务器。有效端口号必须在 1024 - 65535 范围内。

-p <TCP/IP PortName>

指定实例所使用的 TCP/IP 端口名称或者端口号。此选项还为 Db2 实例配置数据库管理器配置参数 SVCENAME 。

-m MemberHostName:NetName1

指定要在实例创建期间设置为 Db2 成员的主机。此参数在 Db2 pureScale 环境中是必需的。

最多可以通过 db2icrt 命令设置 8 Db2 成员。可以使用 db2iupdt -add 命令添加其他 Db2 成员。不推荐使用 NetName1 语法，在将来的发行版中可能会停用此语法。请改为使用 -mnet 参数。

MemberHostName 必须是规范的主机名（例如，在本地主机上运行的“host name”命令的输出）。此处指定的 NetName1 值必须属于与 -cf 参数中指定的子网相同的子网。

-mnet MemberNetName

此参数将替换 -m MemberHostName:NetName1 参数的不推荐使用的 :NetName1 语法。指定集群互连网络名，这是用于在 Db2 pureScale 实例中的成员与集群高速缓存设施 (也称为 CF) 之间进行高速通信的互连的主机名。

MemberNetName 必须属于 -cf 参数中指定的同一个子网，并且必须对应于集群互连网络名（例如，db2_<hostname_ib0）。

-cf CFHostName:NetName2

指定要在实例创建期间设置为集群高速缓存工具 (也称为 CF) 的主机。此参数在 Db2 pureScale 环境中是必需的。

两个 CF 可以通过 db2icrt 命令进行设置。还可以使用 db2iupdt -add 命令添加 CF 。建议不要使用 NetName2 语法，在将来的发行版中可能不再使用此语法。请改为使用 -cfnet 参数。

-cfnet CFNetName

此参数将替换 -cf CFHostName:NetName2 参数的不推荐使用的 :NetName2 语法。指定集群互连网络名，这是用于在 Db2 pureScale 实例中的成员与 CF 之间进行高速通信的互连的主机名。

CFNetName 必须属于 -m 参数中指定的同一子网，并且必须对应于集群互连网络名 (例如， db2_<hostname_ib0>)。

-instance_shared_dev Shared_Device_Path_for_Instance

指定设置 Db2 pureScale 实例以保存实例共享文件和缺省数据库路径所需的共享磁盘设备路径。例如，/dev/hdisk1。共享目录必须可在 Db2 pureScale 实例的所有主机上访问。此选项的值不能与 -tbdev 选项具有相同值。

指定 -instance_shared_dev 参数时， Db2 安装程序将创建 Db2 集群文件系统。

-instance_shared_dev 参数与 -instance_shared_dir 参数是互斥的。

-instance_shared_mount Shared_Mounting_Dir

指定新的 IBM® Spectrum Scale 文件系统的安装点。指定的路径必须是未嵌套在现有 IBM Spectrum Scale 文件系统中的新路径和空路径。

-instance_shared_dir Shared_Directory_for_Instance

指定共享文件系统 (IBM Spectrum Scale) 中设置 Db2 pureScale 实例以保存实例共享文件和缺省数据库路径所需的目录。例如，/sharedfs。该磁盘必须在 Db2 pureScale 实例的所有主机上都可访问。此选项的值不能与 -tbdev 选项或安装路径具有相同值。

如果指定了 -instance_shared_dir 参数，那么 Db2 安装程序将使用用户管理的文件系统。用户管理的文件系统必须在所有主机上都可用，并且必须是 IBM Spectrum Scale 文件系统。

-instance_shared_dir 参数与 -instance_shared_dev 参数是互斥的。

-tbdev Shared_device_for_tiebreaker

指定在 Db2 pureScale 环境中充当仲裁器的设备的共享设备路径，以确保维护数据的完整性。此选项的值不能与 -instance_shared_dev 选项或 -instance_shared_dir 选项具有相同值。首次创建 Db2 集群服务仲裁时，此选项是必需的。磁盘设备不得与任何文件系统相关联。如果存在 Db2 集群服务对等域，那么此选项无效。

注: 在 VMware 环境中运行时，不能将虚拟盘或 RDM 磁盘用作仲裁磁盘，因为这些磁盘上不支持 SCSI-3 持久保留 (PR)。在这种情况下，需要对仲裁磁盘选项指定 inputas，以避免受到此限制。

-i db2sshidName

指定在主机之间使用 Secure Shell (SSH) 网络协议时需要的非 root 用户标识。所指定的用户标识必须是不具备特权的用户。仅对 Db2 受管 IBM Spectrum Scale 文件系统有效。

-s InstType

指定要创建的实例的类型。仅当您创建除了缺省实例之外的实例时，才使用 -s 选项，缺省实例与运行 db2icrt 的已安装产品相关联。有效值为：

dsf: 用于为具有本地客户机和远程客户机的 Db2 数据库服务器创建 Db2 pureScale 实例。此选项是 IBM Db2 pureScale Feature的缺省实例类型。
ese: 用来为具有本地客户机和远程客户机的数据库服务器创建实例。此选项是 Db2 Advanced Enterprise Server Edition， Db2 Advanced Workgroup Server Edition， Db2 的缺省实例类型 Enterprise Server Edition或 Db2 Workgroup Server Edition。
wse: 用来为具有本地客户机和远程客户机的数据库服务器创建实例。此选项是 Db2 Express-C和 Db2 Connect Enterprise Edition的缺省实例类型。
standalone: 用来为具有本地客户机的数据库服务器创建实例。
client: 用来为客户机创建实例。此选项是 IBM Data Server Client和 IBM Data Server Runtime Client的缺省实例类型。

Db2 数据库产品支持其缺省实例类型以及低于其缺省实例类型的实例类型。例如， Db2 Enterprise Server Edition 支持实例类型埃塞，世界报，独立和客户。

-u Fenced ID

指定用来运行受防护用户定义函数和受防护存储过程的用户标识的名称。如果您未创建客户机实例，那么 -u 选项是必需的。

InstName

指定实例的名称，并且该名称也是操作系统中现有用户的名称。实例名称必须是 db2icrt 命令的最后一个参数。

For a non-root thin server instance on Linux and AIX operating systems

-d: 进入调试方式，供 Db2 数据库支持使用。
-h | -?: 显示用法信息。

For root installation on Windows operating systems

InstName

指定实例的名称。

-s InstType

指定要创建的实例的类型。目前，有四种 Db2 实例类型。有效值为：

client

用来为客户机创建实例。此选项是 IBM Data Server Client和 IBM Data Server Runtime Client的缺省实例类型。

standalone

用来为具有本地客户机的数据库服务器创建实例。

ese

用来为具有分区数据库环境支持，并且具有本地客户机和远程客户机的数据库服务器创建实例。该

-s ese -u Username, Password

选项必须与 db2icrt 一起使用，用于创建 ESE 实例类型和分区数据库环境实例。

wse

用来为具有本地客户机和远程客户机的数据库服务器创建实例。此选项是所有 Db2 Edition for Windows 平台的缺省实例类型。

Db2 Advanced Enterprise Server Edition， Db2 Advanced Workgroup Server Edition， Db2 Enterprise Server Edition， Db2 Workgroup Server Edition 支持 ese 实例类型以及低于 ese的实例类型。

例如， Db2 Enterprise Server Edition 支持实例类型埃塞，世界报，独立和客户。

其他版本支持 wse 实例类型以及版本低于 wse 的实例类型。

-u Username, Password

指定 DB2 服务的帐户和密码。当您创建分区数据库实例时，必须指定此选项。

-p InstProfPath

指定实例概要文件路径。

-h HostName

将覆盖缺省 TCP/IP 主机名（如果当前机器有多个 TCP/IP 主机名）。当您创建缺省数据库分区（数据库分区 0）时，将使用 TCP/IP 主机名。此选项仅对于分区数据库实例有效。

-r PortRange

指定在以 MPP 方式运行时，分区数据库实例要使用的 TCP/IP 端口的范围。例如，-r 50000,50007。如果指定了此选项，那么将使用以下条目更新本地机器的 services 文件：

DB2_InstName          baseport/tcp
DB2_InstName_END      endport/tcp

/j "TEXT_SEARCH"

使用为服务名称和 TCP/IP 端口号生成的缺省值配置 Db2 Text Search 服务器。如果实例类型为 CLIENT，那么无法使用此参数。

/j "TEXT_SEARCH,servicename": 使用提供的服务名称和自动生成的端口号配置 Db2 Text Search 服务器。如果服务名称具有在 services 文件中分配的端口号，那么它将使用分配的端口号。
/j "TEXT_SEARCH,servicename,portnumber": 使用提供的服务名称和端口号配置 Db2 Text Search 服务器。
/j "TEXT_SEARCH,portnumber": 使用缺省服务名称和提供的端口号配置 Db2 Text Search 服务器。有效端口号必须在 1024 - 65535 范围内。

-?

显示用法信息。

示例

要为实例所有者 db2sdin1 和受防护用户 db2sdfe1创建 Db2 pureScale 实例，请运行以下命令:
```
DB2DIR/instance/db2icrt 
   -cf host1.domain.com -cfnet host1.domain.com-ib0 
   -m host2.domain.com -mnet host2.domain.com-ib0
   -instance_shared_dev /dev/hdisk1 
   -tbdev /dev/hdisk2 
   -u db2sdfe1 
   db2sdin1
```
其中，DB2DIR 表示 DB2 副本的安装位置。 Db2 pureScale 实例 db2sdin1 在 host1上具有 CF ，在 host2上具有成员。此命令还使用 /dev/hdisk1 来创建共享文件系统以存储实例共享文件，并将 /dev/hdisk2 设置为仲裁器的共享设备路径。
要为用户标识 db2inst1创建 Db2 Enterprise Server Edition 实例，请运行以下命令:
```
DB2DIR/instance/db2icrt -s ese -u db2fenc1 db2inst1
```
其中，DB2DIR 表示 DB2 副本的安装位置。
要为实例所有者 db2sdin1 和受防护用户 db2sdfe1创建使用由 Db2 产品管理的现有文件系统 (IBM Spectrum Scale) 的 Db2 pureScale 实例，请运行以下命令:
```
DB2DIR/instance/db2icrt 
   -cf host1.domain.com -cfnet host1.domain.com-ib0 
   -m host2.domain.com -mnet host2.domain.com-ib0
   -tbdev /dev/hdisk2 
   -u db2sdfe1 
   db2sdin1
```
其中，DB2DIR 表示 DB2 副本的安装位置。
要使用现有用户管理的 IBM Spectrum Scale 文件系统 (/gpfs_shared_dir) 为实例所有者 db2sdin1 和受防护用户 db2sdfe1创建 Db2 pureScale 实例，请运行以下命令:
```
DB2DIR/instance/db2icrt 
   -cf host1.domain.com -cfnet host1.domain.com-ib0 
   -m host2.domain.com -mnet host2.domain.com-ib0
   -instance_shared_dir /gpfs_shared_dir
   -tbdev /dev/hdisk2 
   -u db2sdfe1 
   db2sdin1
```
其中，DB2DIR 表示 DB2 副本的安装位置。
在 AIX 机器上，要为用户标识 db2inst1创建实例，请发出以下命令:
在客户机上：
```
DB2DIR/instance/db2icrt db2inst1
```
在服务器上：
```
DB2DIR/instance/db2icrt -u db2fenc1 db2inst1
```
其中 db2fenc1 是用于运行受防护用户定义函数和受防护存储过程的用户标识。

要在多个成员或 CF 上创建 Db2 pureScale 实例，请运行以下命令:

DB2DIR/instance/db2icrt
-m coralmem1 -mnet coralmem1-ib0
-m coralmem2 -mnet coralmem2-ib0	
-m coralmem3 -mnet coralmem3-ib0	
-m coralmem4 -mnet coralmem4-ib0	
–m coralmem5 -mnet coralmem5-ib0
-m coralmem6 -mnet coralmem6-ib0
-m coralmem7 -mnet coralmem7-ib0	
-m coralmem8 -mnet coralmem8-ib0
-cf coralcf1 -cfnet coralcf1-ib0	
-cf coralcf2 -cfnet coralcf2-ib0
-instance_shared_dev /dev/hdisk1
-tbdev /dev/hdisk10 -u db2sdin1 db2sdin1

其中，DB2DIR 表示 DB2 副本的安装位置。

注: db2icrt 命令支持在多个成员和 CF 上创建 Db2 pureScale 实例，最多只能创建 8 个成员和 2 个 CF。此外，如果指定了多个成员或 CF ，那么不支持不推荐的格式 -m MemberHostname:Netname 或-cf CFHostName:NetName 。

使用说明

所有主机上必须存在具有相同 UID、GID、组名和主目录路径的实例用户。同样的规则适用于受保护用户。成功运行 db2icrt 命令后， Db2 安装程序将为主机之间的实例用户设置 SSH。
当您使用 db2icrt 命令时，实例的名称必须与现有用户的名称相匹配。
每个 Db2 pureScale 环境只能有一个实例。
创建 Db2 实例时，请考虑以下限制:
- 如果现有标识用于创建 Db2 实例，请确保标识未锁定且密码未到期。
您还可以使用 db2isetup 命令来创建和更新 Db2 实例，并使用图形界面添加多个主机。
如果使用 su 命令而不是 login 命令来成为 root 用户，那么必须发出带有 - 选项的 su 命令，以指示要设置进程环境，就像您使用 login 命令登录到系统一样。
不得为 root 用户提供 Db2 实例环境的源。不支持在生成 Db2 实例环境时运行 db2icrt 。
如果先前创建了 Db2 pureScale 实例并将其删除，那么无法使用 -instance_shared_dev 参数规范重新创建该实例，因为可能已创建 Db2 集群文件系统。要指定先前所创建的共享文件系统：
- 如果现有 IBM Spectrum Scale 共享文件系统是由 Db2 pureScale Feature创建和管理的，那么不得使用 -instance_shared_dev 参数和 -instance_shared_dir 参数。
- 如果现有 IBM Spectrum Scale 共享文件系统未由 Db2 pureScale Feature创建和管理，请使用 -instance_shared_dir 参数。
在 AIX 6.1 (或更高版本) 上，从系统工作负载分区 (WPAR) 全局环境中的共享 Db2 副本运行此命令时，必须以 root 用户身份运行此命令。 WPAR 在 Db2 pureScale 环境中不受支持。
有关 /var 目录内存需求，请参阅主题“磁盘和内存需求”。
在 Db2 pureScale 环境中， db2icrt 命令不支持轻量级目录访问协议 (LDAP) 环境。