达梦dminit使用_yxy

1 功能简介

简介：dminit 是 DM 数据库初始化工具。用来创建初始数据库。可以设置各种参数。
位置：安装目录的/bin 目录下。

2 使用 dminit

dminit 工具需要从命令行启动。找到 dminit 所在安装目录/bin，输入 dminit 和参
数后回车。

语法：

dminit KEYWORD=value { KEYWORD=value }
KEYWORD：dminit 参数关键字。多个参数之间排列顺序无影响，参数之间使用空格间隔。
value：参数取值。

例：

初始化一个数据库，放在/home/test/dmdbms 目录下，数据页 PAGE_SIZE 大
小为 16K。
./dminit PATH=/home/test/dmdbms PAGE_SIZE=16
如果创建成功，则屏幕显示如下：
initdb V7.1.5.22-Build(2015.11.17-62910trunc)
db version: 0x70009
createdm database success. 2015-12-21 15:46:27
此时在/home/test/dmdbms 目录下会出现一个 DAMENG 文件夹，内容包含初始数据库 DAMENG 的相关文件和 DM 数据库启动所必须的配置文件 dm.ini。

3 查看 dminit 参数

dminit 使用较为灵活，参数较多。用户可使用“dminit HELP”快速查看各参数。
dminit HELP
INI_FILE 初始化文件 dm.ini 存放的路径
PATH 初始数据库存放的路径
CTL_PATH 控制文件路径
LOG_PATH 日志文件路径
EXTENT_SIZE 数据文件使用的簇大小(16)，可选值：16、32，单位：页
PAGE_SIZE 数据页大小(8)，可选值：4、8、16、32，单位：K
LOG_SIZE 日志文件大小(256)，单位为：M，范围为：64M ~ 2G
CASE_SENSITIVE 大小敏感(Y)，可选值：Y/N，1/0
CHARSET/UNICODE_FLAG 字符集(0)，可选值：0[GB18030]，1[UTF-8]，2[EUC-KR]
LENGTH_IN_CHAR VARCHAR 类型长度是否以字符为单位(N)，可选值：Y/N，1/0
SYSDBA_PWD 设置 SYSDBA 密码(SYSDBA)，密码长度为 9 到 48
SYSAUDITOR_PWD 设置 SYSAUDITOR 密码(SYSAUDITOR)，密码长度为 9 到 48
DB_NAME 数据库名(DAMENG)
INSTANCE_NAME 实例名(DMSERVER)
PORT_NUM 监听端口号(5236)
TIME_ZONE 设置时区(+08:00)
PAGE_CHECK 页检查模式(0)，可选值：0/1/2
EXTERNAL_CIPHER_NAME 设置默认加密算法
EXTERNAL_HASH_NAME 设置默认 HASH 算法
EXTERNAL_CRYPTO_NAME 设置根密钥加密引擎
RLOG_ENC_FLAG 设置日志文件是否加密(N)，可选值：Y/N，1/0
USBKEY_PIN 设置 USBKEY PIN
PAGE_ENC_SLICE_SIZE 设置页加密分片大小，可选值：512、4096，单位：Byte
ENCRYPT_NAME 设置全库加密算法
BLANK_PAD_MODE 设置空格填充模式(0)，可选值：0/1
SYSTEM_MIRROR_PATH SYSTEM 数据文件镜像路径
MAIN_MIRROR_PATH MAIN 数据文件镜像
ROLL_MIRROR_PATH 回滚文件镜像路径
MAL_FLAG 初始化时设置 dm.ini 中的 MAL_INI(0)
ARCH_FLAG 初始化时设置 dm.ini 中的 ARCH_INI(0)
MPP_FLAG Mpp 系统内的库初始化时设置 dm.ini 中的 mpp_ini(0)
CONTROL 初始化配置文件（配置文件格式见系统管理员手册）
AUTO_OVERWRITE 是否覆盖所有同名文件(0) 0:不覆盖 1:部分覆盖 2:完全覆盖
USE_NEW_HASH 是否使用改进的字符类型 HASH 算法(1)
DCP_MODE 是否是 DCP 代理模式(0)
DCP_PORT_NUM DCP 代理模式下管理端口
ELOG_PATH 指定初始化过程中生成的日志文件所在路径
SYSSSO_PWD 设置 SYSSSO 密码(SYSSSO)，密码长度为 9 到 48
SYSDBO_PWD 设置 SYSDBO 密码(SYSDBO)，密码长度为 9 到 48
PRIV_FLAG 设置权限标记，可选值：0、1
AP_PORT_NUM ECS 模式下 AP 协同工作的监听端口
HELP 打印帮助信息

