intra-mart webmail ver5.1インストールガイド · 本ドキュメントは、webmail...

intra-mart WebMail ver5.１インストールガイド

- 1 -

Copyright 2000-2007 (株)NTT データイントラマート All rights Reserved.

intra-mart WebMail ver5.1

インストールガイド

第三版 2007 年 09 月 27 日


- 2 -


＜＜変更履歴＞＞変更年月日変更内容

2005/08/26

2006/12/01

2007/09/27

初版

第二版

3.3 節「サーバへの WebMail のインストール」の中で Web サーバコネクタのディレクトリの初期値を修正

しました。

3.4 節「Web サーバが Apache 2 の場合」を追加しました。

6 節「ファイル一覧」に Web サーバコネクタにインストールされるファイルの一覧を追加しました。

第三版

3.4 節「Web サーバが Apache 2 の場合」に記載されている httpd.conf の編集内容を修正しました。


- 3 -


目次

1 はじめに ................................................................................................................................................. 4

2 前提条件................................................................................................................................................ 4

3 インストール手順 ..................................................................................................................................... 5

3.1 サーバへのJAVAMAIL 1.2 のインストール .............................................................................................. 5 3.2 サーバへのJAF 1.1 のインストール ........................................................................................................ 5 3.3 サーバへのWEBMAILのインストール ...................................................................................................... 5

3.3.1 インストーラの起動と操作方法 .......................................................................................................... 5 3.3.2 intra-martの再起動 ....................................................................................................................... 7

3.4 WEBサーバがAPACHE 2 の場合 ............................................................................................................ 8 3.4.1 Apache 2 のコンフィグレーションファイル(httpd.conf)の編集............................................................ 8

3.5 データベース接続設定 ........................................................................................................................... 8 3.6 ライセンスの登録 .................................................................................................................................... 8 3.7 初期化ファイルの設定 ............................................................................................................................ 8

4 WEBMAILの起動 .................................................................................................................................. 11

4.1 INTRA-MARTの再起動 .......................................................................................................................... 11 4.2 初期データの登録(ログイングループ毎) ................................................................................................ 11 4.3 アプリケーションロール.......................................................................................................................... 12

5 VER5.0 からVER5.1 へのデータ移行 ...................................................................................................... 13

5.1 設定情報のデータ移行......................................................................................................................... 13

6 ファイル一覧 ......................................................................................................................................... 14

7 アンインストール方法............................................................................................................................. 15

7.1 メニューの削除 ..................................................................................................................................... 15 7.2 ポートレット情報の削除 ......................................................................................................................... 15 7.3 ファイルの削除 ..................................................................................................................................... 15

8 FAQサイト ............................................................................................................................................... 16


- 4 -


1 はじめに本ドキュメントは、WebMail のインストール手順と初期起動の方法について記述しています。

WebMail をインストールするには、大きく分けて 6 つの作業が必要です。

1. サーバへのファイルのインストール

2. サーバへの JavaMail のインストール

3. 初期化ファイルの設定変更

4. ライセンスの登録

5. 初期化ファイルの設定変更

6. 初期データ（メニュー・ロール・アプリケーションロール・データベース構築など）の登録

このうち、1.～5.はシステム全体に対し１回行いますが、6.についてはログイングループ毎に実行する必要がありますのでご注

意ください。

【用語】

intra-mart WebMail

以下、IWM と略します。

intra-mart ベースモジュール

以下、BM と略します。 intra-mart Server Manager BM のサービス監視サービスです。以下、imSM と略します。 intra-mart Application Runtime BM の基本動作サービスです。以下、imAR と略します。 intra-mart Resource Service BM のプログラム管理サービスです。以下、imRS と略します。 intra-mart Storage Service BM のファイル管理サービスです。以下、imSS と略します。

2 前提条件 IWM ver5.1 をインストールするためには、以下の前提条件があります。

BM ver5.1 が正常に動作していること。

BM の最新のパッチが適用されていること。

JavaMail1.2 が利用できる環境にあること。


- 5 -


3 インストール手順

3.1 サーバへの JavaMail 1.2 のインストール SMTP サーバや IMAP4 サーバ・POP3 サーバへの接続送受信に必要となります。

製品版に同梱されていますが、以下の場所からもダウンロードできます。(2006 年 1 月 27 日現在)

