半年止まっていたScanSnapの取り込み
レシートを
レシートを1枚差してボタンを押すとスキャナが読み取り、PDFがネットワークの保存先へ自動で届く。無人の取り込みをこうした形で組み、毎朝「今日も流せます」という緑の表示を出していました。ところがある日まとめて数えてみると、半年のあいだ、正確には178日ものあいだ1枚も取り込めていなかったのです。その期間も「今日も流せます」の緑は毎朝表示されていて、私はそれを見て問題なしと判断していました。
『自分が動けるか』しか見ない緑
よくある緑のランプは常駐プロセスが動いているかを確認しているだけで、相手の機器まで処理が届いたかは条件に入っておらず、今回の取り込みも同様の作りでした。
半年気づけなかった原因は判定の条件にあり、毎朝の「流せます」はこちら側のMacが組み上がっているかどうかしか確認していませんでした。常駐プロセスが動いているか、設定がそろっているか、保存先につながるかの3点はどれも問題がないので緑が出ますが、肝心のスキャナが実際に読み取れているかは一度も見ていませんでした。スキャナと半年通信できていなくても、Mac側の3点がそろえば緑が出る作りだったわけです。
修正ではアプリが持っている取り込みの記録から最後に成功した日時を読み、そこから14日が過ぎていたらネットワーク上にスキャナが見えても「流せます」とは言わないようにしました。スキャナには直接問い合わせませんが、これは制御用のポートに接続すると人が手で取り込むときの接続とぶつかるためです。
| 緑が | 緑が |
|---|---|
| 常駐プロセスが | 最後に |
| 設定が | スキャナが |
| 保存先に | 14日以内に |
変わるIPアドレスを古いまま呼ぶ監視
原因を追うとスキャナのIPアドレスに行き着きました。うちのネットワークは集合住宅の共用回線で、スキャナに割り当てられるアドレスは1時間ほどで入れ替わります。けれど設定には、ある日取れた古いアドレスが残っていて、そのアドレスを呼び続けていました。相手はとっくに別のアドレスへ移っているのでつながりません。しかも古いアドレスは設定の2か所に書かれていて、片方だけ直してももう片方が残り、また無効なアドレスを呼んでしまいます。
さらに、つなぎ直すとアプリが自分で、接続時のアドレスを設定へ書き込み直します。アドレスは1時間でまた変わるので、対処しなければ必ず再発する形でした。そこで、設定ファイル全体をたどって、スキャナを指すアドレスの記述を全部、いまの正しいアドレスに書き直すものを用意しました。記述の場所はハードコードせず、数が増えても拾えるようにしてあります。ひとつだけ条件をつけました。スキャナと接続している最中は、設定を書き換えません。取り込みの途中で接続を切ってしまわないためです。この仕組みは、のちに一度だけ自動で動きました。設定のアドレスと実際のアドレスがずれたのを見つけて記述を両方書き直し、常駐プロセスの再起動まで、人の操作なしで済ませています。
紙を吸い込んでもつながらないスキャナ
スキャナが通信できる状態かどうかは、本体の動きを見ても分かりません。給紙口に紙を差すと吸い込むので起動していると思ってしまいますが、本体がスリープしかけた中途半端な状態があり、このときは無線のチップだけが応答を返します。ネットワークの応答履歴には出るのに実際の通信はつながらず、しかもスキャナはスリープから復帰するたびに別のIPアドレスを取得します。アドレスは1時間で切れ、監視は数分おきにポーリングするので、短い復帰の合間に間に合わないこともありました。
ポーリングで壊した接続
調べている途中で自分の失敗もありました。スキャナの死活を確かめようと通信ポートを一秒ごとに叩くスクリプトを動かしていたのですが、このスキャナは一度に一台としか接続できません。こちらが毎秒接続しにいくたびに、本来の取り込み用の接続を横から奪っていたことになります。そうして得た「接続が二、三秒で切れる」という観測を故障の証拠として報告してしまいましたが、接続を切っていたのは自分のスクリプトでした。
このスキャナは、確かめるための接続自体が状態を変えてしまいます。そのため確認には、スキャナに接続せずに読める方法だけを使うことにしました。具体的には、次の3つです。arpで見るネットワークの応答の履歴、lsofで見るソケットの一覧、それに取り込みの記録の台帳を mode=ro の読み取り専用で開くことです。3つともスキャナへの接続が発生しないので、取り込みとぶつかりません。台帳のsqliteは、immutable=1 で開くと -wal を読み飛ばして直前のスキャンが見えなくなるため、mode=ro で開きます。nc -z で制御用のポート(53218〜53220)を叩くのは、確認の手段から外しました。
| スキャナの | 影響 |
|---|---|
| 制御用の | 接続を |
| ネットワークの | 触らない。 |
| 開いている | 触らない。 |
| 取り込みの | 触らない。 |
未確認の扱い
もうひとつ、誤報もありました。ある朝、照合処理が「保存先に実物が無いレシートが350件ある」とアラートを出しましたが、全部まちがいで一枚も欠けていません。原因は、権限の問題でフォルダの中身を一覧できなかっただけなのに、sscommon.search_dirs() が except OSError: return [] で受けて「人が作った分類フォルダは0個」と返したことでした。空と読んだので、分類フォルダにあった354件のうち350件が「消えた」に数え替わりました。
同じ勘違いは配送側の forward.py にもあり、こちらは実害につながる場所でした。人が法人フォルダへ動かしただけの状態を「消えた」と読んでしまうと、すでに届いた紙をもう1本送ってしまいます。直し方は、一覧に失敗したときに「空」と決めつけないことでした。失敗したときは [] でなく None を返して「わからない」として扱い、数え落としたら照合ごと放棄して -1 を返します。一覧に失敗した場合とフォルダが本当に空の場合は、別の結果として返すようにしています。
生きているのに処理を止めた常駐プロセス
復旧したあとにも、似た落とし穴がありました。ある晩、レシート65枚を順調に読み込んでいた常駐プロセスの SshResident が、20:11:13を最後に吸い込みを止めました。macOSのログを log show で読むと、DoStartScan に No paper が返ったところで途切れています。薄いレシートがセンサーに軽く触れて、うまく掴めなかっただけです。それでも、そこから復帰できず、6時間47分、スキャナと一度も通信しませんでした。プロセス自体は終了しておらず、19日間生き続けていました。監視の guard.sh は pgrep -x で死活しか見ていなかったので、固まって動かない常駐プロセスを、問題なしと報告し続けました。固まった常駐プロセス自体は、止めて再起動すれば戻ります。そのため、固まったと判定する条件を先に決める必要がありました。いまは、プロセスの死活に加えて、ログに startPaper is Failed が続けて出たら、scanproc_rescue.py の check_failing_scan() が拾います。再起動は自動にせず、手で kill して起動し直しています。
直したあと、紙を一枚差してボタンを押すと2分半ほどでネットワークの保存先にPDFが届き、半年ぶりの取り込みとなりました。ボタンから保存先までエンドツーエンドで通ったのを確認できたのは、これが初めてです。この一枚はあとで取り込みの記録とも突き合わせて、サイズまで一致しています。
まだ確かめ切れていないのは、再起動をまたいでも同じように動くかです。ログイン時に常駐プロセスが立ち上がる設定も、保存先の資格情報も、人の入力が要らない形にはしてあります。ただ、自前で署名したアプリに与えた権限が再起動後も効くかどうかは、電源を入れ直して紙を通すまで分かりません。この項目は未確認として残し、実機で試したら結果をこの記事に追記します。
今回いちばん効いたのは、緑の判定条件をスキャナ側の記録に切り替えたことでした。止まったこと自体はアドレスの記述を書き直せば直る故障ですが、178日も気づけなかったのは止まったあとも緑が出続けていたからです。人が毎日は見ない処理ほど、この判定条件が無いと停止に気づくまでの日数が延びてしまいます。いまの緑は取り込み記録の日付を読んで14日と比べるだけの仕組みで、スキャナが応えているときにしか出ません。
弊社がお客様の業務に自動化を導入するときも、緑の判定条件を最初に決めてから作成します。「動いているはず」で進めるのをやめて、相手が最後に応答した時刻から状態を出力するようにしています。
次に読む
AIの
ニューヨーク大学と
会員番号を
個人情報保護委員会は
記事の一覧
自社でつくって運用している仕組みの記録をまとめています。
仕事のご相談
同じ作り方で、御社の仕組みを作ります 要件を固める前に、動く実物を1本お見せするところから始めます。ソースコードと設定一式は、御社のクラウドの中に残した状態でお渡しします。