4 dminit参数详解

4.1 INI_FILE
初始化文件 dm.ini 存放的路径，指定一个已经存在的 dm.ini 文件所在的绝对路径。
作用是将现有 INI 文件，拷贝到新库，作为新库的 INI 文件直接使用。文件路径长度最大为 256 个字符。可选参数。
如果不指定该参数，那么 dminit 工具会直接生成一个新的 dm.ini 文件。如果指定了该参数但指定的 INI 文件不存在，那么 dminit 工具会报错无效的 INI 文件，同时生成一个新的 dm.ini 文件。
例如 ，指定现有 /home/test/dmdbms 库中 dm.ini ， 给新创建的/home/dest/dmdbms 库使用。
./dminit INI_FILE=/home/test/dmdbms/DAMENG/dm.ini PATH=/home/dest/dmdbms
4.2 PATH
初始数据库存放的路径。默认路径为 dminit.exe 当前所在的工作目录。文件路径长度最大为 256 个字符。可选参数。
4.3 CTL_PATH
初始数据库控制文件的路径，默认值 Windows 下为 PATH\DB_NAME\dm.ctl，Linux
下为/PATH/DM_NAME/dm.ctl（PATH 和 DB_NAME 表示各自设置的值）。文件路径长度最大为 256 个字符。可选参数。
4.4 LOG_PATH
初始数据库日志文件的路径。默认值 Windows 下为 PATH\DB_NAME\DB_NAME01.log
和 PATH\DB_NAME\DB_NAME02.log，Linux 下为 PATH/DB_NAME/DB_NAME01.log 和PATH/DB_NAME/DB_NAME02.log（PATH 和 DB_NAME 表示各自设置的值）。文件路径长度最大为 256 个字符。日志文件路径个数不能超过 10 个。可选参数。
修改日志文件大小可以使用 LOG_SIZE 参数。
例如，创建一个数据库，包含两个日志文件 DATA01.log 和 DATA02.log。
./dminit PATH=/home/dest/dmdbms LOG_PATH=/home/dest/dmdbms/DATA01.log
LOG_PATH=/home/dest/dmdbms/DATA02.log
4.5 EXTENT_SIZE
数据文件使用的簇大小，即每次分配新的段空间时连续的页数。取值：16、32。单位：
页数。缺省值 16。可选参数。
4.6 PAGE_SIZE
数据文件使用的页大小。取值：4、8、16、32，单位：K。默认值为 8。可选参数。
选择的页大小越大，则 DM 支持的元组长度也越大，但同时空间利用率可能下降。
4.7 LOG_SIZE
重做日志文件大小。取值：64~2048 之间的整数，单位 M。默认值为 256。可选参数。
每个 DM 数据库实例至少有两个重做日志文件，循环使用，LOG_SIZE 设置每个重做日
志文件的大小。
修改日志文件路径可以使用 LOG_PATH 参数。
4.8 CASE_SENSITIVE
标识符大小写敏感。当大小写敏感时，小写的标识符应用""括起，否则被系统自动转换
为大写；当大小写不敏感时，系统不会转换标识符的大小写，在标识符比较时也不能区分大小写。取值：Y、y、1 表示敏感；N、n、0 表示不敏感。默认值为 Y。可选参数。
4.9 CHARSET/UNICODE_FLAG
字符集选项。取值：0 代表 GB18030，1 代表 UTF-8，2 代表韩文字符集 EUC-KR。默
认为 0。可选参数。
4.10 LENGTH_IN_CHAR
VARCHAR 类型对象的长度是否以字符为单位。取值：1、Y 表示是，0、N 表示否。默认值为 0。可选参数。
1 或 Y：是，所有 VARCHAR 类型对象的长度以字符为单位。这种情况下，定义长度并非真正按照字符长度调整，而是将存储长度值按照理论字符长度进行放大。所以会出现实际可插入字符数超过定义长度的情况，这种情况也是允许的。同时，存储的字节长度 8188 上限仍然不变，也就是说，即使定义列长度为 8188 字符，其实际能插入的字符串占用总字节长度仍然不能超过 8188；
0 或 N：否，所有 VARCHAR 类型对象的长度以字节为单位。
4.11 SYSDBA_PWD
初始化时设置 SYSDBA 的密码，默认为 SYSDBA。密码长度为 9~48 个字符。可选参数。
4.12 SYSAUDITOR_PWD
初始化时设置 SYSAUDITOR 的密码，默认为 SYSAUDITOR。密码长度为 9~48 个字符。可选参数。
4.13 DB_NAME
初始化数据库名称，默认为 DAMENG。名称为字符串，长度不能超过 128 个字符。可选参数。WINDOWS 下文件名不能包含字符/ \ * : ? < > " | ，LINUX 下文件名不能包含字符/\ : < > " |。
4.14 INSTANCE_NAME
初始化数据库实例名称，默认为 DMSERVER。名称为字符串，长度不能超过 128 个字符。可选参数。
4.15 PORT_NUM
初始化时设置 dm.ini 中的监听端口号，默认 5236。取值：1024~65534 之间的整数。
可选参数。
4.16 TIME_ZONE
初始化时区，默认为东八区(+08:00)。格式为[正负号]小时[：分钟]，其中，正负号
和分钟为可选项。时区设置范围为：-12:59~+14:00。可选参数。
4.17 PAGE_CHECK
是否启用页面内容校验模式。取值为：0：不启用；1：简单校验；2：严格校验(使用
CRC16 算法生成校验码)。默认 0。可选参数。
PAGE_CHECK 主要用来和数据库镜像一起使用。当 PAGE_CHECK 为 1 或 2 时，表示开启镜像系统，默认值 0 不开启。开启镜像后，用户还需要对指定的数据文件或回滚文件创建对应的镜像文件，涉及到的建库参数有 SYSTEM_MIRROR_PATH、MAIN_MIRROR_PATH 和ROLL_MIRROR_PATH，下文会详细介绍。
镜像系统的运行流程：当系统需要把数据写入数据文件（或回滚文件）时，在写入以后
如果数据文件（或回滚文件）创建了镜像文件，则需要把数据内容同时写入到镜像文件中。当系统需要从数据文件（或回滚文件）中读取数据时，如果数据文件（或回滚文件）中的校验信息与通过页内容生成的校验信息不一致则认为数据页已经损坏，那么系统会自动读取镜像文件中的数据继续提供服务。
4.18 EXTERNAL_CIPHER_NAME、EXTERNAL_HASH_NAME、
EXTERNAL_CRYPTO_NAME
第三方加密时使用。缺省情况下，使用DM内部默认算法。
EXTERNAL_CIPHER_NAME：设置默认加密算法。备份、还原、建表等凡是用到加密算法，但是加密算法缺省的情况下，如果用户指定了第三方加密，则用此算法。密码为字符串，不能超过32个字符。可选参数。
EXTERNAL_HASH_NAME：设置默认HASH算法。用来生成加密数据的校验码。算法为字符串，不能超过64个字符。可选参数。
EXTERNAL_CRYPTO_NAME：设置服务器根密钥加密引擎。加密引擎提供
EXTERNAL_CIPHER_NAME和EXTERNAL_HASH_NAME算法的动态库。加密引擎的使用，详细请参考《DM8安全管理》一书加密引擎章节。密钥为字符串，不能超过256个字符。可选参数。
4.19 USBKEY_PIN
USBKEY PIN 是登录第三方设备 UKEY 的密码。供使用 UKEY 的用户使用。UKEY 用于服务器端存储加密根密钥的证书，缺省使用磁盘物理文件 dm_service.prikey 存储根密钥密钥的密文。
在 DM 的加密机制中，增加移动 UKEY 的使用，更能确保 SVR_KEY 的安全性，数据安全性也得到进一步提升。
USBKEY PIN 为字符串，不能超过 48 个字节。可选参数。
4.20 PAGE_ENC_SLICE_SIZE
使用数据页按扇区大小进行分片加解密时，指定数据页加解密的分片大小。可配置大小
为 512 或 4096，默认值为 0，表示不按分片进行加解密。
4.21 ENCRYPT_NAME
指定全库加密算法，加密密钥由 DM 自动生成。不指定时，不进行全库加密。
全库加密操作流程：
第一步，在创建数据库的过程中，通过参数 ENCRYPT_NAME 的设置，使用 DM 内部支持的加密算法或是第三方的加密算法对数据库文件进行加解密。
第二步，在服务器启动及运行的过程中，需要对处理的所有数据页通过指定的加密算法和 DM 自动生成的密钥进行加解密处理，即如果数据页读入缓存，需要进行解密后才能使用，在缓存中的数据页进行刷盘时，需要对数据页进行加密后存储到数据文件中。
ENCRYPT_NAME：全库加密使用的算法名。算法可以是 DM 内部支持的加密算法，或者是第三方的加密算法，其中 DM 支持的加密算法可通过查询动态视图 V$CIPHERS 得到。算法名为字符串，不能超过 128 个字节。可选参数。
4.22 RLOG_ENC_FLAG
设置联机日志文件和归档日志文件是否加密。取值 Y/N，y/n，1/0，默认 N。可选参数。如果使用第三方加密，则默认值算法为 EXTERNAL_CIPHER_NAME。否则使用
AES256_CFB。
4.23 BLANK_PAD_MODE
设置字符串比较时，结尾空格填充模式是否兼容 ORACLE。取值：1 兼容；0 不兼容。
默认为 0。可选参数。
4.24 SYSTEM_MIRROR_PATH
指定 system.dbf 文件的镜像绝对路径。默认为空。可选参数。
当 PAGE_CHECK 为 1 或 2 时，才需要指定。
4.25 MAIN_MIRROR_PATH
指定 main.dbf 文件的镜像绝对路径。默认为空。可选参数。
当 PAGE_CHECK 为 1 或 2 时，才需要指定。
4.26 ROLL_MIRROR_PATH
指定 roll.dbf 文件的镜像绝对路径。默认为空。可选参数。
当 PAGE_CHECK 为 1 或 2 时，才需要指定。
4.27 MAL_FLAG
初始化时设置 dm.ini 中的 MAL_INI 值。取值 0 或 1。默认值为 0。可选参数。
1 表示 MAL_INI=1，启动 MAL 系统。同时，需要配置 dmmal.ini 文件。
0 表示 MAL_INI=0，不启用 MAL 系统。
4.28 ARCH_FLAG
初始化时设置 dm.ini 中的 ARCH_INI 值。取值 0 或 1。默认值为 0。可选参数。
1 表示 ARCH_INI=1，启用归档。同时，需要配置 dmarch.ini 文件。
0 表示 ARCH_INI=0，不启用归档。
4.29 MPP_FLAG
MPP 系统内的库初始化时设置 dm.ini 中的 MPP_INI。取值 0 或 1。默认值为 0。可选
参数。
1 表示 MPP_INI=1，启用 MPP 系统。
0 表示 MPP_INI=0，不启用 MPP 系统。
4.30 CONTROL
指定初始化配置文件路径。可选参数。
CONTROL 参数只能单独使用，和其他参数一起使用会报错。
CONTROL 参数主要用于将数据文件创建在 ASM 或 DSC 环境中。CONTROL 参数和初始化配置文件，详细信息见下一章节。
4.31 AUTO_OVERWRITE
是否覆盖建库目录下所有同名文件。取值： 0 不覆盖，表示建库目录下如果没有同名文
件，直接创建。如果遇到同名文件时，屏幕提示是否需要覆盖，由用户手动输入是与否（y/n，1/0）；1 部分覆盖，表示覆盖建库目录下所有同名文件；2 完全覆盖，表示先清理掉建库目录下所有文件再重新创建。默认值为 0。可选参数。
4.32 USE_NEW_HASH
是否使用改进的字符类型 HASH 算法。字符类型在计算 HASH 值时所采用的 HASH 算法类别。取值：0：原始 HASH 算法；1：改进的 HASH 算法。默认值为 1。可选参数。如果备份文件和数据库文件中该参数值不一致，则还原时会报错。
4.33 DCP_MODE
是否 DCP 代理模式。取值：1 是；0 否。默认值为 0。可选参数。
4.34 DCP_PORT_NUM
DCP 代理模式下管理监听端口号，默认 5237。取值范围：1024~65534。当 DCP_MODE=1时，该参数才有效。
4.35 SYSSSO_PWD
初始化时设置数据库安全员 SYSSSO 的密码，默认为 SYSSSO。密码为字符串，长度在6 到 48 个字符之间。可选参数。仅在安全版本下可见和可设置。
4.36 SYSDBO_PWD
初始化时设置数据库操作员 SYSDBO 的密码，默认为 SYSDBO。密码为字符串，长度在6 到 48 个字符之间。可选参数。仅在安全版本且 PRIV_FLAG=1 时，才有效。
4.37 PRIV_FLAG
是否是四权分立。取值：1 是，0 否。默认值为 0。可选参数。
为了保证数据库系统的安全性，DM 数据库采用“三权分立”或“四权分立”的安全机制，
“三权分立”时系统内置三种系统管理员，包括数据库管理员、数据库安全员和数据库审计员，“四权分立”时新增了一类用户，称为数据库对象操作员。它们各司其职，互相制约，有效地避免了将所有权限集中于一人的风险，保证了系统的安全性。默认情况下为“三权分立”。仅在安全版本下可见和可设置。
4.38 ELOG_PATH
指定初始化过程中生成的日志文件所在路径。可选参数。
4.39 HELP
显示帮助信息。可选参数。