http://java.sun.com/products/javamail/javamail-1_2.html

javamail-1_2.zip というファイルをダウンロード後解凍すると

javamail-1.2/imap.jar

javamail-1.2/mail.jar

javamail-1.2/mailapi.jar

javamail-1.2/pop3.jar

javamail-1.2/smtp.jar

というファイルができますので、imAR をインストールしたフォルダ直下の lib フォルダに全てのファイルをそれぞれコピーして

ください。

3.2 サーバへの JAF 1.1 のインストールデータの種類 (MIME タイプ)に応じて適切な JavaBeans を呼び出す仕組みを提供する Java API です。

製品版に同梱されていますが、以下の場所からもダウンロードできます。(2006 年 1 月 27 日現在)

2http://java.sun.com/beans/glasgow/jaf.html

jaf1_0_1.zip というファイルをダウンロード後解凍すると

jaf-1.0.1/activation.jar

というファイルができますので、imAR をインストールしたフォルダ直下の lib フォルダにこのファイルをコピーしてください。

3.3 サーバへの WebMail のインストール IWM のインストーラは、intra-mart システムの各サービスに必要なファイルを対話形式で選択しコピーします。IWM では

WEB サーバコネクタと、Server Manager、Application Runtime、Resource Service、Storage Service に対しファイルのコピー

を行います。それ以外のサービスに対してファイルをインストールすることはありません。

WEB サーバコネクタとそれぞれのサービスを別マシンで運用している場合には、それぞれのマシンでインストーラを実行す

る必要があります。WEB サーバのラウンドロビン機能を使用している場合は、すべての WEB サーバに対しインストールくだ

さい。

3.3.1 インストーラの起動と操作方法インストーラでは以下の項目を入力します。

BM のインストールタイプ

サーバで使用する文字コード

インストールするプログラムの種類

・ Web サーバコネクタ

・ Server Manager

・ Application Runtime

・ Resource Service

http://java.sun.com/products/javamail/javamail-1_2.html


- 6 -


・ Storeage Service プログラムをインストールするディレクトリ

また、インストーラの起動及び操作方法は以下の通りです。

Windows 2000 の場合

1. エクスプローラで本リリースの CD-ROM があるディレクトリに移動します。

2. webmail¥install に移動します。

3. setup.jar をダブルクリックし起動します。

4. インストーラの画面が表示されます。

5. まず BM をインストールした時のタイプを選択します。BM をインストールした時に選択したインストールタイプを

選択してください。

6. 次に、文字コードを設定します。BM で設定した文字コードと同じ文字コードを選択してください。

7. （5.で Custom を選択した場合、）そのサーバに入っているモジュールの種類（Web サーバコネクタ、Server

Manager、Application Runtime、Resource Service、Storage Service）を選択してください。

8. BM をインストールした時のルートディレクトリを選択してください。

9. それぞれのサーバをインストールした時のルートパスを設定してください。デフォルトでは以下のようになってい

ます。

Web Server Connector の場合：C:¥imart_web

imAR のコンテキストルートの場合：8.で設定したパス/doc/imart

imRS の場合：8.で設定したパス/pages

imSS の場合：8.で設定したパス/storage

10.最後に設定項目一覧が表示されます。その設定でよろしければ OK ボタンを押します。

（間違っていた場合は、Prev ボタンで戻り、設定し直してください）

11.インストールが開始されます。

Solaris 、Linux の場合

1. コンソール画面で本リリースの CD-ROM があるディレクトリに移動します。

2. webmail/install に移動します。

3. コンソールから java -cp ./setup.jar setup と入力します。

4. インストーラの画面が表示されます。

5. まず BM をインストールした時のタイプを選択します。BM をインストールした時に選択したインストールタイプを

選択してください。

6. 次に、文字コードを設定します。BM で設定した文字コードと同じ文字コードを選択してください。

7. （5.で Custom を選択した場合、）そのサーバに入っているモジュールの種類（Web サーバコネクタ、Server

Manager、Application Runtime、Resource Service、Storage Service）を選択してください。

8. BM をインストールした時のルートディレクトリを選択してください。

9. それぞれのサーバをインストールした時のルートパスを設定してください。デフォルトでは、以下のようになって

います。

Web Server Connector の場合：C:¥imart_web

imAR のコンテキストルートの場合：8.で設定したパス/doc/imart

