1MB

Ｓａｕｓａｌｉｔｏで遊ぼう ! ☆Cobalt Appliance Programming 入門☆ 2002 年 9 月 8 日 NTT 　 DoCoMo Kansai,Inc. Masahiro Watanabe Cobalt Users Conference2002/Summer

Windows マシン、 Unix マシンと Cobalt の違い Cobalt ServerはUNIXの省スペース性と、Webブラウザを使ったGUIでの簡易な操作を兼ね備えたServer Applianceである。可（ GUI ）可（ CUI ）不可遠隔メンテナンス GUI （ LCD コンソールおよび Web ブラウザ） CUI （コマンドラインインターフェース） GUI （ウィンドウシステム）操作の手段不要（ LCD コンソールあり）不要（接続可）要ディスプレイおよびキーボード Cobalt 一般的な Unix Windows

Sausalitoとはなにか Sausalito とは、 Cobalt Server のソフトウェアに一貫した操作性を与えるために開発された、新アーキテクチャである。サーバ管理用デーモン（ CCE) 経由でアクセス Perl にてアクセスシステムリソースへのアクセス表示されるメッセージを String ファイルとして独立させ、 String ファイルを言語毎に用意することにより対応（ソースは各国語版同一）各国版毎に Perl のソースを書き換えてリリース国際版対応 Sausalito 内の独自認証を利用（ユーザ権限ごとにメニュー構成を変更することが可能） HTTP の BASIC 認証を利用管理画面の認証方法 XML を使って自動生成されたメニューと、 PHP の UIFC ライブラリを利用して作成した画面から構成画面ごとに Perl の CGI で作成管理画面の構成 Sausalito 従来の Cobalt

Sausalitoの特長１）柔軟な機能拡張が可能 XML を用いたメニュー自動生成処理（ Navigation Manager ）により、メニューツリーへのメニュー追加が他の既存のメニューに影響を与えずに可能２）各国語版パッチリリースに要する期間の短縮および信頼性の向上各国語版間でソースが共通であるため、シンプルなバージョン管理が可能３）ユーザインターフェースの Look ＆ Feel の統一性の保持が可能ユーザインターフェース用 API （ UIFC ）が公開されているため、サードパーティのアプリケーションにおいても Cobalt オリジナル機能と同一の Look ＆ Feel を実現可能

Sausalitoの特長（つづき）４）サードパーティのアプリケーションにおいても Sausalito のユーザ認証の利用が可能　サードパーティのアプリケーションにおいても、 Navigation Manager および UIFC を用いることにより、 Sausalito のユーザ認証を利用可能（独自の認証機構を準備する必要がない）５） Sausalito 対応機種間でのアプリケーションの移植が容易　ハードウェアやシステム情報へのアクセス用の API （ CCE ）が提供されていることにより、機種間のアプリケーションの移植が従来に比べ容易であると思われる。

