SL151950AL01-4
NEC
WebOTX Portal V10.1
UL1519-50AL
ごあいさつ
このたびは、WebOTX Portal をお買い上げいただき、まことにありがとうございます。
本書は、お買い上げいただいたセットの内容の確認、インストールの内容を中心に構成されています。本製品 をお使いになる前に、必ずお読み下さい。
WebOTX Portal のライセンスは、インストールしたマシンの CPU のコア数に合わせたライセンス方式です。
WebOTX は日本電気株式会社の登録商標です。
Microsoft、Windows、Windows Server および Internet Information Services、SQL Server、Internet Explorer、Active Directory、Microsoft Edge は、米国 Microsoft Corporation の米国およびその他の国 における登録商標です。
Windows の正式名称は、Microsoft Windows Operating System です。
Oracle と Java は、Oracle Corporation 及びその子会社、関連会社の米国及びその他の国における登録 商標です。
Intel は、アメリカ合衆国および/またはその他の国における Intel Corporation の商標です。 Firefox は、Mozilla Foundation の登録商標です。
Google Chrome 、Android は、Google LLC の商標または登録商標です。
Safari、iPad、iPhoneは、米国およびその他の国で登録された Apple Inc. の商標です。iPhoneの商標は、 アイホン株式会社のライセンスにもとづき使用されています。
iOS は、Cisco の米国およびその他の国における商標または登録商標であり、ライセンスに基づき使用さ れています。
PostgreSQL は、PostgreSQL の米国およびその他の国における商標です。 This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)
SL151950AL01-4
目次
1. はじめに __________________________________________________________________ 1 ライセンスについて _______________________________________________________________________ 1 諸元制限 _________________________________________________________________________________ 1 2. 動作環境 __________________________________________________________________ 3 ソフトウェア要件 _________________________________________________________________________ 3 必要リソース _____________________________________________________________________________ 7 3. インストール方法 __________________________________________________________ 8 構成品の確認 _____________________________________________________________________________ 8 インストール前の作業 _____________________________________________________________________ 8 WebOTX Application Server Express のインストール _________________________________________ 11 WebOTX Application Server の環境構築 ____________________________________________________ 20 環境構築後の作業 ________________________________________________________________________ 33 WebOTX Portal のインストール ____________________________________________________________ 40 インストール途中でエラーダイアログが表示された場合の対処方法について _____________________ 52 WebOTX Portal のインストール後の作業 ____________________________________________________ 56 4. アンインストール方法 _____________________________________________________ 67 アンインストール前の作業 ________________________________________________________________ 67 WebOTX Portal のアンインストール ________________________________________________________ 67 WebOTX Application Server Express のアンインストール ______________________________________ 72 アンインストール後の作業 ________________________________________________________________ 76 5. 動作確認 _________________________________________________________________ 78 6. 製品ライセンスの追加登録 _________________________________________________ 80 7. その他のインストール _____________________________________________________ 82 EneterpriseDirectoryServer ________________________________________________________________ 82 オンラインマニュアル ____________________________________________________________________ 82 WebOTX Client __________________________________________________________________________ 82 8. 注意制限事項 _____________________________________________________________ 831. はじめに
ライセンスについて
WebOTX Portal V9 からライセンス方式がプロセッサ・ライセンスに変更になりました。物理サーバ上のOS と仮想マ シン上のOS、どちらを利用する形態においても、OS に割り当てられたコア数を対象とし、2 コアにつき 1 ライセンス必要 になります。インストール対象のマシンにマルチコアCPU 及び複数の CPU が搭載されていてインストール対象の OS に割り当てられたコア数の合計値が3 以上の場合はライセンスの追加登録が必要です。
本製品では、WebOTX Portal と WebOTX AS Express(*)のライセンスをそれぞれ 1 ライセンス同梱しています。
(*)ライセンスは製品に添付されているソフトウェア使用認定証の製品番号に記載されています。本製品リリース時(2018/6) はWebOTX AS Express V10.1 のソフトウェア使用認定証のみ同梱していますが、2020/3 から WebOTX AS Express V10.3 のソフトウェア使用認定証も同梱しています。
諸元制限
WebOTX AS Express はエントリ・モデルのため、以下の諸元制限があります。 • 合計コア数 利用可能なマシンは、最大2CPU ソケットかつ全CPU のコア数合計最大12 コアまでの制限があります。 仮想環境で利用し、マシンのH/W 構成が特定できない場合は、1 仮想マシンあたり最大12 コアまでの制限となりま す。 1 ライセンスにつき 2 コアまで利用可能です。物理マシンの場合は対象マシンに搭載されている全CPU が対象となり、クアッドコア CPU とヘキサコア CPU は共 に2 個までとなります。 仮想マシンの場合、インストール対象の仮想マシンに割り当てるコア数の合計値は12 個までとなります。 (例1) 対象マシンが物理マシンかつクアッドコア CPU を 2 個搭載 「4 (コア) x 2 (個) = 8 コア」 -> 登録するライセンス数 4 (例2) 対象マシンが物理マシンかつヘキサコア CPU を 2 個搭載 「6 (コア) x 2 (個) = 12 コア」 -> 登録するライセンス数 6 (例3) 対象マシンが仮想マシンかつ 12 コア割り当て
SL151950AL01-4 2 「12 コア」 -> 登録するライセンス数 6 • 同時処理数 クライアントからのリクエストの同時処理数（処理スレッド数）は100本までの制限があります。 この制限は、HTTPセ ッション数や、利用可能なクライアント数の上限でありません。 ある時点で同時にリクエスト処理を行う上限です。 対象の設定値は、「アプリケーションサーバ-スレッドプール」のスレッドプール最大値（max-thread-pool-size）で す。 • セッションレプリケーションの共有台数 負荷分散構成で複数台のサーバでシステムを構成する場合、セッションレプリケーション機能によりセッション情報を 共有できます。 このセッションレプリケーションでセッション情報を共有は、4 台までの制限があります。
対象の設定値は、「アプリケーションサーバ-Web コンテナ」の JNDI サーバの URL(session-replication-jndi-url)で す。
(注) 一台に複数ドメインを作成した場合には、それぞれのドメインを 1 台のサーバとみなします。
WebOTX Application Server Express V10.3 を利用し、かつ上記の諸元制限を解除する場合、WebOTX Application Server Express Processor License Unlimited Option を別途購入し、ライセンスを追加登録してください。 WebOTX Application Server Express Processor License Unlimited Option は、WebOTX Application Server Express Processor License と同一数必要です。
構成品の確認
本製品にインストール用のDVD-ROM 媒体は含まれていません。製品全体の構成品に関しては構成品表を確認してくだ さい。
2. 動作環境
ソフトウェア要件
WebOTX Portal でサポートする基本ソフトウェア(OS)と、WebOTX に含まれる各機能を使用する場合に必要なソフトウ ェアを説明します。 オペレーティング・システム (OS) 動作対象の OS は、次の種類をサポートします。 ＜サーバ動作環境＞ ハードウェア オペレーティング・システム Intel 64
Windows Server® 2016 Datacenter (※1) Windows Server® 2016 Standard (※1) Windows Server® 2019 Datacenter (※1) (※2) Windows Server® 2019 Standard (※1) (※2) (※1) Server Core、Nano Server としてインストールした場合は未サポートとなります。 (※2) WebOTX AS Express V10.3 を利用する場合のみサポートします。
＜クライアント動作環境＞
ハードウェア オペレーティング・システム
Intel x86/Intel 64
Windows® 10 Home <Version 1607 (OS build 14393)以降> Windows® 10 Pro <Version 1607 (OS build 14393)以降> Windows® 10 Enterprise <Version 1607 (OS build 14393)以降> Windows® 10 Education <Version 1607 (OS build 14393)以降> Windows® 8.1 Pro Windows® 8.1 Enterprise Windows® 7 Professional Windows® 7 Ultimate Windows® 7 Enterprise ディスプレイの画面サイズは、1024 x 768 以上 を推奨します。
Java SE Development Kit
WebOTX システムは、実行時に Java™ Platform, Standard Edition の SDK を必要とします。サポートする SDK バ ージョンは次のとおりです。
Oracle Java SE Development Kit 8 (Update 172 以降) OpenJDK 8 (※1)(※2)
SL151950AL01-4 4
※1. WebOTX AS Express V10.3 を利用する場合のみサポートします。
※2. 各ディストリビュータからリリースされているOpenJDK 8のうちAdoptOpenJDK 8u242について評価 済み。
適用する JDK のメンテナンス・バージョンは、最新版を推奨します。
スマートデバイス
本製品は次のスマートデバイス端末での動作確認を行っております。
Apple iOS 11 / iPad Pro 9.7 Apple iOS 11 / iPhone X
Android 7.1 / タブレット[LAVIE Tab E (PC-TE510HAW)] (*1) Android 7.1 / スマートフォン[AQUOS sense lite SH-M05] (*1)
*1 本製品は全ての Android タブレットおよびスマートフォンでの動作確認を行っておりませ ん。従いまして、ご利用いただく Android タブレットおよびスマートフォンの機種によって は、画面の乱れ等が発生する可能性があります。
Web ブラウザ
本製品は次の Web ブラウザでの動作確認を行っております。(*1)
Microsoft Internet Explorer 11.0 Microsoft Edge 38 以降 Firefox 59.0 以降 Google Chrome 65 以降 iOS11 Safari 以降
*1 Microsoft Internet Explorer 以外のブラウザは、提示しているバージョン以降をサポート対 象としておりますが、ご利用いただくブラウザによっては、バージョンアップ時にレンダリン グエンジンやJavaScript 実行エンジンが変更されることがあります。その場合、画面の乱 れや一部機能が利用できなくなることがあります。
対応ソフトウェア － アプリケーションサーバ 本製品は次のアプリケーションサーバに対応しています。
WebOTX Application Server Express V10.1 (*1, 2) WebOTX Application Server Express V10.3 (*1, 2)
*1 WebOTX Portal は同じメディアで提供される Application Server 上での動作をサポートします。 *2 WebOTX AS Express のソフトウェア使用認定証は利用するバージョンのものをインストール時に登録し てください。 対応ソフトウェア － Web サーバ 本製品は次のWeb サーバに対応しています。 WebOTX Web サーバ 2.4.27 以降 (*1) Apache HTTP Server 2.4.27 以降 Internet Information Services (IIS) 10.0
*1 WebOTX AS には、Apache HTTP Server の 2.4.xx バージョン相当がバンドルされています。バー ジョンの詳細(xx)はインストールに利用する WebOTX Media のセットアップカードを参照してくださ い。 対応ソフトウェア － データベース・サーバ WebOTX Portal は、次のデータベース・サーバに対応しています。インストール時には、本データベース・サ ーバに接続するために、JDBC ドライバが必要となりますので、別途用意してください。 Oracle Database 12c R2 (*1) Microsoft SQL Server 2016(*2) PostgreSQL 9.6.2 以降 *1 サロゲートペアで表示される文字を利用する場合、データベース・キャラクタ・セットは、AL32UTF8 を 設定してください。 *2 照合順序として、バイナリ照合順序を選択してください。また、サロゲートペアで表示される文字を利用 する場合、照合順序として、*_100 というバージョン参照のものを選択してください。 WebOTX Portal では、以下の JDBC ドライバ、データベース・サーバについて動作確認を行っております。 JDBC ベンダー JDBC ドライバ・ タイプ サポートするデータベース・サーバ
Oracle Type 4 Oracle Database 12c Release 2 (12.2.0) Microsoft Type 4 Microsoft SQL Server 2016
PostgreSQL Development Group
Type 4 PostgreSQL 9.6.2 以降 (JDBC ドライバ 9.4 以降)
SL151950AL01-4 6 WebOTX Portal は、次のディレクトリ・サーバに対応しています。 WebOTX Portal では、ディレクトリ・サーバに格納されたユーザ情報を利用しますので、実行時にはディレクトリ・サー バが動作しており、かつユーザ情報が格納されている必要があります。 EnterpriseDirectoryServer Ver7.1 (*1) Active Directory
*1 EnterpriseDirectoryServer Ver7.1 は、WebOTX Portal V10.1 が格納されている WebOTX メディア にバンドルされています。
EneterpriseDirectoryServer Ver7.1 のセットアップカードでは、サポート OS として、Windows Server 2012 (R2 含む)、Windows Server 2008 (R2 含む)、Windows Server 2003 が含まれていますが、WebOTX Portal と組 み合わせて利用する場合には、Windows Server 2016 / Windows Server 2019 をご利用ください。
対応ソフトウェア － 認証サーバ
WebOTX Portal では自身で認証処理を行わずに外部の認証サーバに認証処理を委譲することができます。 次の認証サーバに対応しています。
WebSAM SECUREMASTER (*1) Active Directory
*1 WebSAM SECUREMASTER は、Webシステムなどに対してシングルサインオン(SSO)やアクセス 制御を提供する弊社製品です。
WebOTX Portal の認証を外部の認証サーバに委譲する設定で運用した場合、WebOTX Portal のログイン 画面は表示されません。また、パスワード変更機能を利用することができないため、個人設定メニューの「パス ワード変更...」は表示されません。 詳細は、マニュアルの[ 運用ガイド > 3. ポータルサイトの基本操作 > 3.3. 認証操作 ] を参照してくださ い。 対応ソフトウェア － 顔認証製品 次の顔認証製品に対応しています。 KAOATO 1.0.0 NeoFace Monitor 3.0
必要リソース
ここでは、インストールするために必要な固定ディスク空き容量と、インストール中、およびインストール後の初期動作 で必要なメモリ容量(*1)について説明します。 下記に示すハードディスク容量は、選択インストール可能な機能やプロダクトを全てインストールした場合を表していま す。ただし、JDK などの関連ソフトウェアのディスク消費量は含まれていません。 メモリ容量は、インストール時に既定値を選択して動作させた場合を表しています。WebOTX Application Server に追加インストールする場合は、追加する WebOTX Application Server の必要リソース に準じます。 プラットフォーム 必要メモリ ハードディスク容量 Windows – Intel x64 最小 640 MB、推奨 1 GB 以上 500 MB *1 WebOTX Portal 実行時には、接続するクライアント数に応じて、「クライアント数*60K バイト」のメモリ 容量がさらに必要となります。例えば、500 クライアントが接続する環境では、500*60K=30M バイト分 のメモリが上記に加えて必要となります。
SL151950AL01-4 8
3. インストール方法
構成品の確認
本製品にインストール用の DVD-ROM 媒体は含まれていません。製品全体の構成品に関しては構成品表を確認して ください。インストール前の作業
インストール前に必ず行う必要がある作業と確認事項について、それぞれの OS ごとに説明します。 • 必要メディア 本製品をインストールするには、次の製品に付属の DVD-ROM 媒体が必要です。Windows の動作環境により、必要と なる製品が異なります。WebOTX Media は出荷時期及び対応プラットフォームにより収録製品及びバージョンが異なりますので、製品 Web サイト(https://jpn.nec.com/webotx/index.html))もしくは WebOTX Media のインストールガイドにて 本製品が収録さ れていることを確認してください。 ＜64 ビット OS> 動作環境 型番 製品名 備考 Windows Server 2019 (64 ビット OS、CPU: Intel 64)(*1) Windows Server 2016 (64 ビット OS、CPU: Intel 64)
UL1519-＊1S WebOTX Media V10 Release ｘ (DVD) "＊"は出荷時期により 変わります。 "ｘ "にはリリース番号 が入ります。 DVD-R メディア (*1) WebOTX AS Express V10.3 を利用する場合のみサポートします。 • インストールは、必ず Administrators グループに所属した管理者権限があるユーザで行ってください。管理者 権限があるユーザでログインしていることを確認してください。インストールを行う場合は、Built-in Administrator ユ ーザで行うか、管理者権限のあるユーザでも「管理者として実行」によりインストーラを起動してください。 • WebOTX の停止とアンインストール WebOTX Portal は、新旧の複数バージョンのインストールと、同一バージョンの複数位置へのインストールはでき ません。したがって、既に旧バージョンのWebOTXか本バージョンのWebOTXがインストールされている場合は、 WebOTX のサービス群を停止した後にアンインストールを行なってください。操作手順については、ご利用にな っているバージョンのマニュアルをご参照ください。
• WebOTX AS のインストール
WebOTX Portal は単体で使用することは出来ません。同じWebOTX Mediaに含まれる以下の製品と必ず一緒 にインストールしてください。
WebOTX Application Server Express V10.1 WebOTX Application Server Express V10.3 • レジストリへの書き込み権限の確認 Windows 版のインストーラはレジストリへの書き込みを行います。以下のレジストリキーに SYSTEM ユーザ及び Administrators グループの書き込み権限が設定されていることを確認してください。 HKEY_LOCAL_MACHINE¥SOFTWARE¥NEC (*1) HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥NEC (*1) *1 存在しない場合は上位のレジストリキーに権限が設定されていることを確認してください。 • JDK のインストール WebOTX のインストール中は、インストーラの内部で Java を使用してセットアップを行います。そのため、 WebOTX をインストールする前に、JDK のインストールされていることを確認してください。まだ、JDK がインスト ールされていない場合は、必ずWebOTX インストール前に JDK をインストールしてください。
Windows 用の JDK は、WebOTX DVD-ROM 媒体に付属しています。 JDK のインストール方法に関しては、 JDK のインストールマニュアルを参照願います。
• Web サーバが既にインストールされている場合
WebOTXをインストールする前に、Microsoft Internet Information Services (IIS)などの他のWebサーバが起動 している場合、WebOTX で使用されるポート番号などの設定内容が重複する恐れがあります。この問題を回避す るために、一旦 Web サーバを停止するようにしてください。停止方法などはインストールされている各 Web サー バのマニュアルを参照してください。 • JDBC ドライバ WebOTX Portal をインストールするには、対応するデータベースの JDBC ドライバが必要となります。JDBC ドラ イバは、各データベースに付属のものか、各データベースベンダの Web サイトからダウンロードしてください。 • Web サーバと Web コンテナとの連携について 静的コンテンツの処理と動的コンテンツの処理を別マシンや別プロセスに分離できるよう、WebサーバとWebコ ンテナは別々のプロセスで動作させることが可能です。その場合、Webサーバの種類とWebコンテナとの構成 について以下のとおり決定しておく必要があります。 Step 1. トポロジの決定
Webコンテナ(Webアプリケーションの実行環境)が動作するWebOTX Application ServerとWebサーバを同一 マシンで構成することを「共存トポロジ」と呼びます。また、WebOTX Application ServerとWebサーバを異なる マシンで構成することを「分離トポロジ」と呼びます。 Step 2. 利用するWebサーバの決定 以下のWebサーバを利用することが可能です。連携可能なWebサーバの詳細は、「2. 動作環境」の「ソフトウェ ア要件」のWebサーバを参照してください。 WebOTX Webサーバ Apache HTTP Server
SL151950AL01-4 10
Microsoft Internet Information Services (IIS) 内蔵Webサーバ
Step 3. アプリケーションを配備するプロセスの決定 [内蔵Webサーバを利用する場合はスキップしてください] アプリケーションを配備するプロセスを決定します。 ・WebOTX Application Server Expressの場合 対象はエージェントプロセスのみです。 ・WebOTX Application Server Standardの場合
対象はエージェントプロセスまたはプロセスグループです。 Step 4. AJPリスナポート番号の決定 [内蔵Webサーバを利用する場合はスキップしてください] Step 3.で決定したプロセスについて、Webコンテナとの連携に使用するAJPリスナのポート番号を決定しま す。 既定値は以下のとおりです。 ・エージェントプロセスに配備するアプリケーション用のAJPリスナポート番号 8099 ・プロセスグループに配備するアプリケーション用のAJPリスナポート番号 20102
Step 1と2で決定した結果を以下の表に当てはめる事で、必要となる作業を示す行が確定します。「WebOTX ASマ シン」列、「Webサーバマシン」列それぞれで作業が必要です。 トポロ ジ 利用するWeb サーバ 作業手順 WebOTX AS マシン Web サーバマシン 共存
WebOTX Web サーバ (1) インストール：(2) 環境構築：共存トポロジで実行WebOTX AS (*1) － Apache HTTP Server (1) インストール：Apache HTTP Server (2) インストール：WebOTX AS (3) 環境構築：共存トポロジで実行 (*1) － IIS (1) インストール：IIS (2) インストール：WebOTX AS (3) 環境構築：共存トポロジで実行 (*1) － 内蔵Web サーバ (1) インストール：WebOTX AS (2) 環境構築：共存トポロジで実行 (*1) － 分離
WebOTX Web サーバ (1) インストール：WebOTX AS (2) 環境構築：分離トポロジ(Web コン テナ)で実行(*1)
(1) インストール：WebOTX AS (*3) (2) 環境構築：分離トポロジ(Web サー
バ)で実行(*2)
テナ)で実行(*1) (2) インストール：WebOTX Client(*4) (3) 環境構築：Web サーバ連携を実施
(*2)
IIS (1) インストール：WebOTX AS (2) 環境構築：分離トポロジ(Web コン テナ)で実行(*1) (1) インストール：IIS (2) インストール：WebOTX Client(*4) (3) 環境構築：Web サーバ連携を実施 (*2) [WebOTX ASマシン] (*1) 既定値以外を利用する場合、ユーザドメインのAJPリスナのポート番号の入力が必要。 [Webサーバマシン] (*2) 既定値以外を利用する場合、接続先のWebOTX ASマシンのAJPリスナのポート番号の入力が必要。 (*3) Webサーバとして動作するマシンにWebOTX ASのライセンスが必要。
(*4) Webサーバとして動作するマシンにWebOTX ASのライセンスは不要。WebOTX Clientのインストールと環境構築 はWebOTX Mediaのインストールガイドを参照してください。（WebOTX ClientのWebサーバ連携機能に関するサ ポートOSはWebOTX ASに準拠します） • 複数台のWebOTX Portal を利用するシステムを構築する場合 2 台目以降の WebOTX Portal をインストール時に、データベースの設定処理はスキップしてください。 • WebOTX Portal の再インストールを行う場合 WebOTX Portal のアンインストール前に以下のファイルのバックアップを保存してください。再インストール後の 環境で暗号化された情報を複合化するために利用します。 ・${INSTANCE_ROOT}/config/portal/storage/crypto.key WebOTX Portal のインストール時に、データベースの設定処理はスキップしてください。 • WebOTX Portal のバージョンアップを行う場合 WebOTX Portal のアンインストール前に以下のファイルのバックアップを保存してください。 ・${INSTANCE_ROOT}/config/portal/storage/crypto.key ・${AS_INSTALL}/Portal/database/build.properties ・${AS_INSTALL}/Portal/database/database.properties ・${AS_INSTALL}/Portal/database/db.io.properties データベースのバックアップを行ってください。データベースの更新処理中にエラーが発生した場合、コマンド等 による回復が困難となることが多いため、エラー発生時にはバックアップデータからリストアを行います。バックアッ プ、リストアの手順については、ご利用になっているデータベースのマニュアルを参照してください。
旧バージョンの WebOTX Portal をアンインストール後、WebOTX Portal V10.1 をインストールする際に、データ ベースの設定処理はスキップしてください。
WebOTX Application Server Express のインストール
本製品はWebOTX Application Server Express のライセンスを同梱しています。このライセンスを使用してインスト ールする場合の手順について説明します。
SL151950AL01-4 12
Caution
本製品にはWebOTX Application Server Express V10.1 と V10.3 のソフトウェア使用認定証が添付されて います。本製品のインストールに使用する WebOTX メディアに格納されている WebOTX Application Server Express のバージョンを確認し、該当バージョンの WebOTX Application Server Express のソフト ウェア使用認定証に記載されているライセンスを画面から登録してください。
なお、本節の画面イメージはV10.1 のものですが、V10.1 と V10.3 のインストール手順は同じため、V10.3 を インストールする場合はV10.3 に読み替えてください。
(1)
DVD-ROM の挿入とインストーラの起動
WebOTX メディアの DVD-ROM 媒体を DVD-ROM ドライブに挿入すると、次の画面が表示されます。[WebOTX Application Server Express V10.1/V10.3]を選び、[Install]ボタンを押してください。
DVD-ROM を挿入しても下の画面が自動的に表示されない場合は、エクスプローラで下記のいずれかを実行してく ださい。 <ドライブ>:wo_setup.exe <ドライブ>:¥EXP¥setup.exe <ドライブ>は、DVD-ROM ドライブのドライブ文字です。 (2)
[WebOTX AS Express のインストールへようこそ] 画面
Windows インストーラが起動し「インストールの準備中」というメッセージのあとに次の画面が表示されます。「次へ」ボ タンを押してください。(3)
[ライセンス情報] 画面
SL151950AL01-4 14
テキストボックスに、製品に添付されている 「ソフトウェア使用認定証(WebOTX Application Server Express)」(*) の「製品番号」に記載されている19 桁の番号を正しく入力します。複数登録する場合、最大 5 個までのライセンスキーを 入力し、情報に間違いがなければ「次へ」ボタンを押してください。
(*)利用するバージョンのソフトウェア使用認定証(WebOTX Application Server Express)で確認してください。
入力したライセンスが「入力済ライセンス数」に反映されているのを確認します。6 個以上のライセンスを登録する場合、 「ライセンス登録画面表示」ボタンを再度押してください。インストーラでは最大32 個までライセンス登録が可能です。ライ センスの登録が完了したら「次へ」ボタンを押してください。 (4)
[セットアップ種別] 画面
セットアップ種別を選択し、「次へ」ボタンを押してください。 既定値でインストールを行う場合、「デフォルト セットアップ」を選択してください。 → (8)に進んでください。 インストールするオプションを選択する場合、「カスタム セットアップ」を選択してください。→ (5)に進んでください。(5)
[インストール先フォルダ] 画面
インストール先フォルダを決定後、「次へ」ボタンを押してください。インストール先フォルダを変更する場合には「変 更」ボタンを押してください。他のWebOTX 製品がすでにインストールされている場合、同じフォルダが表示されます。
SL151950AL01-4 16 (6)
[カスタムセットアップ] 画面
インストールする機能を選択後、「次へ」ボタンを押してください。 リストにある各アイコンの意味は次のとおりです。 アイコン 説明Web サーバ WebOTX Web サーバ(Apache HTTP Server 2.4.xx ベース)をインストールしま す。(*1,2) 既定値でインストールされません。
*1 WebOTX 内蔵型の Java ベースの Web サーバを使用する場合や、外部の Web サーバ、例えば、Microsoft Internet Information Services (IIS)などと連携動作させる場合には、「Web サーバ」を選択する必要はありません。 Web サーバとの連携設定は環境構築にて行います。
*2 バージョンの詳細("xx")は WebOTX Media の添付ドキュメントを参照してください。
(7)
[パッチ適用オプション] 画面
インストール時に本製品のパッチを適用する場合、「パッチを適用する」をチェックしてください。 パッチを適用しない場合、「次へ」ボタンを押して次画面に進んでください。
事前に対象マシンにダウンロードした本製品のパッチのファイルを選択し、「次へ」ボタンを押してください。
Caution
SL151950AL01-4 18
す。
(8)
[プログラムをインストールする準備ができました] 画面
設定を確認して問題ない場合、インストールを開始するため「インストール」ボタンを押してください。
(9)
[WebOTX Application Server Express をインストールしています] 画面
以下の画面が表示され、ファイルのコピーが始まります。選択された機能により、セットアップに必要な時間は異なりま す。ファイルのコピーが終了するまでお待ちください。
(10)
[インストールの完了] 画面
次の画面が表示されたら「完了」ボタンを押してください。これでインストールは完了です。
SL151950AL01-4 20
場合は「いいえ」を押してください。
WebOTX Application Server の環境構築
(1)
環境構築ツールの起動
インストールから連続して環境構築を行う場合、本項の作業は不要なため(2)に進んでください。 環境構築ツール(WebOTX_config.exe)は<WebOTX インストールフォルダ>¥bin 配下にインストールされています。 Built-in Administratorユーザか、管理者権限のあるユーザでも「管理者として実行」により環境構築ツールを起動してく ださい。 (2) 環境構築ツールが起動し、以下の画面が表示されます。「次へ」ボタンを押してください。(3) 環境構築の対象製品として「WebOTX Application Server」を選択し、「次へ」ボタンを押してください。 ※インストールから連続して環境構築を行う場合、本項の画面は表示されないため(4)に進んでください。 (4) 既にマシンにインストールされている JDK のフォルダを選択後、「次へ」ボタンを押してください。 環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。 また、複数のJDK がインストールされている場合、最後にインストールした JDK のフォルダが表示されます。 別のフォルダを選択する場合には「変更」ボタンを押してください。 ※64bit 版の JDK がイ ンストールされているフォルダを指定してください。それ以外のフォルダが指定されている場 合は「次へ」ボタンが無効表示になりますので、正しく指定しなおしてください。
SL151950AL01-4 22
(5) トポロジ種別を選択し、「次へ」ボタンを押してください。
WebOTX Application Server と Web サーバを同じマシンで動作させる場合、「共存トポロジ」を選択してください。 → (6)に進んでください。
WebOTX Application Server と Web サーバを異なるマシンで動作させ、かつ本マシンを Web サーバとして使用す る場合、「分離トポロジ(Web サーバ)」を選択してください。→ (7)に進んでください。
WebOTX Application Server と Web サーバを異なるマシンで動作させ、かつ本マシンでアプリケーションを動作さ せる場合、「分離トポロジ(Web コンテナ)」を選択してください。→ (8)に進んでください。
(6) トポロジ種別として「共存トポロジ」を選択した場合
SL151950AL01-4 24
Apache HTTP サーバの場合、インストールディレクトリも設定してください。
(7) トポロジ種別として「分離トポロジ(Web サーバ)」を選択した場合
利用するWeb サーバを選択し、アプリケーションが動作する WebOTX Application Server への接続情報(ホスト名、 AJP リスナのポート番号)を入力し、「次へ」ボタンを押してください。
設定項目 説明
接続先ホスト名 アプリケーションが動作するWebOTX Application Serverのホスト名また はIP アドレスを入力します。 接続先AJP リスナのポート番号 （エージェントプロセス用） アプリケーションがエージェントプロセス上で動作する場合、接続先ホスト のエージェントプロセス用のAJP リスナのポート番号を入力してください。 接続先AJP リスナのポート番号 （プロセスグループ用） アプリケーションがプロセスグループ上で動作する場合、接続先ホストの プロセスグループ用のAJP リスナのポート番号を入力してください。 (*)接続先が WebOTX Application Server Express の場合は不要なた め、入力値をクリアしてください。
Apache HTTP サーバの場合、インストールディレクトリも設定してください。なお、分散トポロジ(Web サーバ)かつ Apache HTTP サーバの場合はWebサーバの連携設定のみ行い、管理／ユーザドメインを作成しないため(12)に進ん でください。
SL151950AL01-4 26
IIS の場合、IIS サイト名も選択してください。なお、分離トポロジ(Web サーバ)かつ IIS の場合は Web サーバの連携 設定のみ行い、管理／ユーザドメインを作成しないため(12)に進んでください。
(8) 管理ドメインの制御用ポート番号を既定値(6202)から変更する場合は設定し、「次へ」ボタンを押してください。
Caution
通常、ポート番号を変更する必要ありません。複数バージョンインストールしたマシンで両方のバージョンのド メインを同時に起動する場合のみ、対象マシンで未使用かつ他バージョンと重複しないポート番号を入力して ください。
※WebOTX AS Express は複数バージョンインストールをサポートしますが、WebOTX Portal は未サポート です。
(9) ユーザドメインの作成方法を選択し、「次へ」ボタンを押してください。
「ユーザドメインを作成する」を選択した場合、運用管理ドメイン(admin)とユーザドメインを作成します。
「ユーザドメインを作成しない」を選択した場合、運用管理ドメイン(admin)のみ作成します。環境構築完了後、運用管 理コマンド(otxadmin.bat)を実行してユーザドメインを作成します。
SL151950AL01-4 28 「ドメイン定義ファイルの設定を一部流用する」を選択した場合、運用管理ドメイン(admin)とユーザドメインを作成し、 ユーザドメインは指定されたドメイン定義ファイルの設定を一部流用(*)して作成します。既定値は<WebOTX インストー ルフォルダ>¥ sample.properties です。 (*)環境構築ツールで設定可能な項目のみドメイン定義ファイルの設定を流用します。
Caution 複数バージョンインストールしたマシンで両方のバージョンのドメインを同時に起動する場合、インストール時 に既定で作成されるユーザドメイン(既定値 domain1)とはポート番号が重複しない sample ドメインの定義フ ァイル(sample.properties)を指定してください。 (*) 他バージョンで既に sample ドメインの定義ファイルを元にドメインを作成している場合、次項の画面でポ ート番号の変更が必要です。
※WebOTX AS Express は複数バージョンインストールをサポートしますが、WebOTX Portal は未サポート です。 (10) ユーザドメインの情報(ドメイン名、各ポート番号)を設定し、「次へ」ボタンを押してください。既定値のまま環境構築を 行う場合は設定を変更せず、そのまま「次へ」ボタンを押してください。 ※ポート番号の既定値は、V9 インストール時 に作成するユーザドメインと同じです。 設定項目 説明 ドメイン名 ユーザドメイン名を指定します。デフォルト値は、domain1 です。ユ ーザドメイン名として使用できる文字列は、半角英数字と、ハイフン 「-」、アンダーバー「_」であり、32 文字以内で指定します。ただし、 「admin」の文字列は予約語であるため、ユーザドメイン名として指 定できません。 制御用ポート番号 運用管理コマンドや統合運用管理ツールからの運用制御で利用するポ ート番号を指定します。デフォルト値は 6212 です。 管理コンソール用ポート番号 運用管理コンソールで利用するポート番号を指定します。デフォルト
SL151950AL01-4 30 値は 5858 です。 HTTP ポート番号 ユーザドメインで利用する HTTP ポート番号を指定します。デフォル ト値は 80 です。 HTTPS ポート番号 ユーザドメインで利用する HTTPS ポート番号を指定します。デフォ ルト値は 443 です。 AJP リスナのポート番号 （エージェントプロセス用） エージェントプロセス用のAJP リスナのポート番号を指定します。デ フォルト値は 8099 です。Web サーバとして内蔵Web サーバを利用 する場合、本ポートは使用されません。 組み込みIIOP リスナ用ポート 番号 エージェントプロセス上で動作する組み込みIIOP リスナ(*)のポート 番号を指定します。デフォルト値は 7780 です。 JMS サーバ用ポート番号 JMS プロバイダのポート番号を指定します。デフォルト値は 9700 で す。 JMSサーバコネクション用ポー ト番号 JMS プロバイダの一般用コネクションサービスのポート番号を指定 します。デフォルト値は 9701 です。 JMS管理サーバコネクション用 ポート番号 JMS プロバイダの管理用コネクションサービスのポート番号を指定 します。デフォルト値は 9702 です。 名前サーバ用ポート番号 名前サーバのポート番号を指定します。デフォルト値は 2809 です。 IIOP リスナ用ポート番号 未使用です。 AJP リスナのポート番号 （プロセスグループ用） 未使用です。 デバッグ用ポート番号 未使用です。 (11) 事前検証の実施有無を選択し、「次へ」ボタンを押してください。
「事前検証を行う場合」を選択した場合、ドメインのポート番号の重複等の事前検証を行い、問題がある場合は以下のよ うなダイアログを表示します。 ※問題ない場合、ダイアログは表示されず次項の画面が表示されます。
SL151950AL01-4 32
(13) WebOTX の環境構築を行うため、以下の画面が表示されます。画面が終了するまでしばらくお待ちください。環 境構築の実行結果は、<WebOTX インストールフォルダ>¥ant_setup.log で確認できます。
※環境構築ツールを単独で起動した場合、以下のダイアログは表示されません。
環境構築後の作業
環境構築ツールは、環境構築中にWebOTX サービスを OS に登録します。それらは、OS 起動と共に開始するように 設定されます。そのため、環境構築後にマシンを再起動すると、WebOTX のサービスが起動している状態になります。 ドメインが正常に作成されているかを確認する セットアップ中に作成された 2 つのドメイン「admin」と「ユーザドメイン」の動作状態を確認することによって、ドメイン が正しく作成されていることを確認します。 サービスの状態が「開始」であることを確認する。 WebOTX のサービスは、サービスマネージャを開いて状態確認することができます。 次のサービスに対 して確認してください。WebOTX AS (バージョン番号 *1) Agent Service (*1)10.1 または 10.3
運用管理コマンド「otxadmin」でWebOTX ドメインの動作状態を確認する。
Windows のスタートメニューから「WebOTX 10.1/10.3」-「運用管理コマンド」をクリックします。プロンプト 画面が表示されます。
プロンプト画面で、次の太文字部分のコマンドを入力します。
Use "exit" to exit and "help" for online help. otxadmin> list-domains
SL151950AL01-4 34
ユーザドメイン（以下の例では domain1）と admin が「running」状態になっていることを確認します。 List of domains: domain1 running admin running 「exit」を入力して終了します。 otxadmin> exit 運用管理コンソールでWebOTX ドメインへ接続確認する。 Windows のスタートメニューから「WebOTX 10.1/10.3」 - 「運用管理コンソール」をクリックします。 Web ブラウザ画面が表示されます。 Caution 「2. 動作環境」の「ソフトウェア要件」に記載されたサポート対象のブラウザを使用してください。 ユーザ名: admin、パスワード: adminadmin を入力して、「ログイン」ボタンをクリックします。 ログインが成功し、ようこそ画面が表示されることを確認します。 画面右上の「ログアウト」ボタンをクリックすることでログアウトできます。 WebOTXで利用するポート番号が起動済みの他のプログラムで利用しているポート番号と重複している場合、ドメイン の起動に失敗します。 ドメインの起動に失敗した場合には、起動済みのプログラムの停止や、netstatコマンドなどを参照してポート番号の 重複を解消してからドメイン再起動、またはドメインで利用するポート番号を変更して環境構築ツールを再実行してださ い。 WebOTX が使用するポート番号を一時ポート対象範囲から除外する WebOTX AS が使用するポート番号が OS の一時ポートの割り当て範囲と重複していた場合、 WebOTX AS の サービスに定義されているポートが別のアプリケーションによって先に使用されることが原因で WebOTX の起動 に失敗するなどの問題を引き起こすことがあります。 OS の一時ポートの範囲の既定値は「49152～65535」であり、ドメインを既定値で作成している場合、ポート番号は重 複しません。 このため、OS の一時ポートの割り当て範囲とドメインが使用するポート番号が重複する場合のみ、以下の手順を実施して ください。 1．Windows の[スタート]メニューから「コマンドプロンプト」を選択してコマンドプロンプトを起動し、次のコマンド を入力してください。
> netsh int ipv4 show dynamicport tcp > netsh int ipv4 show dynamicport udp
2．実行結果から、設定されている一時ポートの範囲を確認し、ドメインで利用するポートが範囲内に入っていな いかを確認してください。
実行結果例) ======================================= プロトコル tcp の動的ポートの範囲 --- 開始ポート : 49152 ポート数 : 16384 ======================================= 上記の場合、一時ポートの範囲は、49152～65536 となります。この範囲のポートをドメインが使用していな いかを、確認してください。 3．手順 1 で、ドメインで使用するポートが、一時ポートの範囲内だった場合、一時ポートの範囲を変更します。 以下のコマンドを実行し、ドメインで使用するポートが含まれないよう調整してください。
> netsh int ipv4 set dynamicport tcp start=XXXXX num=YYYYY > netsh int ipv4 set dynamicport udp start=XXXXX num=YYYYY
XXXXX には一時ポートの開始ポート、YYYYY には一時ポートとして使用するポート数を設定してください。
シャットダウンスクリプトの登録
WebOTX ASを起動した状態でOSのシャットダウンを行うと、OSによりWebOTX ASのプロセスが強制終了され、 イベントログに以下のような警告ログが出力されます。
OTX01205161: 予期せぬイベントにより、システム内部からアプリケーションサーバのシャットダウン要求が行われ ました。 (com.nec.webotx.enterprise.system.core)
Handle the signal : SIGTERM(15) [<ドメイン名>]
この問題を回避するためにWindows 標準のシャットダウンスクリプトの登録を行ってください。以下に手順を示しま す。 1. スクリプトの作成 以下の一行を内容として含むスクリプトwoShutdown.bat を作成し、 C:¥WINDOWS¥system32¥GroupPolicy¥Machine¥Scripts¥Shutdownまたは環境に合わせた誤って削 除されることのない場所に保存します。
net stop WebOTXAS10.1AgentService
Caution
C:¥WINDOWS¥system32¥GroupPolicy¥Machine¥Scripts¥Shutdown は隠しフォルダになっていま す。
SL151950AL01-4 36 3. 「グループポリシー」左ツリーの[ローカルコンピュータポリシー]-[コンピュータの構成]-[Windows の設定]-[スク リプト]を辿り、右画面に表示される「シャットダウン」右クリックメニューよりプロパティを選択します。 4. 「シャットダウンのプロパティ」の追加より先ほど作成したシャットダウンスクリプトを登録します。 「OK」ボタンを押し、ウィンドウを閉じてください。 データベースを使用するための準備作業 (Java) Java アプリケーションでデータベースを使用する場合には、各データベースで次の準備作業を行ってください。 詳細に ついては、各データベースのリファレンスマニュアルでご確認ください。
• Oracle での作業 トランザクションのリカバリを行うためには、DBA_PENDING_TRANSACTIONS ビューの SELECT 権限が必要です。 JDBC リソースを登録する際に、SELECT 権限を持つユーザを設定してください。 JDBC リソースの登録を省略する場合には、トランザクション実行時に使用する JDBC データソースの定 義で 指定した全ユーザに対して、SELECT 権限を付与してください。 JDBC データソースの設定で、データベースクラスタの使用有無[useDatabaseCluster]に true を設定 した場合、 または、次のバージョン以降の Oracle データベースを使用する場合、ユーザアカウントに sys.dbms_system パッケージへの EXECUTE 権限を付与してください。
Oracle Database 11g Release 2 (11.2.0.4)
• Microsoft SQL Server での作業
SQL Server 2014/ SQL Server 2016 を使用するためには、SqlJDBCXAUser ロールの権限が必要 です。 トランザクション実行時に使用する JDBC データソースの定義で指定した全ユーザに対して、 SqlJDBCXAUser ロールを付与してください。
未完了のトランザクションが存在する状態でMicrosoft SQL Server を再起動すると、Transaction サー ビスから データベースへの接続ができず、未完了トランザクションのリカバリを行うことができません。 あら かじめ、Transaction サービスから接続するデータベースと、アプリケーションから接続するデータベース を 分けるようにしてください。例えば、Transaction サービスでリカバリを行う際に使用するデータベース を master とし、 アプリケーションが使用するデータベースを pubs としてください。
各 JDBC ドライバの分散トランザクション制御用のプログラムをインストールしてください。SQL Server JDBC Driver 3.0 / SQL Server JDBC Driver 4.0 は、SQL Server 2014 に接続することができます。 SQL Server JDBC Driver 4.2 では、SQL Server 2016 に接続することができます。
ファイアウォールの設定に関して ファイアウォールを設定している場合、クライアントマシンからの接続に使用するポート番号のブロックを解除する必要 があります。インストール時に指定したHTTP/HTTPS ポート番号のブロックを解除してください。詳細は WebOTX オン ラインマニュアルの[ リファレンス > ファイアウォールへの例外設定 ]を参照してください。 運用管理コンソールをInternet Explorer から利用する場合の設定 運用管理コンソールをInternet Explorer から利用する場合、下記のいずれかの設定が必要です。 Internet Explorer の「セキュリティ設定」において「アクティブスクリプト」が「有効にする」になっている。 Internet Explorer の「セキュリティ設定」において、「信頼済みサイト」に「about:bkank」が追加されている。 上記のいずれかの設定を実施していない場合、運用管理コンソールから操作を実行した際に、正常に動作しない場 合があります。「アクティブスクリプト」が「有効にする」になっているかを確認する手順は下記のとおりです。 1. Internet Explorer の右上の設定から「インターネットオプション」を選択します。 2. 「セキュリティ」タブを選択します。 3. 「インターネット」の「レベルのカスタマイズ」を選択します。 4. 表示された設定内で「アクティブスクリプト」が「有効にする」になっているかを確認します。
SL151950AL01-4 38 「アクティブスクリプト」が「有効にする」になっていない場合、下記のいずれかの作業を実施してください。 「アクティブスクリプト」を「有効にする」に変更する。 「信頼済みサイト」に「about:bkank」を追加する。 2 点目の「信頼済みサイト」に「about:blank」を追加する手順は下記のとおりです。 1. 「インターネットオプション」の「セキュリティ」タブを選択します。 2. 「信頼済みサイト」を選択し、「サイト」ボタンを押下します。 3. 「このゾーンのサイトにはすべてサーバの確認(https;)を必要とする」のチェックを外し、「about:blank」を記載し 「追加」ボタンを押下します。 4. 運用管理コンソール接続時のURLに「localhost」ではなく「IPアドレス」が含まれる場合、さらに「http://<接続す るIP アドレス>」を「信頼済みサイト」に追加します。 複数のネットワークカードを利用している場合の設定 WebOTX AS が動作するサーバで複数のネットワークカードが有効になっている場合、運用管理コマンドおよび WebOTX Administrator 製品の中に含まれる統合運用管理ツールからドメインへの接続が失敗することがあります。こ れに該当する環境では、本項目の回避手順を実施してください。 [問題の詳細] 運用管理コマンドおよび統合運用管理ツールはドメインに接続する際に、既定ではRMI プロトコルを利用して通信し ます。 RMI 通信では、ドメインの起動時に、RMI 通信用に IP アドレスとポート番号を埋め込んだスタブファイルを作成しま す。そして、運用管理コマンドや統合運用管理ツールから接続要求があると、作成しておいたスタブファイルをツールに 送付します。スタブファイルを受け取ったツールは、スタブファイルに埋め込まれたIP アドレスとポート番号を利用してド メインと通信を行います。 WebOTX が動作するサーバに複数のネットワークカードが設定されている場合、既定では、スタブファイルに埋め込 まれるIP アドレスは、いずれかのネットワークカードに設定されている IP アドレスとなります。このため、ツールから接続 できないIP アドレスがスタブファイルに埋め込まれていると、接続に失敗することがあります。 この問題を回避するために、次の手順を実施して、スタブファイルに埋め込むIP アドレスを明示的に指定してください。 スタブファイルに埋め込むIPアドレスとしてツールが接続できるものを指定することで、正常に接続できるようになります。 [回避手順] 1. 運用管理コマンドを立ち上げます。
2. ドメインが起動できていることを確認します。 次のように表示されれば、起動できています。 3. 管理ドメイン(admin)にログインします。 (*) 管理ユーザの既定値は、admin、パスワードの既定値は、adminadmin 、 管理ポート番号の既定値は、6202 です。 4. 管理ドメインに対して、次のコマンドで Java システムプロパティを設定します。 5. その他のユーザドメインに対しても、同じように手順3、4 を繰り返して Java システムプロパティを設定します。 (*) 管理ユーザとパスワードの既定値は管理ドメインと同じです。管理ポート番号の既定値は、6212 です。 6. WebOTX のサービスを再起動することにより、これらの設定が反映されます。 Caution ドメインを新たに作成する場合は、作成したドメインに対しても上記のJava システムプロパティを設定してくださ い。 複数バージョンインストール時の運用設定変更 ひとつのOSに本バージョンと他のバージョンをインストールする場合に必要となる作業を説明します。本バージョンの みをインストールする場合は、この作業は不要です。
※WebOTX AS Express は複数バージョンインストールをサポートしますが、WebOTX Portal は未サポートです。
下記の運用形態によってインストール後の設定作業が異なります。
・ 単一バージョンのドメインのみ起動 (両方のバージョンのドメインを同時起動しない)
「コントロールパネル」-「管理ツール」-「サービス」で一方の WebOTX サービスの「スタートアップの種類」を「手 動」に設定してください。両バージョンのWebOTX サービスの自動起動が有効になっていると、OS リブートの際 にドメインを起動する過程でポート番号の重複によりエラーが発生します。
V9 以前のサービス名 WebOTX AS Agent Service
V10.1 以降のサービス名 WebOTX AS (バージョン番号) Agent Service otxadmin> list-domains
List of domains: admin running domain1 running
otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
SL151950AL01-4 40 なお、他バージョンのWebOTX サービスの方を自動起動する場合は上記の作業に加えて、「インストール前の 作業」で「スタートアップの種類」を「手動」に設定しているため「自動」に変更してください。 ・ 両方のバージョンのドメインを同時起動。 環境構築時に作成するユーザドメインの各ポート番号を他バージョンのWebOTXと重複しないように変更している 場合、必要な設定作業はありません。 WebOTXの使用ポート番号の詳細に関してはWebOTXオンラインマニュアルの [リファレンス> ポート番号 ] を参照してください。
WebOTX Portal のインストール
WebOTX Application Server をインストールおよび環境構築後、WebOTX Portal をインストールします。WebOTX Portal をインストールするときは、WebOTX Application Server をあらかじめ停止させておく必要があります。
WebOTX Portal をインストールできるのは同じメディアで提供される WebOTX Application Server となります。 WebOTX Application Server のバージョンに関しては[ 1.動作環境 - ソフトウェア要件 - 対応ソフトウェア- アプリケーショ ンサーバ ]を参照してください。
また、インストール中に複数の war ファイル( webotx-portal.war, webotx-portal-portlet.war, webotx-portal-rssportlet.war, webotx-portal-authlink.war, webotx-portal-loginportlet.war, webotx-portal-announceportlet.war, webotx-portal-dataviewportlet.war) を配備します。このため、同名の Web アプリケーションを配備している場合は配備解 除してください。
(1)
DVD-ROM の挿入とインストーラの起動
WebOTX メディアの DVD-ROM 媒体を DVD-ROM ドライブに挿入すると、次の画面が表示されます。[WebOTX Portal V10.1]を選び、[Install]ボタンを押してください。 DVD-ROM を挿入しても下の画面が自動的に表示されない場合は、エクスプローラで下記のいずれかを実行してく ださい。(下の画面は DVD 媒体を挿入した場合の画面です。) <ドライブ>:¥wo_setup.exe <ドライブ>:¥Portal¥setup.exe <ドライブ>は、DVD-ROM ドライブのドライブ文字です。
上記は WebOTX AS Express V10.1 インストール済の場合の画面イメージすが、V10.3 をインストール済の場合は V10.3 に読み替えてください。 (2)
[WebOTX Portal V10.1 のインストールへようこそ] 画面
Windows インストーラが起動し「インストールの準備中」というメッセージのあとに次の画面が表示されます。「次へ」ボ タンを押してください。 (3)[ユーザ情報] 画面
SL151950AL01-4 42 [ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力します。[ライセンス キー] ボックスには、製品に添付されている 「ソフトウェア使用認定証(WebOTX Portal)」の「製品番号」に記載されてい る 19 桁の番号を正しく入力します。入力した情報に間違いがなければ「次へ」ボタンを押してください。 (4)
[インストール済みの JDK] 画面
[インストール済みの JDK] 画面が表示されますので、既にマシンにインストールされている JDK のフォルダを選択後、 「次へ」ボタンを押してください。環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。また、 複数の JDK がインストールされている場合、最後にインストールした JDK のフォルダが表示されます。別のフォルダを 選択する場合には「変更」ボタンを押してください。(5)
[インストール先フォルダ] 画面
[インストール先のフォルダ] 画面が表示されます。他の WebOTX 製品がすでにインストールされていますので、ここ では｢次へ｣ ボタンを押してください。
SL151950AL01-4 44 (6)
[カスタムセットアップ] 画面
[カスタムセットアップ] 画面が表示されます。インストールする機能を選択後、「次へ」ボタンを押してください。 リストにある各アイコンの意味は次のとおりです。 アイコン 説明Portal 実行環境 WebOTX Portal の実行環境をインストールします。
(7)
[JDBC ドライバの設定] 画面
[JDBC ドライバの設定]画面が表示されます。WebOTX Portal が使用するデータベースサーバの情報を設定してくだ さい。設定後、「設定確認」ボタンを押してください。
各設定項目に関する説明を以下に記載します。 設定項目 説明 データベース種別 利用するデータベースサーバを ORACLE、SQL Server、PostgreSQL のどれかを選択するこができます。 ホスト名 データベースサーバのホスト名あるいは IP アドレスを入力してください。 ポート番号 データベースサーバのポート番号を入力してください。 SID/データベース名 ORACLE を利用する場合は SID を入力してください。SQL Server/PostgreSQL を利用する場合はデータベース名を入力してくださ い。 URL JDBC URL を手動設定にしている場合は、利用するデータベースサーバ の URL を入力してください。 ユーザ名 データベースサーバにログインするユーザ名を入力してください。(*1) パスワード データベースサーバにログインするユーザのパスワードを入力してくだ さい。 JDBC ドライバのフルパス 参照ボタンをクリックし、JDBC ドライバを選択してください。(*2) (*1) 接続アカウントにはテーブルの作成/削除の権限を持ったユーザを指定してください。 (*2) JDBC ドライバのフルパスには、2 バイト文字を含むパスを指定しないでください。
SL151950AL01-4 46 ・ データベースへの接続成功時 データベースへの接続に失敗した場合は以下の画面が表示されます。 「OK」ボタンを押してください。 [JDBC ドライバの設定]画面に遷移後、入力した内容が正しいかを確認してください。 ・ データベースへの接続失敗時 データベースへの接続に失敗した場合は以下の画面が表示されます。 「OK」ボタンを押してください。 [JDBC ドライバの設定]画面に遷移後、入力した内容が正しいかを確認してください。
(8)
[WebOTX Application Server の情報設定] 画面
[WebOTX Application Server の情報設定] 画面が表示されますので、WebOTX Portal を配備するインストール済み の WebOTX Application Server のドメインにアクセスするための情報を背設定後、「次へ」ボタンを押してください。
設定項目 説明
ドメイン名 WebOTX Portal を配備する WebOTX のドメイン名を指定します。デフォルト 値は、domain1 です。 ユーザ名 WebOTX のドメインに接続するためのユーザ名を指定します。デフォルト値 は、admin です。 パスワード WebOTX のドメインに接続するためのユーザのパスワードを指定します。デ フォルト値は、adminadmin です。 ポート番号 WebOTX のドメインのポート番号を指定します。デフォルト値は 6212 です。 (9)
[暗号化キー・オプションの設定] 画面
[暗号化キー・オプションの設定]画面が表示されますので、WebOTX Portal で利用する暗号化キー・オプション情報を 設定してください。ここで入力した情報は、インストール後に変更することはできませんので、注意してください。また、分 散環境にインストールする場合には、分散環境同士で同じ値を入力してください。なお、値を何も入力しない場合は、暗 号化は行われません。SL151950AL01-4 48 各設定項目に関する説明を以下に記載します。 設定項目 説明 WebOTX Portal 本体で利用 暗 号 化 キー WebOTX Portal 本体が利用する暗号化キー情報を指定します。デフォルト値には 何も指定しません。本設定項目を設定する場合には「WebOTX Portal 本体で利 用」－「オプション」情報も必ず一緒に設定してください。 なお、本設定項目には、「基本ポートレットで利用」－「暗号化キー」情報で設定した 値と同じ値を設定することはできません。別々の値を設定してください。 オプショ ン WebOTX Portal 本体が利用するオプション情報を指定します。デフォルト値には 何も指定しません。本設定項目を設定する場合には「WebOTX Portal 本体で利 用」－「暗号化キー」情報も必ず一緒に設定してください。 なお、本設定項目には、「基本ポートレットで利用」－「オプション」情報で設定した 値と同じ値を設定することはできません。別々の値を設定してください。 基本ポートレット で利用 暗号化 キー 基本ポートレットが利用する暗号化キー情報を指定します。デフォルト値には何も 指定しません。本設定項目を設定する場合には「基本ポートレットで利用」－「オプ ション」情報も必ず一緒に設定してください。 なお、本設定項目には、「WebOTX Portal 本体で利用」－「暗号化キー」情報で設 定した値と同じ値を設定することはできません。別々の値を設定してください。(注: コンテンツ表示ポートレットでパスワード情報を設定する場合は、暗号化設定する ことをお奨め致します） オプショ ン 基本ポートレットが利用するオプション情報を指定します。デフォルト値には何も指 定しません。本設定項目を設定する場合には、「基本ポートレットで利用」－「暗号 化キー」も必ず一緒に設定してください。 なお、本設定項目には「WebOTX Portal 本体で利用」－「オプション」情報で設定し た値と同じ値を設定することはできません。別々の値を設定してください。 (10)