imRS の場合：8.で設定したパス/pages

imSS の場合：8.で設定したパス/storage

10.最後に設定項目一覧が表示されます。その設定でよろしければ OK ボタンを押します。

（間違っていた場合は、Prev ボタンで戻り、設定し直してください）

11.インストールが開始されます。

※なお、Solaris、Linux では Xwindow が起動しているマシンでインストールする場合だけ、インストーラのウィンド


- 7 -


ウが表示されます。また、telnet などを利用してリモートクライアントからインストールすることも可能です。

Xwindow が起動していない場合にはコンソールでの対話形式でインストールを行います。

3.3.2 intra-mart の再起動 IWM を認識するため、intra-mart システムのサービスをすべて再起動してください。


- 8 -


3.4 Web サーバが Apache 2 の場合

3.4.1 Apache 2 のコンフィグレーションファイル(httpd.conf)の編集

この説明ではエイリアス名を「imart」として説明しています。

httpd.conf の末尾に以下のコードを追加してください。

Alias /imart/webmail "<%web_path%>/webmail"

3.5 データベース接続設定 IWM はデータベースの設定をしていなくても動作しますが、データベースの設定をすることにより、ポータル画面の表

示と、BM アプリ共通マスタのユーザデータからメールアドレスを参照してくることができるようになります。

データベースへの接続設定の方法については、ベースモジュール・アドミニストレータ・ガイド（admin_guide_v51.pdf）及

びベースモジュール・インストールガイド(install_guide_v51.pdf)を参照してください。

3.6 ライセンスの登録インストール直後は、試用版として動作しています。試用版は、６０日の使用期限が設定されています。

ライセンスをご購入いただいている場合には、ライセンス登録画面にて、ライセンスの登録をしていただく必要がありま

す。

下記の手順で、ライセンスの登録を行って下さい。

１：intra-mart のすべてのサーバモジュールが停止している事を確認します。

２：ライセンサを起動します。

< Server Manager のルート>/bin/tools/licedit.bat

(UNIX の場合は licedit.sh)

３：メニューから２を入力して、ライセンスキーを登録します。

４：正常に登録されると、登録されたライセンスが表示されます。

５：メニューから３を入力してライセンサを終了します。

６：ライセンスの登録に失敗した場合

入力したキーが正しいか確認して、間違っていた場合には、正しいキーを入力した上で、再度登録ボタンをクリックして

下さい。

何回登録処理をしても、ライセンス登録ができない場合には、インストールが失敗している可能性があります。

７：ライセンスの登録に成功した場合

ライセンス登録が完了したら、すべてのサーバモジュールを再起動します。

すべてのサーバモジュールを再起動する事で、登録したライセンス情報が有効になり、試用版の制限がなくなります。

