[jfriends-ml 13649] 議事録および標準議事録作成要領について（「 Hadoop 第 2 版」を読む会第 5 回）

["TAKAHASHI,Toru" <torutk@xxxxxxxxxxxx>]

高橋（徹）です。

Hadoop第2版を読む会、第5回の議事録および議事録作成要領のお知らせです。

１）議事録
　本メールに添付しています。今回は、２）の標準フォーマットに沿って記述し
ています。

２）Java読書会議事録の標準フォーマットについて

　Java読書会BOF合宿2012 において、Java読書会議事録の書式統一の提案があり、
今回より標準化を進めることとなりました（ってすっかり記憶から飛んでました
が・・・）。
　
　2/25の読書会の折、議事録作成に立候補がいなかったので何気なくやりますと
言った後に
上述のことを言われ、思い出したというか・・・。

　書式については、Sphinxというドキュメントツールの活用をにらんで、ReST形式で
記述します。といっても、素のテキストで十分見られるので、お作法を守ってい
ただければ
Sphinx自体は意識する必要はありません。

　今回、この提案フォーマットで議事録を作成・添付しますので、添付したファ
イルを開いて
横並びに以下の説明を読んでいただければ幸いです。
（今回の議事録をコピペして作れば以下の説明は読まなくても問題ないくらいで
すが・・・）

Java読書会BOF 議事録標準フォーマット（案） Ver. 0.1

・ファイル名は、「課題図書識別英名」＋「開催回数数値」.rst　とする
　なお、課題図書識別英名は、その課題図書の第1回に決定する
　→　今回は、「Hadoop 第2版」の第5回なので、「課題図書識別英名」は勝手ながら
　　hadoop とし、"hadoop5.rst"　をファイル名としました。

・ファイルの文字コード（エンコーディング）はUTF-8とする
　→　議事録作成担当者は、Windows OS、Mac OS、Linux、iPad、Androidなど様々な
　　計算機を使用していること、Webへの掲載、Sphinxツールでの日本語処理容
易性の3点
　　を考慮しUTF-8としました。
　→　改行コードは、CR+LFを推奨とするが、LFも可とする。

・各議事録の題名は、Java読書会BOFのページで案内している開催名称を使用し、
　文字'='（半角イコール）をオーバーラインおよびアンダーラインで修飾する。
　→ 今回は「Hadoop 第2版」を読む会 第5回 だったのでその名称を使用しました。

・議事録題名に続いて、議事概要として、開催日時、場所、参加者を記載する。
　記載は、表に変換できるようCSV形式（カンマおよび文字列をダブルクォート
する）とする。
　→ ReST書式の指示子 .. csv-table:: を使用しています。おまじないと思って
ください。
　　.. は行頭から、.. と csvの間は半角空白1文字、::と開催概要の間も半角
空白1文字です。
　　.. csv-table:: と、続く表の内容の間に空行が1つ必須です。
　　表の内容は、行頭から最低1文字以上のインデントが必須です。

・議事本文の見出しとして、「議事」の文字列を、文字'='のアンダーラインで
修飾する。

・議事本文については、読み進めた課題図書の書籍中の見出し文字列を、文字'-
'（半角ハイフン）
　のアンダーラインで修飾する。
　見出しは書籍により細かい（大量にある）場合があるので、議事録作成者の一
存で任意の
　見出し文字列を記載すればよい。

・議論ポイントは、書籍の見出し文字列の下に箇条書きで記載する。箇条書き
は、文字'*'と続く
　半角空白とする。
　議論に対する補足議論は、箇条書きのインデントで記述する。
　箇条書きと箇条書きの間は、インデントした箇条書きを含めて空行で分離する。
　→ Sphinx（ReST形式）の制約で、空行を入れないと継続行と見なされるためです。

・議事録の最後には、次回開催で読み始める位置を、ページ番号および見出し文
字列で指定する。
　指定にあたっては、ReSTの指示子 .. note:: を使用する。

３）Sphinxについて

　各回の議事録は、今回提案の要領でReST形式テキストで作成するにとどめ、課
題図書1冊が
読了し議事録がすべてそろった時点で、Sphinxツールを通してHTMLなりPDFなり
ePubなりに
変換してJava読書会BOFのサイトに掲載することを想定しています。

　例えば、最後の回で終了までに時間が余ったときにその作業をする等です。
おおむね1時間もあればできるかなと思います。（仮に時間がないときは、担当
決めて宿題、
もしくは、次回の読書会開始前のズームイン朝の部の1時間など・・・）

　スマートフォンでも読めるということで、ePubが新しい試みかつ読書会っぽくて
興味ありますが・・・




　
　

============================================
Java読書会BOF 「Hadoop 第2版」を読む会 第5回
============================================

.. csv-table:: 開催概要

   "日時", "2012年2月25日 10:00 - 17:00"
   "場所", "エンバカデロテクノロジーズ会議室"
   "出席者(敬称略)", "高橋(智)、岩室、今井、吉本、まさあき、村山、根本、門脇、高橋(徹)"

議事
====

7.2.3 バイナリの入力
--------------------

7.2.4 複数の入力
--------------------

7.3.1 テキスト出力
--------------------

7.3.2 バイナリ出力
--------------------

* MapFileOutputFormatで出力キーがソートされてないといけないのはなぜ？

7.3.3 複数の出力
--------------------

* p.236 下4l 誤記 MultipleSequenceFileOutput は MultipleSequenceFileOutputFormat

* 「新しいMapReduce API」とあるけど？

8.1.1 組み込みカウンター
-------------------------

8.1.2 ユーザー定義のJavaカウンター
----------------------------------

* パッケージ名org.apache.hadoop.mapred と org.apache.hadoop.mapreduce と両方あるの？

  * (議事録追記) hadoop API Javadocを見ると両方存在する

9. Hadoopクラスタの構築
-----------------------

* p.280. 脚注のチェックサムエラーは、メモリのハード的な不良を指すのか、実行途中での偶発的なビット誤りを指すのか？

9.4.2 環境設定
---------------

9.4.3 Hadoopデーモンの重要なプロパティ
--------------------------------------

* p.295 足跡) noatimeオプション、 NTFSにもあるの？

  * HKLM\SYSTEM\CurrentControlSet\Control\FileSystemのNtfsDisableLastAccessUpdateで変更可

* p.297 表9-4 プロパティ名 mapred.local.dirが2つ出てくる、下側はmapred.system.dirの誤記、デフォルト値は、${hadoop.tmp.dir}/mapred/systemか？

9.5 セキュリティ
-----------------

9.6 Hadoopクラスタのベンチマーク
--------------------------------

9.7 クラウドにおけるHadoop
---------------------------

* p.311 2段落目下2l EC3 は EC2 の誤記

.. note:: 次回は、p.315「10章 Hadoopの管理」からです。