Sausalito版Cobalt Server Sausalito アーキテクチャを採用している Cobalt Server は以下のとおり Sun Cobalt Qube3 NTT DoCoMo MMQUBE2 　 (OEM 版 Qube3) Sun Cobalt Qube3 Plus Sun Cobalt RaQ550 SunCobalt Control Station (2002 年 9 月現在）備考：　 Sun Cobalt XTR は部分的に Sausalito が使われている。

Sausalitoの画面構成（ログイン画面） ※ 　この画面は MMQUBE2 のものである。 test.cobalt*qube.org

Sausalitoの画面構成（ログイン後） ※ 　この画面は MMQUBE2 のものである。

Sausalito 対応アプリケーション作成の準備用意するもの Sausalito アーキテクチャのサーバ管理者権限が必要 IE5 以上が動作する PC Telnet クライアントフト TeraTerm( フリーウェア ) がおすすめ FTP クライアントソフト FFFTP( フリーウェア ) がおすすめ tar,gzip,rpm に対応した圧縮・解凍ソフト ExpLzh( シェアウェア )+tar32.dll がおすすめテキストエディタ秀丸 ( シェアウェア ) がおすすめ

Sausalito 対応アプリケーション作成の準備あるとうれしい予備知識（なくても可？） Telnet および Shell を使ったことがある html のソースを見たり書いたことがある xml について知っている rpm の SPEC ファイルを書いたことがある Perl 、 PHP 、 Awk のソースを見たことがある EUC 、 SJIS コードとは何のことか知っている vi 、 more を使ったことがある ‘ /’ と書いて root と読める

Sausalito のディレクトリ構成（後で使うよ） /usr/ share/locale/ ja/LC_MESSAGES/ ***.mo String ファイル en/LC_MESSAGES/ ***.mo ・・・ sausalito/ constructor/ destructor/ handler/ schema/ ***.pl ***.pl ***.schema ***.pl CCE 関連ファイル（今回は作成しない） ui/ menu/ web/ style/ conf/ libPhp/ bin/ lib/ ・・・ Sausalito システムディレクトリ（ユーザは直接使用しない） ***.xml ***. ｐｈｐ ,html,pl ***.xml menu 定義ファイル CGI ファイル Style ファイル

本日のお題課題１） Sausalito メニューに“ HelloWorld” アプリを追加する課題２） Sausalito のメッセージを大阪弁に変更する

課題１：メニュー追加　 Sausalito メニューに“ HelloWorld” アプリを追加しよう

STEP１：メニューの構造を探ってみる /usr/sausalito/ui/menu の下を覗く [admin admin]$ cd /usr/sausalito/ui/menu [admin menu]$ ls -F VM/ base/ ioffice/ live/ palette/ [admin menu]$ cd base [admin base]$ ls -F addressbook/ carmel/ firewall/ network/ telnet/ wizard/ am/ dhcpd/ ftp/ power/ time/ workgroup/ apache/ disk/ import/ quotastats/ user/ appleshare/ dns/ ldap/ snmp/ webmail/ backup/ email/ maillist/ swupdate/ webstats/ cache/ fileshare/ multidrop/ system/ winshare/ [admin base]$ cd am [admin am]$ ls -F amSettings.xml amStatus.xml monitor.xml monitorLight.xml

STEP２：ｘｍｌファイルの構造を推測する ① 既存のｘｍｌファイルを見てみるソース１： monitor.xml ソース２： amStatus.xml <item id="base_monitor" label="[[base-am.activeMonitor]]" description=“[[base-am.activeMonitor_help]]” 　 > <parent id="base_administration" order="80"/> </item> <item id="base_amStatus" label="[[base-am.amStatusMenuName]]" description="[[base-am.amStatusMenuDesc]]" url=“/base/am/amStatus.php” 　 > <parent id="base_monitor" order="10"/> </item>

STEP２：続き ② ｘｍｌファイルの構造を推測する (id 属性） item エレメントの id 属性は自分自身の ID を指しているらしい。 parent エレメントの id 属性は自分の親の ID を指しているらしい。 base_administration base_monitor base_amStatus

STEP２：続き ③ ｘｍｌファイルの構造を推測する (order 属性） parent エレメントの order 属性は同じ親に属しているものの間の順序を指しているらしい。 monitor.xml の parent エレメントの order 属性を 80 から２５に変更してみるアクティブモニタのメニューの場所が移動した。注意：自分で試す場合、ファイルを書き換えるときは、元のファイルを必ず　　　　バックアップしてから行うこと！

STEP２：続き ④ ｘｍｌファイルの構造を推測する (label,description 属性） monitor.xml の item エレメントの label description 属性を右のように書き換えてみる注意：自分で試す場合、ファイルを書き換えるときは、元のファイルを必ず　　　　バックアップしてから行うこと！メニュータイトルとアクティブヘルプが書き換わった！ <item id="base_monitor" label="base_monitor の Label だよ " description="base_monitor の description だよ "> <parent id="base_administration" order="80"/> </item>

STEP2:続き ⑤ ｘｍｌファイルの構造を推測する (url 属性） amStatus.xml ファイルの item エレメントの URL 属性の URL を左上のロゴのビットマップの URL に書き換えてみる。 ※ URL のドキュメントルートは /usr/sausalito/ui/web である。注意：自分で試す場合、ファイルを書き換えるときは、元のファイルを必ず　　　　バックアップしてから行うこと！ amStatus.xml クリックすると、ロゴが表示された！ <item id="base_amStatus" label="[[base-am.amStatusMenuName]]" description="[[base-am.amStatusMenuDesc]]" url="/libImage/topLogo.gif“ > <parent id="base_monitor" order="10"/> </item>

STEP2:まとめ xmlファイルの構造 amStatus.xml <item id="base_amStatus" label="[[base-am.amStatusMenuName]]" description="[[base-am.amStatusMenuDesc]]" url=“/base/am/amStatus.php” 　 > <parent id="base_monitor" order="10"/> </item> メニューの並び（小さいほど上または、左に表示される。） order parent 自分がぶら下がるメニュー項目 ID id parent メニュー項目クリック時に表示される URL url item アクティブヘルプに表示される文字列（日本語も使用可。 S-JIS で指定する必要がある。） description item メニューに表示される文字列（日本語も使用可。 S-JIS で指定する必要がある。） label item 自分自身のメニュー項目 ID 　（すべてのメニュー項目でユニークである必要がある） id item 意味属性エレメント

STEP3:メニューツリーを確認する管理者ログイン時のメニューツリーを知るメニューツリーのTOPはrootである。 ① 　②　③　④　　⑤　⑥　⑦ root root ① base_administration ② base_software ③ base_programs ④ base_personalProfile ⑤ base_updateLight ⑥ base_monitorLight ⑦ base_logout

STEP4: 課題の Hello メニューをチェックする Hello メニューは「プログラム」タブの中にある。 base_programs の子メニューとなる HelloWorld メニューは「 Hello 」メニューの中にある Hello メニューの ID の子メニューとなる。 HelloWorld アプリケーションは「 HelloWorld 」メニューから呼び出される。 base_programs base_hello base_helloWorld

STEP5:Helloメニューを作成するこれまでの情報を用いて、Helloメニューを作成する hello.xml helloworld.xml <item id="base_hello" label=“Hello" description=“Hello メニューです。”　 > <parent id="base_administration" order=“21"/> </item> <item id="base_helloWorld" label=“HelloWorld” description=“HelloWorld アプリケーションです。 " url=“hello/hello.htm” 　 > <parent id="base_hello" order="10"/> </item>

STEP5:続きどこに XML ファイルを置くか？ Sausalito は /usr/sausalito/ui/menu の下のフォルダを再帰的に探索する。アプリごとにｘｍｌファイル配置のためのディレクトリを分けることが望ましい。今回は、 ui/menu の下に、 hello というディレクトリを作成し、その中に配置する。注意： Sausalito は、シンボリックリンクのディレクトリは探索　　　しないため、実体のディレクトリ内に入れる必要がある

STEP6:hello.htmを作成するメニューからリンクされる HTML ファイルを作成する hello.htm HTML ファイルの配置場所は /usr/sausalito/ui/web/hello/ <HTML> <body> Hello 　 World アプリケーションの出力です。 </body> </html>

課題２：メッセージの書き換え課題２） Sausalito のメッセージを大阪弁に変更しよう電源切断手順画面を大阪弁に変更する

STEP1:メッセージのありかを探す /usr/share/locale/ja/LC_MESSAGES/ の下を覗く *.mo というファイルが多数存在する。これらは String ファイルと呼ばれるものである。 admin admin]$ cd /usr/share/locale/ja/LC_MESSAGES/ [admin LC_MESSAGES]$ ls base-fileshare.mo base-sys.mo base-firewall.mo base-system.mo base-ftp.mo base-telnet.mo base-import.mo base-time.mo base-lcd.mo base-user.mo base-ldap.mo base-webmail.mo adamnet.mo base-maillist.mo base-webstats.mo base-addressbook.mo base-memory.mo base-winnetwork.mo base-am.mo base-modem.mo base-winshare.mo base-apache.mo base-multidrop.mo base-wizard.mo base-appleshare.mo base-network.mo base-workgroup.mo base-backup.mo gnupg.mo base-cache.mo base-power.mo palette.mo base-carmel.mo base-power.mo.org sharutils.mo base-cce.mo base-quotastats.mo swatch.mo base-dhclient.mo base-sauce-basic.mo tar.mo base-dhcpd.mo base-services.mo textutils.mo base-disk.mo base-snmp.mo trueBlue.mo base-dns.mo base-ssl.mo util-linux.mo base-email.mo base-swupdate.mo [admin LC_MESSAGES]$

STEP2:Stringファイルとは String ファイルとは、文字列にタグ (ID) をつけて格納したもの。 String ソースファイル (*.po) から生成される。国際化ライブラリにて使用される。 String ソースファイル (*.po) String ファイル (*.mo) encode decode msgfmt コマンド msgunfmt コマンド

STEP3:Stringソースファイルの書式　 msgid: メッセージの ID をあらわす msgstr: メッセージの文字列。日本語可。文字コードは　　　　　　　　 S-JIS を使用する。 msgid “ ユニークな ID1” msgstr “ メッセージ 1” 　 ( 空行 ) msgid “ ユニークな ID2” msgstr “ メッセージ 2” 　　 ( 空行 ) 　　・・・・・・ msgid “ ユニークな IDn” msgstr “ メッセージ n”

STEP4:msgfmt,msgunfmtの使い方ｍｓｇｆｍｔコマンド書式： msgfmt xxx.po 　［ -o xxx.mo ] String ソースファイル　 xxx.po 　から、 String ファイル　 xxx.mo を生成する。 -o オプションが無指定の場合は　 message 　というファイル名のファイルに出力する。 msgunfmt コマンド書式： msgunfmt xxx.mo [ -o xxx.po] String ファイル　 xxx.mo から、 String ファイル xxx.po 　を生成する。 -o オプションが無指定の場合は、標準出力に出力する。

STEP5:*mo ファイルから *po ファイルを作成Ｓｔｒｉｎｇファイルから、Ｓｔｒｉｎｇソースファイルを作成する [root LC_MESSAGES]# msgunfmt base-power.mo -o /tmp/base-power.po [root LC_MESSAGES]# head /tmp/base-power.po msgid "askRebootConfirmation" msgstr " サーバを再起動してよろしいですか？ " msgid "power" msgstr " 電源 " msgid "powerHelp" msgstr " サーバを再起動できます。 " msgid "reboot“ ・・・・・

STEP6:*po ファイルをＰＣに転送する STEP5 で生成した base-power.po を FFFTP を利用してＰＣに転送する。 ASCII モードで転送する。文字コードは、変換しない。

STEP7:*.po ファイルを編集する msgunfmt コマンドで生成された　 *.po ファイルは、文字列が長い場合８０文字で改行されているため、文字列を一本にする。

STEP7:続き（関西人用）文字列をチェックし、変な日本語をすべて大阪弁に書き換える。編集が完了したら、 base-power-osaka.po というファイル名で保存する。

STEP7:続き（関西人以外用）インターネット上の大阪弁変換フィルタ等を用いて、メッセージを大阪弁に変換する。例： http://www.yorosiku.net/yan/imode/iosaka.html を用いる。編集が完了したら、 base-power-osaka.po というファイル名で保存する。

STEP8: 編集後の *.po ファイルをアップする。編集後の base-power-osaka.po ファイルをサーバにＦＴＰする。・ ASCII モードで転送する。・文字コードは、変換しない。

STEP9:*.moファイルを作成し入替える書き換えた、 base-power-osaka.po ファイルを元に、 base-power.mo ファイルを作成し、元のファイルと入替えを行う。注意：自分で試す場合、ファイルを書き換えるときは、元のファイルを必ず　　　　バックアップしてから行うこと！ [root /tmp]# msgfmt base-power-osaka.po -o base-power.mo [root /tmp]# cd /usr/share/locale/ja/LC_MESSAGES/ [root LC_MESSAGES]# mv base-power.mo base-power.mo.org [root LC_MESSAGES]# cp /tmp/base-power.mo . [root LC_MESSAGES]#

おまけ１：メニュ内でStringファイルを使う hello.po hello.xml helloworld.xml /usr/share/locale/ja/ LC_MESSAGES/hello.mo *.mo ファイル名 msgid msgid "hellogroup" msgstr "Hello でっせ " msgid "helloworldgroup" msgstr "HelloWorld どすえ " <item id="base_hello" label="[[hello.hellogroup]]" description="HelloWorld メニューです " type="monitorOn" > <parent id="base_programs" order="21"/> </item> <item id=“base_hello_helloApp” label=“[[hello.helloworldgroup]]” description=“HelloWorld でっせ。よろしゅうたのむわ” url="/hello/hello.htm" > <parent id="base_hello" order="21"/> </item>

おまけ２：日本語文字が化ける場合 S-JIS 漢字中に含まれる 0x5c(\) キャラクターコードをエスケープすることにより回避する。 enadd.pl ：漢字中に 0 ｘ 5c が含まれている場合、その前に 0x5c を挿入する。（ msgfmt の前に使用 ) endel.pl ：漢字中に 0 ｘ 5c が 2 回連続して含まれている場合、 0x5c をひとつ削る。（ msgunfmt の後に使用 ) enadd.pl endel.pl #!/usr/bin/perl while(<>){ s/\\\\/\\/g; print; } #!/usr/bin/perl while(<>){ s/\\/\\\\/g; print; }

おまけ３：メニューツリーのrootを変えるログイン後特定のメニューを root にして、 Navigation Manager を立ち上げる http:// サーバ :444/ login.php?target= /nav/cList.php%3Froot= メニュー ID %3FCommFrame= 追加スクリプト例 :http://192.168.0.30:444/login.php?target=/nav/cList.php%3Froot=base_administration

1MB

More Related Content

What's hot (20)

Viewers also liked (9)

Similar to 1MB (20)

More from arase_utagoe (9)

1MB