dbaminit
Synopsis
dbaminit
-D data_file_name1,data_file_size1{MB | GB}
[-D data_file_name2,data_file_size2{MB | GB}]
[-D…] …
-T translog_file_name,translog_file_size{MB | GB}
[-I report_interval] |
-V
Options
-D data_file_name1*,data_file_size1\{*MB | GB} [-D data_file_name2*,data_file_size2\{*MB | GB}] …
-
Specifies the file name and the file size of a file to be used as a directory data device where:
-
data_file_name is the name of the file; for example, /opt/dirx/DBAMFiles/DATA1.
-
data_file_size specifies the size of the associated file.
-
-
Specify data_file_size as an integer in the range 1 through 9999 followed by the keyword MB (to specify the size in megabytes) or GB (to specify the size in gigabytes).
-
Use one or more -D options to specify one or more files to be used as directory data devices for the database.
-T translog_file_name,translog_file_size\{MB | GB}
-
Specifies the file name and the file size of a file to be used as a directory transaction logging device where:
-
translog_file_name is the name of the file; for example, /opt/dirx/DBAMFiles/TRANS1.
-
translog_file_size specifies the size of the associated file.
-
-
Specify translog_file_size as an integer in the range 1 through 9999 followed by the keyword MB (to specify the size in megabytes) or GB (to specify the size in gigabytes). The minimum size is 256MB. It must be greater than the DBAM cache size. For best performance the size of the translog device should increase with the DBAM cache size and the checkpoint size. A good way to calculate the optimum size is to multiply the DBAM cache size by two (2). A translog device size of 4 GB performs well even for very large DBAM cache sizes (greater than 4 GB).
-I report_interval
-
(Capital letter "i".) Sets the reporting interval to report_interval %, for example -I20, displays a progress message every 20 % and does not overwrite the previously displayed message. Specify a value between 1 and 100. The default value is 10. (Displays a progress message every 10 % and overwrites the previously displayed message.)
-V
-
Displays the DirX Directory product version, in the format:
product_version build_id date time
For example:
DirX Directory V9.0 9.4.428 2023:03:23 20:10 64-Bit
Description
The dbaminit command initializes a file-based DBAM database; that is, it creates files with the specified names and allocates physical disk space in the specified size. In the event that the files already exist dbaminit fails.
Before you can use dbaminit, you must:
-
Provide disk space for the database(s).
Use the -D option to specify the file names and the file sizes for the directory data and the -T option to specify the file name and the file size of the transaction log file.
dbaminit lasts several minutes. The operation progress is displayed after 10 % of the file has been initialized, for example 20% of file /opt/dirx/DBAMfiles/DATA1 initialized. Use the -I (capital letter "i") option to modify the reporting interval and to enforce the operation not to overwrite the previously displayed message.
Examples
The following sample command initializes the file /opt/dirx/DBAMFiles/DATA1 for storing DirX Directory data and the file /opt/dirx/DBAMFiles/TRANS1 for storing transactions. The files consume 22 GB.
dbaminit –D /opt/dirx/DBAMFiles/DATA1,21GB
–T /opt/dirx/DBAMFiles/TRANS1,1GB