5 dminit 高级主题

CONTROL 参数是 dminit 工具的高级功能，用于初始化数据库时指定初始化配置文件。初始化配置文件是一个保存了各数据文件路径和大小设置、所有 dminit 工具的命令行参数设置等信息的文本，名称由用户自己选取，例如：dminit.ini、abc.txt、dminit.ctl
等。各数据文件路径和大小设置相关参数详见表 5.1 和表 5.2；dminit 工具的命令行参数详见第 4 章。
dminit 工具使用 CONTROL 参数，就不能再指定其他参数，CONTROL 参数只能单独使用。
DM 既支持初始化单机数据库，又支持初始化 DSC 集群的数据库。操作非常简单，只要在使用 dminit 工具创建数据库的时候，使用 CONTROL 参数指定初始化配置文件即可。
例如：初始化配置文件为 dminit.ini。
./dminit CONTROL=/home/data/dminit.ini
初始化配置文件（本章统一命名为 dminit.ini）内容如何书写，单机和 DSC 环境下
略有不同，下面分别详细介绍

5.1 初始化单机数据库

DM 支持初始化数据库到一个普通机器上或是一个共享存储上。本节以 DMASM 文件系统为例，初始化单机数据库。
涉及路径和文件大小的参数配置，详细请参考下表。