3.7 初期化ファイルの設定 IWM では以下の項目を初期化ファイル(webmail.ini）ファイルで設定することが可能です。運用開始前に設定を行って

ください。初期化ファイルを変更した場合には、intra-mart システムの再起動が必要です。

設定ファイルは以下の場所にあります

Resource Service インストールフォルダ/webmail/webmail.ini


- 9 -


設定内容は以下の通りです。

項目名称説明

WML_INFO_BOUNDARY 個人情報設定保存ファイルで用いる区切り文字。

通常は変更する必要はありません。

初期値：

/*------------------------------------------------------------

-----------*/

WML_ATTACH_COUNT 添付ファイルの個数。送信画面において、メールに添付できる添付ファイ

ルの最大数を設定します。

初期値：3

WML_ATTACH_MAX 添付ファイルの容量制限。メールに添付できる添付ファイルの最大容量を

指定します。サーバ側でチェックするので、サーバへは一度アップロードす

る仕様になります。半角数字で指定してください。

初期値：3145728

WML_CHAR_CODE_HELP 制約文字のURL。ネットワークアクセスが社内に限定されている場合は、

webmail/help/mojibake.htmlを指定してください。

初期値：

http://www.intra-mart.co.jp/download/information/webmail/mojibake.html

WML_NO_CASH_OPTION ブラウザキャッシュを指定するかどうかを設定します。ON/OFFで指定しま

す。

初期値：ON

webmail/enable ログファイルを作成するかどうかを指定します。true/falseで指定してくださ

い。

初期値：true

webmail/id ログファイルの名前を指定します。ログファイルは、imARのインストールル

ート/logフォルダに指定された名前で作成されます。形式は基本的に、

日付エラー内容サーバ種別サーバポート番号アカウント

です。

初期値：webmail.log

WML_DEFAULT_EXT 添付ファイル名にファイル名がついていないときのデフォルトの拡張子で

す。拡張子だけを指定してください。デフォルトの拡張子は「eml」になりま

す。

初期値：eml

WM_IMAP_SOCKET_TIMEOUT IMAPサーバに対するソケットタイムアウト時間を設定します。省略時はタイ

ムアウトしません。半角数字以外の値を設定したときも無視されます。ま

た、1000ミリ秒以下の値を設定したときも無視されます。

初期値：10000

WM_POP3_SOCKET_TIMEOUT POP3サーバに対するソケットタイムアウト時間を設定します。省略時はタ

イムアウトしません。半角数字以外の値を設定したときも無視されます。ま

た、1000ミリ秒以下の値を設定したときも無視されます。

初期値：10000

WM_IMAP_CONNECTION_TIMEOUT IMAPサーバに対するコネクションタイムアウト時間を設定します。省略時

はタイムアウトしません。半角数字以外の値を設定したときも無視されま

す。また、1000ミリ秒以下の値を設定したときも無視されます。

初期値：10000


- 10 -


WM_POP3_CONNECTION_TIMEOUT POP3サーバに対するコネクションタイムアウト時間を設定します。省略時

はタイムアウトしません。半角数字以外の値を設定したときも無視されま

す。また、1000ミリ秒以下の値を設定したときも無視されます。

初期値：10000

WM_MAX_CONNECTION_ENABLE 受信サーバに対する最大接続数設定を有効にするかどうかを設定しま

す。

初期値：OFF

WM_MAX_CONNECTION 受信サーバに対する最大接続数を設定します。省略時は50になります。半

角数字以外の値を設定したときは50になります。

初期値：50

WM_FILTER_ONLY_INBOX 振り分け設定機能の対象フォルダをINBOXだけに

限定するかどうかのフラグを設定します。

ON : INBOXに限定する

OFF : 全てのフォルダを対象にする

初期値：OFF

WM_BODY_MAX_SIZE 受信する本文の最大値(文字数) を設定します。

初期値：20000

省略時：100

WM_ENTRY_DOMAIN 宛先確認時に色を変えないドメイン

社内ドメインを登録する場合に設定します。


- 11 -


4 WebMail の起動

4.1 intra-mart の再起動 IWM を認識するため、intra-mart システムのサービスをすべて再起動してください。

intra-mart システム全体を再起動することで同時に IWM も起動されます。

4.2 初期データの登録(ログイングループ毎) IWM を使用する際に必要な基本データ（メニュー・ロール・ユーザ・メッセージ・データベース初期データ）を登録しま

す。

メニューの[システム設定]-[ライセンス]をクリックします。

WebMail の欄の初期データインポートで初期データを投入するログイングループを選択して「インポート」ボタンを押下

すると、基本データがすべて登録されます。（登録には少し時間がかかります。）

データベースの設定をしていない場合、データベース初期データの投入が失敗しますが、ポートレットの情報が登録さ

れないだけですので、データベース情報の設定後、あとからポートレット情報を登録してもかまいません。


- 12 -


4.3 アプリケーションロール IWM を使用するユーザはユーザ設定で WebMail のアプリケーションロールを登録する必要があります。

[ログイングループ管理]-[アカウント設定]において IWM を使用させるユーザを選択してください。

アカウント設定画面の[アカウント]-[権限設定]において、アプリケーションロール一覧の追加ボタンを押下してください。

アプリケーション検索 Window が別 Window で開きます。

ここで、ID が「WM」、アプリケーションが「WebMail」という項目にチェックして、OK ボタンを押してください。アカウント設

定画面においてアプリケーション一覧の項に、WebMail が追加されていることを確認したら、更新ボタンを押してくださ

い。以上で、選択しているユーザにアプリケーションロールを与えて、ユーザがアプリケーションを使用することができる

ようになります。


- 13 -


5 ver5.0 から ver5.1 へのデータ移行 IWM ver5.0をお使いのユーザは、以下の方法によりIWM ver5.1に個人情報設定、アドレス帳などのデータを移

行することができます。ただし、データ以降の作業はWebMail ver5.1をインストールした直後の状態のときに行っ

てください。WebMailを起動して、個人情報設定などのデータを登録した後に、以下の作業を行うと、それまでに

登録したデータが失われてしまう可能性があります。

5.1 設定情報のデータ移行 IWM ver5.0 の File Server の storage/webmail/data フォルダの下にある、

(設定しているログイングループコード)ディレクトリ

grp_conf ディレクトリ

を、IWM ver5.1 の Resource Service の storage/webmail/data ディレクトリの下にコピーしてください。


- 14 -


6 ファイル一覧 IWMで使用するファイルおよびディレクトリの一覧は以下のとおりです。種別のDはディレクトリで、Fはファイルで

す。

Webサーバのコンテキストルートファイル及びディレクトリ種別説明 webmail D 画像などの静的ファイル flash/webmail D Flashのモジュール

Application Runtime ファイル及びディレクトリ種別説明 doc/imart/WEB-INF/lib/webmail.jar F メール送受信モジュール webmail/ D JavaMailアーカイブなど

Server Manager ファイル及びディレクトリ種別説明 licenses/webmail.iar F WebMail license情報アーカイブ

Resource Service ファイル及びディレクトリ種別説明 pages/product/src/webmail/addr D アドレス帳関係のプログラム pages/product/src/webmail/admin_conf D 管理者設定のプログラム pages/product/src/webmail/advance D Flash用プログラム pages/product/src/webmail/basic_data D 基本データ pages/product/src/webmail/common D 共通画面など pages/product/src/webmail/config D 個人情報設定のプログラム pages/product/src/webmail/data D ファイル保存データ用テンプレートなど pages/product/src/webmail/imode D モバイル画面用プログラム pages/product/src/webmail/ library D 共通関数プログラム pages/product/src/webmail/portlet D ポートレットプログラム pages/product/src/webmail/receive D メール受信画面用プログラム pages/product/src/webmail/send D メール送信画面用プログラム pages/product/src/webmail/unit D ユニットプログラム(旧移行ツールなど)

Storage Service ファイル及びディレクトリ種別説明 storage/webmail D WebMailデータ用ディレクトリ


- 15 -


7 アンインストール方法 IWM をアンインストールする場合は、以下の手順に従って作業を行ってください。

7.1 メニューの削除メニューから、[WebMail]というメニューを削除してください。メニューの名称は、初期データによりインストールされた場

合のものです。メニュー設定において、メニューの名称を変更していた場合には、該当するメニューを削除してくださ

い。

7.2 ポートレット情報の削除メニューから、[システム設定]-[ポータル]-[ポートレット設定]から、「メール受信状況」というポートレットを削除してくださ

い。ポートレット名称を「メール受信状況」とは違う名前で登録している場合には、該当するポートレットを削除してくださ

い。

7.3 ファイルの削除以下の intra-mart の各サービスをインストールしている各サーバにおいて以下のファイルを削除して下さい。

Server Manager

licenses/webmail.iar

conf/message/wm-message_ja.properties

Resource Service

pages/product/src/webmail

Storage Service storage/webmail ディレクトリ

Web サーバコネクタまたは Application Runtime のコンテキストルート

ｗebmail ディレクトリ

Application Runtime のコンテキストルート

WEB-INF/lib/webmail.jar Application Runtime のルート

lib/imap.jar

lib/mail.jar

lib/mailapi.jar

lib/pop3.jar

lib/smtp.jar

lib/actication.jar (他のプログラムで JavaMail を使用している場合には消さないで下さい。)


- 16 -


8 FAQ サイト下記 FAQ サイトにて intra-mart 技術情報の公開をおこなっています。ご利用ください。

Developer Support site：

http://www.intra-mart.jp/support/intramart.cgi


- 17 -


※本ドキュメントに記載されている社名及び商品名は、各社の商標及び登録商標です。

intra-mart WebMail ver5.1 インストール・ガイド

初版：January 27, 2006

第三版：September 27, 2007

Copyright(C) NTT DATA INTRAMART CO.,LTD.

TEL: 03-5549-2821

URL: http://www.intra-mart.jp/

intra-mart webmail ver5.1インストールガイド · 本ドキュメントは、webmail...

Documents