CUSTOMER (顧客)
SAP BusinessObjects Business Intelligence プラットフォーム
文書バージョン: 4.2 Support Package 03 – 2016-09-09
Web アプリケーションデプロイメントガイド (Windows 版)
目次
1
ドキュメント履歴. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2
はじめに. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.1
このドキュメントについて. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2
『Web アプリケーションデプロイメントガイド』の新しい内容. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.3
このドキュメントの対象読者. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.4
変数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.5
用語. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3
Web アプリケーションのデプロイメントの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.1
OSGi WAR ファイルの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.2
フェイルオーバーと負荷分散. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Web アプリケーションクラスタリングのサポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.3
SAP BusinessObjects Business Intelligence プラットフォームの WAR ファイルと EAR ファイル. . . . . . . . . . . 14
モバイルアプリケーションをサポートするために MobileOTA14.war をデプロイする. . . . . . . . . . . . . . . . . . 16
OpenSearch をサポートするために OpenSearch.war をデプロイする. . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.4
デフォルトのコンテキストルート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.5
カスタムのルートコンテキストおよびコンテキストパス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
ルートコンテキストを変更する. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Web アプリケーションのコンテキストパスを変更する. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4
WDeploy ツールを使用して Web アプリケーションをデプロイする. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.1
WDeploy の概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.2
WDeploy の前提条件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Web アプリケーションをデプロイする前の作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
ハードウェアの要件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
64 ビットのサポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
8.3 ファイル名のサポートの有効化. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Java 環境をセットアップする. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Web アプリケーションサーバのパラメータ設定ファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
WDeploy をリモートの Web アプリケーションサーバにインストールする. . . . . . . . . . . . . . . . . . . . . . . . . 24
4.3
SAP システムランドスケープディレクトリ (SLD) 登録. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
SAP Netweaver Technology Platform の SLD 登録を有効化する. . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Tomcat の SLD 登録を有効化する. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
WebSphere の SLD 登録を有効化する. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.4
2
デプロイメントモード. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
目次
スタンドアロンデプロイメント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
分割 Web Tier デプロイメント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.5
WDeploy 設定ファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
WDeploy 設定ファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Web アプリケーションサーバの設定ファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Web アプリケーション設定プロパティファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
4.6
WDeploy コマンドラインツールの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
構文. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
WDeploy の使用例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
特殊留意点. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Web アプリケーションサーバへのアクセスなしの分割 Web Tier の事前デプロイ. . . . . . . . . . . . . . . . . . . . 67
CMC または BI 起動パッドの Web アプリケーションを無効にする. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
インストールされた言語の変更. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
4.7
WDeploy GUI ツールの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
WDeploy GUI ツールの起動. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
WDeploy GUI ツールの画面. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
WDeploy によって実行された Web アプリケーションの更新. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
WDeploy GUI ツールのオプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
WDeploy GUI ファイルへのパスワードの追加. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
4.8
Web アプリケーションのデプロイメント後の作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
4.9
ログファイル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5
管理コンソールを使用して Web アプリケーションをデプロイする. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.1
Web アプリケーションを手動でデプロイする. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
JBoss 6.4.0 管理コンソールでの手動デプロイメント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
JBoss 7.1 管理コンソールでの手動デプロイメント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
SAP NetWeaver Technology Platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Tomcat 7 および 8 管理コンソールでの手動デプロイメント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
WebLogic 11gR1 管理コンソールでの手動デプロイメント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
WebSphere 7.0 および 8.5 管理コンソールでの手動デプロイメント. . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
6
既知の問題と回避策. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
6.1
BOE Web アプリケーションまたは Web アプリケーションソースツリーの名前変更. . . . . . . . . . . . . . . . . . . . . .89
6.2
IPv6 単独環境での WDeploy の使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
6.3
分割 Web Tier サーバ上の Web サービス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
6.4
末尾にバックスラッシュ文字 (¥) があるパスは、デプロイメントの失敗の原因になります。. . . . . . . . . . . . . . . . . 90
6.5
英語以外の言語を使用した WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
6.6
Windows オペレーティングシステムの WDeploy GUI 参照ウィンドウ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
6.7
Web アプリケーションがサーバから削除されない. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
6.8
Web Tier のインストール後の MobileOTA14.properties のコピー. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Web アプリケーションデプロイメントガイド (Windows 版)
目次
CUSTOMER (顧客)
3
6.9
WDeploy GUI ツールの [キャンセル] ボタン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
6.10
JBoss. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
JBoss 7.1 に AdminTools、dswsbobje、または BusinessProcessBI をデプロイする際のセキュリティ例
外. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
6.11
SAP NetWeaver Technology Platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
SUM を使用する SAP NetWeaver Technology Platform へデプロイする場合に表示される不正な
servicelevel、patchlevel、および name パラメータ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
WDeploy ツールは、SAP NetWeaver Technology Platform へのデプロイメントまたは SAP NetWeaver
からのアンデプロイメントをサポートしていません. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
6.12
Tomcat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Windows Vista または 2008 Server の IPv6 専用モードでの Tomcat の使用. . . . . . . . . . . . . . . . . . . . 94
WDeploy を使用した Tomcat からの Web アプリケーションのアンデプロイ. . . . . . . . . . . . . . . . . . . . . . . 94
WDeploy の実行後に、Tomcat が最初に Web アプリケーションをロードしない場合. . . . . . . . . . . . . . . . . 94
更新のインストール後に Explorer URL を起動すると HTTP 404 エラーが表示される. . . . . . . . . . . . . . . . 94
6.13
WebLogic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
WebLogic からの Web サービスデプロイメントの解除. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6.14
WebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
セキュリティモードでの WebSphere へのデプロイメント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
WebSphere 7.0 に Web サービスをデプロイした後の内部サーバエラー. . . . . . . . . . . . . . . . . . . . . . . . .96
WASX7017E: WebSphere におけるデプロイメントでの例外. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
4
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
目次
1
ドキュメント履歴
以下の表は、最も重要なドキュメント変更の概要です。
注記
このリリースでサポートされる Web アプリケーションサーバの最新の一覧は、Product Availability Matrix (サポートされ
ているプラットフォーム/PAR) を参照してください。このドキュメントは、次の SAP サポートポータルの SAP
BusinessObjects セクションにあります: https://support.sap.com/home.html
。
表 1:
バージョン
日付
説明
SAP BusinessObjects
2013 年 5 月
このドキュメントの初版です。
2013 年 8 月
JBoss 7.1 に AdminTools、dswsbobje、または BusinessProcessBI をデプロイする際
Business Intelligence プラ
ットフォーム 4.1
SAP BusinessObjects
Business Intelligence プラ
のセキュリティ例外 [92 ページ]が更新されました。JBoss 7.1 にデプロイする場合、
ットフォーム 4.1 サポートパ
dswsbobje アプリケーションおよび BusinessProcessBI アプリケーションでもワ
ッケージ 1
ークアラウンドが必要な場合があります。
Web アプリケーションを SAP Netweaver technology platform にデプロイするため、
SAP Java Support Package Manager (JSPM) の代わりに SAP Software Update
Manager (SUM) を使用するようになりました。SAP Software Update Manager (SUM)
を使用した SAP NetWeaver Technology Platform のデプロイメント [78 ページ]が更
新されました。
SAP BusinessObjects
2013 年 11 月
Business Intelligence プラ
ットフォーム 4.1 サポートパ
ッケージ 2
●
Weblogic 10 は、サポートされるプラットフォームから削除されました。
●
再度フルインストールを行うのではなく、変更インストールを行うことによって言語を
追加できるため、インストールされた言語の変更が更新されました。
●
rockit パラメータを追加するため wdeploy predeploy 節および wdeploy
predeployall 節が更新されました
SAP BusinessObjects
2014 年 6 月
Business Intelligence プラ
ットフォーム 4.1 サポートパ
●
サポートされるプラットフォームに WebSphere 8.5.5 が追加されました
●
分割 Web Tier デプロイメントに MOBIServer が追加されました。
●
節 SAP Software Update Manager (SUM) を使用した SAP NetWeaver
technology platform のデプロイメントの weblogic11 が sapappsvr73 に変更され
ッケージ 4
ました。
●
節 IHS Web サーバと WebSphere Web アプリケーションサーバに個別にデプロイ
するの config.apache の内容が変更されました。
●
分割 Web Tier サーバ上の Web サービス、Web アプリケーションクラスタリングの
サポート、フェイルオーバーと負荷分散が更新されました。
●
パフォーマンスは改善されないものの、Web アプリケーションがサポートされることを
●
WDeploy は SAP NetWeaver technology platform へのデプロイメントでサポート
記載するため、分割 Web Tier デプロイメントが更新されました。
されないため、節 SAP 設定ファイルが削除されました。
Web アプリケーションデプロイメントガイド (Windows 版)
ドキュメント履歴
CUSTOMER (顧客)
5
バージョン
日付
SAP BusinessObjects
2014 年 11 月
Business Intelligence プラ
説明
●
Web アプリケーションクラスタリングのサポートに関する節が更新されました。BI ラウ
ンチパッドおよび CMC のフォールトトレランスに関する節が更新されました。
ットフォーム 4.1 サポートパ
ッケージ 5
SAP BusinessObjects
Business Intelligence プラ
2015 年 11 月
ットフォーム 4.2
●
Tomcat 6 は非推奨となっているため削除し、Tomcat 8 を更新しました。
●
Web アプリケーションをリモートマシンにデプロイする [28 ページ]に JDK 8 に関
する情報を追加しました。
●
Tomcat に関する既知の問題の更新後に Explorer を起動するとエラーが表示され
る [94 ページ]に情報を追加しました。
SAP BusinessObjects
Business Intelligence プラ
2015 年 12 月
JBoss 6.4.0 管理コンソールでの手動デプロイメントを追加しました。JBoss 6.4.0 管理コ
ンソールでの手動デプロイメント [75 ページ]
ットフォーム 4.2 サポートパ
ッケージ 01
SAP BusinessObjects
2016 年 3 月
ブランド変更のみの更新です。
2016 年 8 月
WebSphere 管理コンソールの手動デプロイメント CLI モードを WebSphere 7.0 管理コ
Business Intelligence プラ
ットフォーム 4.2 サポートパ
ッケージ 02
SAP BusinessObjects
Business Intelligence プラ
ンソールの手動デプロイメント - コマンドラインインタフェースメソッド [84 ページ] および
ットフォーム 4.2 サポートパ
WebSphere 8.5 管理コンソールの手動デプロイメント - コマンドラインインタフェースメソッ
ッケージ 03
ド [86 ページ] に追加しました。
6
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
ドキュメント履歴
2
はじめに
2.1
このドキュメントについて
このドキュメントには、BI プラットフォーム Web アプリケーションを WDeploy ツールを使用して Web アプリケーションサーバ
にデプロイする方法が記載されています。
BI プラットフォームのインストールについては、SAP BusinessObjects Business Intelligence プラットフォームインストールガ
イドを参照してください。
SAP BusinessObjects Business Intelligence プラットフォームサーバの管理の詳細については、SAP BusinessObjects
Business Intelligence Platform 管理者ガイドを参照してください。
2.2
『Web アプリケーションデプロイメントガイド』の新しい内容
Web アプリケーションサーバのサポート
このリリースでサポートされるプラットフォーム、データベース、Web アプリケーションサーバ、Web サーバ、およびその他のシ
ステムの一覧は、SAP サポートポータル () の SAP BusinessObjects セクションにある製品出荷マトリックス https://
support.sap.com/home.html
(サポートされているプラットフォーム/PAR) を参照してください。 製品出荷マトリックス
は、Web アプリケーションデプロイメントガイドと矛盾点がある場合に常に優先されます。
BI プラットフォーム 4.x
BI プラットフォーム 4.x では、次の機能が導入されています。
表 2: WDeploy デプロイメントツールの新機能
機能
説明
GUI インタフェース
deployall および undeployall アクションの新しい GUI インタフェース。
2 段階のログファイル
1 つ目は概要のログで、管理者がデプロイメントのステータスを理解するのに役立ちます。もう 1 つは詳細なロ
グで、開発者がデプロイメントの問題を発見するのに役立ちます。
簡単な設定
WDeploy グローバルパラメータの一元化された設定ファイル。WDeploy GUI からサーバおよび WDeploy の
パラメータにアクセスします。
ローカライゼーションサポ
ート
WDeploy GUI はローカライゼーションをサポートしています。
Web アプリケーションデプロイメントガイド (Windows 版)
はじめに
CUSTOMER (顧客)
7
機能
説明
中間 WAR ファイルなし
中間 WAR ファイルは、デプロイメントのプロセスの一部で作成されなくなりました。 特定の Web アプリケーシ
ョンサーバ用に調整されていない WAR ファイルを作成する必要がある場合は、wdeploy
buildwarall コマンドを使用します。
デプロイメントの簡易化
BI プラットフォーム Web アプリケーションで使用される WAR ファイルの数が削減されました。 これにより、リ
ソースの重複消費と、Web アプリケーションサーバから CMS に対して作成されるクエリの数が減ります。
表 3: このドキュメントでの新構成
機能
説明
コンテンツの再構築
各 Web アプリケーションサーバの各 WDeploy コマンドを一覧表示するのではなく、WDeploy コ
マンドが一度だけ表示され、サポートされている各 Web アプリケーションサーバの例が提示され
るようになりました。
新機能の記載
WDeploy の新機能が記載されています。
サポート Web サイトから、サポートされる言語の BI プラットフォーム製品マニュアルが利用できるようになりました。これらの
マニュアルは、リリースが変わるたびに、最新の内容で更新されます。 最新の製品マニュアルについては、http://
help.sap.com を参照してください。
2.3
このドキュメントの対象読者
このドキュメントは、BI プラットフォームのインストールをサポートするシステム管理者または IT プロフェッショナルを対象とし
ています。全体的なネットワーク環境やポートの使用規則、データベース環境、および Web サーバソフトウェアに関する知識
が必要です。
2.4
変数
以下の変数は、このマニュアル全体を通して使用しています。
変数
説明
<BIP_INSTALL_DIR>
BI プラットフォームのインストールディレクトリ。
Windows の場合、デフォルトのディレクトリは C:¥Program
Files (x86)¥SAP BusinessObjects¥ です。
<WAS_HOSTNAME>
BI プラットフォーム Web アプリケーションがデプロイされる Web ア
プリケーションサーバのホスト名または IP。
<WEB_APP>
BI プラットフォームの Web アプリケーションの名前です。たとえば、
<WEB_APP> の値が BOE であるとします。このアプリケーションに
は BOE.properties という設定ファイルがあり、特定のアプリ
8
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
はじめに
変数
説明
ケーションサーバの事前デプロイ処理中に、WDeploy ツールによ
って BOE.war が作成されます。
BI プラットフォーム Web アプリケーションの完全な一覧について
は、SAP BusinessObjects Business Intelligence プラットフォー
ムの WAR ファイルと EAR ファイル [14 ページ]を参照してくださ
い。
<WEB_APP_SERVER>
WDeploy ツールで使用される Web アプリケーションサーバの省略
名です。たとえば、Tomcat 8.0 の場合、<WEB_APP_SERVER> の
値は tomcat8 になります。
値の完全な一覧については、WEB_APP_SERVER の値 [46 ペ
ージ]を参照してください。
2.5
用語
BI プラットフォームのドキュメントでは、次の用語が使用されます。
表 4:
用語
定義
アドオン製品
BI プラットフォームで動作する一方、独自のインストールプログラム
がある製品で、SAP BusinessObjects Explorer などがあります。
監査データストア (ADS)
監査データを保存するために使用されるデータベースです。
BI プラットフォーム
SAP BusinessObjects Business Intelligence プラットフォームの
略語です。
バンドルされたデータベース、バンドルされた Web アプリケーション
BI プラットフォームに同梱されているデータベースまたは Web アプ
サーバ
リケーションサーバのことです。
クラスタ (名詞)
1 つの CMS データベースを使用し、同時に動作する 2 つ以上の
Central Management Server (CMS) です。
クラスタ化する (動詞)
クラスタを作成することです。
たとえば、クラスタを作成するには以下の手順に従います。
1.
マシン A に CMS および CMS データベースをインストールしま
す。
2. マシン B に CMS をインストールします。
3. マシン B の CMS がマシン A の CMS データベースを使用す
るように指定します。
Web アプリケーションデプロイメントガイド (Windows 版)
はじめに
CUSTOMER (顧客)
9
用語
定義
クラスタキー
CMS データベースでキーを解読するのに使用されます。
CCM を使用してクラスタキーを変更できますが、パスワードのように
キーをリセットすることはできません。暗号化されたコンテンツが含ま
れており、紛失しないようにすることが重要です。
CMS
Central Management Server の略語です。
CMS データベース
BI プラットフォームに関する情報を保存するために CMS で使用さ
れるデータベースです。
デプロイメント
1 つ以上のマシンにおいてインストール、設定、実行されている BI プ
ラットフォームソフトウェアのことです。
インストール
インストールプログラムによって 1 つのマシン上に作成される BI プラ
ットフォームファイルのインスタンスです。
BI プラットフォームソフトウェアがインストールされるコンピュータで
マシン
す。
メジャーリリース
4.0 のような、ソフトウェアのフルリリースです。
移行
BI コンテンツを以前のメジャーリリース (XI 3.1 など) から、アップグ
レード管理ツールを使用して移行するプロセスです。
この用語は、同じメジャーリリースのデプロイメントには適用されませ
ん。昇格を参照してください。
マイナーリリース
4.2 のような、ソフトウェアの一部のコンポーネントのリリースです。
ノード
同じマシンで実行され、同じ Server Intelligence Agent (SIA) で管
理される BI プラットフォームサーバのグループです。
パッチ
特定のサポートパッケージバージョンの小規模な更新です。
昇格
BI コンテンツを同じメジャーリリース (4.0 から 4.0 など) のデプロイ
メント間で、プロモーションマネジメントアプリケーションを使用して移
行するプロセスです。
BI プラットフォームのプロセスの 1 つです。サーバは、1 つ以上のサ
サーバ
ービスをホストします。
Server Intelligence Agent(SIA)
サーバの停止、起動、起動など、サーバのグループを管理するプロ
セスです。
サポートパッケージ
マイナーリリースまたはメジャーリリースに対するソフトウェアの更新
です。
10
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
はじめに
用語
定義
Web アプリケーションサーバ
動的コンテンツを処理するサーバです。たとえば、4.2 用にバンドル
された Web アプリケーションサーバは Tomcat 8 です。
アップグレード
移行プロセスを完了するために必要な計画、準備、移行、後処理の
ことです。
Web アプリケーションデプロイメントガイド (Windows 版)
はじめに
CUSTOMER (顧客)
11
3
Web アプリケーションのデプロイメントの概要
BI プラットフォームインストールプログラムでは、バンドルされている Tomcat Web アプリケーションサーバのみに Web アプ
リケーションをデプロイできます。サポートされているその他すべての Web アプリケーションサーバへの Web アプリケーショ
ンのデプロイは、インストール完了後に行う必要があります。WDeploy Web アプリケーション Deployment Tool を使用する
ことをお勧めします。WDeploy ツールを使用したデプロイ方法の詳細と手順については、このガイドの「“WDeploy ツールを
使用して Web アプリケーションをデプロイする”」の節を参照してください。
必要に応じて、アプリケーションサーバの管理コンソールを使用して Web アプリケーションをデプロイすることもできます。
Web アプリケーションサーバの管理コンソールでデプロイされる Web アプリケーションは、最初に、デプロイ可能な WAR ファ
イルまたは EAR ファイルに変更する必要があります。wdeploy predeploy コマンドおよび wdeploy predeployall
コマンドを使用すると、このプロセスが自動化されます。これらの事前デプロイメントコマンドの使用後の手順については、この
ガイドの「“管理コンソールを使用して Web アプリケーションをデプロイする”」の節を参照してください。ただし、Web アプリケ
ーションサーバに関する幅広い知識を持ち、デプロイメント用の Web アプリケーションのカスタマイズ方法を知っている場合
は、このプロセスを手動で行うことができます。Web アプリケーションサーバに合わせた、デプロイメント用の Web アプリケー
ションの手動での調整については、このガイドでは扱っていません。
3.1
OSGi WAR ファイルの概要
Java Web アプリケーション用の OSGi フレームワークにより、BI プラットフォームにバンドルされている Web アプリケーショ
ンのデプロイメントが簡単になります。OSGi フレームワークを使用すると、Web アプリケーション、言語パック、SDK、プラグイ
ン、およびその他のリソースを単一のバンドルにまとめ、ワンステップで Web アプリケーションサーバにデプロイできます。
単一 WAR ファイルをデプロイすると、ユーザが複数の Web アプリケーションにアクセスするときに必要な Web セッション数
が減り、Web アプリケーションサーバに課されるメモリ、ディスク、および処理負荷が軽減されます。
3.2
フェイルオーバーと負荷分散
BI プラットフォームは、負荷分散のあるクラスタ化された Web アプリケーションをサポートします。 ハードウェアまたはソフトウ
ェアのロードバランサーを Web アプリケーションサーバのエントリポイントとして使用すると、複数の Web アプリケーションサ
ーバに処理が均等に分散されます。
現在、次の永続性の種類がサポートされています。
● ソース IP アドレスの永続性
● Cookie 永続性 Insert モード (ArrowPoint Cookie)
注記
Central Management Server (CMS) がすでにクラスタノード間の作業に配布されているため、BI プラットフォームサーバ
のクラスタの負荷分散は、必要ありません。
12
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
3.2.1 Web アプリケーションクラスタリングのサポート
BI プラットフォームは、クラスタ化、負荷バランス、またはフォールトトレランスの設定が異なる環境で使用することができま
す。 次の表に、Web でホストされる BI ツール、CMC、および BI ラウンチパッド Web アプリケーションの設定サポートを示し
ます。
Web アプリケーション
クラスタ化された Web アプ
負荷バランス (セッションの
負荷バランス (セッションの
リケーションサーバ
類似性あり)
類似性なし)
フォールトトレランス
(フォールトトレランスの説明
を参照してください)
サポートされる
未サポート
×
サポートされる
サポートされる
未サポート
×
Web でホストされる BI ツ サポートされる
サポートされる
未サポート
○
BI 起動パッド (ステートレ サポートされる
ス)
CMC (ステートフル)
ール
注記
WDeploy ツールは、クラスタ、または Websphere Application Server Network Deployment などのクラスタソフトウェ
アへのデプロイメントではサポートされません。
フォールトトレランスの説明
フォールトトレランス (またはフェイルオーバー) が、BI プラットフォームによるドキュメントシリアル化の形式でサポートされて
います。 CMC および BI ラウンチパッドでは、フェイルオーバーはサポートされていません。Web Tier が適切に設定されてい
る場合、Web サーバエラーの発生時に次の動作がサポートされます。
表 5:
Web アプリケーション
フォールトトレランスの説明
BI ラウンチパッド
再度ログオンする必要があります。
CMC
再度ログオンする必要があります。
Web でホストされる BI ツール
再度ログオンする必要がありますが、ドキュメントのコンテンツは保
持されます。
フェイルオーバーを設定する場合は、オブジェクトのデータがシリアル化される頻度を考慮する必要があります。 ステータスを
頻繁に保存しすぎると、Web アプリケーションサーバでさらなる負荷がかかり、ユーザエクスペリエンスが低下する場合があり
ます。 提案される設定については、Web アプリケーションベンダーのドキュメントを参照してください。
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
CUSTOMER (顧客)
13
3.3
SAP BusinessObjects Business Intelligence プラットフォーム
の WAR ファイルと EAR ファイル
BI プラットフォームを構成している機能は、組織に必要なコンポーネントだけを簡単にデプロイできるようにするため、複数の
Web アプリケーションに分割されています。 BI プラットフォーム 4.2 では、旧リリースに含まれていた多数の主力 Web アプリ
ケーションが、1 つの OSGi アーカイブにバンドルされています。 これによって Web アプリケーションサーバのメモリが節約で
き、旧リリースでは複数のアーカイブに分かれていた Web アプリケーションに必要な Web セッション数が減少します。
たとえば、BI プラットフォーム XI 3.x にはセントラル管理コンソール (CMC) および InfoView (現在は BI ラウンチパッド) の
Web アプリケーションが含まれており、それぞれ CMC.war および InfoView.war としてアーカイブされていました。 BI プ
ラットフォーム 4.2 では CMC および InfoView (現在は BI ラウンチパッド) の Web アプリケーションがその他の Web アプリ
ケーションと共に、BOE.war または BOE.ear という名前の 1 つのアーカイブに統合されています。
WDeploy ツールは、サポートされている Web アプリケーションサーバにデプロイできるように、Web アプリケーションを調整
するプロセスを自動化する際に使用されます。 経験豊富な管理者であれば、Web アプリケーションを特定の Web アプリケー
ションサーバに合わせて手動で調整できますが、WDeploy ツールを使用してプロセスを自動化することをお勧めします。
次の表に、Web アプリケーションアーカイブとこれらのアーカイブを必要とする Web アプリケーションを示します。 インストー
ルプログラムで自動的にデプロイされない Web アプリケーションは、インストール後にデプロイする必要があリます。
Web アプリケーションアーカイブ (WAR または
自動デプロイ
説明
EAR)
○
BOE
以下を含む、主力の Web アプリケーション
の OSGi アーカイブ
●
Analytical Reporting
●
CMC
●
SAP Crystal Reports
●
BI 起動パッド (以前は InfoView)
●
Eclipse IDE サポート
●
Lifecycle Manager
●
モニタリング
●
OpenDocument
●
BI ワークスペース (以前は
Dashboard Builder)
●
プラットフォーム検索
●
プラットフォームサービス
●
Visual Difference
●
SAP BusinessObjects Dashboards
(旧 Xcelsius)
BusinessProcessBI (廃止予定)
○
この Web アプリケーションは廃止予定で
す。 以下を含む従来の Crystal Reports
Web サービスおよび SDK コンポーネントの
サポートを提供します。
14
CUSTOMER (顧客)
●
Crystal Enterprise
●
Crystal Reports Report Application
Server(RAS)
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
Web アプリケーションアーカイブ (WAR または
自動デプロイ
説明
EAR)
●
SAP BusinessObjects Dashboards
(旧 Xcelsius)
●
SAP BusinessObjects Analysis,
OLAP edition (旧 Voyager)
clientapi
○
SAP Crystal Reports JavaScript API 1 の
サポート
dswsbobje
○
以下を含む Web サービスコンポーネント
●
セッション
●
BI プラットフォーム
●
BI カタログ
●
フェデレーション管理ツール
●
Live Office
●
Web サービスクエリツール (以前は
Query as a Web Service)
●
公開
●
レポートエンジン
●
SAP BusinessObjects Web
Intelligence (旧 Web Intelligence)
●
SAP BusinessObjects Dashboards
Web サービス (旧 Xcelsius)
jsfplatform
×
Java Server Faces のサポートおよび例。
MobileOTA14
×
モバイルクライアントのサポート向け Web
アプリケーション。
OpenSearch
×
OpenSearch のサポート。
AdminTools
○
クエリビルダのサポート。
次の表では、旧バージョンに付属している WAR ファイルに格納されているものと同じ機能が保存されている BI プラットフォー
ム 4.2 の場所を、旧バージョンと比較して示します。
旧バージョンの Web アプリケーションアーカイブ (WAR または EAR)
新バージョンの Web アプリケーションアーカイブ (WAR または EAR)
AdminTools
AdminTools
AnalyticalReporting
BOE
BusinessProcessBI
BusinessProcessBI (廃止予定)
CmcApp
BOE
CmcAppActions
BOE
CrystalReports
BOE
Xcelsius
BOE
dswsbobje
dswsbobje
InfoViewApp
BOE
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
CUSTOMER (顧客)
15
旧バージョンの Web アプリケーションアーカイブ (WAR または EAR)
新バージョンの Web アプリケーションアーカイブ (WAR または EAR)
InfoViewAppActions
BOE
LCM
BOE
OpenDocument
BOE
PerformanceManagement
BOE
PlatformServices
BOE
PMC_Help
BOE
VoyagerClient
BOE
XCTemplateUploader
BOE
3.3.1 モバイルアプリケーションをサポートするために
MobileOTA14.war をデプロイする
BI プラットフォームインストールプログラムは、モバイルアプリケーションのサポートを提供する MobileOTA14 Web アプリケ
ーションをデプロイしません。
モバイルアプリケーションを使用するには、インストールプロセスの完了後に MobileOTA14 アーカイブ
(MobileOTA14.war または MobileOTA14.ear) を手動でデプロイする必要があります。
注記
WDeploy GUI ツールは、個別の Web アプリケーションのデプロイには使用できません。 MobileOTA14 などの個別の
Web アプリケーションをデプロイするには、WDeploy コマンドラインツールを使用します。
1. MobileOTA14 Web アプリケーションをデプロイする前に、使用している Web アプリケーションサーバに WDeploy の設
定ファイル config.<WEB_APPLICATION_SERVER> が、適切に設定されていることを確認してください。 WDeploy 設
定ファイル [30 ページ]を参照してください。
2. MobileOTA14 Web アプリケーションをデプロイします。
MobileOTA14 Web アプリケーションをデプロイするには、次の WDeploy コマンドを使用します。
wdeploy.bat <WEB_APPLICATION_SERVER>
-Dwar_dir=<LOCATION_OF_MOBILEOTA14.WAR>
-DAPP=MobileOTA14
deploy
たとえば、次のコマンドは、WebSphere 7 Web アプリケーションサーバに MobileOTA14 をデプロイします。
wdeploy.bat websphere7
-Dwar_dir="C:¥Program Files (x86)¥SAP BusinessObjects¥Mobile 14¥Client"
-DAPP=MobileOTA14
deploy
3. Web アプリケーションサーバを再起動します。
4. 次の URL にアクセスして、MobileOTA14 Web アプリケーションが動作していることを確認します。
16
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
http://<HOSTNAME>:<PORT>/MobileOTA14
<HOSTNAME> を Web アプリケーションサーバのホスト名に置き換え、<PORT> を Web アプリケーションサーバのポート
番号に置き換えます。
モバイル製品の詳細については、SAP BusinessObjects Mobile のインストールとデプロイメントガイドを参照してください。
3.3.2 OpenSearch をサポートするために OpenSearch.war をデプロ
イする
インストールプログラムは、OpenSearch アプリケーションのサポートを提供する OpenSearch Web アプリケーションをデプ
ロイしません。
OpenSearch アプリケーションを使用するには、インストールプロセスの完了後に OpenSearch.war アーカイブを手動でデ
プロイする必要があります。
注記
WDeploy GUI ツールは、個別の Web アプリケーションのデプロイには使用できません。 OpenSearch などの個別の
Web アプリケーションをデプロイするには、WDeploy コマンドラインツールを使用してください。
1. Web アプリケーションサーバの接続の詳細情報が、WDeploy Web アプリケーションサーバの設定ファイルに設定され
ていることを確認してください。 ファイルは以下の場所にあります。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf
¥config.<WEB_APP_SERVER>
WDeploy Web アプリケーションサーバの設定ファイルの詳細については、SAP BusinessObjects Business
Intelligence プラットフォーム Web アプリケーションデプロイメントガイドの“設定ファイル”に関するトピックを参照してくだ
さい。
2. OpenSearch Web アプリケーションの config.properties ファイルで、OpenSearch の設定を更新します。 ファイ
ルは以下の場所にあります。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥OpenSearch¥WEB-INF
次のパラメータがサーバ用に設定されていることを確認します。
○ cms: CMS のホスト名および CMS のポート番号。 たとえば、次の形式を使用します。
<CMS_HOSTNAME>:<PORT>。
○ opendoc: OpenDocument Web アプリケーションの URL。 例: http://<WAS_HOSTNAME>:<PORT>/BOE/
OpenDocument/opendoc/openDocument.jsp.
○ proxy.rpurl: リバースプロキシの URL (組織でリバースプロキシサーバを使用する場合)。
○ proxy.opendoc.rpurl: OpenDoc リバースプロキシサーバの URL (組織で OpenDoc リバースプロキシサー
バを使用する場合)。
3. OpenSearch Web アプリケーションをデプロイします。
OpenSearch Web アプリケーションをデプロイするには、次の WDeploy コマンドを使用します。
wdeploy.bat WEB_APPLICATION_SERVER
-Dapp_source_dir=<LOCATION_OF_OPENSEARCH_WEB_APP_SOURCE_TREE>
-DAPP=OpenSearch
deploy
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
CUSTOMER (顧客)
17
たとえば、次のコマンドは、WebSphere 7 Web アプリケーションサーバに OpenSearch Web アプリケーションをデプロ
イします。
wdeploy.bat websphere7
-Dapp_source_dir="C:¥Program Files (x86)¥SAP BusinessObjects¥SAP
BusinessObjects Enterprise XI 4.0¥warfiles¥OpenSearch"
-DAPP=OpenSearch
deploy
OpenSearch 関連の製品の詳細については、SAP BusinessObjects Business Intelligence プラットフォーム管理者ガイド
の“OpenSearch”に関する節を参照してください。
3.4
デフォルトのコンテキストルート
すべての Web アプリケーションは、Web アプリケーションサーバのカスタムのコンテキストルートにデプロイすることができま
す。次の表に、各 Web アプリケーションのコンテキストルートを示します。
Web アプリケーション
コンテキストパス
セントラル管理コンソール(CMC)
/BOE/CMC
BI 起動パッド
/BOE/BI
OpenDocument
/BOE/OpenDocument
SAP Crystal Reports JavaScript API
/clientapi
Web サービスプロバイダ
/dswsbobje
BI Business Processes (廃止予定)
/BusinessProcessBI
3.5
カスタムのルートコンテキストおよびコンテキストパス
BI プラットフォーム Web アプリケーションは、Web アプリケーションサーバのカスタムの場所にデプロイすることができます。
この場所は、Web ブラウザから Web アプリケーションにアクセスする際に使用される URL に反映され、コンテキストと呼ば
れます。
ルートコンテキストは、Web アプリケーションが配置されている Web アプリケーションサーバの最上位フォルダです。BI プラッ
トフォーム Web アプリケーションのデフォルトルートコンテキストは /BOE です。たとえば、www.mycompany.com という名
前の Web アプリケーションサーバでは、サーバ上の Web アプリケーションへのアクセスに使用される URL プレフィックスは
http://www.mycompany.com/BOE/ のようになります。
コンテキストパス (仮想ディレクトリとも呼ばれます) は、Web アプリケーションが配置されているルートコンテキスト内のフォル
ダです。たとえば、BI 起動パッドアプリケーションのデフォルトコンテキストパスは /BI です。www.mycompany.com という
名前の Web アプリケーションサーバ上の BI 起動パッド Web アプリケーションへのアクセスに使用される URL は、
http://www.mycompany.com/BOE/BI/ のようになります。
ルートコンテキストおよびコンテキストパスはいずれも、組織のニーズに合わせて変更することができます。次の表に、
MyApp という名前の Web アプリケーションをさまざまなルートおよび Web アプリケーションのコンテキストパスにデプロイす
18
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
る例を示します。 次の項目では、ルートおよび Web アプリケーションのコンテキストパスをカスタマイズする方法について説
明します。
3.5.1 ルートコンテキストを変更する
BI プラットフォーム Web アプリケーションで使用されるルートコンテキストを変更できます。ただし、AdminTools Web アプリ
ケーションは除きます。 AdminTools を正常に実行するには、デフォルトのルートコンテキストを使用する必要があります。
デフォルト設定は、空のルートコンテキストを含むため、Web アプリケーションコンテキストパスは、URL のサーバアドレスの
直後に表示されます。
たとえば、URL 内の空のルートコンテキスト結果は http://localhost:8080/BOE/CMC のようになり、ここで http://
localhost:8080/ は、サーバおよびポート番号で、ルートコンテキストはなく、BOE/CMC が Web アプリケーションコンテキ
ストパスです。 ルートコンテキストを /MY_COMPANY に設定すると、上記の URL 例は、http://localhost:8080/
MY_COMPANY/BOE/CMC となります。
WDeploy ツールを使用する場合、ルートコンテキストは、オプション画面で設定できます。 WDeploy コマンドラインツールを
使用する場合、BI プラットフォーム Web アプリケーションのルートコンテキストは、以下の設定ファイルに設定されます。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf¥wdeploy.conf
テキストエディタを使用して、wdeploy.conf で指定されている root_context_path の値を更新します。
たとえば、wdeploy.conf 設定ファイルには次のパラメータがデフォルトで含まれています。
as_lang=en
work_dir=
war_dir=
app_source_tree=
disable_CMC=false
disable_InfoView=false
JCoStandalone=
root_context_path=
recent_app_svr=<WEB_APP_SERVER>
3.5.2 Web アプリケーションのコンテキストパスを変更する
BI プラットフォーム Web アプリケーションのデフォルトのコンテキストパス (仮想ディレクトリとも呼ばれる) は変更することが
できます。
たとえば、BOE Web アプリケーションのデフォルトのコンテキストパスは BOE で、これはサンプルの URL http://
localhost:8080/BOE/CMC に示されています。 この例では、http://localhost:8080/ はサーバおよびポート番
号、BOE は Web アプリケーション、/CMC は BOE Web アプリケーションに含まれるコンポーネントとなります。
BI プラットフォーム Web アプリケーションのコンテキストパスは、次の設定ファイルで設定されます。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf¥apps
¥WEB_APP.properties
テキストエディタを使用して、設定ファイル WEB_APP.properties 内の appvdir パラメータの値を更新します。
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
CUSTOMER (顧客)
19
たとえば、BOE.properties 設定ファイルには次のパラメータがデフォルトで含まれています。
warfile=BOE.war
appvdir=BOE
buildfile=BOE.xml
osgisupported=true
20
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
Web アプリケーションのデプロイメントの概要
4
WDeploy ツールを使用して Web アプリケーショ
ンをデプロイする
4.1
WDeploy の概要
WDeploy ツールは、BI プラットフォームに含まれ、Web アプリケーションを Java ベースの Web アプリケーションサーバにデ
プロイする場合に役に立ちます。
WDeploy には以下のような 2 つの異なるインタフェースがあります。
● コマンドラインで指定されたコマンドおよびパラメータを処理する、従来のテキストベースのインタフェース。
● ユーザに対してデプロイメントパラメータの入力を要求する、BI プラットフォームインストールプログラムに似た、Windows
ベースのガイド付き新規アシスタント。
サポートされる Web アプリケーションサーバごとに異なるコマンドおよび Web アプリケーションパッケージ更新が必要になり
ますが、WDeploy では、管理者用の一貫したインタフェースが提供され、特定の Web アプリケーションサーバへのデプロイ
メントに必要な調整が自動的に行われます。
たとえば、Web アプリケーションを IBM WebSphere Web アプリケーションサーバにデプロイする場合は、単一の WDeploy
コマンドで以下のタスクを実行できます。
1. IBM WebSphere に固有の設定を Web アプリケーションの web.xml ファイルに作成する。
2. Web アプリケーションのコンテンツを Web アーカイブにバンドルする。
3. Web アプリケーションを含む EAR ファイルを作成する。
4. IBM WebSphere デプロイメントツールを呼び出して Web アプリケーションをデプロイする。
4.2
WDeploy の前提条件
この節では、サポートされている Web アプリケーションサーバに BI プラットフォーム Web アプリケーションをデプロイするた
めの前提条件について詳細を説明します。
注記
Web アプリケーションを WebSphere にデプロイする前に、WASX7017E: WebSphere におけるデプロイメントでの例外
[96 ページ]を参照してください。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
21
4.2.1 Web アプリケーションをデプロイする前の作業
BI プラットフォームをインストールする前に、Web アプリケーションサーバがインストールされ、稼動している必要があります。
インストール手順については、Web アプリケーションサーバのマニュアルを参照してください。
マシンにインストールされている他のソフトウェアで指定されている要件に加えて、Web アプリケーションサーバに 5 GB 以上
の空きディスク領域が必要です。
JVM のヒープサイズと最大永続サイズの設定を -Xms128m -Xmx2048m -XX:MaxPermSize=512m に変更することを
お勧めします。 たとえば、Tomcat を使用している場合、設定を変更すると、次のようになります。
JAVA_OPTS="-Xms128m -Xmx2048m -XX:MaxPermSize=512m"
注記
SAP Netweaver technology platform では、最高ヒープサイズは 4096 MB 以上にする必要があります。 たとえば、
JAVA_OPTS="-Xms128m -Xmx4096m -XX:MaxPermSize=512m" のように指定します。
Java のメモリ設定を変更する方法については、JVM のマニュアルを参照してください。
デプロイメントを開始する前に、Web アプリケーションサーバがインストールされていることを確認し、管理コンソールを起動し
てアプリケーションサーバが正しく実行されていることを確認してください。
4.2.2 ハードウェアの要件
WDeploy ツールを使った Web アプリケーションサーバへの Web アプリケーションのデプロイメントには、4 GB 以上の RAM
(SAP NetWeaver technology platform では 8 GB)、および 15 GB 以上の空きディスク容量、さらに Web アプリケーション
のデプロイメントには、%TEMP% 環境変数で定義される一時フォルダをホストするドライブに 5 GB 以上の空きディスク容量が
必要です。 この要件は、ホストにインストールされた Web アプリケーションサーバ、その他すべてのサーバまたはサービスに
おける、他のすべての要件に追加されます。
4.2.3 64 ビットのサポート
BI プラットフォームは、64 ビットオペレーティングシステムでのみサポートされ、64 ビット JDK を使用した 64 ビット Web アプ
リケーションサーバのみをサポートします。
4.2.4 8.3 ファイル名のサポートの有効化
Windows 8.3 ファイル名のサポートは、Windows ファイルシステムがファイルごとに 2 つのファイル名(8 文字までの文字と
3 文字の拡張子で構成されるファイル名、および何百文字でも指定できるフルネームで構成されるファイル名)を維持する方
法を表します。
22
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
Windows オペレーティングシステムではこの機能はデフォルトで有効になっていて、従来の Microsoft オペレーティングシス
テムおよびファイルシステムとの下位互換性が確保されます。
BI プラットフォームでは、8.3 のサポートを有効にする必要があります。Windows サーバで 8.3 ファイル名が有効になってい
るかどうかを確認するには、次の手順を実行します。
1. Windows の[スタート]メニューの[ファイル名を指定して実行]を選択します。
[ファイル名を指定して実行]ダイアログウィンドウが表示されます。
2. [名前]フィールドに「regedit」と入力します。
レジストリエディタプログラムが表示されます。
3. レジストリツリーの
HKEY_LOCAL_MACHINE
SYSTEM
CurrentControlSet
Control
FileSystem
まで
移動します。
4. <NtfsDisable8dot3NameCreation> をダブルクリックし、値が 0 に設定されていることを確認します。
0 に設定すると、Windows 8.3 ファイル名のサポートが有効になります。
これで、Windows では長いファイル名と短いファイル名の両方がサポートされます。
変更を有効にするには、システムを再起動します。
4.2.5 Java 環境をセットアップする
WDeploy を使用するには、ホストシステムで Java 仮想マシンが使用可能になっている必要があります。 Java
Development Kit (JDK) 1.6 は BI プラットフォームインストールプログラムにより自動的にインストールされますが、専用のマ
シンに手動でインストールする場合は、セットアップするか BI プラットフォームサーバからコピーする必要があります。
デフォルトでは、BI プラットフォームインストールプログラムでインストールされた JDK が使用されます。 専用の Web アプリ
ケーションサーバを使用している場合は、Web Tier のインストールを実行するか、Web アプリケーションサーバでサポートさ
れる適切な JDK 1.5 または 1.6 を手動でインストールして、JDK を設定する必要があります。 JDK を手動でセットアップする
場合は、以下の環境設定が設定されていることを確認してください。
● WDeploy 設定ファイルでは、最初に BI プラットフォームと一緒にインストールされた JVM を使用しようとします。 JVM
が見つからないと、次に WDeploy は有効な Java ディレクトリに設定されている <JAVA_HOME> 環境変数設定を使用し
ようとします。 有効または適合する JVM が存在しない場合、WDeploy は終了します。
● ユーザアカウントの PATH 変数に以下が含まれている。
<JAVA_HOME>¥bin
● 任意のディレクトリから WDeploy を実行できるようにするには、PATH 環境変数に以下を追加して更新します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
4.2.6 Web アプリケーションサーバのパラメータ設定ファイル
Web アプリケーションをデプロイするために WDeploy コマンドラインを使用する前に、WDeploy Web アプリケーションデプ
ロイメントサーバのパラメータ設定ファイルに正しいパラメータが設定されていることを確認してください。設定済みのパラメー
タがデフォルト設定として使用されるため、コマンドラインでの指定は不要です。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
23
注記
GUI インタフェースを使用する場合、または、wdeploy predeploy コマンドまたは wdeploy predeployall コマン
ドを使用して事前デプロイのみを行う場合、これらのデプロイメント設定ファイルにパラメータを設定する必要はありませ
ん。
Web アプリケーションサーバの設定ファイルは、フォルダ <BIP_INSTALL_DIR>¥SAP BusinessObjects
Enterprise XI 4.0¥wdeploy¥conf にあります。たとえば、Tomcat 8 を使用している場合は、C:¥Program Files
(x86)¥SAP BusinessObjects¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf
¥config.tomcat8 を選択します。
テキストエディタを使用して、組織の Web アプリケーションサーバに固有の値に更新します。WDeploy 設定ファイルの設定
方法の詳細については、WDeploy 設定ファイル [30 ページ]を参照してください。
WDeploy Web アプリケーションサーバのパラメータ設定ファイルに設定されているパラメータは、コマンドラインから
WDeploy を呼び出すときに、デフォルト動作を変更するスイッチとパラメータを使用して上書きできます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することを強くお勧めし
ます。
4.2.7 WDeploy をリモートの Web アプリケーションサーバにインストー
ルする
Web アプリケーションを専用の Web アプリケーションサーバにデプロイするには、BI プラットフォームインストールプログラム
で Web Tier またはカスタム/拡張インストールを実行します。 WDeploy ツールを手動でコピーする場合は、次のフォルダを
Web アプリケーションサーバにコピーします。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
注記
WDeploy ツールを手動でコピーする場合は、環境変数 JAVA_HOME が Web アプリケーションサーバに適切に設定され
ていることを確認してください。
4.3
SAP システムランドスケープディレクトリ (SLD) 登録
SAP システムランドスケープディレクトリ (SLD) データサプライヤ (DS) は、組織の所有する SAP ソフトウェアに関する情報
の中央リポジトリを維持管理するのに使用できます。管理者は、システムのトポロジーおよびソフトウェアコンポーネントに関
する詳細情報をここから取得できます。SLD に対する BI プラットフォームの設定方法の詳細については、SAP
BusinessObjects Business Intelligence プラットフォーム管理者ガイドの“システムランドスケープでの BI プラットフォームの
登録”または SAP ノート 1653689 を参照してください。
Web アプリケーションがデプロイされたりアンデプロイされたときに SLD 登録から SLD に通知し、組織の Web アプリケーシ
ョンデプロイメントに関する最新情報で SLD データベースを最新の状態に維持することができます。
24
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
Web アプリケーションコンポーネントは、以下の Web アプリケーションサーバで SLD に登録することができます。
● SAP Netweaver Technology Platform
● Apache Tomcat 7.0、8.0
● IBM WebSphere 7.0
4.3.1 SAP Netweaver Technology Platform の SLD 登録を有効化
する
SAP システムランドスケープディレクトリデータサプライヤ (SLD-DS) の統合は、SAP Netweaver Technology Platform で
使用可能です。 SLD-DS の統合および SAP Netweaver technology platform についての詳細は、以下にあるシステムラ
ンドスケープディレクトリに関する SCN のドキュメントを参照してください。http://scn.sap.com/docs/DOC-8042
.
4.3.2 Tomcat の SLD 登録を有効化する
SAP システムランドスケープディレクトリデータサプライヤ (SLD-DS) の Apache Tomcat 用を使用するには、SLDREG 登録
ツールを Apache Tomcat の各 Web アプリケーションサーバにインストールする必要があります。
注記
SLDREG は、BI プラットフォームの一部としてはインストールされません。 SLDREG をインストールする方法については、
SAP ノート 1018839 を参照してください。
Web アプリケーションが Apache Tomcat Web アプリケーションサーバにデプロイまたは Apache Tomcat Web アプリケー
ションサーバからアンデプロイされたときに、常に SLD が更新されるように SLDREG を設定するには、SAP ノート 1508421
を参照してください。
注記
SAP ノート 1508421 に添付の必要な sap.com~TomcatSLDDataSupplierWEB.war ファイルは、Web Tier のインス
トール中に Java Web アプリケーション機能がインストールされた後なら、<<BIP_INSTALL_DIR>>¥SAP
BusinessObjects¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps フォルダにもありま
す。
4.3.3 WebSphere の SLD 登録を有効化する
SAP システムランドスケープディレクトリデータサプライヤ (SLD-DS) の WebSphere 用を使用するには、SLDREG 登録ツー
ルを WebSphere の各 Web アプリケーションサーバにインストールする必要があります。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
25
注記
SLDREG は、BI プラットフォームの一部としてはインストールされません。SLDREG をインストールする方法については、
SAP ノート 1018839 を参照してください。
Web アプリケーションが WebSphere Web アプリケーションサーバにデプロイまたは WebSphere Web アプリケーションサ
ーバからアンデプロイされたときに、常に SLD が更新されるように SLDREG を設定するには、SAP ノート 1482727 を参照し
てください。
4.4
デプロイメントモード
WDeploy では、2 つの異なるデプロイメントモードがサポートされます。
1. スタンドアロンモード (Web アプリケーションサーバ)
Web アプリケーションサーバは、静的コンテンツ (HTML ページ、イメージ、ドキュメント、JavaScript、カスケードスタイル
シート) および動的コンテンツ (Java サーバページ、JAR ファイル、XML ファイル) の両方を配信します。
2. 分割 Web Tier モード (Web アプリケーションサーバと専用の Web サーバ)
専用の Web サーバは、Web ブラウザからのリクエストを受信し、すべての静的コンテンツ (HTML ページ、イメージ、ド
キュメント、JavaScript、カスケードスタイルシート) を処理します。動的コンテンツ (Java サーバページ、JAR ファイル、
XML ファイル) のリクエストは、専用のアプリケーションサーバに転送され、コンテンツの作成後、Web ブラウザに返され
ます。
このモードは、スケーラビリティとパフォーマンスが重要となる大規模な実稼動デプロイメントに適しています。
WDeploy を使用して、各種 Web アプリケーションを、BI プラットフォームと同じシステムにインストールされている Web アプ
リケーションサーバにデプロイすることもできます。この設定は、小規模なデプロイメントまたはテストシステムでの使用に適し
ており、実稼動システムでの使用はお勧めしません。
4.4.1 スタンドアロンデプロイメント
スタンドアロンモードとは、静的コンテンツと動的コンテンツの両方を Web クライアントに配信する Web アプリケーションサー
バのことを指します。Web アプリケーションサーバは、BI プラットフォームと同じマシン、またはネットワークで接続された別の
マシンで実行できます。
次の図で、Web クライアントはファイアウォールを通じて Web アプリケーションサーバ [1] に接続し、静的コンテンツと動的コ
ンテンツを処理します。Web アプリケーションサーバからの処理リクエストは BI プラットフォーム Central Management
Server (CMS) [2] に送信されて処理されます。
26
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
上の図で、WDeploy は CMS [2] のコンポーネントとしてインストールされており、Web アプリケーションは静的コンテンツ用
のディレクトリと動的コンテンツ用のディレクトリに分割されています。これで、動的コンテンツを Web アプリケーションサーバ
[1] へコピーすることができます。
また、WDeploy ツールを専用の Web アプリケーションサーバ [1] にインストールまたはコピーすると、CMS [2] から受け取
った分割コンテンツを簡単にデプロイすることができます。
このモードは、ユーザ数が限られている小規模なデプロイメントに最も適しています。スタンドアロンデプロイメントの利点は、
デプロイメントや管理が簡単であるという点です。ただし、このデプロイメントでは、静的コンテンツと動的コンテンツの両方が
Web アプリケーションサーバで処理されるため、ユーザ数の多い環境に合わせて拡張することはできません。
4.4.2 分割 Web Tier デプロイメント
Web Tier の分割デプロイメントでは、静的 Web アプリケーションコンテンツと動的 Web アプリケーションコンテンツが分割さ
れ、静的コンテンツは Web サーバ、動的コンテンツは Web アプリケーションサーバで処理されます。 Web サーバと Web ア
プリケーションサーバは、同じマシンで実行しても、ネットワークで接続された異なるマシンで実行してもかまいません。
注記
分割 Web Tier モードで次の Web アプリケーションをデプロイする場合は、パフォーマンスの向上はありません。
WDeploy は、分割 Web Tier モードでもこれらの Web アプリケーションをスタンドアロン Web アプリケーションとして処理
します。
● Web サービス
● MobileOTA14
● MOBIServer
● OpenSearch
● jsfplatform
次の図で、Web クライアントはファイアウォールを通じて Web サーバ [1] に接続し、静的コンテンツのみ (HTML ページ、イメ
ージ、ドキュメント、JavaScript、カスケードスタイルシート) を処理します。 動的コンテンツが必要な場合、Web サーバは
Web アプリケーションサーバ [2] にリクエストを送ります。 BI プラットフォームによる追加の処理が必要なリクエストは
Central Management Server (CMS) [3] に送信され、処理されます。
上の図で、WDeploy は CMS [3] のコンポーネントとしてインストールされており、Web アプリケーションは静的コンテンツ用
のディレクトリと動的コンテンツ用のディレクトリに分割されています。 これで、動的コンテンツは Web アプリケーションサーバ
[2] へ、静的コンテンツは Web サーバ [1] へコピーすることができます。
また、WDeploy コマンドを専用の Web サーバ [1] および Web アプリケーションサーバ [2] にインストールすると、CMS [3]
から受け取った分割コンテンツを簡単にデプロイすることができます。
組織がサーバマシンへのアクセスを制限するセキュリティ対策を実装している場合は、分割された静的コンテンツと動的コン
テンツをコンテンツのデプロイ権限を持つユーザに個別に送信することができます。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
27
分割デプロイメントは、ユーザ数の多い (または増えている) 中規模から大規模のデプロイメントに最も適しています。 分割デ
プロイメントの利点は、拡張可能で、最適なパフォーマンスを実現できるという点です。
注記
Web サーバ、Web アプリケーションサーバ、および BI プラットフォームサーバをクラスタ化することで、スケーラビリティ、
可用性、およびパフォーマンスを向上させることができます。
4.4.2.1
サポートされる専用の Web サーバと Web アプリケーションサ
ーバの組み合わせ
分割デプロイメントでは、WDeploy は、次の Web サーバおよび Web アプリケーションサーバの設定をサポートします。
● Apache 2.2 Web サーバと Tomcat 7 または 8
● Apache 2.2 Web サーバと WebLogic 10.3.x
● IBM IHS Web サーバ 7 と WebSphere 7.0
● IBM IHS Web サーバ 8.5 と WebSphere 8.5 または 8.5.5
注記
WDeploy 設定ファイルでは、Apache および IBM IHS Web サーバはすべて apache として指定されます。
4.4.2.2
Web アプリケーションをリモートマシンにデプロイする
以下の手順では、Web アプリケーションをリモートマシンにデプロイします。この手順では、Box 1 が BI プラットフォームインス
トール環境をホストするマシン、Box 2 が Web アプリケーションサーバがインストールされているリモートマシンです。
1. Box 2 に以下のディレクトリを作成します。
○ <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
○ <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps
○ <BIP_INSTALL_DIR>¥InstallData
これらのディレクトリは、Box 1 上にインストールされているデフォルトのディレクトリ構造を反映しています。
ヒント
フォルダ構造は各自の要件に基づいてカスタマイズできますが、Box 2 でも Box 1 と同じフォルダ構造(階層構造)でフ
ァイルを保守することをお勧めします。
2. 以下のファイルを Box 1 から Box 2 にコピーします。
○ フォルダ <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy。
28
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
ヒント
ファイルをコピーする前に、<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥workdir が空ではない場合はその下にあるコンテンツを削除します。
○ フォルダ <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps。
○ フォルダ <BIP_INSTALL_DIR>¥InstallData¥setup.engine。
3. JAVA_HOME 環境変数を JDK 8 ディレクトリに設定します。
注記
WDeploy ツールを使用する Web アプリケーションサーバをデプロイする場合は、バンドルされた SAP JVM 8 を使用
することをお奨めします。
4. 使用する Web アプリケーションサーバ用の WDeploy 設定ファイルを編集します。WDeploy が Web アプリケーションを
デプロイできるように、必要なすべての情報を入力します。
たとえば、WebLogic 11 用の設定ファイルを編集する場合は、ファイルを次のように修正します。
as_domain_dir=C:¥Oracle¥Middleware¥user_projects¥domains¥base_domain
as_instance=AdminServer
as_admin_port=7001
as_admin_username=weblogic
as_admin_password=weblogic
設定ファイルは次のディレクトリにあります。
<BOE_INSTALL_DI>R¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf
¥config.<WEB_APP_SERVER>
5. コマンドラインコンソールを開き、次のコマンドを入力して、WDeploy スクリプトを Box 2 でのその場所から実行します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥wdeploy.bat
<WEB_APP_SERVER>
-Dapp_source_tree=“<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥warfiles¥webapps”
deployall
注記
○ WDeploy パラメータのデフォルト値を WDeploy 設定ファイルに設定できます
コマンドラインでパラメータを指定する代わりに、<BIP_INSTALL_DIR>¥SAP BusinessObjects
Enterprise XI 4.0¥wdeploy¥conf¥wdeploy.conf と設定します。たとえば、パラメータを次のように
設定します。
○ app_source_tree または war_dir
○ work_dir
○ root_context_path
詳細については、WDeploy 設定ファイル [30 ページ]を参照してください。
○ 汎用の WAR ファイルの場所をデプロイメントの入力として指定するために、引数 -Dwar_dir を渡します。たと
えば、汎用の BOE.war ファイルをデプロイするには、次のコマンドを実行します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥wdeploy.bat <WEB_APP_SERVER>>
-Dwar_dir="C:¥myGenericWarFiles¥BOE.war"
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
29
-DAPP=BOE
deploy
○ すべての BI プラットフォームアプリケーションの汎用 WAR ファイルを作成するには、次のコマンドを実行しま
す。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥wdeploy.bat
buildwarall
-Dapp_source_tree=“<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise
XI 4.0¥warfiles¥webapps”
-Dwar_dir=“C:¥myGenericWarFiles”
○ 汎用の WAR ファイルの出力先を指定するために、パラメータ Dwar_dir=<TARGET_LOCATION_OF_GENERIC_WAR_FILE> を渡します。
4.5
WDeploy 設定ファイル
WDeploy 設定ファイルには、key-value ペアテキスト形式で保存される設定が含まれます。 起動時に WDeploy によって読
み取られ、設定ファイルに保存されるオプションおよびパラメータがデフォルト設定として使用されるため、コマンドラインでの
指定は不要です。 ただし、オプションおよびパラメータはすべて、コマンドラインで指定してもかまいません。コマンドラインでの
指定によって設定ファイルが上書きされます。 コマンドラインで指定するオプションおよびパラメータが、設定ファイルに保存さ
れているオプションを変更することはありません。
注記
Web アプリケーションサーバ管理者アカウントのパスワードは WDeploy 設定ファイルに保存せず、パラメータ Das_admin_password=<PASSWORD> を使用してコマンドラインから WDeploy に渡されるようにすることをお勧めしま
す。
WDeploy によって使用される設定ファイルには、次の 3 種類があります。
● WDeploy 設定ファイル (<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥conf¥wdeploy.conf): すべての Web アプリケーションサーバに提供される一般的な WDeploy 設定を保存しま
す。
● Web アプリケーションサーバ設定ファイル (<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥conf¥config.<WEB_APP_SERVER>): 特定の Web アプリケーションサーバの設定を保存します。
● Web アプリケーションサーバ設定ファイル (<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥conf¥apps¥<WEB_APP>.properties): 各 Web アプリケーションのデプロイメント設定を個別に保
存します。
4.5.1 WDeploy 設定ファイル
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf¥wdeploy.conf 設定フ
ァイルには、デプロイ時にすべての Web アプリケーションサーバ間で共有される可能性の高い設定が保存されます。
30
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
WDeploy 設定ファイルに保存されているプロパティは、コマンドラインから -D<PROPERTY> スイッチパラメータを使用して上
書きすることができます。 ただし、config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて
適切に設定することを強くお勧めします。
WDeploy プロパティの一覧については、WDeploy プロパティのパラメータ [37 ページ]を参照してください。
4.5.2 Web アプリケーションサーバの設定ファイル
Web サーバと Web アプリケーションサーバではサーバごとに異なる WDeploy 設定が必要となるため、WDeploy ツールで
は、サポートされるサーバごとに設定ファイルが参照されます。設定ファイルは次の WDeploy conf フォルダに保存されま
す。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf
¥config.<WEB_APP_SERVER>
<WEB_APP_SERVER> は、WDeploy ツールによるデプロイ先の Web アプリケーションサーバの名前に置き換えます。
次の一覧に、現在サポートされている Web アプリケーションサーバのすべての設定ファイルを示します。
● config.jboss7 (JBoss 7.1)
● config.sapappsvr73 (SAP NetWeaver Technology Platform)
● config.tomcat7 (Tomcat 7.0)
● config.tomcat7 (Tomcat 8.0)
● config.weblogic11 (WebLogic 11gR1)
● config.websphere7 (WebSphere 7.0)
● config.websphere8 (WebSphere 8.5 または 8.5.5)
次の節では、サポートされている各 Web サーバおよび Web アプリケーションサーバで使用可能な設定オプションを一覧で
示します。
4.5.2.1
JBoss 7.1 の設定ファイル
毎回コマンドラインで値を指定しなくても済むように、config.jboss7 (JBoss 7.1) にある次のパラメータのデフォルト値を
設定します。
表 6: JBoss 7.1 の必須 WDeploy パラメータ
パラメータ名
説明
as_dir
JBoss Web アプリケーションサーバがインス C:¥jboss-as-7.1.1.Final
トールされた場所 (<JBOSS_HOME>)。
as_instance
JBoss アプリケーションサーバインスタンス
例
default
の名前。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
31
4.5.2.2
Tomcat 7 または 8 設定ファイル
毎回コマンドラインで値を指定しなくても済むように、config.tomcat7 または config.tomcat8 にある次のパラメータの
デフォルト値を設定します。
Tomcat Web アプリケーションサーバが専用 Apache Web サーバと組み合わされている分割環境にデプロイする場合は、
Apache Web サーバと Tomcat Web アプリケーションサーバに個別にデプロイする [59 ページ]を参照してください。
表 7: Tomcat 7 または 8 の必須 WDeploy パラメータ
パラメータ名
説明
例
as_instance
アプリケーションサーバのインスタンス
名。
localhost
as_service_name
アプリケーションサーバが Windows
Tomcat7 または Tomcat8
サービスとしてインストールされる場合
の Tomcat サービスの名前
(Microsoft Windows でのインストー
ルにのみ適用可)。
as_dir
Tomcat 7 または 8 がインストールさ
れた場所。
as_service_key
Software Foundation¥Tomcat 8.0
Java パラメータを渡すために Tomcat HKLM¥SOFTWARE¥Wow6432Node
で使用されるレジストリキー
(Microsoft Windows でのインストー
ルにのみ適用可)。
as_service_key_value
C:¥Program Files¥Apache
¥Apache Software Foundation
¥Procrun 2.0¥
$<as_service_name>¥Parameters
¥Java
Tomcat の Java パラメータ: レジストリ オプション
キー as_server_key の値。
4.5.2.3
WebLogic 11gR1 設定ファイル
毎回コマンドラインで値を指定しなくても済むように、config.weblogic11 にある次のパラメータのデフォルト値を設定しま
す。
表 8: WebLogic 11gR1 の必須 WDeploy パラメータ
パラメータ名
説明
例
as_admin_port
WebLogic 管理リクエストポート。
7001
as_admin_username
WebLogic 管理アカウントのユーザ名。
weblogic
as_admin_password
WebLogic 管理アカウントのパスワード。
password
as_instance
WebLogic アプリケーションサーバのインス
AdminServer
タンスの名前。
32
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
パラメータ名
説明
例
as_domain_dir
WebLogic ドメインディレクトリ。
C:¥bea¥weblogic
¥user_projects¥domains
¥base_domain
4.5.2.4
WebSphere 7、8.5 または 8.5.5 設定ファイル
毎回コマンドラインで値を指定しなくても済むように、config.websphere7 または config.websphere8 にある次のパ
ラメータのデフォルト値を設定します。
表 9: WebSphere 7、8.5、または 8.5.5 の必須 WDeploy パラメータ
パラメータ名
説明
サンプル値
as_soap_port
SOAP アプリケーションサーバ管理のためのポ 8880
ート番号。 この値を設定しなかった場合、デフ
ォルトの SOAP ポート番号が使用されます。
as_instance
WebSphere アプリケーションサーバのインス
server1
タンスの名前。
as_admin_password
WebSphere 管理アカウントのパスワード。
password
as_admin_username
WebSphere 管理アカウントのユーザ名。
administrator
WebSphere アプリケーションサーバ用に作成
AppSrv01
as_profile_name
されたプロファイル名。 デフォルトではないプロ
ファイルがデプロイメントで使用されている場
合、このパラメータを指定します。
as_virtual_host
as_admin_is_secure
アプリケーションをバインドする必要のある仮
想ホスト。
default_host
WebSphere セキュリティが有効化されている
false
WDeploy を指定します。
注記
as_admin_username および
as_admin_password の値は、
as_admin_is_secure が true であ
る場合に設定する必要があります。
as_dir
WebSphere がインストールされた場所。
C:¥Program Files
¥IBM¥WebSphere
¥AppServer
ws_instance
分割環境 (専用 Web サーバ) にデプロイした
webserver1
場合の Web サーバインスタンス。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
33
パラメータ名
説明
サンプル値
enforce_file_limit
65535 個を超えるファイルを含むアプリケーシ
false
ョンをロード中に Web アプリケーションサーバ
で問題が発生するかどうかを WDeploy に伝え
ます (デフォルトでは false)。
as_plugin_cfg_dir
WebSphere の plugin-cfg.xml ファイ
C:¥AppServers¥IBM
ルの場所。 このパラメータは、分割 Web Tier
¥WebSphere7¥profiles
デプロイメントでのみ必要です。
¥AppSrv01¥config¥cells
¥<cell_name> ¥nodes
¥<webserver_node>
¥servers
¥<webserver_name>
4.5.2.5
分割デプロイメント内の専用 Web サーバ
Web アプリケーションを分割デプロイメントで専用の Web サーバにデプロイする場合は、サポートされている Web サーバの
名前を使用します。
● config.apache (Apache Web Server または IBM IHS)
注記
Web アプリケーションサーバ管理者アカウントのパスワードは WDeploy 設定ファイルに保存せず、パラメータ Das_admin_password=<PASSWORD> を使用してコマンドラインから WDeploy に渡されるようにすることをお勧めしま
す。
分割デプロイメントでは、専用の Web アプリケーションサーバを動的コンテンツに、専用の Web サーバを静的コンテンツに
使用します。次の表には、BI プラットフォームの分割デプロイメント用に設定できる Web アプリケーションサーバが一覧表示
されています。
アプリケーションサーバ
Apache Web サーバ
JBoss 7.1
×
SAP Netweaver Technology Platform
該当なし
Tomcat 7.0
○
Tomcat 8.0
○
WebLogic 11gR1
○
WebSphere 7
○ (IHS 7)
WebSphere 8.5 および 8.5.5
○ (IHS 8.5)
34
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
4.5.2.5.1
Apache または IBM IHS (分割デプロイメント) 設定ファイ
ル
毎回コマンドラインで値を指定しなくても済むように、config.apache にある次のパラメータのデフォルト値を設定します。
注記
同じ設定ファイル (config.apache) が Apache 2.2 または IBM IHS で使用されます。
表 10: Apache 2.2 または IBM IHS (分割デプロイメント) で必須の WDeploy パラメータ
パラメータ名
説明
例
connector_type
分割モードの設定に使用される Apache コ
tomcat8
ネクタの種類。
deployment_dir
WDeploy によって、Web サーバが処理す
る静的コンテンツを保存するサブディレクトリ
が作成されるディレクトリ。WDeploy は、
C:¥apache2¥htdocs
Web サーバ上に仮想ディレクトリを作成し、
サブディレクトリを URL にマッピングします。
plugin_install_dir
WebSphere アプリケーションサーバのルー
トプラグインインストールディレクトリ
ws_dir
Apache Web サーバのインストールディレク
トリ。
${ws_dir}¥Plugins
C:¥apache2
注記
IBM IHS を WebSphere 7、8.5、または 8.5.5 の Web アプリケーションサーバと共に使用する場合、
as_plugin_cfg_dir が config.websphere7 または config.websphere8 に正しく設定されていることを確認し
てください。
4.5.3 Web アプリケーション設定プロパティファイル
各 Web アプリケーションは、Web アプリケーションサーバ上のそれぞれ異なる場所にデプロイし、異なるパッケージ化オプシ
ョンで設定することができます。
デプロイ可能な各 Web アプリケーションは、設定ファイル <BIP_INSTALL_DIR>¥SAP BusinessObjects
Enterprise XI 4.0¥wdeploy¥conf¥app¥<WEB_APP>.properties で設定します。
<WEB_APP>.properties 設定ファイルで指定可能な設定を次に示します。
表 11:
変数
説明
warfile
この Web アプリケーション用に作成す dswsbobje.war
例
る WAR ファイルの名前です。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
35
変数
appvdir
説明
例
Web アプリケーションがデプロイされ
dswsbobje
るコンテキストパス (仮想ディレクトリ)
の名前です。
buildfile
Web アプリケーションのビルドに使用
dswsbobje.xml
する Ant ビルドファイルです。
deploy_as_a_filetree true の場合、開いた WAR ファイルの
true
デプロイメントを有効にします。
classloading_mode
クラスローダー順序を決定するための
設定です。
classloader_package_ クラスローダーのフィルタです。
filtering
PARENT_LAST
com.ctc.wstx.*、javax.xml.*、
org.apache.*
Web アプリケーションを Web アプリケーションサーバ上の特定の場所にデプロイする場合は、appvdir 変数を使用して、サ
ーバのルートコンテキスト内に Web アプリケーションの場所を設定します。 たとえば、Web アプリケーションサーバのルート
コンテキストが http://www.mycompany.com/BOE であった場合、appvdir を mywebapp/ に設定すると、その Web
アプリケーションには http://www.mycompany.com/BOE/mywebapp/ からアクセスできるようになります。
4.6
WDeploy コマンドラインツールの使用
WDeploy コマンドラインツールを使用する前に、WDeploy 設定ファイルが Web アプリケーションサーバに適切に設定されて
いることを確認します。 WDeploy 設定ファイル [30 ページ]を参照してください。
WDeploy の前提条件についての詳細は、以下を参照してください。
● WDeploy の前提条件 [21 ページ]
WDeploy コマンドラインツールは、BI プラットフォームの一部としてインストールされます。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥wdeploy.bat
コマンドには、次の 2 種類があります。
● 一般コマンド
このツール自体および使用可能な Web アプリケーションサーバのデプロイに関する、高度な情報を指定する場合に使
用できます。 サーバ名、プロパティ、またはアクションと一緒には使用しません。 例:
○ wdeploy.bat help
○ wdeploy.bat listappservers
● デプロイメントコマンド
特定の Web アプリケーションを特定の Web アプリケーションサーバにデプロイする場合に使用できます。 これらのコマ
ンドは常に、サーバ、プロパティ、アクションの形式に従います。 例:
wdeploy.bat <WEB_APP_SERVER> [-D<PROPERTY>=<value>] <ACTION>
Where:
36
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
○ <WEB_APP_SERVER> は Web サーバまたは Web アプリケーションサーバの名前で、WDeploy 設定ファイル
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf
¥config.<WEB_APP_SERVER> の名前と一致する必要があります。
たとえば SAP NetWeaver Technology Platform の場合、設定ファイルの名前は <BIP_INSTALL_DIR>¥SAP
BusinessObjects Enterprise XI 4.0¥wdeploy¥conf¥config.sapappsvr73 なので、コマンドライ
ンで WDeploy に設定する <WEB_APP_SERVER> パラメータには、名前 sapappsvr73 を指定します。
○ -D<PROPERTY>=<value> には、少なくとも 1 つの key-value ペアを指定します。 コマンドラインで指定されたパラ
メータは、設定ファイルのパラメータよりも優先されます。
たとえば、BOE Web アプリケーションをデプロイするには、-DAPP=BOE を使用します。 この値は、Web アプリケー
ションサーバ設定ファイル config.<WEB_APP_SERVER> に保存されている -DAPP= のすべての値よりも優先さ
れます。
○ <ACTION> は、実行する操作の名前です。
たとえば、deployall アクションはすべての Web アプリケーションを、最初のパラメータの <WEB_APP_SERVER>
で指定された Web アプリケーションサーバにデプロイします。
4.6.1 構文
4.6.1.1
WDeploy サーバ名
WDeploy では、サーバ名を、コマンドラインで使用したり、サーバ設定ファイルのファイル名の一部として使用します。 サーバ
名は、WDeploy ツールを実行するときにコマンドラインで指定する最初のパラメータです。
wdeploy.bat <WEB_APP_SERVER> [-D<PROPERTY>=<value>] <ACTION>
<WEB_APP_SERVER> は、Web サーバまたは Web アプリケーションサーバの名前です。 指定する名前は、
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥config 内の設定ファイルの名
前と一致する必要があります。
<WEB_APP_SERVER> で使用可能な名前のすべてのリストについては、WEB_APP_SERVER の値 [46 ページ] を参照し
てください。
4.6.1.2
WDeploy プロパティのパラメータ
WDeploy プロパティは、コマンドラインで -D<PROPERTY> スイッチパラメータを使用して設定できます。各プロパティに対して
-D<PROPERTY> スイッチパラメータを繰り返し設定します。
たとえば、次のコマンドでは、-D<PROPERTY> スイッチパラメータを複数呼び出すことによって、Tomcat 8 Web アプリケーシ
ョンサーバの複数のプロパティ (as_dir、as_instance、as_service_name、および APP) を設定します。
wdeploy.bat Tomcat8
-Das_dir=C:¥Tomcat8
-Das_instance=localhost
-Das_service_name=Tomcat8
-DAPP=BOE
deployonly
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
37
プロパティは、wdeploy.config 設定ファイルで設定することもできます。これによってプロパティのデフォルトを設定するこ
とができ、必要に応じてコマンドラインの設定を優先させることができます。wdeploy.conf 設定ファイルの詳細について
は、WDeploy 設定ファイル [30 ページ]を参照してください。
次の表に、WDeploy のすべてのプロパティの一覧を示します。
表 12: WDeploy のプロパティ
プロパティ
APP
説明
サンプル値
デプロイする Web アプリケーションの名前。WAR または EAR のフ
BOE
ァイル名および Web アプリケーションプロパティファイルにおいて次
のようになります。
<BIP_INSTALL_DIR>SAP BusinessObjects
Enterprise XI 4.0¥wdeploy¥conf¥apps
¥<WEB_APP>.properties
このプロパティは、個々の Web プリケーションを wdeploy
predeploy コマンド、wdeploy deploy コマンド、または
wdeploy deployonly コマンドなどで操作する場合に使用し
ます。
app_source_dir
app_source_tree
個々の Web アプリケーションのソースファイルの場所。
<BIP_INSTALL_DIR>
このプロパティは、個々の Web プリケーションを wdeploy
¥SAP BusinessObjects
predeploy コマンド、wdeploy deploy コマンド、または
Enterprise XI
wdeploy deployonly コマンドなどで操作する場合に使用し
4.0¥wdeploy¥warfiles
ます。
¥webapps¥<WEB_APP>
すべての使用可能な Web アプリケーションのソースファイルの場所
<BIP_INSTALL_DIR>
(app_source_dir の親フォルダ)。
¥SAP BusinessObjects
このプロパティは、すべての使用可能な Web アプリケーションを
Enterprise XI
wdeploy predeployall コマンド、wdeploy
4.0¥wdeploy¥warfiles
deployall コマンド、または wdeploy deployonlyall コ ¥webapps
マンドなどで同時に操作する場合に使用します。
as_admin_is_secure
Web アプリケーションのデプロイメント時に SSL 暗号化を使用する
false(デフォルト)
Web アプリケーションサーバの場合、WebSphere など。
true
注記
この値を true に設定するには、管理者のアカウント名とパスワー
ドの指定も必要となります。
as_admin_password
Web アプリケーションサーバ管理アカウントのパスワード。
password
as_admin_port
Web アプリケーションサーバ管理アクセスに必要なポート番号。
8080
as_admin_username
Web アプリケーションサーバ管理アカウントのユーザ名。
administrator
as_dir
Web アプリケーションサーバのインストールディレクトリ。
C:¥tomcat8
38
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
プロパティ
説明
サンプル値
as_domain_dir
Web アプリケーションサーバのインストールディレクトリ。
C:¥BEA¥Weblogic
WebLogic アプリケーションサーバの場合、as_domain_dir は
ドメインルートになります。
as_instance
すべてのアプリケーションサーバで必須です。
localhost
Web アプリケーションサーバインスタンスの名前。
as_lang
WDeploy ユーザインタフェースの優先言語です。
●
チェコ語: CS
●
デンマーク語: DA
●
オランダ語: NL
●
英語: EN
●
フィンランド語: FI
●
フランス語: FR
●
ドイツ語: DE
●
ハンガリー語: HU
●
イタリア語: IT
●
日本語: JA
●
韓国語: KO
●
ノルウェー語 (ブークモー
ル): NB
as_mode
●
ポーランド語: PL
●
ポルトガル語: PT
●
ルーマニア語: RO
●
ロシア語: RU
●
簡体字中国語: zh_CN
●
スロバキア語: SK
●
スペイン語: ES
●
スウェーデン語: SV
●
タイ語: TH
●
繁体字中国語: zh_TW
●
トルコ語: TR
Web アプリケーションデプロイメントの種類。
standalone
スタンドアロンは、静的 Web コンテンツと動的 Web コンテンツの両
split
方を処理する Web アプリケーションサーバです。分割デプロイメント
では、専用の Web サーバを静的コンテンツ用サービスとして、Web
アプリケーションサーバを動的コンテンツ用サービスとして使用しま
す。
as_service_key
Windows で実行中の Tomcat で使用します。
サービスとしてインストールされている場合は、JVM の起動パラメー
タが保存されている Windows レジストリキーの名前。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
HKLM¥SOFTWARE¥Apache
Software Foundation
¥Procrun
2.0¥<AS_SERVICE_NAME
>¥Parameters¥Java
CUSTOMER (顧客)
39
プロパティ
説明
サンプル値
as_service_key_value Windows で実行中の Tomcat で使用します。
サービスとしてインストールされている場合は、JVM の起動パラメー
タが保存されている Windows レジストリキーの値。
as_service_name
Tomcat8
Windows で実行中の Tomcat で使用します。
Tomcat サービスの名前。
as_sid
ターゲットインスタンスのシステム ID。
AS1
as_soap_port
WebSphere では必須です。SOAP アプリケーションサーバ管理のた 8880
めのポート番号。この値を設定しなかった場合、デフォルトの SOAP
ポート番号が使用されます。
as_virtual_host
default_host
WebSphere でのみ使用します。
アプリケーションをバインドする必要のある仮想ホスト。
connector_type
分割モードで実行中の Web サーバの場合、Apache など。
tomcat8
connector_type は、Web サーバで使用される専用の Web ア
プリケーションサーバの名前に設定します。
deploy_as_a_filetree WebLogic Web アプリケーションサーバで使用します。
アプリケーションをファイルツリー(拡張書式)としてデプロイする必要
false (デフォルト)
true
があるか、パッケージ化された WAR ファイルまたは EAR ファイルと
してデプロイする必要があるかを示します。
deployment_dir
WDeploy によって、専用の Web サーバが処理する静的コンテンツ
を保存するサブディレクトリが作成されるディレクトリ。
C:¥apache2¥htdocs
WDeploy は、Web サーバ上に仮想ディレクトリを作成し、サブディレ
クトリを URL にマッピングします。
disable_CmcApp
true に設定すると、CMC Web アプリケーションが無効になりま
す。
false
true
disable_InfoView
true に設定すると、BI 起動パッド Web アプリケーションが無効に
なります。
false
true
enforce_file_limit
Web アプリケーションに 85,535 個を超えるファイルが含まれている
かどうかを WDeploy に伝えます。
デフォルトでは、WebSphere を除き、false に設定されています。
JCoStandalone
BI プラットフォームが SAP BW システムと統合されている場合に使
用します。
false (デフォルト)
true
false
true
SAP NetWeaver Web アプリケーションサーバコンポーネントにデプ
ロイする場合、false に設定します。
その他のアプリケーションサーバにデプロイする場合、true に設定
します。
40
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
プロパティ
説明
サンプル値
recent_app_svr
Web アプリケーションがデプロイされた最新の Web アプリケーション Tomcat8
サーバです。
root_context_path
すべての Web アプリケーションのデプロイ先となる、Web アプリケー /BOE
ションのルートコンテキストパスです。Web アプリケーションをルート
コンテキスト内のフォルダにデプロイするには、Web アプリケーション
の .properties 設定ファイル内の appvdir 設定を参照してく
ださい。
work_dir
WDeploy が Web アプリケーションの WAR アーカイブまたは EAR
アーカイブを操作するフォルダです (たとえば、Web アプリケーション
での静的コンテンツと動的コンテンツの分割)。このフォルダは
wdeploy predeploy アクションの結果を格納したり、Web ア
プリケーションを案デプロイするために必要なデータを格納したりしま
す。
ws_dir
分割モードで実行中の Web サーバの場合、Apache など。
<BIP_INSTALL_DIR>
¥SAP BusinessObjects
Enterprise XI
4.0¥wdeploy¥workdir
C:¥apache2
Web サーバホームディレクトリ。
ws_instance
WebSphere でのみ使用します。
webserver1
分割モードの、アプリケーションがインストールされている Web サー
バの名前。
ws_type
分割モードで実行中の Web サーバの場合、Apache など。
apache
Web サーバの名前。<BIP_INSTALL_DIR>¥SAP
BusinessObjects Enterprise XI 4.0¥wdeploy
¥conf¥config.<WEB_SERVER> ファイルのようになります。
注記
Apache、IBM HTTP Server はいずれも、ws_type として
apache を保持します。
war_dir
デプロイする WAR または EAR アーカイブの場所、または、ジェネリ
ック WAR ファイルを作成するためのターゲットとなる出力先。
4.6.1.2.1
C:¥myGenericWarFiles
分割 Web Tier のデプロイメントに使用する必須プロパティ
のパラメータ
一部のプロパティは分割 Web Tier デプロイメント (Web サーバと Web アプリケーションを分割する) に必要となります。分割
Web 層デプロイメントにデプロイする場合、次のプロパティのパラメータを、コマンドラインで指定するか、Web サーバまたは
Web アプリケーションサーバの設定ファイル (config.<WEB_APP_SERVER>) に指定します。
● -Das_mode=split プロパティを設定して、Web サーバの静的コンテンツと Web アプリケーションサーバの動的コンテ
ンツを分割します。
● -Dconnector_type=<CONNECTOR_TYPE> プロパティを、適切なコネクタの種類に設定します。connector_type
は、Web サーバで使用される専用の Web アプリケーションサーバの名前に設定します。たとえば、Apache Web サー
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
41
バと Tomcat 8 Web アプリケーションサーバを使用している場合は、connector_type を tomcat8 に設定する必要
があります。
● Web サーバと Web アプリケーションサーバが同じホスト上で実行されるデプロイメントでは、Dws_type=<WEB_SERVER_TYPE> プロパティおよび -Dws_dir=<WEB_SERVER_DIR> プロパティを指定する必要
があります。
4.6.1.3
WDeploy アクション
WDeploy コマンドの最後のパラメータには、実行するアクションを指定します。 次の節では、各有効なアクションと、各アクシ
ョンで実行される内容を定義します。
表 13: WDeploy アクション
アクション
説明
predeploy
wdeploy predeploy コマンドは、ターゲットの Web アプリケーションサーバにデプロイできるように
Web アプリケーションを準備します。
Web アプリケーションの web.xml 設定ファイルが、Web アプリケーションをターゲットの Web アプリケ
ーションサーバにデプロするために必要な他の変更とともに更新されます。
設定が完了すると、Web アプリケーションが WAR ファイルまたは EAR ファイルにパッケージ化され、
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥workdir¥<WEB_APP_SERVER> に保存されます。
このファイルは、Web アプリケーションサーバの管理コンソールから手動でデプロイすることも、
wdeploy deploy コマンドを使用してデプロイすることもできます。
wdeploy predeploy を使用して BOE Web アプリケーションを準備することにより、特定の Web ア
プリケーションサーバにデプロイできるようになります。 次はその例です。
wdeploy.bat <WEB_APP_SERVER>
-DAPP=BOE
predeploy
42
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
アクション
predeployall
説明
wdeploy predeployall コマンドは、次の BI プラットフォーム Web アプリケーションソースディレ
クトリにあるすべての Web アプリケーションに対して wdeploy predeploy コマンドを実行します。
<BIP_INSTALL_DIR>SAP BusinessObjects Enterprise XI 4.0¥warfiles
¥webapps
wdeploy predeployall コマンドを使用して、wdeploy predeploy コマンドをすべての
Web アプリケーションに適用します。 次はその例です。
wdeploy.bat <WEB_APP_SERVER> predeployall
注記
WebSphere 以外の Web アプリケーションサーバでは、事前デプロイメントなしで Web アプリケーショ
ンサーバにアクセスできます。 WebSphere にデプロイする場合は、default_virtual_host
パラメータが必須です。
deploy
wdeploy deploy コマンドは、wdeploy predeploy コマンドと wdeploy deployonly コ
マンドを連結したもので、このコマンド 1 つで Web アプリケーションを準備し、ターゲットの Web アプリケ
ーションサーバにデプロイします。
wdeploy deploy を使用して、BOE Web アプリケーションを準備し、ターゲットの Web アプリケーシ
ョンサーバにデプロイします。
wdeploy.bat <WEB_APP_SERVER>
-DAPP=BOE
deploy
deployall
wdeploy deployall コマンドは、次の BI プラットフォーム Web アプリケーションソースディレクトリ
にあるすべての Web アプリケーションに対して wdeploy deploy コマンドを実行します。
<BIP_INSTALL_DIR>SAP BusinessObjects Enterprise XI 4.0¥warfiles
¥webapps
wdeploy deployall を使用して、wdeploy deploy コマンドをすべての Web アプリケーショ
ンに適用します。 次はその例です。
wdeploy.bat <WEB_APP_SERVER> deployall
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
43
アクション
deployonly
説明
wdeploy deployonly コマンドは、準備した Web アプリケーションをターゲットの Web アプリケー
ションサーバにデプロイします。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥workdir¥<WEB_APP_SERVER> にあるデプロイ可能な WAR ファイルまたは EAR ファイルが、
Web アプリケーションサーバのコマンドラインインタフェースを呼び出す wdeploy deployonly コマ
ンドによって Web アプリケーションサーバにデプロイされます。
Web アプリケーションをデプロイする準備が整っていない場合は、wdeploy predeploy コマンドが
自動的に呼び出されます。
wdeploy deployonly を使用して、準備した BOE Web アプリケーションを Web アプリケーション
サーバにデプロイします。 次はその例です。
wdeploy.bat <WEB_APP_SERVER>
-DAPP=BOE
deployonly
deployonlyall
wdeploy deployonlyall コマンドは、準備したすべての Web アプリケーションに対して
wdeploy deployonly コマンドを実行します。
wdeploy deployonlyall コマンドを使用して、wdeploy deployonlyonly コマンドを準
備したすべての Web アプリケーションに適用します。 次はその例です。
wdeploy.bat <WEB_APP_SERVER> deployonlyall
buildwarall
Web アプリケーションソースツリーからジェネリック WAR ファイルを作成します。 次はその例です。
wdeploy.bat buildwarall
-Dapp_source_tree=<LOCATION_OF_APP_SOURCE_TREE>
-Dwar_dir=<TARGET_LOCATION_OF_GENERIC_WAR_FILE>
listapps
Web アプリケーションサーバにデプロイできるすべての Web アプリケーションを一覧にします。 次はその
例です。
wdeploy.bat <WEB_APP_SERVER> listapps
listdeployedapps
Web アプリケーションサーバに現在デプロイされているすべての Web アプリケーションを一覧にします。
このアクションは、Web サーバまたは Web アプリケーションサーバのシステムでのみ実行できます。 次
はその例です。
wdeploy.bat <WEB_APP_SERVER> listdeployedapps
44
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
アクション
説明
undeploy
wdeploy undeploy コマンドは、ターゲットの Web アプリケーションサーバのコマンドラインインタフ
ェースを呼び出して、デプロイされている BI プラットフォーム Web アプリケーションをサーバから削除しま
す。
wdeploy undeploy コマンドを使用して、ターゲットの Web アプリケーションサーバから BOE Web
アプリケーションのデプロイメントを解除します。
wdeploy.bat <WEB_APP_SERVER>
-DAPP=BOE
undeploy
undeployall
wdeploy undeployall コマンドは、ターゲットの Web アプリケーションサーバにデプロイされたす
べての BI プラットフォーム Web アプリケーションに対して wdeploy undeploy コマンドを実行しま
す。 次はその例です。
wdeploy.bat <WEB_APP_SERVER> undeployall
validateconfig
サポートされている Web アプリケーションサーバの WDeploy 設定を確認し、正常にデプロイメントが行
われるようにします。 次はその例です。
wdeploy.bat <WEB_APP_SERVER> validateconfig
<WEB_APP_SERVER> は、Web アプリケーションサーバの名前に置き換えます。
4.6.1.4
WDeploy の一般コマンド
WDeploy の一般コマンドは、このツール自体および使用可能な Web アプリケーションサーバのデプロイに関する、高度な情
報を指定する場合に使用できます。サーバ名、プロパティ、またはアクションと一緒には使用しません。次の一般コマンドを使
用できます。
● wdeploy help: 使用可能な WDeploy コマンドラインの使用方法の概要を表示します。
● wdeploy listappservers: このバージョンの WDeploy でサポートされるすべての Java Web アプリケーションサ
ーバをリストします。
● wdeploy version: WDeploy ツール自体のバージョン番号を表示します。
● wdeploy buildwarall: Web アプリケーションソースツリーを使用して、一般的な WAR ファイルを生成します。
使用方法:
wdeploy.bat
buildwarall
-Dapp_source_tree=<LOCATION_OF_WEB_APP_SOURCE>
-Dwar_dir=<TARGET_LOCATION_OF_GENERIC_WAR_FILES>
例:
wdeploy.bat
buildwarall
-Dapp_source_tree="C:¥Program Files (x86)¥SAP BusinessObjects¥SAP
BusinessObjects Enterprise XI 4.0¥warfiles¥webapps"
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
45
-Dwar_dir="C:¥myGenericWarFiles"
4.6.2 WDeploy の使用例
この節には、サポートされている Web アプリケーションサーバ用の WDeploy コマンドの使用例が含まれています。
注意
WDeploy を使用する前に、WDeploy の設定ファイルが Web アプリケーションサーバに適切に設定されていることを確認
します。WDeploy 設定ファイル [30 ページ]を参照してください。使用している Web アプリケーションサーバに特化した重
要な情報の一覧については、特殊留意点 [58 ページ]を参照してください。
4.6.2.1
WEB_APP_SERVER の値
次の例では、以下の表に示すとおり、変数 <WEB_APP_SERVER> は、使用している Web アプリケーションサーバの名前に
置き換えます。
表 14:
Web アプリケーションサーバ
<WEB_APP_SERVER> の名前
JBoss 7.1
jboss7
SAP NetWeaver Technology Platform
sapappsvr73
Tomcat 7.0
tomcat7
Tomcat 8.0
tomcat8
WebLogic 11gR1
weblogic11
WebSphere 7.0
websphere7
WebSphere 8.5 または 8.5.5
websphere8
4.6.2.2
wdeploy predeploy
wdeploy predeploy コマンドは、ターゲットの Web アプリケーションサーバにデプロイできるように Web アプリケーション
を準備します。
Web アプリケーションの内部にある web.xml 設定ファイルが、Web アプリケーションをターゲットの Web アプリケーションサ
ーバにデプロイするために必要な他の変更とともに、WDeploy によって設定されます。
設定が完了すると、Web アプリケーションが WAR ファイルまたは EAR ファイルにパッケージ化され、
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥workdir
¥<WEB_APP_SERVER> に保存されます。
46
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
結果の WAR ファイルまたは EAR ファイルは、Web アプリケーションサーバの管理コンソールから手動でデプロイすること
も、wdeploy deploy コマンドを使用してデプロイすることもできます。
例
たとえば、wdeploy predeploy を使用して、BOE Web アプリケーションを準備することにより、特定の Web アプリケー
ションサーバにデプロイできるようになります。
wdeploy.bat <WEB_APP_SERVER>
-DAPP=BOE
predeploy
以下の表に示すとおり、<WEB_APP_SERVER> に Web アプリケーションサーバ名を代入します。
以下の表は、BOE Web アプリケーションを特定の Web アプリケーションサーバに事前にデプロイするためのパラメータの
例です。設定ファイルでオプションとしてマーク付けされていない限り、すべてのパラメータを指定する必要があります。コマ
ンドラインで指定されたパラメータは、設定ファイルに保存されているパラメータよりも優先されます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することをお勧めし
ます。
表 15:
サーバ
JBoss 7.1 (jboss7)
SAP Technology
(sapappsvr73)
Tomcat 7.0 (tomcat7)
Tomcat 8.0 (tomcat8)
WebLogic 11gR1
(weblogic11)
WebSphere 7.0 (websphere7)
パラメータ
wdeploy.bat jboss7
-DAPP=BOE
predeploy
wdeploy.bat sapappsvr73
-DAPP=BOE
predeploy
wdeploy.bat tomcat7
-DAPP=BOE
predeploy
wdeploy.bat tomcat8
-DAPP=BOE
predeploy
wdeploy.bat weblogic11
-DAPP=BOE
predeploy
wdeploy.bat websphere7
-Das_virtual_host=default_host
-DAPP=BOE
predeploy
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
47
サーバ
パラメータ
WebSphere 8.5 または 8.5.5
(websphere8)
4.6.2.3
wdeploy.bat websphere8
-Das_virtual_host=default_host
-DAPP=BOE
predeploy
wdeploy predeployall
wdeploy predeployall コマンドは、BI プラットフォーム Web アプリケーションソースディレクトリにあるすべての Web ア
プリケーションに対して wdeploy predeploy コマンドを実行します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps
例
たとえば、wdeploy predeployall を使用して、wdeploy predeploy コマンドをすべての Web アプリケーションに
適用します。
wdeploy.bat <WEB_APP_SERVER> predeployall
以下の表に示すとおり、<WEB_APP_SERVER> に Web アプリケーションサーバ名を代入します。
以下の表は、すべての Web アプリケーションを特定の Web アプリケーションサーバに事前にデプロイするためのパラメ
ータの例です。設定ファイルでオプションとしてマーク付けされていない限り、すべてのパラメータを指定する必要がありま
す。コマンドラインで指定されたパラメータは、設定ファイルに保存されているパラメータよりも優先されます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することをお勧めし
ます。
表 16:
サーバ
JBoss 7.1 (jboss7)
SAP Technology
(sapappsvr73)
Tomcat 7.0 (tomcat7)
Tomcat 8.0 (tomcat8)
48
CUSTOMER (顧客)
パラメータ
wdeploy.bat jboss7
predeployall
wdeploy.bat sapappsvr73
predeployall
wdeploy.bat tomcat7
predeployall
wdeploy.bat tomcat8
predeployall
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
サーバ
パラメータ
WebLogic 11gR1
(weblogic11)
wdeploy.bat weblogic11
predeployall
WebSphere 7.0 (websphere7)
WebSphere 8.5 および 8.5.5
(websphere8)
4.6.2.4
wdeploy.bat websphere7
-Das_virtual_host=default_host
predeployall
wdeploy.bat websphere8
-Das_virtual_host=default_host
predeployall
wdeploy deployonly
wdeploy deployonly コマンドは、準備した Web アプリケーションをターゲットの Web アプリケーションサーバにデプロイ
します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥workdir
¥<WEB_APP_SERVER> にあるデプロイ可能な WAR ファイルまたは EAR ファイルが、Web アプリケーションサーバのコマン
ドラインインタフェースを呼び出す wdeploy deployonly コマンドによって Web アプリケーションサーバにデプロイされま
す。
Web アプリケーションをデプロイする準備が整っていない場合は、wdeploy predeploy コマンドが自動的に呼び出されま
す。
例
たとえば、wdeploy deployonly を使用して、準備した BOE Web アプリケーションを Web アプリケーションサーバに
デプロイします。
wdeploy.bat <WEB_APP_SERVER>
-DAPP=BOE
deployonly
以下の表に示すとおり、<WEB_APP_SERVER> に Web アプリケーションサーバ名を代入します。
以下の表は、BOE Web アプリケーションを特定の Web アプリケーションサーバにデプロイするためのパラメータの例で
す。設定ファイルでオプションとしてマーク付けされていない限り、すべてのパラメータを指定する必要があります。コマンド
ラインで指定されたパラメータは、設定ファイルに保存されているパラメータよりも優先されます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することをお勧めし
ます。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
49
表 17:
サーバ
JBoss 7.1 (jboss7)
パラメータ
wdeploy deployonly コマンドは JBoss 7.1 をサポートしていません。WDeploy ツールの
wdeploy predeploy または wdeploy predeployall コマンドを使用して WAR フ
ァイルを作成し、JBoss コマンドラインインタフェース (CLI) またはファイルシステムデプロイメント
スキャナを使用して手動でデプロイする必要があります。
SAP NetWeaver Technology
Platform(sapappsvr73)
wdeploy deployonly コマンドは SAP NetWeaver Technology Platform をサポートして
いません。WDeploy ツールの wdeploy predeploy コマンドまたは wdeploy
predeployall コマンドを使用して SCA ファイルを作成し、SAP Software Update
Manager (SUM) を使用して手動でデプロイする必要があります。
Tomcat 7.0 (tomcat7)
Tomcat 8.0 (tomcat8)
WebLogic 11gR1
(weblogic11)
WebSphere 7.0 (websphere7)
WebSphere 8.5 または 8.5.5
(websphere8)
50
CUSTOMER (顧客)
wdeploy.bat tomcat7
-Das_dir=C:¥Tomcat7
-Das_instance=localhost
-Das_service_name=Tomcat7
-DAPP=BOE
deployonly
wdeploy.bat tomcat8
-Das_dir=C:¥Tomcat8
-Das_instance=localhost
-Das_service_name=Tomcat8
-DAPP=BOE
deployonly
wdeploy.bat weblogic11
-Das_domain_dir=C:¥bea¥user_projects¥domains
¥base_domain
-Das_admin_port=7001
-Das_instance=AdminServer
-Das_admin_username=weblogic
-Das_admin_password=weblogic
-DAPP=BOE
deployonly
wdeploy.bat websphere7
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
-DAPP=BOE
deployonly
wdeploy.bat websphere8
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
-DAPP=BOE
deployonly
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
4.6.2.5
wdeploy deployonlyall
wdeploy deployonlyall コマンドは、準備したすべての Web アプリケーションに対して wdeploy deployonly コマ
ンドを実行します。
例
たとえば、wdeploy deployonlyall を使用して、wdeploy deployonly コマンドを準備したすべての Web アプリ
ケーションに適用します。
wdeploy.bat <WEB_APP_SERVER> deployonlyall
以下の表に示すとおり、<WEB_APP_SERVER> に Web アプリケーションサーバ名を代入します。
以下の表に、すべての Web アプリケーションを特定の Web アプリケーションサーバにデプロイするためのパラメータの例
を示します。設定ファイルでオプションとしてマーク付けされていない限り、すべてのパラメータを指定する必要があります。
コマンドラインで指定されたパラメータは、設定ファイルに保存されているパラメータよりも優先されます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することをお勧めし
ます。
表 18:
サーバ
JBoss 7.1 (jboss7)
パラメータ
wdeploy deployonlyall コマンドは JBoss 7.1 をサポートしていません。WDeploy ツー
ルの wdeploy predeploy または wdeploy predeployall コマンドを使用して
WAR ファイルを作成し、JBoss コマンドラインインタフェース (CLI) またはファイルシステムデプロ
イメントスキャナを使用して手動でデプロイする必要があります。
SAP Technology
(sapappsvr73)
wdeploy deployonlyall コマンドは SAP technology をサポートしていません。
WDeploy ツールの wdeploy predeploy コマンドまたは wdeploy predeployall
コマンドを使用して SCA ファイルを作成し、SAP Software Update Manager (SUM) を使用して
手動でデプロイする必要があります。
Tomcat 7.0 (tomcat7)
Tomcat 8.0 (tomcat8)
wdeploy.bat tomcat7
-Das_dir=C:¥Tomcat7
-Das_instance=localhost
-Das_service_name=Tomcat7
deployonlyall
wdeploy.bat tomcat8
-Das_dir=C:¥Tomcat8
-Das_instance=localhost
-Das_service_name=Tomcat8
deployonlyall
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
51
サーバ
パラメータ
WebLogic 11gR1
(weblogic11)
wdeploy.bat weblogic11
-Das_domain_dir=C:¥bea¥user_projects¥domains
¥base_domain
-Das_admin_port=7001
-Das_instance=AdminServer
-Das_admin_username=weblogic
-Das_admin_password=weblogic
deployonlyall
WebSphere 7.0 (websphere7)
WebSphere 8.5 または 8.5.5
(websphere8)
4.6.2.6
wdeploy.bat websphere7
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
deployonlyall
wdeploy.bat websphere8
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
deployonlyall
wdeploy deploy
wdeploy deploy コマンドは、wdeploy predeploy コマンドと wdeploy deployonly コマンドを連結したもので、こ
のコマンド 1 つで Web アプリケーションを準備し、ターゲットの Web アプリケーションサーバにデプロイします。
例
たとえば、wdeploy deploy を使用して、BOE Web アプリケーションを準備し、ターゲットの Web アプリケーションサー
バにデプロイします。
wdeploy.bat <WEB_APP_SERVER>
-DAPP=BOE
deploy
以下の表に示すとおり、<WEB_APP_SERVER> に Web アプリケーションサーバ名を代入します。
以下の表は、BOE Web アプリケーションを特定の Web アプリケーションサーバにデプロイするためのパラメータの例で
す。設定ファイルでオプションとしてマーク付けされていない限り、すべてのパラメータを指定する必要があります。コマンド
ラインで指定されたパラメータは、設定ファイルに保存されているパラメータよりも優先されます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することをお勧めし
ます。
52
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
表 19:
サーバ
JBoss 7.1 (jboss7)
パラメータ
wdeploy deploy コマンドは JBoss 7.1 をサポートしていません。WDeploy ツールの
wdeploy predeploy または wdeploy predeployall コマンドを使用して WAR フ
ァイルを作成し、JBoss コマンドラインインタフェース (CLI) またはファイルシステムデプロイメント
スキャナを使用して手動でデプロイする必要があります。
SAP Technology AS Java
(sapappsvr73)
wdeploy deploy コマンドは SAP technology AS Java をサポートしていません。WDeploy
ツールの wdeploy predeploy コマンドまたは wdeploy predeployall コマンドを
使用して SCA ファイルを作成し、SAP Software Update Manager (SUM) を使用して手動でデ
プロイする必要があります。
Tomcat 7.0 (tomcat7)
Tomcat 8.0 (tomcat8)
WebLogic 11gR1
(weblogic11)
WebSphere 7.0 (websphere7)
WebSphere 8.5 または 8.5.5
(websphere8)
wdeploy.bat tomcat7
-Das_dir=C:¥Tomcat7
-Das_instance=localhost
-Das_service_name=Tomcat7
-DAPP=BOE
deploy
wdeploy.bat tomcat8
-Das_dir=C:¥Tomcat8
-Das_instance=localhost
-Das_service_name=Tomcat8
-DAPP=BOE
deploy
wdeploy.bat weblogic11
-Das_domain_dir=C:¥bea¥user_projects¥domains
¥base_domain
-Das_admin_port=7001
-Das_instance=AdminServer
-Das_admin_username=weblogic
-Das_admin_password=weblogic
-DAPP=BOE
deploy
wdeploy.bat websphere7
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
-DAPP=BOE
deploy
wdeploy.bat websphere8
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
-DAPP=BOE
deploy
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
53
4.6.2.7
wdeploy deployall
wdeploy deployall コマンドは、BI プラットフォーム Web アプリケーションソースディレクトリにあるすべての Web アプリ
ケーションに対して wdeploy deploy コマンドを実行します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps
例
たとえば、wdeploy deployall を使用して、wdeploy deploy コマンドをすべての Web アプリケーションに適用しま
す。
wdeploy.bat <WEB_APP_SERVER> deployall
以下の表に示すとおり、<WEB_APP_SERVER> に Web アプリケーションサーバ名を代入します。
以下の表に、すべての Web アプリケーションを特定の Web アプリケーションサーバにデプロイするためのパラメータの例
を示します。設定ファイルでオプションとしてマーク付けされていない限り、すべてのパラメータを指定する必要があります。
コマンドラインで指定されたパラメータは、設定ファイルに保存されているパラメータよりも優先されます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することをお勧めし
ます。
表 20:
サーバ
JBoss 7.1 (jboss7)
パラメータ
wdeploy deployall コマンドは JBoss 7.1 をサポートしていません。WDeploy ツールの
wdeploy predeploy または wdeploy predeployall コマンドを使用して WAR フ
ァイルを作成し、JBoss コマンドラインインタフェース (CLI) またはファイルシステムデプロイメント
スキャナを使用して手動でデプロイする必要があります。
SAP Netweaver Technology
Platform (sapappsvr73)
wdeploy deployall コマンドは SAP Netweaver technology platform をサポートしてい
ません。WDeploy ツールの wdeploy predeploy コマンドまたは wdeploy
predeployall コマンドを使用して SCA ファイルを作成し、SAP Software Update
Manager (SUM) を使用して手動でデプロイする必要があります。
Tomcat 7.0 (tomcat7)
Tomcat 8.0 (tomcat8)
54
CUSTOMER (顧客)
wdeploy.bat tomcat7
-Das_dir=C:¥Tomcat7
-Das_instance=localhost
-Das_service_name=Tomcat7
deployall
wdeploy.bat tomcat8
-Das_dir=C:¥Tomcat8
-Das_instance=localhost
-Das_service_name=Tomcat8
deployall
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
サーバ
パラメータ
WebLogic 11gR1
(weblogic11)
wdeploy.bat weblogic11
-Das_domain_dir=C:¥bea¥user_projects¥domains
¥base_domain
-Das_admin_port=7001
-Das_instance=AdminServer
-Das_admin_username=weblogic
-Das_admin_password=weblogic
deployall
WebSphere 7.0 (websphere7)
WebSphere 8.5 または 8.5.5
(websphere8)
4.6.2.8
wdeploy.bat websphere7
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
deployall
wdeploy.bat websphere8
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
deployall
wdeploy undeploy
wdeploy undeploy コマンドは、ターゲットの Web アプリケーションサーバのコマンドラインインタフェースを呼び出して、デ
プロイされている BI プラットフォーム Web アプリケーションをサーバから削除します。
例
たとえば、wdeploy undeploy コマンドを使用して、ターゲットの Web アプリケーションサーバから BOE Web アプリケ
ーションのデプロイメントを解除します。
wdeploy.bat <WEB_APP_SERVER>
-DAPP=BOE
undeploy
以下の表に示すとおり、<WEB_APP_SERVER> に Web アプリケーションサーバ名を代入します。
以下の表は、BOE Web アプリケーションを特定の Web アプリケーションサーバにアンデプロイするためのパラメータの例
です。設定ファイルでオプションとしてマーク付けされていない限り、すべてのパラメータを指定する必要があります。コマン
ドラインで指定されたパラメータは、設定ファイルに保存されているパラメータよりも優先されます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することをお勧めし
ます。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
55
表 21:
サーバ
JBoss 7.1 (jboss7)
SAP Netweaver Technology
Platform (sapappsvr73)
Tomcat 7.0 (tomcat7)
Tomcat 8.0 (tomcat8)
WebLogic 11gR1
(weblogic11)
WebSphere 7.0 (websphere7)
WebSphere 8.5 または 8.5.5
(websphere8)
56
CUSTOMER (顧客)
パラメータ
wdeploy undeploy コマンドは JBoss 7.1 をサポートしていません。
wdeploy undeploy コマンドは SAP Netweaver technology platform をサポートしていま
せん。
wdeploy.bat tomcat7
-Das_dir=C:¥Tomcat7
-Das_instance=localhost
-DAPP=BOE
-Das_service_name=Tomcat7
undeploy
wdeploy.bat tomcat8
-Das_dir=C:¥Tomcat8
-Das_instance=localhost
-DAPP=BOE
-Das_service_name=Tomcat8
undeploy
wdeploy.bat weblogic11
-Das_domain_dir=C:¥bea¥user_projects¥domains
¥base_domain
-Das_admin_port=7001
-Das_instance=AdminServer
-Das_admin_username=weblogic
-Das_admin_password=weblogic
-DAPP=BOE
undeploy
wdeploy.bat websphere7
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
-DAPP=BOE
undeploy
wdeploy.bat websphere8
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
-DAPP=BOE
undeploy
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
4.6.2.9
wdeploy undeployall
wdeploy undeployall コマンドは、ターゲットの Web アプリケーションサーバにデプロイされたすべての BI プラットフォ
ーム Web アプリケーションに対して wdeploy undeploy コマンドを実行します。
例
wdeploy.bat <WEB_APP_SERVER> undeployall
以下の表に示すとおり、<WEB_APP_SERVER> に Web アプリケーションサーバ名を代入します。
以下の表は、すべての Web アプリケーションを特定の Web アプリケーションサーバにアンデプロイするためのパラメータ
の例です。設定ファイルでオプションとしてマーク付けされていない限り、すべてのパラメータを指定する必要があります。
コマンドラインで指定されたパラメータは、設定ファイルに保存されているパラメータよりも優先されます。ただし、
config.<WEB_APP_SERVER> 設定ファイル内のパラメータをデプロイメントに合わせて適切に設定することをお勧めし
ます。
表 22:
サーバ
JBoss 7.1 (jboss7)
SAP Technology
(sapappsvr73)
Tomcat 7.0 (tomcat7)
Tomcat 8.0 (tomcat8)
WebLogic 11gR1
(weblogic11)
WebSphere 7.0 (websphere7)
パラメータ
wdeploy undeployall コマンドは JBoss 7.1 をサポートしていません。
wdeploy undeployall コマンドは SAP technology をサポートしていません。
wdeploy.bat tomcat7
-Das_dir=C:¥Tomcat7
-Das_instance=localhost
-Das_service_name=Tomcat7
undeployall
wdeploy.bat tomcat8
-Das_dir=C:¥Tomcat8
-Das_instance=localhost
-Das_service_name=Tomcat8
undeployall
wdeploy.bat weblogic11
-Das_domain_dir=C:¥bea¥user_projects¥domains
¥base_domain
-Das_admin_port=7001
-Das_instance=AdminServer
-Das_admin_username=weblogic
-Das_admin_password=weblogic
undeployall
wdeploy.bat websphere7
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
undeployall
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
57
サーバ
パラメータ
WebSphere 8.5 または 8.5.5
(websphere8)
wdeploy.bat websphere8
-Das_dir=C:¥IBM¥WebSphere¥AppServer
-Das_instance=server1
-Das_virtual_host=default_host
-Das_profile_name=AppSrv01
-Das_soap_port=8880
undeployall
4.6.3 特殊留意点
以下の節には、Web アプリケーションサーバへの Web アプリケーションのデプロイメントに関する重要な情報が含まれてい
ます。
4.6.3.1
4.6.3.1.1
SAP NetWeaver Technology Platform
SAP NetWeaver technology platform へのデプロイメン
トの要件
注記
SAP BusinessObjects Business Intelligence プラットフォーム Web アプリケーションがすでにサーバで稼動している場
合は、それらのアプリケーションのデプロイメントを解除してから続行する必要があります。
BI プラットフォーム Web アプリケーションを SAP NetWeaver Application Server コンポーネント (すべてのバージョン) にデ
プロイする前に、.html ファイルおよび .htm ファイルが圧縮されないようにする必要があります。 たとえば、SAP NetWeaver
AS コンポーネント 7.3 では次の手順を実行します。
1. SAP Administrator Portal にログオンします。
例: http://<servername>:50200/nwa
2. 以下に移動します。
設定
インフラストラクチャ
Java システムプロパティ
に移動します。
3. [サービス] タブで、[HTTP プロバイダサービス] を選択します。
4. 詳細で、常に圧縮および圧縮しないを次のように変更します。
○ 常に圧縮: このプロパティから *.htm,*.html,text/html を削除します。 このフィールドを空にすることはできま
せん。空にする場合は、スペースを入力してください。
○ 圧縮しない: このプロパティに *.htm,*.html,text/html を追加します。
58
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
表 23: 例
名前
デフォルトの計算済み値
常に圧縮
(空にする場合はスペースを入力)
圧縮しない
*.htm,*.html,text/html
5. 閉じる前に変更を保存します。
4.6.3.2
4.6.3.2.1
Tomcat
Apache Web サーバと Tomcat Web アプリケーションサ
ーバに個別にデプロイする
Web アプリケーションサーバの負荷を減らすためには、静的コンテンツを処理する専用 Web サーバを設定します。すべての
静的コンテンツは Web サーバで処理され、動的コンテンツは Web アプリケーションサーバで処理されます。次の手順で、
WDeploy ツールを使用して Web アプリケーションのリソースを静的コンテンツおよび動的コンテンツに分割し、そのコンテン
ツを適切にデプロイするための方法を示します。
1. Apache Web サーバを設定し、適切に稼働していることを確認します。Apache のデフォルトのテストページなどの Web
ページを読み込んで、Web サーバがコンテンツを正しく処理するか確認します。
Web ブラウザを開き、Web サーバの URL を入力します。例: http://apache.mycompany.com。
2. Tomcat Web アプリケーションサーバが正しく稼働していることを確認します。
Web ブラウザを開き、Web アプリケーションサーバの IP アドレスとホスト名、およびポート番号を入力します。例:
http://tomcat.mycompany.com:8080。
注記
BI プラットフォーム Web アプリケーションがサーバですでに稼働している場合は、それらのアプリケーションのデプロ
イメントを解除してから続行する必要があります。
3. Apache Tomcat コネクタを Tomcat の Web サイトからダウンロードします。Apache Tomcat コネクタを使用すると、
Apache Web サーバを Tomcat Web アプリケーションサーバに接続できるため、Apache は動的リソースのリクエストを
Tomcat に送信できます。
4. Apache Web サーバと Tomcat Web アプリケーションサーバ間のブリッジの設定については、Apache の Web サイト
に記載されているプラグインの設定手順に従ってください。
動的リソースのリクエストは、Apache が受信すると、Tomcat に転送されます。
5. Web サーバと Web アプリケーションサーバ間のブリッジが稼働していることを確認します。これを行うには、ブラウザが
Web サーバを指し示すようにし、Web アプリケーションサーバからの動的コンテンツが正しく処理されていることを確認し
ます。
次の例の URL にアクセスします。http://apache.mycompany.com/jsp-examples/。
注記
この例の URL は、手動で jsp-examples Web アプリケーションをデプロイしている場合にのみ機能します。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
59
6. Web アプリケーションサーバが BI プラットフォームと同じマシンにインストールされている場合は、WDeploy をそのマシ
ンでローカルに実行します。Web アプリケーションサーバが別のマシンで実行されている場合は、WDeploy コマンドと環
境を Web アプリケーションサーバにコピーします。Web アプリケーションをリモートマシンにデプロイするを参照してくださ
い。
7. Web サーバと Web アプリケーションサーバにコンテンツが分割されるように WDepoly 環境を設定します。これは "分
割" モードと呼ばれます。
Apache および Tomcat の WDeploy 設定ファイルは <BIP_INSTALL_DIR>¥SAP BusinessObjects
Enterprise XI 4.0¥wdeploy¥conf に保存されています。
○ Tomcat の WDeploy 設定ファイルを編集します。たとえば、Tomcat 8.0 の場合、config.tomcat8 ファイルは
次のようになります。
as_dir=C:¥Appserver¥Tomcat
as_instance=localhost
as_service_name=tomcat8
as_service_key=HKLM¥SOFTWARE¥Apache Software Foundation¥
Procrun 2.0¥tomcat8¥Parameters¥Java
as_service_key_value=Options
○ config.apache を編集します。例:
ws_dir=C:¥Webserver¥Apache224
connector_type=tomcat8
deployment_dir=C:¥Webserver¥Apache224¥htdocs
8. 分割モードで wdeploy predeploy を使用して、ソースの Web アプリケーションを静的ファイルと動的ファイルにそれ
ぞれ分割します。
例:
○ 次のコマンドを実行して、Apache Web サーバの静的コンテンツを抽出します。
wdeploy.bat tomcat8 -Das_mode=split
-Dws_type=apache predeployall
9. wdeploy deployonlyall コマンドを実行して、動的コンテンツを Tomcat アプリケーションサーバにデプロイし、静
的コンテンツを Apache にデプロイします。
Apache と Tomcat が同じマシン上にある場合、次のコマンドを実行すると、静的コンテンツと動的コンテンツは自動的に
サーバにデプロイされます。
wdeploy.bat tomcat8 -Das_mode=split
-Dws_type=apache deployonlyall
注記
動的コンテンツと静的コンテンツがカスタムの場所に保存されている場合は、-Dwork_dir パラメータを使用します。
Apache と Tomcat が別のマシンにある場合、次のコマンドを実行すると、動的コンテンツは自動的に Tomcat にデプロ
イされます。その後に、静的コンテンツをリモートの Apache マシンに手動でデプロイする必要があります。
wdeploy.bat tomcat8 -Das_mode=split
deployonlyall
60
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
注記
動的コンテンツと静的コンテンツがカスタムの場所に保存されている場合は、-Dwork_dir パラメータを使用します。
静的コンテンツを、Web サーバの htdocs ディレクトリにコピーします。
○ Web アプリケーションサーバの <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥workdir¥tomcat8¥resources に zip ファイルを解凍します。
○ これらのフォルダを、Tomcat Web アプリケーションサーバから Apache サーバの Apache <WS_DIR>¥htdocs
フォルダにコピーします。
○ bobj.<application>.conf ファイルを、Tomcat Web アプリケーションサーバから Apache サーバの
Apache <WS_DIR>¥conf フォルダにコピーします。
○ <WS_DIR>¥conf 内の Apache httpd.conf をアプリケーションの設定ファイルで更新します。Web アプリケーシ
ョンごとに、httpd.conf に 1 つのエントリを含めます。たとえば、BOE を含めるには、次のように入力します。
Include conf¥bobj.BOE.conf
静的コンテンツは専用の Web サーバで処理され、動的コンテンツは専用の Web アプリケーションサーバで処理されます。
4.6.3.2.2
Tomcat gzip 圧縮
BI プラットフォームの新しいインストールを実行して、バンドルされている Tomcat Web アプリケーションサーバの使用を選択
する場合は、Tomcat の HTTP gzip 圧縮が自動的に有効化されます。
gzip 圧縮は、Web アプリケーションサーバの応答時間と処理量を改善します。ただし、Tomcat Web アプリケーションサーバ
に Web アプリケーションをデプロイする予定がある場合、gzip 圧縮を有効化した Tomcat サーバへの Web アプリケーショ
ンのデプロイメントは、以前のバージョンの BI プラットフォームにバンドルされている Tomcat のバージョンに Web アプリケ
ーションをデプロイするために使用される手順とは異なる可能性があることに注意してください。
4.6.3.3
4.6.3.3.1
WebLogic
Apache Web サーバと WebLogic Web アプリケーション
サーバに個別にデプロイする
Web アプリケーションサーバの負荷を減らすためには、静的コンテンツを処理する専用 Web サーバを設定します。 すべての
静的コンテンツは Web サーバで処理され、動的コンテンツは Web アプリケーションサーバで処理されます。 次の手順で、
WDeploy ツールを使用して Web アプリケーションのリソースを静的コンテンツおよび動的コンテンツに分割し、そのコンテン
ツを適切にデプロイするための方法を示します。
1. Apache Web サーバを設定し、適切に稼動していることを確認します。 Apache のデフォルトのテストページなどの Web
ページを読み込んで、Web サーバがコンテンツを正しく処理するか確認します。
Web ブラウザを開いて、Web サーバの IP アドレスまたはホスト名、およびサーバがポート 80 で受信待機していない場
合はポート番号を入力します。例: http://apache.mycompany.com。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
61
2. WebLogic Web アプリケーションサーバが正しく稼動していることを確認します。
Web ブラウザを開き、Web アプリケーションサーバの IP アドレスとホスト名、およびポート番号を入力します。 例:
http://weblogic.mycompany.com:7001。
注記
BI プラットフォーム Web アプリケーションがサーバですでに稼動している場合は、それらのアプリケーションのデプロ
イメントを解除してから続行する必要があります。
3. WebLogic Apache HTTP サーバプラグインを BEA の Web サイトからダウンロードします。 このプラグインを使用する
と、Apache Web サーバを WebLogic Web アプリケーションサーバに接続できるため、Apache は動的リソースのリクエ
ストを WebLogic に送信できます。
4. Apache Web サーバと WebLogic 間のブリッジの設定については、BEA の Web サイトに記載されているプラグインの
設定手順に従ってください。
動的リソースのリクエストは、Apache が受信すると、WebLogic に転送されます。
5. Web サーバと Web アプリケーションサーバ間のブリッジが稼動していることを確認します。これを行うには、ブラウザが
Web サーバを指し示すようにし、Web アプリケーションサーバからの動的コンテンツが正しく処理されていることを確認し
ます。
次の例の URL にアクセスします。 http://apache.mycompany.com/jsp-examples/。
注記
この例の URL は、手動で jsp-examples Web アプリケーションをデプロイしている場合にのみ機能します。
6. Web アプリケーションサーバが BI プラットフォームと同じマシンにインストールされている場合は、WDeploy をそのマシ
ンでローカルに実行します。 Web アプリケーションサーバが別のマシンで実行されている場合は、WDeploy コマンドと環
境を Web アプリケーションサーバにコピーします。 Web アプリケーションをリモートマシンにデプロイするを参照してくだ
さい。
7. Web サーバと Web アプリケーションサーバにコンテンツが分割されるように WDepoly 環境を設定します。 これは "分
割" モードと呼ばれます。
Apache および WebLogic の WDeploy 設定ファイルは <BIP_INSTALL_DIR>¥SAP BusinessObjects
Enterprise XI 4.0¥wdeploy¥conf に保存されています。
○ config.weblogic11 を編集します。 例:
as_admin_port=7001
as_admin_username=weblogic
as_admin_password=weblogic
as_instance=AdminServer
as_domain_dir=C:¥bea¥user_projects¥domains¥base_domain
○ config.apache を編集します。 例:
ws_dir=C:¥Webserver¥Apache224
connector_type=weblogic11
deployment_dir=C:¥Webserver¥Apache224¥htdocs
8. 分割モードで wdeploy predeploy を使用して、ソースの Web アプリケーションを静的リソースと動的リソースにそれ
ぞれ分割します。
例:
62
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
○ 次のコマンドを実行して、Apache Web サーバの静的コンテンツと、WebLogic アプリケーションサーバの動的コン
テンツを抽出します。
wdeploy.bat weblogic11 -Das_mode=split
-Dws_type=apache predeployall
動的コンテンツは <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥workdir¥weblogic11¥application にあります。 静的コンテンツは <BIP_INSTALL_DIR>¥SAP
BusinessObjects Enterprise XI 4.0¥wdeploy¥workdir¥weblogic11¥resources にあります。
9. wdeploy deployonlyall を実行して、動的コンテンツを WebLogic アプリケーションサーバにデプロイし、静的コン
テンツを Apache にデプロイします。
Apache と WebLogic が同じマシン上にある場合、次のコマンドを実行すると、静的コンテンツと動的コンテンツは自動的
にサーバにデプロイされます。
wdeploy.bat weblogic11 -Das_mode=split
-Dws_type=apache deployonlyall
注記
動的コンテンツと静的コンテンツがカスタムの場所に保存されている場合は、-Dwork_dir パラメータを使用します。
Apache と WebLogic が別のマシンにある場合、次のコマンドを実行すると、動的コンテンツは自動的に WebLogic に
デプロイされます。 その後に、静的コンテンツをリモートの Apache マシンに手動でコピーしてデプロイする必要がありま
す。
wdeploy.bat weblogic11 -Das_mode=split
deployonlyall
注記
動的コンテンツと静的コンテンツがカスタムの場所に保存されている場合は、-Dwork_dir パラメータを使用します。
静的コンテンツを、Web サーバの htdocs ディレクトリにコピーします。
○ Web アプリケーションサーバの <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥workdir¥WebLogic11¥resources に zip ファイルを抽出します。
○ これらのフォルダを、WebLogic Web アプリケーションサーバから Apache サーバの Apache <WS_DIR>
¥htdocs フォルダにコピーします。
○ bobj.<application>.conf ファイルを、WebLogic Web アプリケーションサーバから Apache サーバの
Apache <WS_DIR>¥conf フォルダにコピーします。
○ <WS_DIR>¥conf 内の Apache httpd.conf をアプリケーションの設定ファイルで更新します。 Web アプリケー
ションごとに、httpd.conf に 1 つのエントリを含めます。 たとえば、BOE を含めるには、次のように入力します。
Include conf¥bobj.BOE.conf
静的コンテンツは専用の Web サーバで処理され、動的コンテンツは専用の Web アプリケーションサーバで処理されます。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
63
4.6.3.4
4.6.3.4.1
WebSphere
IHS Web サーバと WebSphere Web アプリケーションサ
ーバに個別にデプロイする
Web アプリケーションサーバの負荷を減らすためには、静的コンテンツを処理する専用 Web サーバを設定します。 すべての
静的コンテンツは Web サーバで処理され、動的コンテンツは Web アプリケーションサーバで処理されます。 次の手順で、
WDeploy ツールを使用して Web アプリケーションのリソースを静的コンテンツおよび動的コンテンツに分割し、そのコンテン
ツを適切にデプロイするための方法を示します。
1. IBM HTTP Server(IHS)Web サーバを設定し、適切に稼動していることを確認します。 IHS のデフォルトのテストページ
などの Web ページを読み込んで、Web サーバがコンテンツを正しく処理するか確認します。
Web ブラウザを開いて、Web サーバの IP アドレスまたはホスト名、およびサーバがポート 80 で受信待機していない場
合はポート番号を入力します。例: http://ihs.mycompany.com。
2. WebSphere Web アプリケーションサーバが正しく稼動していることを確認します。
Web ブラウザを開き、Web アプリケーションサーバの IP アドレスとホスト名、およびポート番号を入力します。 例:
http://websphere.mycompany.com:9080。
注記
BI プラットフォーム Web アプリケーションがサーバですでに稼動している場合は、それらのアプリケーションのデプロ
イメントを解除してから続行する必要があります。
3. Web サーバプラグインのインストールウィザードを実行して WebSphere を IHS にブリッジするプラグインをインストール
し、指示に従って IHS Web サーバの情報を入力します。
4. IHS と WebSphere 間のブリッジの設定については、WebSphere の Web サイトに記載されているプラグインの設定手
順に従ってください。
動的リソースのリクエストは、IHS が受信すると、WebSphere に転送されます。
5. Web サーバと Web アプリケーションサーバ間のブリッジが稼動していることを確認します。これを行うには、ブラウザが
Web サーバを指し示すようにし、Web アプリケーションサーバからの動的コンテンツが正しく処理されていることを確認し
ます。
次の例の URL にアクセスします。 http://ihs.mycompany.com/snoop/。
6. Web アプリケーションサーバが BI プラットフォームと同じマシンにインストールされている場合は、WDeploy をそのマシ
ンでローカルに実行します。 Web アプリケーションサーバが別のマシンで実行されている場合は、WDeploy コマンドと環
境を Web アプリケーションサーバにコピーします。 Web アプリケーションをリモートマシンにデプロイするを参照してくだ
さい。
7. Web サーバと Web アプリケーションサーバにコンテンツが分割されるように WDepoly 環境を設定します。 これは "分
割" モードと呼ばれます。
Apache および WebSphere の WDeploy 設定ファイルは <BIP_INSTALL_DIR>¥SAP BusinessObjects
Enterprise XI 4.0¥wdeploy¥conf に保存されています。
○ config.apache を編集します。 例:
ws_dir=C:¥Program Files¥Apache Software Foundation¥Apache 2.2
connector_type=websphere7
deployment_dir=C:¥Program Files¥Apache Software Foundation¥Apache 2.2¥htdocs
plugin_install_dir=${ws_dir}/Plugins
64
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
○ config.websphere7 を編集します。 例:
as_soap_port=8880
#as_admin_username=admin
#as_admin_password=password
as_dir=C:¥Program Files¥IBM¥WebSphere¥AppServer
as_instance=server1
as_plugin_cfg_dir=C:¥Program Files¥IBM¥WebSphere¥AppSever¥profiles
¥AppSrv01¥config¥cells¥<CELLNAME>¥nodes¥<NODENAME>¥servers¥${ws_instance}
as_profile_name=AppSrv01
as_virtual_host=default_host
as_admin_is_secure=false
enforce_file_limit=true
ws_instance=webserver1
8. 分割モードで wdeploy predeploy を使用して、ソースの Web アプリケーションを静的リソースと動的リソースにそれ
ぞれ分割します。
注記
wdeploy predeploy を実行する前に、config.websphere<X> のパラメータ as_plugin_cfg_dir が
WebSphere のファイル plugin-cfg.xml を含むフォルダに設定されていることを確認してください。
例:
○ 次のコマンドを実行して、IHS Web サーバの静的コンテンツを抽出します。
wdeploy.bat websphere7
-Das_mode=split
-Dws_type=apache
predeployall
Web アプリケーションの動的コンテンツは、 <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥workdir¥websphere7¥application にあります。 静的コンテンツは、 <BIP_INSTALL_DIR>
¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥workdir¥websphere7¥resources にありま
す。
9. wdeploy deployonlyall コマンドを実行して、動的コンテンツを WebSphere アプリケーションサーバにデプロイし、
静的コンテンツを IHS にデプロイします。
IHS と WebSphere が同じマシン上にある場合、次のコマンドを実行すると、静的コンテンツと動的コンテンツは自動的に
サーバにデプロイされます。
wdeploy.bat websphere7 -Das_mode=split
-Dws_type=apache deployonlyall
注記
動的コンテンツと静的コンテンツがカスタムの場所に保存されている場合は、-Dwork_dir パラメータを使用します。
IHS と WebSphere が別のマシンにある場合、次のコマンドを実行すると、動的コンテンツは自動的に WebSphere にデ
プロイされます。 その後に、静的コンテンツをリモートの IHS マシンに手動でデプロイする必要があります。
wdeploy.bat websphere7 -Das_mode=split
deployonlyall
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
65
注記
動的コンテンツと静的コンテンツがカスタムの場所に保存されている場合は、-Dwork_dir パラメータを使用します。
静的コンテンツを、Web サーバの htdocs ディレクトリにコピーします。
○ Web アプリケーションサーバの <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥workdir¥websphere7¥resources に zip ファイルを抽出します。
○ これらのフォルダを、WebSphere Web アプリケーションサーバから IHS サーバの IHS <WS_DIR>¥htdocs フォ
ルダにコピーします。
○ bobj.<application>.conf ファイルを、WebSphere Web アプリケーションサーバから IHS サーバの IHS
<WS_DIR>¥conf フォルダにコピーします。
○ <WS_DIR>¥conf 内の IHS httpd.conf をアプリケーションの設定ファイルで更新します。 Web アプリケーション
ごとに、httpd.conf に 1 つのエントリを含めます。 たとえば、BOE を含めるには、次のように入力します。
Include conf¥bobj.BOE.conf
10. plugin-cfg.xml ファイルを IHS 作業フォルダおよび WebSphere 作業フォルダにコピーします。 WebSphere 管理
コンソールを使用してデプロイし、IHS および WebSphere が同じホストシステムにインストールされている場合、次の手
順にスキップします。 IHS および WebSphere が同じホストシステムにインストールされると、WDeploy コマンドは自動
的に plugin-cfg.xml をコピーします。
たとえば、次のファイルをコピーします。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥work_dir
¥websphere7¥application¥PluginSplit¥plugin-cfg.xml
コピー先の WebSphere 作業フォルダ:
<WS_HOME>¥AppServer¥profiles¥AppSrv01¥config¥cells¥<CELL_NAME>¥nodes¥<NODE_NAME>
¥servers¥<SERVER_NAME>
コピー先の IHS 作業フォルダ:
<WS_DIR>¥Plugins¥config¥<WEB_SERVER_NAME>
11. Web サーバから Web アプリケーションにアクセスして、静的コンテンツと動的コンテンツの両方が正しく設定されている
ことを確認します。 たとえば、Web アプリケーションサーバにデプロイされている Web アプリケーションのルートコンテキ
ストを使用する Web サーバのアドレスを含む URL http://ihs.mycompany.com/BOE/CMC/ を作成します。 この
例では、ihs.mycompany.com が Web サーバで、/BOE/CMC/ がデプロイされる Web アプリケーションです。
静的コンテンツは専用の Web サーバで処理され、動的コンテンツは専用の Web アプリケーションサーバで処理されます。
4.6.3.4.2
アプリケーションクラスローダーで最初にクラスをロードする
WebSphere の [管理コンソール] を使用して、インストールされている Web アプリケーションのクラスロード動作を [最初にア
プリケーションクラスローダーでロードされたクラス (最後に親)] に設定する必要があります。JavaServer Faces (JSF) ライブ
ラリなど BI プラットフォームの Web アプリケーションにバンドルされている共通のクラスが WebSphere で提供されている実
装以外を使用していることを確認します。
管理者アカウントを使用して WebSphere Integrated Solutions Console にログインします。WebSphere 管理コンソール プ
ログラムを実行することも、Web ブラウザを使用して http://<WAS_HOSTNAME>:<PORT>/ibm/console
66
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
(<WAS_HOSTNAME> は WebSphere サーバの名前、<PORT> はサーバがログインリクエストを受信待機するポート番号) を
開くこともできます。デフォルトのポート番号は 9060 です。
1. メニューから、
アプリケーション
アプリケーションの種類
WebSphere エンタープライズアプリケーション を選択し
ます。
[エンタープライズアプリケーション]画面が表示されます。
2. WDeploy によってデプロイされた Web アプリケーションを、管理対象リソースの一覧から選択します。
[エンタープライズアプリケーション]設定画面が表示されます。
3. [モジュールの管理]をクリックします。
[モジュールの管理]画面が表示されます。
4. Web アプリケーションモジュール ([モジュール] 列内) を選択します。
[モジュールの一般プロパティの管理]画面が表示されます。
5. [クラスローダー順序] プロパティから [最初にアプリケーションクラスローダーでロードされたクラス (最後に親)] を選択し
ます。
確認メッセージが表示されます。
6. [マスタ設定に直接保存]をクリックします。
Web アプリケーション設定が保存され、[モジュールの管理]画面に戻ります。
7. [OK]をクリックします。
マスタ設定変更の確認メッセージが表示されます。
8. [マスタ設定に直接保存]をクリックします。
Web アプリケーション設定が保存され、[エンタープライズアプリケーション]画面に戻ります。
9. Web アプリケーションのチェックボックスをオンにして、[開始]をクリックします。
Web アプリケーションが正しく開始されたことを確認するメッセージが表示されます。
複数の Web アプリケーションをデプロイする場合は、Web アプリケーションごとに手順 2 ～ 9 を繰り返します。
4.6.4 Web アプリケーションサーバへのアクセスなしの分割 Web Tier
の事前デプロイ
WDeploy コマンドは、Web サーバおよび Web アプリケーションサーバにデプロイできるように静的コンテンツと動的コンテン
ツを分離します。Web アプリケーションサーバのデプロイメントフォルダにアクセスする必要はありません。WDeploy をホスト
しているサーバから、個別のコンテンツを手動で Web サーバおよび Web アプリケーションサーバにコピーできるからです。
WDeploy が専用の Web サーバにインストールされている場合は、wdeploy predeploy コマンドまたは wdeploy
predeployall コマンドを使用して、Web アプリケーションの静的コンテンツを直接 Web サーバのコンテンツディレクトリに
作成できます。特定の Web サーバまたは Web アプリケーションサーバで必須のパラメータを次に示します。
表 24:
Web サーバまたは Web アプリケ
プリデプロイメントに必要なパラメータ
ーションサーバ
WebSphere Application Server
as_virtual_host
Apache および IBM IHS
ws_dir、deployment_dir、connector_type
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
67
4.6.5 CMC または BI 起動パッドの Web アプリケーションを無効にする
セントラル管理コンソール (CMC) および BI 起動パッド (以前は InfoView) の Web アプリケーションは、現在 BOE アーカイ
ブ (BOE.war または BOE.ear) に含まれています。CMC または BI 起動パッドの Web アプリケーションを無効にし、BOE ア
ーカイブを Web アプリケーションサーバにデプロイするときにこのどちらかまたは両方の Web アプリケーションにアクセスで
きないようにするには、WDeploy ツールを使用します。
CMC Web アプリケーションを無効にするには、BOE.war を Web アプリケーションサーバにデプロイするときに Ddisable_CmcApp=true スイッチを使用します。たとえば、次のコマンドでは、BOE.war を Tomcat 8 Web アプリケーシ
ョンサーバにデプロイして CMC を無効にします。
wdeploy.bat tomcat8 -DAPP=BOE -Ddisable_CmcApp=true deploy
BI 起動パッド Web アプリケーションを無効にするには、BOE.war を Web アプリケーションサーバにデプロイするときに Ddisable_InfoView=true スイッチを挿入します。たとえば、次のコマンドでは、BOE.war を Tomcat 8 Web アプリケー
ションサーバにデプロイして BI 起動パッドを無効にします。
wdeploy.bat tomcat8 -DAPP=BOE -Ddisable_InfoView=true deploy
4.6.6 インストールされた言語の変更
Web アプリケーションの言語サポートを追加するには、BI プラットフォームを再インストールし、インストールプロセス時に必要
な言語を選択する必要があります。再インストールが完了したら、新しい言語が必要なデプロイ済みの Web アプリケーション
を Web アプリケーションサーバに再デプロイする必要があります。
これは、インストールプログラムでは Web アプリケーションが自動的に再デプロイされないためです。Web アプリケーションを
再度パッケージ化して Web アプリケーションサーバに再デプロイする必要があります。
4.7
WDeploy GUI ツールの使用
WDeploy GUI ツールは、BI プラットフォームの一部としてインストールされ、wdeploy deployall または wdeploy
undeployall コマンドを実行するグラフィカルな代替方法を提供します。
注記
● WDeploy GUI ツールではなく、WDeploy コマンドラインツールを使用することをお勧めします。 このコマンドラインツ
ールの機能のほうが強力です。
● WDeploy GUI ツールは、Web アプリケーションの事前デプロイには使用できません。 コマンドラインツールを使用し
て、wdeploy predeployall コマンドを実行してください。
WDeploy の要件についての詳細は、以下を参照してください。
● WDeploy の前提条件 [21 ページ]
他のデプロイメント操作を実行するには、コマンドラインバージョンの WDeploy を使用してください。
68
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
WDeploy GUI ツールでは、デフォルトで英語のインタフェースが使用されますが、言語パックがインストールされている場合
には、ツールの初回実行時に、ユーザが言語を選択できるプロンプトが表示されます。 BI プラットフォームでは、次の言語パ
ックがサポートされます。
● チェコ語
● 簡体字中国語
● 繁体字中国語
● デンマーク語
● オランダ語
● 英語
● フィンランド語
● フランス語
● ドイツ語
● ハンガリー語
● イタリア語
● 日本語
● 韓国語
● ノルウェー語 (ブークモール)
● ポーランド語
● ポルトガル語
● ルーマニア語
● ロシア語
● スロバキア語
● スペイン語
● スウェーデン語
● タイ語
● トルコ語
4.7.1 WDeploy GUI ツールの起動
スタート
ム
すべてのプログラム
WDeploy
SAP BusinessObjects BI プラットフォーム 4
SAP BusinessObjects BI プラットフォー
を選択して WDeploy GUI ツールを実行します。 <BIP_INSTALL_DIR>¥SAP BusinessObjects
Enterprise XI 4.0¥wdeploy¥wdeployGUI.bat を実行して起動することもできます。
WDeploy GUI ツールの初回実行時は、ユーザインタフェースに情報を表示する際に使用する言語の選択を求めるプロンプト
が表示されます。 言語を選択して続行します。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
69
4.7.2 WDeploy GUI ツールの画面
WDeploy GUI ツールを使用して、Web アプリケーションを Web アプリケーションサーバにデプロイ/デプロイ解除できます。
BI プラットフォームインストールプログラムまたは WDeploy ツールによってデプロイされなかった Web アプリケーションには
影響ありません。
[Web アプリケーションサーバタイプの選択] ドロップダウンリストからサポートされている Web アプリケーションサーバを選択
します。Web アプリケーションサーバを選択したら、[Web Application Server Information] セクションと [Application
Server Domain Root Directory] セクションの情報を参照して、使用している Web アプリケーションサーバに適切な設定か
確認してください。
詳細オプションについては、[オプション] を選択してください。
注記
すべての Web アプリケーションが自動的にデプロイされるわけではありません。自動的にデプロイされない Web アプリケ
ーションは、WDeploy コマンドラインツールまたは Web アプリケーションサーバ管理コンソールを使用してデプロイする必
要があります。
Web アプリケーションアーカイブ (WAR または EAR)
自動デプロイ
BOE
○
AdminTools
○
dswsbobje
○
BusinessProcessBI (廃止予定)
○
clientapi
×
MobileOTA14
×
jsfplatform
×
OpenSearch
×
4.7.3 WDeploy によって実行された Web アプリケーションの更新
表 25: WDeploy によって Web アプリケーション設定に加えられた変更
サーバ
変更内容
Apache Web サーバ
アプリケーションごとに ${ws_dir}/conf/bobj.${APP}.conf ファイルが作成されま
す。このファイルには、コネクタの設定、ディレクトリ、およびサーブレットマッピング情報が含まれま
す。このファイルを含めるために、${ws_dir}/conf/httpd.conf ファイルが変更されま
す。
70
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
サーバ
Tomcat
変更内容
classpath に追加されたファイルは、${as_dir}/shared/lib で削除されます。
${as_dir}/bin/bobjeEnv.${APP}.[sh|bat] ファイルが作成され、ライブラリパス
の変更、およびアプリケーションのプロパティを追加するための Java プロパティの変更が含まれま
す。
このファイルを含めるために、${as_dir}/bin/catalina.[sh|bat] ファイルが変更さ
れます。
Windows では、追加の Java プロパティが Tomcat サービス起動パラメータに追加されます。シ
ステム全体の PATH 環境変数に対してライブラリパスの変更を手動で行う必要があります。
変更を有効にするには、Tomcat を再起動します。
WebLogic
classpath に追加されたファイルはアプリケーション(WEB-INF/lib に追加されている)に
バンドルされます。
${as_domain_dir}/bin/bobjeEnv.${APP}.[sh|cmd] ファイルが作成され、ラ
イブラリパスおよび Java プロパティの変更が含まれます。
このファイルを含めるために、${as_domain_dir}/bin/startWebLogic.[sh|
cmd] ファイルが変更されます。
WebSphere
classpath に追加されたファイルはアプリケーション(WEB-INF/lib に追加されている)に
バンドルされます。
プロパティは、JVM カスタムプロパティとして追加されます。ライブラリパスの変更は、JVM の環境
を変更して行われます。Web サーバーのプラグインが自動的に再生成されます。
4.7.4 WDeploy GUI ツールのオプション
WDeploy GUI ツールの [オプション] 画面では、Web アプリケーションのデプロイメントに使用するカスタムフォルダを選択で
きます。これは、WDeploy コマンドラインを使用している際の、プロパティの設定に相当します。WDeploy パラメータについて
の詳細は、WDeploy プロパティのパラメータ [37 ページ]を参照してください。
● WDeploy 作業ディレクトリ (work_dir パラメータに該当)。
● Web アプリケーションソースツリーロケーション (app_source_tree パラメータに相当) または 汎用 WAR ファイルロ
ケーション (war_dir パラメータに相当)。
● Web アプリケーションルートコンテキスト (root_context_path パラメータに該当)。
注記
現行バージョンの WDeploy GUI ツールでは、英語以外の文字を含むパスは無効です。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
71
4.7.5 WDeploy GUI ファイルへのパスワードの追加
WDeploy GUI ツールはファイルに入力を保存し、入力した情報を使用して、Web アプリケーションをデプロイします。 セキュ
リティ上の理由から、パスワードは自動では記録されないため、GUI の実行時にパスワードを入力した場合でも、このファイル
にパスワードを手動で追加する必要があります。
Web アプリケーションサーバのパスワードを WDeploy GUI ファイルに追加するには、以下を行います。
1. 以下の WDeploy の情報を含むファイルを開きます。
<BOE_INSTALL_DIR>¥wdeploy¥conf¥config.<WEB_APP_SERVER>
2. 以下のパスワードの情報を含む行を見つけます。
as_admin_password=
3. パスワードの値がある場合は、Web アプリケーションのパスワードで置き換えます。
4. ファイルを保存して、WDeploy GUI を再実行します。
4.8
Web アプリケーションのデプロイメント後の作業
Web アプリケーションサーバをデプロイまたはアンデプロイ後、Web アプリケーションサーバを再起動します。
Web アプリケーションサーバの設定を確認するには、Web ブラウザから BI 起動パッドとセントラル管理コンソール (CMC) を
起動できることを確認します。 例:
● http[s]://<WEB_APP_SERVER>:<PORT>/<BI_LAUNCHPAD_CONTEXT>
● http[s]://<WEB_APP_SERVER>:<PORT>/<CMC_CONTEXT>
<WEB_APP_SERVER> は、Web サーバまたは Web アプリケーションサーバのホスト名または IP アドレスで置き換え、
<PORT> は、HTTP または HTTPS 通信に使用されるポート番号で置き換えます。 BI 起動パッドに使用されるデフォルトのル
ートコンテキストは /BOE/BI です。CMC に使用されるデフォルトのコンテキストは /BOE/CMC です。
4.9
ログファイル
WDeploy ツールでは、問題の診断や使用状況の監視に役立つ詳細情報を含む、2 つのログファイルが作成されます。
1. <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥logs
¥WDeploy_summary.log: WDeploy の使用状況の詳細な記録です。WDeploy のバージョン、使用されている JDK、
発行されたコマンド、設定、および WAR ファイルの場所に関する情報、操作またはイベントとそれらの結果に関する情
報、および、実行時にユーザに表示されるすべてのエラーメッセージまたは警告が含まれます。
2. <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥logs¥WDeploy.log:
WDeploy_summary.log のすべての内容に加え、タイムスタンプ、およびすべての警告またはエラーメッセージが含ま
れます。
WDeploy コマンドが発行されると、WDeploy_summary.log.01 は現在のコマンドで上書きされ、WDeploy.log が追加
されます。
72
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
WDeploy.log ファイルはサイズが増大して 512 KB 以上になるため、固有の数字を末尾につけてファイル名を変更します。
たとえば、WDeploy.log を WDeploy.log.01 という名前に変更します。 WDeploy.log.01 という名前のファイルがすで
に存在している場合は、WDeploy.log.02 を作成します。
Web アプリケーションデプロイメントガイド (Windows 版)
WDeploy ツールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
73
5
管理コンソールを使用して Web アプリケーション
をデプロイする
5.1
Web アプリケーションを手動でデプロイする
デプロイ可能な WAR または EAR ファイルを Web アプリケーションサーバにデプロイするには、WDeploy ツールを使用して
それらのファイルを生成する必要があります。
以下の手順では、アプリケーションサーバの管理コンソールを使用して Web アプリケーションをデプロイします。
1. 1 つの Web アプリケーションを準備する場合は wdeploy predeploy コマンドを実行し、すべての Web アプリケーシ
ョンを準備するには、wdeploy predeployall を実行します。
例 1: wdeploy predeploy を使用して BOE.war Web アプリケーション WAR ファイルを Tomcat にデプロイするため
の準備を行います。
wdeploy.bat tomcat8
-DAPP=BOE
predeploy
例 2: wdeploy predeployall を使用してすべての Web アプリケーションを Tomcat にデプロイするための準備を
行います。
wdeploy.bat tomcat8
predeployall
注記
predeploy および predeployall コマンドは、Web アプリケーションサーバをホストしていないマシンで使用でき
ます。ただし、predeploy または predeployall コマンドに必要なパラメータを指定する必要があります。
WDeploy コマンドでは、Web アプリケーションサーバにデプロイできるように Web アプリケーションを準備し、Dwork_dir パラメータを指定していない場合、<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise
XI 4.0¥wdeploy¥workdir¥<APP_SERVER>¥application に WAR または EAR ファイルを作成します。
2. Web アプリケーションサーバに固有の手動のデプロイメント手順に従います。
これで、Web アプリケーションを Web アプリケーションサーバに手動でデプロイできるようになります。
インストールが必要な他の Web アプリケーションに対して上記の手順を繰り返します。
74
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
5.1.1 JBoss 6.4.0 管理コンソールでの手動デプロイメント
Web アプリケーションサーバがインストールおよび設定され、実行中 (環境に応じてスタンドアロンモードまたはドメインモード
で) であることを確認します。wdeploy predeploy コマンドを使用して、JBoss に手動でデプロイできる BOE.war または
AdminTools.war などの WAR ファイルを作成します。
wdeploy.bat jboss6 predeployall
wdeploy predeploy コマンドを使用すると、Web サービス Web アプリケーション用の展開された WAR ファイル構造 (フ
ォルダ名: dswsbobje.war および BusinessProcessBI.war) が作成されます。例:
jboss6
application
dswsbobje.war
axis2-web
images
META-INF
WEB-INF
WAR ファイルが作成された後、それらを新しい場所にコピーしてから、JBoss コマンドラインインタフェース (CLI) を使用して
JBoss にデプロイします。
1. JBoss の bin ディレクトリからコマンド jboss-cli を実行して JBoss CLI を起動し、[Enter] を押します。
2. コマンド connect を実行してアプリケーションサーバに接続し、[Enter] を押します。
3. 圧縮された WAR ファイルまたは展開された WAR フォルダに対してコマンド /deployment を実行します。
○ 圧縮された .war ファイル (たとえば、BOE.war) の場合
deploy BOE.war
○ 展開された .war ファイル構造 (たとえば、dswsbobje.war) の場合
cd subsystem=deployment-scanner/scanner=default
:write-attribute(name=auto-deploy-exploded,value=true)
完了後、デプロイメントが成功したことを示す次のようなメッセージが表示されます:{"outcome" => "success"}
JBoss [管理コンソール] Web インタフェース (http://<WAS_HOSTNAME:/WAS_PORT>/console) に管理者アカウント
でログオンし、アプリケーションが実行されていることを確認します。
5.1.2 JBoss 7.1 管理コンソールでの手動デプロイメント
Web アプリケーションサーバがインストールおよび設定され、実行中 (環境に応じてスタンドアロンモードまたはドメインモード
で) であることを確認します。wdeploy predeploy コマンドを使用して、JBoss に手動でデプロイできる BOE.war または
AdminTools.war などの WAR ファイルを作成します。
wdeploy.bat jboss7 -DAPP=BOE predeploy
wdeploy predeploy コマンドを使用すると、Web サービス Web アプリケーション用の展開された WAR ファイル構造 (フ
ォルダ名: dswsbobje.war および BusinessProcessBI.war) が作成されます。例:
jboss7
application
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
75
dswsbobje.war
axis2-web
images
META-INF
WEB-INF
WAR ファイルが作成された後、それらを新しい場所にコピーしてから、JBoss コマンドラインインタフェース (CLI) を使用して
JBoss にデプロイします。
AdminTools、dswsbobje、または BusinessProcessBI Web アプリケーションを JBoss 7.1 にデプロイする場合は、
JBoss 7.1 に AdminTools、dswsbobje、または BusinessProcessBI をデプロイする際のセキュリティ例外 [92 ページ]を
参照することをお奨めします。
1. JBoss の bin ディレクトリから、jboss-cli --connect コマンドを実行し、JBoss CLI を起動してアプリケーションサ
ーバに接続します。
2. 圧縮された WAR ファイルまたは展開された WAR フォルダに対して /deployment コマンドを実行します。マネージドド
メインにデプロイする場合は、/server-group コマンドも実行します。
以下の例では、WAR は C:¥BIPwebapps¥ に保存され、サーバグループの名前は main-server-group であるとし
ます。
○ BOE.war などの圧縮された .war ファイルの場合は、archive 値を true に設定します。
スタンドアロンサーバ:
/deployment=BOE.war:add(enabled="true",runtimename="BOE.war",content=[{"path"=>"C:/BIPwebapps/BOE.war","archive"=>true}])
マネージドドメイン:
/deployment=BOE.war:add(runtime-name="BOE.war",content=[{"path"=>"C:/
BIPwebapps/BOE.war","archive"=>true}])
/server-group=main-server-group /deployment=BOE.war:add(enabled=true)
○ dswsbobje.war などの展開された .war ファイル構造の場合は、archive 値を false に設定します。
スタンドアロンサーバ:
/deployment=dswsbobje.war:add(enabled="true",runtimename="dswsbobje.war",content=[{"path"=>"C:/BIPwebapps/
dswsbobje.war","archive"=>false}])
マネージドドメイン:
/deployment=dswsbobje.war:add(runtimename="dswsbobje.war",content=[{"path"=>"C:/BIPwebapps/
dswsbobje.war","archive"=>false}])
/server-group=main-server-group /deployment=dswsbobje.war:add(enabled=true)
完了後、デプロイメントが成功したことを示す次のようなメッセージが表示されます:{"outcome" => "success"}
JBoss [管理コンソール] Web インタフェース (http://<WAS_HOSTNAME>:9990/console) に管理者アカウントでログ
オンし、アプリケーションが実行されていることを確認します。
76
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
5.1.3 SAP NetWeaver Technology Platform
5.1.3.1
SAP NetWeaver technology platform へのデプロイメント
の要件
注記
SAP BusinessObjects Business Intelligence プラットフォーム Web アプリケーションがすでにサーバで稼動している場
合は、それらのアプリケーションのデプロイメントを解除してから続行する必要があります。
BI プラットフォーム Web アプリケーションを SAP NetWeaver Application Server コンポーネント (すべてのバージョン) にデ
プロイする前に、.html ファイルおよび .htm ファイルが圧縮されないようにする必要があります。 たとえば、SAP NetWeaver
AS コンポーネント 7.3 では次の手順を実行します。
1. SAP Administrator Portal にログオンします。
例: http://<servername>:50200/nwa
2. 以下に移動します。
設定
インフラストラクチャ
Java システムプロパティ
に移動します。
3. [サービス] タブで、[HTTP プロバイダサービス] を選択します。
4. 詳細で、常に圧縮および圧縮しないを次のように変更します。
○ 常に圧縮: このプロパティから *.htm,*.html,text/html を削除します。 このフィールドを空にすることはできま
せん。空にする場合は、スペースを入力してください。
○ 圧縮しない: このプロパティに *.htm,*.html,text/html を追加します。
表 26: 例
名前
デフォルトの計算済み値
常に圧縮
(空にする場合はスペースを入力)
圧縮しない
*.htm,*.html,text/html
5. 閉じる前に変更を保存します。
5.1.3.2
SAP BusinessObjects Explorer を SAP NetWeaver テク
ノロジプラットフォームにデプロイする前に必要な設定
BI プラットフォーム Web アプリケーション (explorer) を SAP NetWeaver テクノロジプラットフォームにデプロイする前
に、/WEB-INF/classes/default.settings.properties ファイルの disable.compression.filter プロパ
ティを true に設定する必要があります。この値は、デフォルトでは false に設定されています。次の場所にある
default.settings.properties を変更します。
● <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps¥explorer¥WEB-INF
¥classes¥
注記
WDeploy ツールは、SAP NetWeaver Technology Platform へのデプロイメントまたは SAP NetWeaver からのア
ンデプロイメントをサポートしていません WDeploy ツールの predeploy コマンドまたは predeployall コマンドを
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
77
使用して SCA ファイルを作成し、SAP Software Update Manager (SUM) を使用して手動でデプロイする必要があ
ります。SAP NetWeaver technology platform への手動デプロイメント実行手順の詳細については、SAP Software
Update Manager (SUM) を使用した SAP NetWeaver Technology Platform のデプロイメント [78 ページ] を参
照してください。
5.1.3.3
SAP Software Update Manager (SUM) を使用した SAP
NetWeaver Technology Platform のデプロイメント
Web アプリケーションサーバがインストールおよび設定され、実行中であることを確認します。wdeploy predeploy コマン
ドを使用して、SAP NetWeaver Technology Platform に手動でデプロイできる BOE.sca および AdminTools.sca など
の SCA パッケージを作成します。
wdeploy.bat sapappsvr73 -DAPP=BOE predeploy
Web アプリケーションを SAP NetWeaver Technology Platform にデプロイするには、SAP Software Update Manager
(SUM) が必要です。次の場所にある SUM をダウンロードします。
https://support.sap.com/swdc
Support Packages and Patches > [A - Z Index] > [S] > [SL Toolset
<release>] > [Entry by Component] > [Software Update Manager (SUM)]。
SUM は、デプロイされる SCA パッケージへのネットワークアクセスが可能な、SAP NetWeaver Technology Platform をホ
ストするシステムと同じシステムにインストールします。
1. 次のコマンドを使用して、Software Update Manager パッケージを解凍します。
SAPCAR - xvf <download directory>¥<path>¥<Archive>.SAR -R <SAPNW_INSTALL_DRIVE>:
¥usr¥sap¥<sapsid>
上記のファイルを抽出すると、指定したパスに 「SUM」 フォルダが作成されます。
注記
SAPSID は、NetWeaver のインストール時に指定したシステム ID です。
SAPSID: データベースサーバおよびアプリケーションロジックを実行するいくつかのアプリケーションサーバの R/3 イ
ンストールはそれぞれ単一の SID (SAP システム ID) である SAPSID (C11、PRD、E56 などの 3 文字のコード) によ
って一意に識別されます。
2. 以下の predeploy または predeployall コマンドを実行して SCA ファイル (BOE.sca や AdminTools.sca など) を
生成します。
wdeploy.bat sapappsvr73 predeployall
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥workdir
¥sapappsvr73¥application
3. すべての SCA ファイルを次のフォルダにコピーします。
<SAPNW_INSTALL_DRIVE>/usr/sap/Trans/EPS/in
4. SAP NetWeaver Application Server コンポーネントを起動して、次の手順を実行します。
78
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
1. [SAP 管理コンソール] を起動します。
2. [開始] を選択します。
3. NetWeaver アプリケーションをインストールしたローカルマシンの詳細を入力します。
5. コマンド STARTUP confighostagent <SAPSID> で Software Update Manager サーバプロセスを開始します。
<sid>ADM ユーザは、NetWeaver のインストール時に作成された OS ユーザです。Software Update Manager を起
動するには、<sid>ADM ユーザとしてログオンする必要があります。
SAR.ファイルを SUM フォルダに抽出したドライバでバッチファイルを見つけることができます。
6. ブラウザで http://<host>:1128/lmsl/sumjava/<SAPSID>/index.html から SUM の GUI を開始します。
7. ターゲット定義ステップで [手動で準備されたディレクトリ] オプションを選択します。スタックファイルまたはディレクトリパ
スをテキストボックスに入力して、[次へ] を選択します。
8. デプロイメントが完了し、確認のタブが表示されるまで、更新手順に従います。
注記
詳細については、<SAPNW_INSTALL_DRIVE>:¥usr¥sap¥<sapsid>¥SUM¥sdt¥htdoc に保存されている最
新の ProcessOverview.html レポートを参照してください。
Software Update Manager の詳細については、ユーザガイドおよび http://help.sap.com にあるその他のドキュメントを参
照してください。
注記
問題なくデプロイしたアプリケーション (CMC など) にアクセスすると HTTP エラーやセッションエラーが発生する場合は、
数分待ってからページを更新してください。
5.1.4 Tomcat 7 および 8 管理コンソールでの手動デプロイメント
Web アプリケーションサーバがインストールおよび設定され、実行中であることを確認します。wdeploy predeploy コマン
ドを使用して、Tomcat に手動でデプロイできる BOE.war および AdminTools.war などの WAR ファイルを作成します。
wdeploy.bat tomcat8 -DAPP=BOE predeploy
1. http://<WAS_HOSTNAME>:<PORT>/manager/html で、[Tomcat Manager] 管理コンソールアプリケーションに
ログオンします。
デフォルトのポート番号は 8080 です。
2. デプロイする Web アプリケーションのコンテキストパスを設定します。
コンテキストパスは WAR ファイル名である必要がありますが、拡張子は付けずに、スラッシュで始めます。たとえば、
<YOUR_WEB_APPLICATION>.war としてパッケージ化されている Web アプリケーションをデプロイする場合、コンテキ
ストパスは /<YOUR_WEB_APPLICATION> にする必要があります。
3. [XML 設定ファイル] 設定を、コンテキストパスとドキュメントベースを含む XML ファイルの保存場所に設定します。
ドキュメントのベースは、wdeploy predeploy コマンドで作成した事前デプロイ済みの WAR ファイルです。例:
<Context
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
79
docBase="<BOE_INSTALL_DIR>/SAP BusinessObjects Enterprise XI 4.0/wdeploy/
workdir/tomcat8/application/<YOUR_WEB_APPLICATION>.war"
path="<context_path>"
crossContext="false" debug="0" reloadable="false" trusted="false"
/>
4. WAR ファイルへの完全パスを入力し、[デプロイ]をクリックします。
WAR ファイルがデプロイされます。
5.1.4.1
Tomcat クラスタにデプロイする
複数のマシンに分散されている Tomcat Web アプリケーションクラスタに Web アプリケーションを手動でデプロイするには、
Web アプリケーションを各 Tomcat Web アプリケーションサーバにデプロイします。管理コンソールを使用して、Web アプリ
ケーションを各サーバインスタンスの Tomcat ホームディレクトリの webapps サブフォルダにデプロイします。
注記
Tomcat を使用しているときは、Web アプリケーションサーバを停止してから wdeploy undeployall アクションコマン
ドを送ります。
ヒント
BI プラットフォーム Web アプリケーションを Tomcat Web アプリケーションクラスタで実行している場合は、ハードウェアロ
ードバランサまたはソフトウェアロードバランサのいずれかをインストールおよび設定することをお勧めします。Tomcat ク
ラスタに負荷分散を設定する方法については、Tomcat のマニュアルを参照してください。
5.1.5 WebLogic 11gR1 管理コンソールでの手動デプロイメント
デプロイする前に、Web アプリケーションサーバがインストールおよび設定され、実行中であることを確認します。 BI プラット
フォーム Web アプリケーションを実行する WebLogic ドメインを作成します。
wdeploy predeploy コマンドを使用して、WebLogic に手動でデプロイできる BOE.war および AdminTools.war など
の WAR ファイルを作成します。
wdeploy.bat weblogic11 -DAPP=BOE predeploy
注記
wdeploy predeploy コマンドを使用すると、WAR ファイルではなく Web サービス Web アプリケーション
(dswsbobje および BusinessProcessBI) 用のパッケージされていないフォルダ構造が作成されます。 例:
weblogic11
application
dswsbobje
dswsbobje
80
CUSTOMER (顧客)
axis2-web
images
META-INF
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
WEB-INF
lib
META-INF
Resources
WebLogic にデプロイするときは、2 番目の、より深い階層の dswsbobje または BusinessProcessBI フォルダを選
択する必要があります。
1. Web ブラウザを使用して、http://<WAS_HOSTNAME>:<PORT>/console で WebLogic Server 管理コンソールに
ログオンします。
デフォルトのポート番号は 7001 です。
[WebLogic Server 管理コンソール] Web ページが表示されます。
2. (オプション) [チェンジセンター] パネルで、[ロックして編集] をクリックします。
このステップは、本稼働環境などでドメイン設定がロックされている場合にのみ必要です。
3. [ドメイン構造] パネルで、[デプロイメント] をクリックします。
4. [デプロイメントのサマリー] ページで、[インストール] をクリックし、[アプリケーションインストールアシスタント] ページで、
WAR ファイルまたはフォルダパスに移動します。
オプション
説明
WAR ファイル (BOE.war
など)
WAR ファイルへのパスを選択します。 例:
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥workdir¥weblogic11¥application¥BOE.war
フォルダ構造 (dswsbobje フォルダ構造へのパスを選択します。 例:
など)
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥workdir¥weblogic11¥application¥dswsbobje¥dswsbobje
注記
WebLogic にデプロイするときは、2 番目の、より深い階層の dswsbobje または
BusinessProcessBI フォルダを選択する必要があります。
次へをクリックします。
5. [このデプロイメントをアプリケーションとしてインストールする] を選択し、[次へ] をクリックします。 ウィザードで追加のパ
ラメータを確認して指定したら、[終了] をクリックします。
6. (オプション) [チェンジセンター] パネルで、[変更のアクティブ化] をクリックし、Web アプリケーションサーバに変更を適用
します。
このステップは、本稼働環境などでドメイン設定がロックされている場合にのみ必要です。
Web ブラウザで Web アプリケーションを開き、すぐに実行できることを確認します。
5.1.5.1
WebLogic クラスタにデプロイする
Web アプリケーションを WebLogic クラスタにデプロイする場合は、WebLogic 管理サーバをホストしているマシンにデプロイ
します。 WebLogic 管理コンソールで、Web アプリケーションをクラスタ内の他のマシンにプッシュできるようになります。
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
81
注記
WebLogic クラスタでのデプロイメントには、ハードウェアロードバランサまたはソフトウェアロードバランサの使用をお勧め
します。
WebLogic クラスタのデプロイメントには次の一般的なワークフローを使用します。
1. WebLogic 管理コンソールを使用して、BI プラットフォーム Web アプリケーションをサービスするインスタンスの
WebLogic XML レジストリを作成します。 XML レジストリの作成には、次の表の値を使用します。
プロパティ
値
名前
<REGISTRY_NAME> (レジストリに名前を付ける)
ドキュメントビルダファクトリ
weblogic.apache.xerces.jaxp.DocumentBuil
derFactoryImpl
SAX パーサーファクトリ
weblogic.apache.xerces.jaxp.SAXParserFac
toryImpl
トランスフォーマファクトリ
weblogic.apache.xalan.processor.Transfor
merFactoryImpl
2. BI プラットフォームが、WebLogic 管理サーバをホストしている同じマシンにインストールされている場合は、手順 6 に進
みます。BI プラットフォームと WebLogic 管理サーバがそれぞれ異なるマシンで実行されている場合は、WDeploy ツー
ルおよび環境を、WebLogic 管理サーバをホストしているマシンにコピーします。
3. BIP_INSTALL_DIR¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf にある
config.weblogic11 設定ファイルを変更します。
例:
as_domain_dir=c:¥bea¥user_projects¥domains¥base_domain
as_instance=AdminServer
as_admin_port=7001
as_admin_username=weblogic
as_admin_password=password
4. 次のディレクトリにある weblogic.xml の PersistentStoreType 設定を変更します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf¥templates
¥weblogic.xml 例:
<weblogic-web-app>
<session-descriptor>
<session-param>
<param-name>PersistentStoreType</param-name>
<param-value>replicated</param-value>
</session-param>
</session-descriptor>
5. コマンドラインコンソールを開き、次のコマンドを実行します。
wdeploy.bat weblogic<X> predeployall
6. WebLogic 管理コンソールを使用して、次のディレクトリからデプロイする各 Web アプリケーションを個別にインストール
します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥workdir¥weblogic<X>
¥application¥
82
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
7. デプロイメントターゲットを選択ワークフローで、クラスタ名およびクラスタ内のすべてのサーバを選択します。
8. デプロイメントターゲットを選択が完了したら、インストールされたすべてのアプリケーションを選択し、
開始
すべての
リクエストに応答 を選択します。
5.1.6 WebSphere 7.0 および 8.5 管理コンソールでの手動デプロイメン
ト
5.1.6.1
WebSphere 7.0 管理コンソールマニュアルデプロイメント - グ
ラフィカルユーザインタフェースメソッド
Web アプリケーションサーバがインストールおよび設定され、実行中であることを確認します。wdeploy predeploy コマン
ドを使用して、WebSphere にマニュアルでデプロイできる BOE.ear および AdminTools.ear などの EAR ファイルを以下
のように作成します。
wdeploy.bat websphere7 -DAPP=BOE predeploy
BOE アプリケーションまたはすべての Web アプリケーションをデプロイする場合、タイムアウトメッセージおよびデプロイメント
の失敗を回避するために、タイムアウト設定を増やします (WebSphere 7.0 または 8.5 のデプロイメントのタイムアウト設定
を変更する [87 ページ]を参照)。
1. 管理者アカウントを使用して、http://<WAS_HOSTNAME>:<PORT>/ibm/console で WebSphere Integrated
Solutions Console にログオンします。
デフォルトのポート番号は 9060 です。
2. メニューから、
アプリケーション
アプリケーションの種類
WebSphere エンタープライズアプリケーション
を選択
します。
[エンタープライズアプリケーション] 画面が表示されます。
3. [インストール] をクリックします。
[アプリケーションインストールの準備] の [新規アプリケーションへのパス] 画面が表示されます。
4. [参照] をクリックし、Web アプリケーションの EAR ファイルを選択します。
[完全パス] 項目に、Web アプリケーションの EAR ファイルへの完全修飾パスが表示されます。
5. 次の画面に進みます。
[アプリケーションのインストール方法] 画面が表示されます。
6. [高速パス] のデフォルトオプションをそのまま使用して、次の画面に進みます。
[新規アプリケーションのインストール] 画面の [ステップ 1:インストールオプションの選択] が表示されます。
7. デフォルトオプションをそのまま使用して、次の画面に進みます。
[ステップ 2:サーバへのモジュールのマッピング] 画面が表示されます。
8. デフォルトオプションをそのまま使用して、次の画面に進みます。
[ステップ 3:概要] 画面が表示されます。
9. 要約を確認し、[終了] をクリックします。
Web アプリケーションがインストールされ、マスタ設定変更の確認メッセージが表示されます。
10. [マスタ設定に直接保存] をクリックします。
Web アプリケーション設定が保存され、[エンタープライズアプリケーション] 画面に戻ります。Web アプリケーションはま
だ実行されていません。
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
83
11. デプロイされたアプリケーション (管理対象リソース) の一覧から Web アプリケーションを選択します。
[設定] 画面が表示されます。
12. [モジュールの管理] をクリックします。
[モジュールの管理] 画面が表示されます。
13. Web アプリケーションモジュール ([モジュール] 列内) を選択します。
[モジュールの一般プロパティの管理] 画面が表示されます。
14. [クラスローダー順序] プロパティから [最初にローカルクラスローダーをロードしたクラス (親は最後)] を選択します。
確認メッセージが表示されます。
15. [マスタ設定に直接保存] をクリックします。
Web アプリケーション設定が保存され、[モジュールの管理] 画面に戻ります。
16. [OK] をクリックします。
マスタ設定変更の確認メッセージが表示されます。
17. [クラスのロードとアップデートの検出] をクリックします。
[クラスローダ] 設定画面が表示されます。
18. [アップデートしたファイルのポーリング間隔] ダイアログボックスで希望するポーリング間隔を入力して、[OK] をクリックし
ます。
マスタ設定変更の確認メッセージが表示されます。
19. [マスタ設定に直接保存] をクリックします。
Web アプリケーション設定が保存され、[エンタープライズアプリケーション] 画面に戻ります。
20.Web アプリケーションのチェックボックスをオンにして、[開始] をクリックします。
Web アプリケーションが正しく開始されたことを確認するメッセージが表示されます。
Web アプリケーションのデプロイおよび設定が完了し、正しく開始されました。先ほど指定したルートコンテキストを使用して、
Web アプリケーションをテストしてください。Web アプリケーションごとにこれらの手順を繰り返します。
5.1.6.2
WebSphere 7.0 管理コンソールの手動デプロイメント - コマン
ドラインインタフェースメソッド
WebSphere 管理コンソールの手動デプロイメント用コマンドラインインタフェースメソッドを使用して、サイズが 1 GB 以上であ
る EAR ファイルをデプロイします。
Web アプリケーションサーバがインストールおよび設定され、実行中であることを確認します。wdeploy predeploy コマン
ドを使用して、WebSphere にマニュアルでデプロイできる BOE.ear および AdminTools.ear などの EAR ファイルを以下
のように作成します。
wdeploy.bat websphere7 -DAPP=BOE predeploy
BOE アプリケーションまたはすべての Web アプリケーションをデプロイする場合、タイムアウトメッセージおよびデプロイメント
の失敗を回避するために、タイムアウト設定を増やします (WebSphere 7.0 または 8.5 のデプロイメントのタイムアウト設定
を変更する [87 ページ]を参照)。
1. WebSphere bin ディレクトリから wsadmin.bat –lang jacl コマンドを実行して WebSphere コマンドラインインタ
フェースを開始して、Enter を押します。
2. EAR ファイルで $AdminApp install <Location of BOE.ear>/BOE.ear コマンドを実行します。
84
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
3. デプロイメントが完了したら、$AdminConfig save を実行してデプロイメントを保存します。
Web アプリケーションのデプロイおよび設定が完了し、正しく開始されました。
WebSphere [管理コンソール] Web インタフェース (http://<WAS_HOSTNAME:/WAS_PORT>/console) に管理者アカ
ウントでログオンして、アプリケーションが実行されていることを確認します。
5.1.6.3
WebSphere 8.5 管理コンソールマニュアルデプロイメント - グ
ラフィカルユーザインタフェースメソッド
Web アプリケーションサーバがインストールおよび設定され、実行中であることを確認します。wdeploy predeploy コマン
ドを使用して、WebSphere にマニュアルでデプロイできる BOE.ear および AdminTools.ear などの EAR ファイルを以下
のように作成します。
wdeploy.bat websphere8 -DAPP=BOE predeploy
BOE アプリケーションまたはすべての Web アプリケーションをデプロイする場合、タイムアウトメッセージおよびデプロイメント
の失敗を回避するために、タイムアウト設定を増やします (WebSphere 7.0 または 8.5 のデプロイメントのタイムアウト設定
を変更する [87 ページ]を参照)。
1. 管理者アカウントを使用して、http://<WAS_HOSTNAME>:<PORT>/ibm/console で WebSphere Integrated
Solutions Console にログオンします。
デフォルトのポート番号は 9060 です。
2. メニューから、
アプリケーション
アプリケーションの種類
WebSphere エンタープライズアプリケーション
を選択
します。
[エンタープライズアプリケーション] 画面が表示されます。
3. [インストール] をクリックします。
[アプリケーションインストールの準備] の [新規アプリケーションへのパス] 画面が表示されます。
4. [参照] をクリックし、Web アプリケーションの EAR ファイルを選択します。
[完全パス] 項目に、Web アプリケーションの EAR ファイルへの完全修飾パスが表示されます。
5. 次の画面に進みます。
[アプリケーションのインストール方法] 画面が表示されます。
6. [高速パス] のデフォルトオプションをそのまま使用して、次の画面に進みます。
[新規アプリケーションのインストール] 画面の [ステップ 1:インストールオプションの選択] が表示されます。
7. デフォルトオプションをそのまま使用して、次の画面に進みます。
[ステップ 2:サーバへのモジュールのマッピング] 画面が表示されます。
8. デプロイするモジュールを選択し、次の画面に進みます。
[ステップ 3:概要] 画面が表示されます。
9. 要約を確認し、[終了] をクリックします。
Web アプリケーションがインストールされ、マスタ設定変更の確認メッセージが表示されます。
10. [マスタ設定に直接保存] をクリックします。
Web アプリケーション設定が保存され、[エンタープライズアプリケーション] 画面に戻ります。Web アプリケーションはま
だ実行されていません。
11. デプロイされたアプリケーション (管理対象リソース) の一覧から Web アプリケーションを選択します。
[設定] 画面が表示されます。
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
85
12. [モジュールの管理] をクリックします。
[モジュールの管理] 画面が表示されます。
13. Web アプリケーションモジュール ([モジュール] 列内) を選択します。
[モジュールの一般プロパティの管理] 画面が表示されます。
14. [クラスローダー順序] プロパティから [最初にローカルクラスローダーをロードしたクラス (親は最後)] を選択します。
確認メッセージが表示されます。
15. [マスタ設定に直接保存] をクリックします。
Web アプリケーション設定が保存され、[モジュールの管理] 画面に戻ります。
16. [OK] をクリックします。
マスタ設定変更の確認メッセージが表示されます。
17. [クラスのロードとアップデートの検出] をクリックします。
[クラスローダ] 設定画面が表示されます。
18. [アップデートしたファイルのポーリング間隔] ダイアログボックスで希望するポーリング間隔を入力して、[OK] をクリックし
ます。
マスタ設定変更の確認メッセージが表示されます。
19. [マスタ設定に直接保存] をクリックします。
Web アプリケーション設定が保存され、[エンタープライズアプリケーション] 画面に戻ります。
20.Web アプリケーションのチェックボックスをオンにして、[開始] をクリックします。
Web アプリケーションが正しく開始されたことを確認するメッセージが表示されます。
Web アプリケーションのデプロイおよび設定が完了し、正しく開始されました。先ほど指定したルートコンテキストを使用して、
Web アプリケーションをテストしてください。Web アプリケーションごとにこれらの手順を繰り返します。
5.1.6.4
WebSphere 8.5 管理コンソールの手動デプロイメント - コマン
ドラインインタフェースメソッド
WebSphere 管理コンソールの手動デプロイメント用コマンドラインインタフェースメソッドを使用して、サイズが 1 GB 以上であ
る EAR ファイルをデプロイします。
Web アプリケーションサーバがインストールおよび設定され、実行中であることを確認します。wdeploy predeploy コマン
ドを使用して、WebSphere にマニュアルでデプロイできる BOE.ear および AdminTools.ear などの EAR ファイルを以下
のように作成します。
wdeploy.bat websphere8 -DAPP=BOE predeploy
BOE アプリケーションまたはすべての Web アプリケーションをデプロイする場合、タイムアウトメッセージおよびデプロイメント
の失敗を回避するために、タイムアウト設定を増やします (WebSphere 7.0 または 8.5 のデプロイメントのタイムアウト設定
を変更する [87 ページ]を参照)。
1. WebSphere bin ディレクトリから wsadmin.bat –lang jacl コマンドを実行して WebSphere コマンドラインインタ
フェースを開始して、Enter を押します。
2. EAR ファイルで $AdminApp install <Location of BOE.ear>/BOE.ear コマンドを実行します。
3. デプロイメントが完了したら、$AdminConfig save を実行してデプロイメントを保存します。
Web アプリケーションのデプロイおよび設定が完了し、正しく開始されました。
86
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
WebSphere [管理コンソール] Web インタフェース (http://<WAS_HOSTNAME:/WAS_PORT>/console) に管理者アカ
ウントでログオンして、アプリケーションが実行されていることを確認します。
5.1.6.5
WebSphere 7.0 または 8.5 のデプロイメントのタイムアウト設
定を変更する
BI プラットフォーム Web アプリケーションを WebSphere 7、8.5 または 8.5.5 Web アプリケーションサーバにデプロイする場
合、時間がかかることがあります。
Web アプリケーションを WebSphere 7、8.5 または 8.5.5 にデプロイしているときにタイムアウトのメッセージが表示される場
合は、デプロイメントのタイムアウト設定の時間を増やします。
1. テキストエディタを使用して、設定ファイル deployment.xml を編集します。 deployment.xml の場所は、サーバの
インストールおよび設定の状況によって変わります。
deployment.xml 設定ファイルは、通常 <DEPLOYMENT_CELL>¥applications¥isclite.ear
¥deployments¥isclite¥deployment.xml にあります。
<DEPLOYMENT_CELL> をデプロイメントサーバのセル名に置き換えます。
たとえば、セル名が NetworkDeploymentCell01 の場合、deployment.xml への完全パスは C:¥Program
Files¥IBM¥WebSphere¥AppServer¥profiles¥Dmgr01¥config¥cells
¥NetworkDeploymentCell01¥applications¥isclite.ear¥deployments¥isclite
¥deployment.xml になります。
2. 属性 invalidationTimeout を必要な値に分単位で設定します。最大値は -1 (タイムアウトしない) です。
3. deployment.xml を保存します。
4. WebSphere サービスを再起動します。
WebSphere のタイムアウト設定は変更されました。
5.1.6.6
WebSphere クラスタにデプロイする
BI プラットフォーム Web アプリケーションを、複数のマシンに分散された WebSphere Web アプリケーションクラスタに手動
でデプロイするには、WebSphere Deployment Manager をホストしているマシンに Web アプリケーションをデプロイする必
要があります。 必要なすべての Web アプリケーションがインストールされたら、WebSphere Integrated Solutions Console
を使用してこれらのアプリケーションをクラスタに個別にデプロイできます。
ヒント
BI プラットフォーム Web アプリケーションを WebSphere Web アプリケーションクラスタで実行している場合は、ハードウェ
アロードバランサまたはソフトウェアロードバランサのいずれかをインストールおよび設定することをお勧めします。 ロード
バランサーおよびクラスタを設定する方法については、WebSphere のマニュアルを参照してください。
WebSphere クラスタに Web アプリケーションをデプロイするには、次の一般的なワークフローを使用します。
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
CUSTOMER (顧客)
87
1. BI プラットフォームが、WebSphere Deployment Manager をホストしている同じマシンにインストールされている場合
は、手順 3 に進みます。BI プラットフォームと WebSphere Deployment Manager がそれぞれ異なるマシンで実行され
ている場合は、最初に WDeploy ツールおよび環境を、WebSphere 管理サーバをホストしているマシンにコピーします。
2. <BOE_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf にある
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf を変更します。
管理サーバに関する情報を指定する必要があります。 例:
as_dir=C:¥Program Files¥IBM¥WebSphere¥AppServer
as_soap_port=8779
as_virtual_host=default_host
as_admin_is_secure=false
enforce_file_limit=true
3. コマンドラインコンソールを開き、次のコマンドを実行します。
wdeploy.bat websphere7 predeployall
注記
WebSphere 8.5 または 8.5.5 の場合、websphere8 を使用してください。
4. WebSphere Integrated Solutions Console を開きます。
5.
アプリケーション
エンタープライズアプリケーション
に進んで、次のディレクトリからデプロイする各 Web アプリケ
ーションを個別にインストールします。 <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥workdir¥websphere<X>¥application¥
注記
すべての Web アプリケーションは、EAR モジュールとして保存されます。
6. コンソールで新しいアプリケーションのインストール手順に従って、Web アプリケーションをインストールします。
注記
[モジュールをサーバへマップ]で、ターゲットのクラスタを強調表示していること、およびインストールするモジュールを
選択していることを確認してから、[適用]をクリックします。
7. アプリケーションをインストールしたら、[保存]をクリックします。
8. インストールする EAR ファイルごとに手順 5 ～ 7 を繰り返します。
9.
システム管理
ノード
を選択して、同期済みとして指定されていないクラスタ内のノードを選択します。
10. [同期]をクリックします。
11. クラスタ内の各アプリケーションサーバの場合、
ン管理
分散環境設定
サーバ
チューニングパラメータ
アプリケーションサーバ
カスタムチューニングパラメータ
<app_server_name>
セッショ
を選択し、書き込みコンテンツプ
ロパティからすべてのセッション属性を選択します。
書き込みコンテンツプロパティは、Web アプリケーションを適切にフェイルオーバーするために、すべてのセッション属性
に設定する必要があります。 カスタム設定を使用しない場合は、高または低などのデプロイメントに適したチューニングレ
ベルを使用していることを確認し、このプロパティをすべてのセッション属性に設定します。
12.
88
アプリケーション
CUSTOMER (顧客)
Enterprise アプリケーション
を選択し、インストールしたアプリケーションを起動します。
Web アプリケーションデプロイメントガイド (Windows 版)
管理コンソールを使用して Web アプリケーションをデプロイする
6
既知の問題と回避策
6.1
BOE Web アプリケーションまたは Web アプリケーションソースツリ
ーの名前変更
フォルダ内の BI プラットフォーム Web アプリケーションソースツリーの名前が変更されると、WDeploy ツールによって正しく
デプロイされない場合があります。 この現象は、サポートされているすべてのプラットフォームで発生します。 ソースツリーフォ
ルダは以下の場所にあります。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps
この問題を回避するには、次の手順に従います。
1. BOE Web アプリケーション設定ファイル BOE.properties を以下で検索します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf¥apps
2. Web アプリケーション WAR ファイルの新しい名前が反映されるよう、BOE.properties の名前を変更します。
たとえば、Web アプリケーションの名前を BOE から MYBOE に変更する必要があり、すでに BOE.war から
MYBOE.war に名前を変更している場合、BOE.properties を MYBOE.properties に変更します。
3. テキストエディタを使用し、名前を変更した .properties ファイルの内容を更新します。 設定ファイルの Web アプリケ
ーション情報を更新します。
#Business Objects Configuration Utility
#BOE specific properties
warfile=<WEB_APP_NAME>.war
appvdir=<WEB_APP_NAME>
buildfile=<WEB_APP_NAME>.xml
osgisupported=true
たとえば、Web アプリケーションの名前を BOE から MYBOE に変更する場合、上の <WEB_APP_NAME> を MYBOE に
置換します。
4. Web アプリケーション WAR ファイルの新しい名前が反映されるよう、BOE.xml の名前を変更します。
たとえば、Web アプリケーションの名前を BOE から MYBOE に変更する必要があり、すでに BOE.war または
BOE.ear から MYBOE war または MYBOE.ear に名前を変更している場合、BOE.xml を MYBOE.xml に変更します。
WDeploy ツールを使用して、新しい名前の Web アプリケーションを Web アプリケーションサーバにデプロイできるようになり
ます。
6.2
IPv6 単独環境での WDeploy の使用
IPv6 単独環境で wdeploy コマンドを Oracle Java Development Kit (JDK) に使用すると、Oracle JDK では、Web アプリ
ケーションサーバの IPv6 アドレスとのバインドが許可されない場合があり、wdeploy コマンドが失敗することがあります。
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
CUSTOMER (顧客)
89
これは、Oracle JDK がデフォルト IPv4 アドレスを使用するためです。Java が IPv6 アドレスを使用するように Oracle JDK
の設定を変更するには、作業環境または起動スクリプトで JAVA_OPTIONS 変数を設定します。
JAVA_OPTIONS="-Djava.net.preferIPv6Addresses=true"
たとえば、WebLogic Web アプリケーションサーバの場合は、JAVA_OPTIONS="Djava.net.preferIPv6Addresses=true" を setDom inEnv.sh または setDomainEnv.cmd スクリプトに追加
します。
Web アプリケーションサーバを再起動して、hosts ファイルで ::1 または localhost エイリアスが接続に使用されている
ことを確認します。
6.3
分割 Web Tier サーバ上の Web サービス
Web サービス Web アプリケーション (dswsbobje.war) は分割 Web Tier デプロイメントではサポートされていません。 分
割 Web Tier デプロイメントにより、Web サーバと Web アプリケーションは分割されています。 WDeploy では、分割 Web
Tier デプロイメントの場合でも、スタンドアロンの Web アプリケーションとして Web サービス Web アプリケーションが処理さ
れます。
6.4
末尾にバックスラッシュ文字 (¥) があるパスは、デプロイメントの失
敗の原因になります。
末尾にバックスラッシュ文字 (¥) がある WDeploy コマンドに、二重引用符文字 (") で囲まれたパスを指定すると、Web アプ
リケーションのデプロイメントが失敗する場合があります。この問題によって、以下のパラメータが影響を受けます。
● as_dir
● ws_dir
● war_dir
● appsource_dir
● app_source_tree
たとえば、パラメータ -Dwar_dir="C:¥App Server¥" を使用して WDeploy コマンドラインツールを呼び出すと、Web ア
プリケーションサーバへの Web アプリケーションのデプロイに失敗する場合があります。
この問題を避けるため、WDeploy コマンドに二重引用符文字で囲まれたパスを指定するときには、末尾にバックスラッシュ文
字を使用しないでください。
たとえば、上記の war_dir パラメータを修正するには、末尾のバックスラッシュを -Dwar_dir="C:¥App Server" のよう
に削除します。
90
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
6.5
英語以外の言語を使用した WDeploy
WDeploy ツールで英語以外の言語を使用している場合、以下のことに気をつけてください。
● WDeploy GUI ツールは、config.<WEB_APP_SERVER> 設定ファイル内のサーバ管理者のユーザ名またはパスワー
ドのパラメータに、英語以外の文字を使用できません。
● Windows では、UTF-8 文字を使用した英語以外のファイルパスを渡した場合、WDeploy GUI ツールとコマンドラインツ
ールでエラーが発生して例外処理が実行される可能性があります。 ログファイルには、パスが無効な文字で構成されて
いるので見つからないと記録されます。
6.6
Windows オペレーティングシステムの WDeploy GUI 参照ウィン
ドウ
WDeploy UI [参照] ボタンは、一部の Microsoft Windows オペレーティングシステムで機能しない場合があります。これ
は、Windows オペレーティングシステムに関する既知の制限です。
6.7
Web アプリケーションがサーバから削除されない
Web アプリケーションが WDeploy undeploy または undeployall コマンドで削除されなかった場合は、管理コンソールを使
用して、すべての Web アプリケーションを停止し、サーバを再起動してから、undeploy または undeployall コマンドを再
実行してください。
6.8
Web Tier のインストール後の MobileOTA14.properties のコピ
ー
BI プラットフォーム Mobile サポートを使用する予定であり、Web Tier のインストールを実行した場合、
MobileOTA14.properties ファイルを Web Tier インストールを受け取ったホスト (たいていの場合 Web アプリケーショ
ンサーバ) にコピーする必要があります。
Web Tier インストールを受け取ったホストに MobileOTA14.properties をコピーするには、以下の手順に従います。
1. BI プラットフォームの完全またはカスタム/拡張インストールを受け取ったホストで MobileOTA14.properties を検
索します。
MobileOTA14.properties ファイルは以下の場所にあります
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥conf¥apps
2. Web Tier のインストールを受け取ったホストの対応するパスに MobileOTA14.properties をコピーします。
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
CUSTOMER (顧客)
91
6.9
WDeploy GUI ツールの [キャンセル] ボタン
Web アプリケーションサーバへの Web アプリケーションのデプロイ中に、WDeploy の [キャンセル] ボタンを押しても、Web
アプリケーションサーバにすでにコピーされた Web アプリケーションサーバやサポートファイルは、削除されません。
この問題を回避するには、Web アプリケーションサーバからファイルを手動でアンデプロイするか削除します。一部の Web ア
プリケーションサーバでは、[キャンセル] ボタンが無効な場合があります。これは、デプロイメントに使用される JDK の制限で
す。
6.10 JBoss
6.10.1 JBoss 7.1 に AdminTools、dswsbobje、または
BusinessProcessBI をデプロイする際のセキュリティ例外
JBoss 7.1 に AdminTools、dswsbobje、または BusinessProcessBI Web アプリケーションをデプロイする際に、以下
のエラーが発生する場合があります。
java.lang.SecurityException: Toolkit not encapsulated by a jar.
このエラーは RSA ライブラリによってスローされます。 この問題を解決するには、Web アプリケーションを事前デプロイおよ
びデプロイする前に、Web アプリケーションソースファイルおよび JBoss アプリケーションサーバに対して変更を行う必要が
あります。 以下の例では AdminTools アプリケーションを使用します。 dswsbobje アプリケーションおよび
BusinessProcessBI アプリケーションに対して、以下のように同じ手順を繰り返します。
1. 以下の WDeploy RSA モジュールディレクトリからすべてのファイルをコピーします。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥rsa_module
2. JBoss アプリケーションサーバの modules¥com の下で rsa¥main ディレクトリを作成し、手順 1 でコピーしたすべての
ファイルを貼り付けます。
<JBOSS_INSTALL_DIR>¥modules¥com¥rsa¥main
3. 以下の場所から jboss-deployment-structure.xml ファイルを移動します。
<JBOSS_INSTALL_DIR>¥modules¥com¥rsa¥main
次に、そのファイルを次の AdminTools ソースファイルディレクトリに配置します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps¥AdminTools
¥WEB-INF
4. RSA JAR ファイル certjFIPS.jar、cryptojFIPS.jar、および ssljFIPS.jar を AdminTools ソースファイル
から削除します。
<BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥warfiles¥webapps¥AdminTools
¥WEB-INF¥lib
5. WDeploy ツールを使用して、変更した AdminTools Web アプリケーションを事前デプロイします。 例:
wdeploy jboss7 predeploy -DAPP=AdminTools
6. JBoss コマンドラインインタフェース (CLI) を使用して、変更した AdminTools WAR ファイルをデプロイします。 CLI の
使用例については、JBoss 7.1 管理コンソールでの手動デプロイメント [75 ページ]を参照してください。
92
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
6.11 SAP NetWeaver Technology Platform
6.11.1 SUM を使用する SAP NetWeaver Technology Platform へ
デプロイする場合に表示される不正な servicelevel、
patchlevel、および name パラメータ
BI プラットフォーム 4.0 サポートパッケージ 1 以降の Web アプリケーションを SAP Software Update Manager (SUM) を使
用する SAP NetWeaver Application Server コンポーネントにデプロイする場合、servicelevel、patchlevel および
scn パラメータが正しく表示されない場合があるので、修正する必要があります。 この問題を解決するには、各 Web アプリ
ケーションバンドルの SAP_metadata.Properties ファイルで、それらのパラメータが次の値に設定されていることを確認
します。
● servicelevel および patchlevel パラメータは、実際に適用している Support Pack やパッチリリースと一致して
いる必要があります。 たとえば、次のようになります。
○ サポートパッケージ 1 の場合、servicelevel を 1 に設定し、patchlevel を 0 に設定します。
○ サポートパッケージ 2 の場合、servicelevel を 2 に設定し、patchlevel を 1 に設定します。
● scn および name パラメータは固定値を持っている必要があります。 たとえば、name プロパティが BOEWEBAPPJAVA
の値に設定されている場合は、scn プロパティも BOEWEBAPPJAVA に設定されている必要があります。
異なる Web アプリケーションバンドルに対する SAP_metadata.Properties ファイルは、次の場所に保存されています。
● BOE.sca: <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy¥SLDSupport
¥NWSLD¥BOE
● dswsbobje.sca: <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥SLDSupport¥NWSLD¥dswsbobje
● BusinessProcessBI.sca (非推奨): <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI
4.0¥wdeploy¥SLDSupport¥NWSLD¥BusinessProcessBI
● MobileOTA14.sca: <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥SLDSupport¥NWSLD¥MobileOTA14
● OpenSearch.sca: <BIP_INSTALL_DIR>¥SAP BusinessObjects Enterprise XI 4.0¥wdeploy
¥SLDSupport¥NWSLD¥OpenSearch
6.11.2 WDeploy ツールは、SAP NetWeaver Technology Platform
へのデプロイメントまたは SAP NetWeaver からのアンデプロイ
メントをサポートしていません
WDeploy ツールは、SAP NetWeaver Technology Platform へのデプロイメントまたは SAP NetWeaver technology
platform からのアンデプロイメントをサポートしていません WDeploy ツールの predeploy コマンドまたは
predeployall コマンドを使用して SCA ファイルを作成し、SAP Software Update Manager (SUM) を使用して手動でデ
プロイする必要があります。 SAP NetWeaver technology platform への手動デプロイメント実行手順の詳細については、
SAP Software Update Manager (SUM) を使用した SAP NetWeaver Technology Platform のデプロイメント [78 ページ]
を参照してください。
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
CUSTOMER (顧客)
93
6.12 Tomcat
6.12.1 Windows Vista または 2008 Server の IPv6 専用モードでの
Tomcat の使用
Windows Vista または 2008 Server 上で IPv6 専用モードで Tomcat を使用する場合は、Windows の [コントロールパネ
ル] の [ネットワーク接続] アプレットを使用して IPv4 を無効にします。IPv4 をアンインストールしないでください。アンインスト
ールすると、Tomcat が起動しない場合があります。
これは、JDK 5 および 6 に関する既知の問題です。
6.12.2 WDeploy を使用した Tomcat からの Web アプリケーションのア
ンデプロイ
Web アプリケーションサーバがシャットダウンしておらず、まだ使用中の場合に、Tomcat Web アプリケーションサーバで
wdeploy undeploy コマンドを実行すると、エラーが発生する場合があります。この問題を回避するには、wdeploy
undeploy コマンドを実行する前に、Tomcat Web アプリケーションサーバをシャットダウンします。
6.12.3 WDeploy の実行後に、Tomcat が最初に Web アプリケーション
をロードしない場合
WDeploy ツールを使用して Tomcat に新しくデプロイされた Web アプリケーションが、デフォルト以外のコンテキストパスを
使用すると、最初にロードされないことがあります。変更を有効化するため、Tomcat を再起動します。
6.12.4 更新のインストール後に Explorer URL を起動すると HTTP
404 エラーが表示される
SAP BusinessObjects Business Intelligence (BI) を 4.0 SP8 以降から 4.1 SP6 以降に更新した後で、SAP
BusinessObjects Business Intelligence (BI) Web アプリケーションを Tomcat 8 にデプロイし、Explorer URL を起動する
と、エラー「HTTP Status 404 - / explorer」が表示されます。
例:BI を 4.0 SP8 から 4.2 または 4.0 SP10 から 4.2 に更新した後で、BI Web アプリケーションを Tomcat 8 にデプロイし、
Explorer を起動すると、エラー「HTTP Status 404 - / explorer」が表示されます。
この問題を回避するには、以下の手順を実行してください。
1.
94
開始
セントラル設定マネージャ
CUSTOMER (顧客)
に移動します。
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
2. [セントラル設定マネージャ] ウィンドウで、[Apache Tomcat 8] を選択します。
3. ウィンドウの上部にある [停止] を選択して Apache Tomcat 8 を停止します。
4. <BOE_Install_Dir>SAP BusinessObjects¥SAP BusinessObjects Enterprise XI 4".
0¥warfiles¥webapps¥explorer¥WEB-INF に移動します。
5. Web.XML ファイルで、com.businessobjects.webutil.internal.filters.StrutsParamFilter を
com.businessobjects.bip.core.web.filters.StrutsParamFilter で置き換え、ファイルを保存します。
6. Wdeploy を使用して、BOE および Explorer Web アプリケーションを Tomcat 8 に再デプロイします。
7. [セントラル設定マネージャ] ウィンドウで、[Apache Tomcat 8] を選択し、[開始] を選択します。
6.13 WebLogic
6.13.1 WebLogic からの Web サービスデプロイメントの解除
wdeploy undeploy または wdeploy undeployall コマンドを使用しても、WebLogic 10.3.x Web アプリケーションサ
ーバから BusinessProcessBI および dswsbobje Web サービス Web アプリケーションを削除できない場合があります。
この問題を回避するには、WebLogic 管理コンソールを使用して BusinessProcessBI と dswsbobje Web アプリケーション
を停止し、Web アプリケーションサーバを再起動します。Web アプリケーションサーバの再起動後、wdeploy undeploy ま
たは wdeploy undeployall コマンドを使用して BusinessProcessBI および dswsbobje を削除してください。
6.14 WebSphere
6.14.1 セキュリティモードでの WebSphere へのデプロイメント
Secure Socket Layer (SSL) 暗号化を使用する WebSphere インストールで WDeploy を使用すると、検証エラーが発生す
る場合があります。 この問題を回避するには、WDeploy を使用してデプロイを行う前に、wsadmin コマンドを使用して、SSL
証明書を手動で受け入れるよう設定します。
たとえば、ディレクトリを <WEBSPHERE_INSTALL_DIR>¥AppServer¥bin に変更して、以下のコマンドを実行します。
wsadmin -conntype SOAP -port <SOAP_admin_port> -user <as_admin_username> -password
<as_admin_password>
<SOAP_admin_port> を WebSphere が使用する 8880 などのポート番号に置き換え、<as_admin_username> を
admin などの管理者アカウントのユーザ名に置き換え、<as_admin_password> を <as_admin_username> に指定し
たアカウントのパスワードに置き換えます。
Y を押して証明書を受け入れた後、WDeploy を使用して Web アプリケーションのデプロイメントを続行します。
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
CUSTOMER (顧客)
95
6.14.2 WebSphere 7.0 に Web サービスをデプロイした後の内部サー
バエラー
WS-addressing モジュールが有効化されている WebSphere 7.0 に Web サービスプロバイダ (dswsbobje.war) をデプ
ロイすると、内部サーバエラーが発生する場合があります。Web サービスプロバイダアプリケーション (dswsbobje.war) は、
このモジュールが含まれる Apache Axis2 Web サービスフレームワーク上に構築されます。
この問題を回避するには、BI プラットフォームのデフォルトのインストールで、この WS-addressing モジュールを無効化しま
す。
WebSphere 7.0 以外の Web アプリケーションサーバにデプロイして Axis2 WS-addressing モジュールを有効化する場合
は、axis2.xml ファイルを編集して、<!--<module ref="addressing"/>--> 行をコメント解除します。axis2.xml
ファイルは、Web サービスプロバイダの WAR ファイルの /WEB-INF/conf にあります。変更を有効化するため、Web アプ
リケーションサーバを再起動します。
6.14.3 WASX7017E: WebSphere におけるデプロイメントでの例外
WebSphere の使用中に次の例が発生する場合があります。
com.ibm.websphere.management.exception.ConfigServiceException
com.ibm.websphere.management.exception.ConnectorException
org.apache.soap.SOAPException: [SOAPException: faultCode=SOAP-ENV:Client;
msg=Read timed out; targetException=java.net.SocketTimeoutException: Read timed out]
この問題を回避するには、次の場所でタイムアウト値を変更してみてください。
● soap.client.props ファイルを開き、プロパティで設定されている SOAP 接続タイムアウト値を増やすか、削除しま
す。
com.ibm.SOAP.requestTimeout=0
soap.client.props は、次の場所にあります。
<WAS_INSTALL_DIR>¥profiles¥<PROFILE>¥properties¥soap.client.props
● WebSphere Integrated Solutions Console で、アプリケーションサーバの JMX SOAP コネクタの requestTimeout
プロパティの値を増やします。
96
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
図 1:
注記
サードパーティツールを使用して作成された画像は英語でのみ使用できます。
注記
http://<WAS_HOSTNAME>:<PORT>/ibm/console で WebSphere コンソールにアクセスします。 デフォルトの
ポート番号は 9060 です。
Web アプリケーションデプロイメントガイド (Windows 版)
既知の問題と回避策
CUSTOMER (顧客)
97
重要免責事項および法的情報
コードサンプル
この文書に含まれるソフトウェアコード及び / 又はコードライン / 文字列 (「コード」) はすべてサンプルとしてのみ提供されるものであり、本稼動システム環境で使用することが目的ではあり
ません。「コード」は、特定のコードの構文及び表現規則を分かりやすく説明及び視覚化することのみを目的としています。SAP は、この文書に記載される「コード」の正確性及び完全性の
保証を行いません。更に、SAP は、「コード」の使用により発生したエラー又は損害が SAP の故意又は重大な過失が原因で発生させたものでない限り、そのエラー又は損害に対して一切
責任を負いません。
アクセシビリティ
この SAP 文書に含まれる情報は、公開日現在のアクセシビリティ基準に関する SAP の最新の見解を表明するものであり、ソフトウェア製品のアクセシビリティ機能の確実な提供方法に関
する拘束力のあるガイドラインとして意図されるものではありません。SAP は、この文書に関する一切の責任を明確に放棄するものです。ただし、この免責事項は、SAP の意図的な違法行
為または重大な過失による場合は、適用されません。さらに、この文書により SAP の直接的または間接的な契約上の義務が発生することは一切ありません。
ジェンダーニュートラルな表現
SAP 文書では、可能な限りジェンダーニュートラルな表現を使用しています。文脈により、文書の読者は「あなた」と直接的な呼ばれ方をされたり、ジェンダーニュートラルな名詞 (例: 「販売
員」又は「勤務日数」) で表現されます。ただし、男女両方を指すとき、三人称単数形の使用が避けられない又はジェンダーニュートラルな名詞が存在しない場合、SAP はその名詞又は代
名詞の男性形を使用する権利を有します。これは、文書を分かりやすくするためです。
インターネットハイパーリンク
SAP 文書にはインターネットへのハイパーリンクが含まれる場合があります。これらのハイパーリンクは、関連情報を見いだすヒントを提供することが目的です。SAP は、この関連情報の可
用性や正確性又はこの情報が特定の目的に役立つことの保証は行いません。SAP は、関連情報の使用により発生した損害が、SAP の重大な過失又は意図的な違法行為が原因で発生
したものでない限り、その損害に対して一切責任を負いません。すべてのリンクは、透明性を目的に分類されています (http://help.sap.com/disclaimer を参照)。
98
CUSTOMER (顧客)
Web アプリケーションデプロイメントガイド (Windows 版)
重要免責事項および法的情報
Web アプリケーションデプロイメントガイド (Windows 版)
重要免責事項および法的情報
CUSTOMER (顧客)
99
go.sap.com/registration/
contact.html
© 2016 SAP SE or an SAP affiliate company.All rights reserved.
本書のいかなる部分も、SAP SE 又は SAP の関連会社の明示的な許可な
くして、いかなる形式でも、いかなる目的にも複製又は伝送することはでき
ません。本書に記載された情報は、予告なしに変更されることがあります。
SAP SE 及びその頒布業者によって販売される一部のソフトウェア製品に
は、他のソフトウェアベンダーの専有ソフトウェアコンポーネントが含まれて
います。製品仕様は、国ごとに変わる場合があります。
これらの文書は、いかなる種類の表明又は保証もなしで、情報提供のみを
目的として、SAP SE 又はその関連会社によって提供され、SAP 又はその
関連会社は、これら文書に関する誤記脱落等の過失に対する責任を負うも
のではありません。SAP 又はその関連会社の製品及びサービスに対する
唯一の保証は、当該製品及びサービスに伴う明示的保証がある場合に、
これに規定されたものに限られます。本書のいかなる記述も、追加の保証
となるものではありません。
本書に記載される SAP 及びその他の SAP の製品やサービス、並びにそ
れらの個々のロゴは、ドイツ及びその他の国における SAP SE （又は SAP
の関連会社）の商標若しくは登録商標です。本書に記載されたその他すべ
ての製品およびサービス名は、それぞれの企業の商標です。
商標に関する詳細の情報や通知については、http://www.sap.com/
corporate-en/legal/copyright/index.epx をご覧ください。

マイナンバー法導入にあたって – テスト自動化のすすめ;pdf

ERP（SAPシステム）ビジネスのご紹介

EZSource 導入事例 アフリカの国際銀行

GuiXT WS で実現！ SAPトランザクションの最適化による業務改善

TGLプログラム説明会 チラシ - 東北大学グローバルラーニングセンター

触って実感 日本向け拡張機能を実機で確認（FI・HCM）

事例講演 - SAP.com

VOLVOHANDELNS の サービス/整備業務を強化する SAP