例如，在 ASM 文件系统上创建数据库。参数 system_path、main、system、roll、
ctl_path、log01、log02 都指定了 ASM 文件系统。以+开头的就是 ASM 文件系统的路径，例如+DMDATA/data。单机配置文件（命名 dminit.ini）书写如下：
[DAMENG]
system_path = +DMDATA/data
main = +DMDATA/data/dsc/main.dbf
main_size = 2509
system = +DMDATA/data/dsc/system.dbf
system_size = 2509
roll = +DMDATA/data/dsc/roll.dbf
roll_size = 2509
ctl_path = +DMDATA/data/dsc/dm.ctl
log_size = 1024
log_path = +DMLOG/log/log01.log
log_path = +DMLOG/log/log02.log
auto_overwrite =2

5.2 初始化 DSC 集群的数据库

DM DSC 是一个单数据库、多实例的集群系统，数据库部署在共享存储上，供所有节点
访问，具有高可用性、高性能、低成本等特性。DM 支持在 DSC 环境下创建数据库。
DSC 的初始化库配置文件 dminit.ini 中涉及到的参数，是在单机 dminit.ini 基础上，增加了 DSC 节点信息。同时，把单机 dminit.ini 中 node_instance 参数去掉，log_path 参数下放到每个 DSC 节点里。详细的节点信息请参考下表:

例如，初始化 DSC 集群的数据库。两节点的 DSC 集群是搭建在 ASM 文件系统上。DSC环境初始化配置文件（命名 dminit.ini）书写如下：
db_name = dsc
system_path= +DMDATA/data
system= +DMDATA/data/dsc/system.dbf
system_size= 128
roll= +DMDATA/data/dsc/roll.dbf
roll_size= 128
main= +DMDATA/data/dsc/main.dbf
main_size= 128
ctl_path= +DMDATA/data/dsc/dm.ctl
ctl_size= 8
log_size= 256
dcr_path= /dev/raw/raw1 #dcr 磁盘路径，目前不支持 asm，只能是裸设备
dcr_seqno= 0
auto_overwrite= 1
[DSC0] #inst_name 跟 dmdcr_cfg.ini 中 DB 类型 group 中 DCR_EP_NAME 对应
config_path= /home/data/dsc0_config
port_num= 5236
mal_host= 10.0.2.101
mal_port= 9340
log_path= +DMLOG/log/dsc0_log01.log
log_path= +DMLOG/log/dsc0_log02.log
[DSC1] #inst_name 跟 dmdcr_cfg.ini 中 DB 类型 group 中 DCR_EP_NAME 对应
config_path= /home/data/dsc1_config
port_num= 5237
mal_host= 10.0.2.102
mal_port= 9341
log_path= +DMLOG/log/dsc1_log01.log
log_path= +DMLOG/log/dsc1_log02.log