nDiki : マニュアル

取扱説明書。

• 管理者マニュアル (Administrator's Manual)
• 開発者マニュアル (Developer's Manual)

インストール Windows ポイント ノート PC Linux デジカメ メモリ Web USB メール 検索 電話 CD-ROM ヨドバシカメラ ミーティング ビルド パスワード 暗号化 Web ブラウザ Perl SSH Debian GNU/Linux ThinkPad X31 無線 LAN ThinkPad 製品レポート 在庫 プリント インストーラ 散歩

■ Unison で Windowsのローカルディレクトリとリモートの共有フォルダ間の同期

オフィスのPC上のホームディレクトリを別のWindows BOX にミラーしておくのに DirSync (ディルシンク)を利用している。 最近ちょっとさぼっていたミラー作業を、今回は実験をかねて Unison でやってみた。

Windows 間なので今回は、共有フォルダに直接同期。

遅い。

オプションで -fastcheck true を指定しても、ファイル自体のスキャンは実行されるのか。10GBオーバーのファイル群の同期をこの方法で取ると、リモートのファイルのスキャンのために結局全て1度転送が起きることになる(同期の必要なものはまた転送が起きる)。

転送が始まってからも共有フォルダ内での renaming が Permission denied で失敗したりするしどうもよろしくない。

ということ共有フォルダを使った Unison はいまいち。 やはり規模が大きい時には、サーバ側でも Unison が動く形でないと駄目だな。

@ 追記 (2004年8月4日)

全部転送される旨がマニュアルに書いてあった。

(However, running Unison this way is only a good idea if the remote host is reached by a very fast network connection, since the full contents of every file in the remote replica will have to be transferred to the local machine to detect updates.)

• Unison で Windowsのローカルディレクトリとリモートの共有フォ... (2004-08-10)
• cwRsync と UNC (2004-09-03)
• TrueCrypt で USB メモリに Windows と Linux ... (2006-12-14)
• ワイヤレスLAN 802.11a/b/g Mini-PCI カード 31P... (2004-11-26)
• 1インチポータブル HDD HDMC-U12 インプレッション (2006-12-28)

■ ANTLR

やっぱり手でYAMLのパーサを作成するのが面倒なので(FIRSTとかFOLLOWとか入力バッファ処理とか)、やっぱりジェネレータを使う事を検討。 Java だと ANTLR あたりか。

YAMLだと文脈に応じて、インデント用空白列トークンの長さをかえて認識しなければならないのでそれがうまくできるかどうかがポイント。

まずはインストール(Eclipse 用のプラグインも入れておく)。 ちょっとずつマニュアルも読み始める。

• YAMLのJava実装を書く (2004-09-03)
• 自宅の無線 LAN を復旧 & IEEE 802.11g 化 (2004-11-26)
• PEG-TJ25 インストールメモ (2004-04-06)
• Eclipse 3.0M8 (2004-04-19)
• サブプロジェクトが使える GTD ツール ThinkingRock 2.0.1 (2008-06-23)

■ 自宅の無線 LAN を復旧 & IEEE 802.11g 化

不調になった無線 LAN を早く復旧しておきたい。 ということで会社帰りにヨドバシカメラへ行ってアクセスポイントを購入。 ここ最近周辺機器とか買ってなくて「何か買いたい物ないかなぁ」なんて事を考えていたのだが、今回はあまりトキメかない物を買うハメになってしまった。

選んだのはBUFFALOのブリッジモデルアクセスポイント AirStation WLA2-G54。 ルータ無し・ハブ付き IEEE 802.11g だとそれほど選択肢がない。 最近はルータ機能のついているのが主流なのか。 丸っこいデザインがダサいが我慢。

• BUFFALO IEEE802.11g 無線 LAN AirStation ブリッジモデル WLA2-G54

@ 設置

紙のマニュアルはペラッペラのが一枚。あとは注意書きの紙が数枚。 それ以外はCD-ROMに。 CD-ROM の中を見るのも面倒なので、紙のマニュアルだけでいってみる。 分かっていない人に分かり易く書こうとしてあるので、分かっている人には分かりにくい説明。

AOSSは最初から使わない。 暗号化方式は手持ちの機器・ドライバがどこまで対応できるのかわからないので、まずはWEPにしておく。

@ RTW65b の無線 LAN 機能を停止

ルータの無線 LAN 機能をまず止める。

@ Windows XP + WLI-PCM-L11GP から

現行で使っている構成から ESSID をアクセスポイントの初期設定値へ変更。 最初のテストなので一旦キー無しにし、接続できる事を確認。

@ Linux + ThinkPad X31内蔵アダプタから

DHCPがうまくとれない。なぜ?

@ Windows 98 SE を有線で接続して付属CD-ROMを使用

しかたないので CD-ROM ドライブのついている Windows 98 を起動。 付属CD-ROMをさして、エアステーション設定をしてみる。

えーと LAN 側 IP アドレスは 192.168.11.100 か (後でペラペラマニュアルを見直したら一応ちゃんと書いてあった)。

Web ブラウザから最終的に以下を設定

• 管理パスワード - 設定
• ANY接続 - 許可しない
• WEPを選択、キーを設定
• IP アドレスをRTW65bのネットワーク上の1つに固定で変更。
• RTW65b がDHCPでアクセスポイントの IP アドレスをリースしないように設定。

@ 再び Linux + ThinkPad X31内蔵アダプタから

接続成功。 そういえば今まで WEP のキー無しで接続が成功したことなかったっけか。 今度設定方法を確認しておかねば。

@ Windows XP + ワイヤレス LAN 802.11a/b/g Mini-PCI カード 31P9702

ThinkPad X31 2672-BJ9 に 31P9702 を増設。 以前にインストールしたクライアントマネージャーは削除して Windows (+ IBM 同梱ソフト?)の機能を使うように戻しておく。

@ アクセスポイントを鎮座

とりあえず場所を決めて設置。

片付け等をして結局2時間半以上かかってしまった。

• ルータ直結有線生活 (2004-11-25)
• ワイヤレスLAN 802.11a/b/g Mini-PCI カード 31P... (2004-11-26)
• MADWIFI で WPA を使うように変更 (2007-01-20)
• 納品前日なのに /var が壊れた! HDDからのブートで Debian ... (2005-09-27)
• Wi-Fi ファインダで Wi-Fi ホットスポットを探せ (2007-01-23)

■ ワイヤレスLAN 802.11a/b/g Mini-PCI カード 31P9702

妻の使っている ThinkPad X31 は 2672-BJ9 で LAN機能無し。 もともと ThinkPad X31 はどのモデルもアンテナを内蔵していて Mini-PCI のカードを増設できるようになっている。

今まではPCカード(WLI-PCM-L11GP)を使っていたのだが、アンテナ部分のでっぱりが邪魔。 今回IEEE 802.11g化するのを機に、いつかは買おうと思っていた 31P9702 を買うことに。

• IBM ワイヤレスLAN 802.11a/b/g 31P9702 Mini-PCIカード

ヨドバシカメラに店頭在庫があったので、そちらへ買いにいった。

@ 増設

ThinkPad の説明書には増設方法が書いていない。 カードの説明書にも増設方法が書いていない。 付属CD-ROMに入っているマニュアルを見ると、「ThinkPad のオンラインマニュアル」に書いてあるとのこと。 Windows を消してあると参照できないねぇ。

指示通りオンラインマニュアルを参照すると、増設方法が書いてあった。 英語キーボード(08K5073)に交換した時と同様、キーボードを外したところに増設するようになっている。 増設方法を暗記(増設中は当然電源を落とすので参照できない)。

で増設。アンテナケーブルを2本つないで、メモリを増設する時のように差し込み固定。

で起動すると自動的にドライバが入ってすぐ使えるようになる。 素晴しい。

• 自宅の無線 LAN を復旧 & IEEE 802.11g 化 (2004-11-26)
• ルータ直結有線生活 (2004-11-25)
• ThinkPad X31 英語キーボード(08K5073)注文 (2004-02-20)
• ThinkPad X31英語キーボード交換(08K5073) (2004-02-28)
• [ 秋葉原 ] 若松通商 PS/PLAZA (2003-12-08)

■ わかりやすいマニュアルを作る 文章・用字用語ハンドブック

[ コンピュータ書籍 ]

今日の作業で今年度の作業に区切りがついて一段落。 (いつものことだが)マニュアルについては後手にまわってしまって完成度の高さが充分ではなかったと反省。

いや、時間だけの問題ではないな。 考えてみれば、テクニカルライティングのイロハをきちんと学んでいない。 自分で書くにしても他人が書いた物の問題の指摘をするにしても、これはいけない。

それから、電子マニュアル化ソリューションを提供するなんて言うのに「マニュアルとはなんぞや」を学んでいないなんて恥ずかしい。 Webベースソリューションを提供する企業のWebサイトが駄目駄目なのが恥ずかしいのと同様。

ということでまずは書籍をチェック。 まずは評判の良い「わかりやすいマニュアルを作る 文章・用字用語ハンドブック」を手にしてみた。 主にコンピュータ業界を対象にした内容になっているが、書泉ブックタワーではコンピュータ書籍のフロアではなく1階上のフロアに置いてあった。

冒頭で

この本は、この本で示したルールに従って書いています。p.iii

と書かれている。素晴しい。 X言語で書かれたX言語処理系とか、そういった自己記述・自己適用の好きな自分のハートをがっちりキャッチされた。

まずマニュアル作成工程

1. 企画
2. 目次の作成
3. アウトラインの作成
4. レイアウトの決定
5. 執筆規則の作成
6. 執筆と推敲
7. 査読とテスト

の概要が解説されている。 この点からして頭の中で整理されていなかった部分があるので有り難い。

さすが、読みやすく書かれているのでさらりと読めそうだ。

[ 書評 ] [ お薦めの本 ]

• 仕事のヒント (2005-11-26)
• かんたん年賀状素材集 (2004-12-10)
• 恋愛に写真を持ち込みたい人必読「センネン画報」 (2008-09-28)
• Life Hacks PRESS で Life Hacks をおさらい (2006-03-28)
• すごい会議 - 短期間で会社が劇的に変わる! (2005-05-27)

■ Inline::Pdlpp で 手軽に PDL::PP のコードを書く

PDL を使用しているプログラムの高速化のため、再び PDL::PP でコードを書こうとマニュアルを見直したりしている。

PDL::PP にも Inline 系の Inline::Pdlpp モジュールが用意されているのか。 PDL::PP の仕様は結構わかりにくくて(かなり)慣れないと大変。 何度も書いてはテストしてみることになるので、そういった意味でも Inline できるのはすごい便利。

Inline::pdlpp で関数ができあがったら 整理して PDL::Core::Dev のサポートのもとで Makefile.PL を書くようにすれば、いっちょあがり。

• [ Perl ] PDL::PP で C extension を書く (2004-02-19)
• PDL と 疎行列 (2004-06-14)
• 続 PAR 化 (2004-08-25)
• WiKicker の Makefile.PL を Module::Inst... (2006-02-10)
• GRAPH GEAR セミハードタイプ デジタルカメラケース DGB-01... (2005-02-07)

■ [ WiKicker ] Storable 永続化データの互換性

fkimura 氏から WiKicker の障害レポートをいただいた。 Perl v5.8.6 へ移行した環境で WiKicker 0.26 を試してみたところエラーになってしまうとのこと。

 "Error
 action: do_read: Byte order is not compatible at blib/lib/Storable.pm
 (autosplit into blib/lib/auto/Storable/thaw.al) line 366,
 at /usr/local/lib/perl5/site_perl/5.8.6/WiKicker/DB/File.pm line 161
 at /usr/local/lib/perl5/site_perl/5.8.6/WiKicker/CGI/AbstractController.pm line 93"

(FreeBSD 4.11-RELEASE-p9)

Storable がエラーを吐いている。 Storable データ形式に互換性のない環境 (Perl and/or Storable) 変化があったようだ。

例えば Storable のマニュアルによれば 64bit integer をサポートするように構築された Perl v5.6.0 や v5.6.1 で Storable 2.02 以前を使って書き出したデータを他の環境で読み出すと 'Byte order is not compatible' エラーが出るとある。

確認したところ前のバージョンは Perl v5.6.2 だそうなので、もしかしたら上記の非互換性にあたってしまったのかもしれない (FreeBSD の Perl って 64bit integer サポートでビルドされるようになっている?)。

@ WiKicker での対応方法

WiKicker で使用している Perl のアップグレードで上記問題にあたった場合、一番簡単な方法は Storable で書き出しているページ情報ファイルを一旦全部消してしまうという方法。

WiKicker のデータベースディレクトリ (wikicker.database.directory プロパティで指定しているディレクトリ)の下の、info/basic/* を全て消してしまう(一応バックアップとしてコピーした方が良い)。

この場合、各ページの「最終更新時刻、最終更新者名、要約文」が消えてしまうが、これらの消えてしまった情報は次にページを更新した時に最新の情報で上書きされる。

WikiPage そのものおよび古いリビジョンは影響がなく全て残っているので、通常の運用ではまあ許容できる範囲の対処方法か。

情報ファイルを消したくない場合は、コンバートする必要があるけれど古い Storable データを読み出せる環境で export して、新しい形式で書き直す必要があるので作業する人にとってもちょっと面倒かもしれない。いや、新しい Storable ならば $Storable::interwork_56_64bit あたりを使えば両方をきりかえて読めそうであるので、新しい環境だけあればいいのかな。

• [ Perl ] Memcached を使ってみる (2004-01-12)
• SQLite とか DbUnit とか (2005-05-23)
• [ WiKicker ] キャッシュまわりにバグ (2004-06-05)
• [ WiKicker ] SpeedyCGI 対応するも…… (2003-11-09)
• テスト。More。 (2005-03-13)

■ Mew と GnuPG

久しぶりに GnuPG な暗号化メールのやりとり。 PGP/MIMEではない暗号化メールって Mew で扱えたっけかと調べたら、マニュアルにちゃんと書いてあった。以前は PGP/MIME だけだったような覚えがあるのだが、勘違いだったかかなり以前の話だったか。

メモ

• 復号化/検証: C-cC-z
• 暗号化: (setq mew-use-old-pgp t) か zo して C-cC-e

入社してから名刺を作る際に Fingerprint を印刷してもらうようにしてあるんだけれど、此の方ビジネスでやりとりしている人と PGP なやりとりしたことって全くないのだよねぇ。

• GnuPG の布教失敗 (2005-02-02)
• フィルムスキャンできるインクジェットプリンタ PIXUS MP980 (2008-11-03)
• 結局自分も MOLESKINE に行き着くのか (2005-12-15)
• 自宅の無線 LAN を復旧 & IEEE 802.11g 化 (2004-11-26)
• Wi-Fi ファインダで Wi-Fi ホットスポットを探せ (2007-01-23)

■ MOLESKINE でマニュアル作成

まずはミーティングの進め方などのポイントを LaTeX 打ちして 7 x 12cm 9pt トンボ有りの jsarticle でA4用紙にプリントアウト。

カッターで1枚1枚ちまちまとカットして、MOLESKINE の左側のページへ貼っていく。右側は手書きで追記するように開けておいた。

サイズ的には 縦横もう 5mm ぐらい広げても良かったかな。

会社で変な黒い手帳を開いていたら、それを見ているとお思い下さい。 きっと心の中で何か企んでいるはずです。

• 2008年夏の GTD 運用ツール (2008-07-23)
• 結局自分も MOLESKINE に行き着くのか (2005-12-15)
• フィルムスキャンできるインクジェットプリンタ PIXUS MP980 (2008-11-03)
• ステーショナリーに手を出した - 私的10大ニュース2005 [ misc ] (2005-12-31)
• 方眼手帳と方眼ミーティングメモ (2005-11-27)

■ 書籍の処分の判断はどのようにするべきですかね

今年も今日が最後である。昼休みはオフィスのスタッフ全員で近くのPATATI PATATAへテクテク歩いて行って食事会。 午後の3:00過ぎから、大掃除。

チームメンバ内で「本が増えてきたから本棚が欲しいね。その前にまずは今あるキャビネットにある古い本を捨ててスペースを確保しよう。」と話ていたので、今日実行することにした。

古いハードウェアのマニュアルやら、もはや使っていない開発環境に関する解説本やら出るわ出るわ。また、プロジェクトの資料として購入していたであろう特定分野の本などもいろいろと。

「もはや、いらんだろう」という本が多いのだが、こういうのって誰かが「それいる」というのが出てきそうで決断しにくかったりするのだよね。 誰が何のために買ったのかわからんものは特に。

ということで不要と判断した本を一度山積みして必要だと思った人がそれらを棚に戻し、残ったものは捨てるということにした。

なので、大掃除は済んだものの机の上にはいらないであろう本がどっさり。

今後、本を購入していく際はどうしていくのがいいのだろうね。 購入を希望した人の名前を書いておくかね?

• NASA World Wind 1.3 は他人のPCで (2005-03-22)
• オフィスの高度 (2004-12-24)
• スティラコサウルスは How How と鳴く? (2005-04-25)
• ちくわ笛 (2006-02-02)
• スクラッチから書き直したくなるプログラマは、書き直したプログラムもまたスク... (2008-06-14)

■ はじめての iTunes

実家の妹が「iPod が欲しい」と言っているのだが、PCの方が使える状態なのか不明である。 里子に出している DynaBook SS 3440 で使えそうなのかチェックしてみることに。

かくいう自分も iTunes を使うのも初めてだったりする。 iTunes 6 をインストールしてから、リッピングのテスト。

手持ちの東芝製の PC カード接続24倍速 CD-ROM ドライブ(PA2673UJ)で問題なくリッピングできることを確認。 おお、簡単。 特にマニュアル等を読まなくても、適当にボタンを押せばできてしまった。 iTunes のインタフェースが良くできているということか。

iPod との接続についてだがこのノート PC、USB 1.1 なんだよね。さすがにこれでは辛いか。 と思ったら IEEE 1394 があったんだっけ。 使った事ないのでちょっと不安だが、これで一応使えるわけだね。

ということで、いけそう判定。

• iPod 用に USB 2.0 インタフェース PC カード購入 (2006-01-20)
• DynaBook SS 3440を再セットアップして里子に (2004-03-06)
• 納品前日なのに /var が壊れた! HDDからのブートで Debian ... (2005-09-27)
• 昨日友人が東芝 Satellite 2520 を購入 (1999-01-19)
• DVD コンポ (2004-01-10)