Hitachi

Hitachi Advanced Database Command Reference


12.5 Notes

  1. You can execute the adbconvertaudittrailfile command when the audit trail facility is enabled.

  2. The character encoding of common format audit trail files is the same as the character encoding of the HADB server that outputs the audit trail files to be converted.

  3. To execute the adbconvertaudittrailfile command, all the following conditions must be met. If the conditions are not met, the adbconvertaudittrailfile command results in an error.

    • An existing directory is specified for the -d option.

    • Read, write, and execution privileges are set so that the HADB administrator can access the directory specified for the -d option.

  4. You cannot convert the current audit trail file. If you want to convert the current audit trail file, execute the adbaudittrail --swap command to swap the current audit trail file. Then, specify the renamed audit trail file for the audit-trail-file-path for the adbconvertaudittrailfile command to perform the conversion.

  5. You can use the adbcancel command to forcibly terminate the processing of the adbconvertaudittrailfile command.

  6. Only one adbconvertaudittrailfile command can be executed at a time. If multiple instances of the adbconvertaudittrailfile command are executed simultaneously, an error occurs. However, if the multi-node function is used and the commands are executed on different nodes, multiple instances of the adbconvertaudittrailfile command can be executed simultaneously.

  7. If the multi-node function is used, execute the adbconvertaudittrailfile command on the nodes where the audit trail files to be converted exist.

  8. If the specified audit trail file is corrupted, the audit trails in the file might not be converted. Alternatively, the audit trails at and from the corrupted location might not be converted.

  9. The common format audit trail files are swapped by using the round-robin method. For this reason, when the 4th common format audit trail file is full, the 1st common format audit trail file is deleted. Then, a new 1st common format audit trail file is created.

    If deletion of the common format audit trail file might be problematic, back up the common format audit trail file as necessary.

  10. When the adbconvertaudittrailfile command is used to convert more than two million audit trails at a time, the common format audit trail files might be wrapped at a high speed. In this situation, JP1/Audit might not collect all audit trails. We recommend that you specify the default value (256 megabytes) for the adb_audit_log_max_size operand in the server definition, so that the number of audit trail files to be output to one audit trail file is no more than two million. For details about the adb_audit_log_max_size operand in the server definition, see the Operands related to audit trail facility (set format) in Detailed descriptions of the server definition operands in the HADB Setup and Operation Guide.