25.5.32 ndbxfrm — Compress, Decompress, Encrypt, and Decrypt Files Created by NDB Cluster

25.5.32 ndbxfrm — NDB Cluster가 생성한 파일의 압축, 압축 해제, 암호화 및 복호화

ndbxfrm utility는 NDB Cluster에 의해 생성된, 압축되었거나 암호화되었거나, 또는 둘 다인 파일을 압축 해제하고 복호화하며, 해당 파일에 대한 정보를 출력하는 데 사용할 수 있습니다. 또한 파일을 압축하거나 암호화하는 데에도 사용할 수 있습니다.

Usage

1ndbxfrm --info file[ file ...]
2
3ndbxfrm --compress input_file output_file
4
5ndbxfrm --decrypt-password=password input_file output_file
6
7ndbxfrm [--encrypt-ldf-iter-count=#] --encrypt-password=password input_file output_file

input_file 과 output_file 은 같은 파일일 수 없습니다.

Options

• --compress, -c

Property	Value
Command-Line Format	--compress

입력 파일을, NDB Cluster 백업을 압축할 때 사용되는 것과 동일한 압축 방식(compression method)을 사용하여 압축하고, 결과를 출력 파일(output file)에 기록합니다. 암호화되지 않은 압축된 NDB 백업 파일을 압축 해제하려면, 압축된 파일 이름과 출력 파일 이름만을 사용하여 (옵션 없이) ndbxfrm을 실행하기만 하면 됩니다.

• --decrypt-key=key, -K key

Property	Value
Command-Line Format	--decrypt-key=key

제공된 키(key)를 사용하여 NDB에 의해 암호화된 파일을 복호화합니다.

참고

이 옵션은 --decrypt-password와 함께 사용할 수 없습니다.

• --decrypt-key-from-stdin

Property	Value
Command-Line Format	--decrypt-key-from-stdin

stdin으로부터 제공된 키를 사용하여 NDB에 의해 암호화된 파일을 복호화합니다.

• --decrypt-password=password

Property	Value
Command-Line Format	--decrypt-password=password
Type	String
Default Value	[none]

제공된 패스워드를 사용하여 NDB에 의해 암호화된 파일을 복호화합니다.

참고

이 옵션은 --decrypt-key와 함께 사용할 수 없습니다.

• --decrypt-password-from-stdin[=TRUE|FALSE]

Property	Value
Command-Line Format	--decrypt-password-from-stdin

표준 입력에서 제공된 패스워드를 사용하여 NDB에 의해 암호화된 파일을 복호화합니다. 이는 mysql을 --password 옵션 뒤에 패스워드 없이 실행한 후 패스워드를 입력하는 것과 유사합니다.

• --defaults-extra-file

Property	Value
Command-Line Format	--defaults-extra-file=path
Type	String
Default Value	[none]

전역 파일(global files)이 읽힌 후에 지정된 파일을 읽습니다.

• --defaults-file

Property	Value
Command-Line Format	--defaults-file=path
Type	String
Default Value	[none]

지정된 파일에서만 기본 옵션(default options)을 읽습니다.

• --defaults-group-suffix

Property	Value
Command-Line Format	--defaults-group-suffix=string
Type	String
Default Value	[none]

CONCAT(group, suffix)와 같은 그룹도 읽습니다.

• --detailed-info

Property	Value
Command-Line Format	--encrypt-block-size=#
Type	Boolean
Default Value	FALSE

파일의 헤더와 트레일러를 포함하여, --info와 같이 파일 정보를 출력하되, 더 자세한 정보를 출력합니다.

예:

1$> ndbxfrm --detailed-info S0.sysfile
2File=/var/lib/cluster-data/ndb_7_fs/D1/NDBCNTR/S0.sysfile, compression=no, encryption=yes
3header: {
4    fixed_header: {
5      magic: {
6        magic: { 78, 68, 66, 88, 70, 82, 77, 49 },
7        endian: 18364758544493064720,
8        header_size: 32768,
9        fixed_header_size: 160,
10        zeros: { 0, 0 }
11      },
12      flags: 73728,
13      flag_extended: 0,
14      flag_zeros: 0,
15      flag_file_checksum: 0,
16      flag_data_checksum: 0,
17      flag_compress: 0,
18      flag_compress_method: 0,
19      flag_compress_padding: 0,
20      flag_encrypt: 18,
21      flag_encrypt_cipher: 2,
22      flag_encrypt_krm: 1,
23      flag_encrypt_padding: 0,
24      flag_encrypt_key_selection_mode: 0,
25      dbg_writer_ndb_version: 524320,
26      octets_size: 32,
27      file_block_size: 32768,
28      trailer_max_size: 80,
29      file_checksum: { 0, 0, 0, 0 },
30      data_checksum: { 0, 0, 0, 0 },
31      zeros01: { 0 },
32      compress_dbg_writer_header_version: { ... },
33      compress_dbg_writer_library_version: { ... },
34      encrypt_dbg_writer_header_version: { ... },
35      encrypt_dbg_writer_library_version: { ... },
36      encrypt_key_definition_iterator_count: 100000,
37      encrypt_krm_keying_material_size: 32,
38      encrypt_krm_keying_material_count: 1,
39      encrypt_key_data_unit_size: 32768,
40      encrypt_krm_keying_material_position_in_octets: 0,
41    },
42    octets: {
43       102, 68, 56, 125, 78, 217, 110, 94, 145, 121, 203, 234, 26, 164, 137, 180,
44       100, 224, 7, 88, 173, 123, 209, 110, 185, 227, 85, 174, 109, 123, 96, 156,
45    }
46}
47trailer: {
48    fixed_trailer: {
49      flags: 48,
50      flag_extended: 0,
51      flag_zeros: 0,
52      flag_file_checksum: 0,
53      flag_data_checksum: 3,
54      data_size: 512,
55      file_checksum: { 0, 0, 0, 0 },
56      data_checksum: { 226, 223, 102, 207 },
57      magic: {
58        zeros: { 0, 0 }
59        fixed_trailer_size: 56,
60        trailer_size: 32256,
61        endian: 18364758544493064720,
62        magic: { 78, 68, 66, 88, 70, 82, 77, 49 },
63      },
64    }
65}

• --encrypt-block-size=#

Property	Value
Command-Line Format	--encrypt-block-size=#
Type	Integer
Default Value	0
Minimum Value	0
Maximum Value	2147483647

단위로 암호화되는 입력 데이터 청크(chunk)의 크기입니다. XTS와 함께 사용합니다; CBC 모드의 경우 0(기본값)으로 설정합니다.

• --encrypt-cipher=#

Property	Value
Command-Line Format	--encrypt-cipher=#
Type	Integer
Default Value	1
Minimum Value	0
Maximum Value	2147483647

암호화에 사용되는 사이퍼(cipher)입니다. CBC 모드(기본값)에는 1로, XTS에는 2로 설정합니다.

• --encrypt-kdf-iter-count=#, -k #

Property	Value
Command-Line Format	--encrypt-kdf-iter-count=#
Type	Integer
Default Value	0
Minimum Value	0
Maximum Value	2147483647

파일을 암호화할 때, 암호 키(encryption key)에 사용할 반복(iteration) 횟수를 지정합니다. 이 옵션은 --encrypt-password 옵션이 필요합니다.

• --encrypt-key=key

Property	Value
Command-Line Format	--encrypt-key=key

제공된 키를 사용하여 파일을 암호화합니다.

참고

이 옵션은 --encrypt-password와 함께 사용할 수 없습니다.

• --encrypt-key-from-stdin

Property	Value
Command-Line Format	--encrypt-key-from-stdin

stdin으로부터 제공된 키를 사용하여 파일을 암호화합니다.

• --encrypt-password=password

Property	Value
Command-Line Format	--encrypt-password=password
Type	String
Default Value	[none]

옵션으로 제공된 패스워드를 사용하여 백업 파일을 암호화합니다. 패스워드는 여기 나열된 요구 사항을 만족해야 합니다:

• !, ', ", $, %, \, ``````, ^를 제외한 임의의 출력 가능한(printable) ASCII 문자를 사용합니다.

• 길이는 256자를 넘지 않습니다.

• 작은따옴표(single quotation mark) 또는 큰따옴표(double quotation mark)로 둘러싸야 합니다.

참고

이 옵션은 --encrypt-key와 함께 사용할 수 없습니다.

• --encrypt-password-from-stdin[=TRUE|FALSE]

Property	Value
Command-Line Format	--encrypt-password-from-stdin

표준 입력에서 제공된 패스워드를 사용하여 파일을 암호화합니다. 이는 mysql을 --password 옵션 뒤에 패스워드 없이 실행한 후 패스워드를 입력하는 것과 유사합니다.

• --help, -?

Property	Value
Command-Line Format	--help

프로그램에 대한 사용법(usage) 정보를 출력합니다.

• --info, -i

Property	Value
Command-Line Format	--info

하나 이상의 입력 파일(input file)에 대해 다음 정보를 출력합니다:

• 파일 이름

• 파일이 압축되었는지 여부 (compression=yes 또는 compression=no)

• 파일이 암호화되었는지 여부 (encryption=yes 또는 encryption=no)

예:

1$> ndbxfrm -i BACKUP-10-0.5.Data BACKUP-10.5.ctl BACKUP-10.5.log
2File=BACKUP-10-0.5.Data, compression=no, encryption=yes
3File=BACKUP-10.5.ctl, compression=no, encryption=yes
4File=BACKUP-10.5.log, compression=no, encryption=yes

--detailed-info 옵션을 사용하여 파일의 헤더와 트레일러도 확인할 수 있습니다.

• --login-path

Property	Value
Command-Line Format	--login-path=path
Type	String
Default Value	[none]

로그인 파일(login file)에서 지정된 경로(path)를 읽습니다.

• --no-login-paths

Property	Value
Command-Line Format	--no-login-paths

로그인 경로 파일(login path file)에서 옵션을 읽는 것을 건너뜁니다.

• --no-defaults

Property	Value
Command-Line Format	--no-defaults

로그인 파일 이외의 어떤 옵션 파일(option file)에서도 기본 옵션을 읽지 않습니다.

• --print-defaults

Property	Value
Command-Line Format	--print-defaults

프로그램 인자 목록(program argument list)을 출력하고 종료합니다.

• --usage, -?

Property	Value
Command-Line Format	--usage

--help의 동의어입니다.

• --version, -V

Property	Value
Command-Line Format	--version

버전(version) 정보를 출력합니다.

ndbxfrm은 어떤 버전의 NDB Cluster에서 생성된 백업도 암호화할 수 있습니다. 백업을 구성하는 .Data, .ctl, .log 파일은 각각 별도로 암호화되어야 하며, 이러한 파일은 각 데이터 노드(data node)마다 별도로 암호화되어야 합니다.

일단 암호화되면, 이러한 백업은 ndbxfrm, ndb_restore, 또는 ndb_print_backup에 의해서만 복호화될 수 있습니다.

암호화된 파일은 --encrypt-password과 --decrypt-password 옵션을 함께 사용하여 새로운 패스워드로 재암호화할 수 있습니다. 예:

1ndbxfrm --decrypt-password=old --encrypt-password=new input_file output_file

방금 보여 준 예에서, _old_와 _new_는 각각 이전 패스워드와 새 패스워드입니다. 이 둘 모두는 인용부호로 둘러싸야 합니다.

입력 파일(input file)은 복호화된 다음 출력 파일(output file)로 암호화됩니다. 입력 파일 자체는 변경되지 않습니다. 이전 패스워드로 접근할 수 없게 하려면, 입력 파일을 수동으로 삭제해야 합니다.