'\" t
.\"     Title: gfjournaladmin
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 21 Jun 2012
.\"    Manual: Gfarm
.\"    Source: Gfarm
.\"  Language: English
.\"
.TH "GFJOURNALADMIN" "1" "21 Jun 2012" "Gfarm" "Gfarm"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gfjournaladmin \- ジャーナルファイルの特定レコードを消去する。
.SH "SYNOPSIS"
.HP \w'\fBgfjournaladmin\fR\ 'u
\fBgfjournaladmin\fR [\fIオプション\fR] \fIジャーナルファイル\fR \fIシーケンス番号\fR
.SH "DESCRIPTION"
.PP
\fBgfjournaladmin\fR
は、ジャーナルファイルの中から、 シーケンス番号
\fIsequence\-number\fR
を持った レコードを消去します。 レコードは、同じ長さの NOP (no operation) レコードで置き換えられるため、 ジャーナルファイル内の他のレコードが移動したり、内容が変更されたりする ことはありません。
.PP
gfmd はメタデータの不整合を検知すると、以下のようなログメッセージを出力 し、ただちに終了します。
.sp
.if n \{\
.RS 4
.\}
.nf
	db_journal_store_thread : seqnum=938 ope=FILECOPY_ADD : \e
	    already exists
.fi
.if n \{\
.RE
.\}
.PP
このような不整合は発生してはならないものではありますが、gfmd のバグに よって一旦生じてしまうと、gfmd を再起動できなくなります。 起動時に gfmd はジャーナルデータの適用を行うため、再び不整合を検知して、 終了してしまいます。
\fBgfjournaladmin\fR
コマンドは、このような状況から抜け出す ために使用します。 上記のログメッセージでは、シーケンス番号 938 のレコードによって不整合が 起きていることが示されています。 このレコードを消すには、次のようにコマンドを実行します。
.sp
.if n \{\
.RS 4
.\}
.nf
	gfjournaladmin /var/gfarm\-metadata/journal/0000000000\&.gmj 938
.fi
.if n \{\
.RE
.\}
.PP
BEGIN (オペレーションID 1) および END (オペレーションID 2) の ジャーナルレコードは消すことができないので、注意して下さい。
.SH "OPTIONS"
.PP
\fB\-h\fR
.RS 4
引数オプションを表示します。
.RE
.PP
\fB\-?\fR
.RS 4
\fB\-h\fR
と同じです。
.RE
.PP
\fB\-n\fR
.RS 4
ジャーナルファイルは読み込みますが、実際に書き出す処理は行いません。　
.RE
.PP
\fB\-v\fR
.RS 4
冗長な表示を行います。
.RE