NEC
WebOTX Developer
(with Developer's Studio) V9.2
お試し版(Windows)
ごあいさつ
日頃より弊社製品をご愛顧いただきありがとうございます。このたびは、お客様にご利用いただく 「WebOTX Developer V9.2 - お試し版」(以降、WebOTX Developer と表記します)のインストール方法や利用上
の注意等について説明させていただきます。
ダウンロードしていただいたソフトウェアは、インストール後
365 日間
利用可能な「お試し版」です。 インストールしてから 365 日を超えると各種機能が動作しなくなります。本書は、WebOTX Developer お試し版のインストール方法を中心に構成されています。WebOTX Developer お試し版をご使用になるまえに、必ずお読みください。
以下からの説明では、WebOTX Application Server を「WebOTX AS」と省略して表現します。
WebOTX は日本電気株式会社の登録商標です。
Microsoft、Windows、Windows Server、Windows Vista、Visual C++、Visual Basic、SQL Server およびInternet Information Services は、米国 Microsoft Corporation の米国およびその他の国に おける登録商標です。
Windows の正式名称は、Microsoft Windows Operating System です。
Oracle は、Oracle Corporation 及びその子会社、関連会社の米国及びその他の国における登録商標 です。
Sun、Sun ONE、Sun Java、MySQL は、Oracle Corporation 及びその子会社、関連会社の米国及 びその他の国における登録商標です。
Java およびすべての Java 関連の商標は、Oracle Corporation 及びその子会社、関連会社の米国及 びその他の国における登録商標です。
IBM は、米国およびその他の国における International Business Machines Corporation の商標で す。
DB2、DB2 Universal Database および Cloudscape は、米国およびその他の国における International Business Machines Corporation の商標です。
Sybase、Adaptive ServerおよびAdaptive Server Enterprise は、米国法人 Sybase, Inc.の登録商標 または商標です。
DataDirect、DataDirect Connect および SequeLink は、DataDirect Technologies,Inc の商標また は登録商標です。
Intel は、米国およびその他の国における Intel Corporation の商標です。 PostgreSQL は、PostgreSQL の米国およびその他の国における商標です。
CORBA は、米国 Object Management Group, Inc. の米国またはその他の国における商標または登 録商標です。
目次
1. はじめに ____________________________________________________________________________ 1 2. 動作環境 ____________________________________________________________________________ 2 ソフトウェア要件 _________________________________________________________________________________2 必要リソース _____________________________________________________________________________________5 3. インストール方法_____________________________________________________________________ 6 インストール前の作業 _____________________________________________________________________________6WebOTX Developer（with Developer’s Studio） のインストール _______________________________________7
インストール後の作業 ___________________________________________________________________________ 14
4. アンインストール方法 ________________________________________________________________ 16
アンインストール前の作業 _______________________________________________________________________ 16
WebOTX Developer（with Developer’s Studio） のアンインストール _________________________________ 16
アンインストール後の作業 _______________________________________________________________________ 20
5. 動作確認 ___________________________________________________________________________ 21 6. 注意制限事項 _______________________________________________________________________ 22
1
1. はじめに
WebOTX Developer お試し版をダウンロードいただきありがとうございます。
WebOTX Developer は、WebOTX Application Server の拡張製品として位置付けられ、Java EE や CORBA などのアプリケーション開発を支援するための機能群で構成されます。
WebOTX Developer は、Java EE 開発用途と、CORBA 開発用途の 2 つに分かれており、イ ンストーラもこれら2 つに分かれています。
WebOTX Developer (with Developer's Studio)
Java EE アプリケーション開発に利用できる Eclipse をベースに標準のオープンソース技術を 統合して構成された統合開発環境(IDE)を提供します。さらに、開発・配備・実行・デバッグの サイクルを個人環境で行えるようにするため、テスト用サーバを同梱しています。
統合開発環境ツール「WebOTX Developer's Studio」 Eclipse をベースとした統合開発環境 Java アプリケーション開発のデファクトスタンダードともいえる「Eclipse」をベー スに、Java EE 6 アプリケーション開発に必要な機能をトータルにサポートします。 バグ検出ツール、カバレッジツール、ソース解析ツールのサポート バグ検出ツール(FindBugs)や、カバレッジツール(JaCoCo)、ソース解析ツール(PMD) を利用することで開発を効率よく行うことができます。 テスト用サーバ アプリケーションのデバッグ／テスト用にWebOTX AS Express と同一コア・エンジンを 搭載したテスト用サーバをバンドルしています。なお、テスト用サーバでは、同時接続可 能なセッション数が10 個に制限されており、開発・評価用途でのみ利用することが可能 です。
WebOTX Developer (for CORBA Application)
CORBA アプリケーション開発では、主に WebOTX Application Server Enterprise で動作す るCORBA C++/Java アプリケーションを開発するための、コンパイラ／ライブラリを提供しま す。その他に、クライアント側をWindows Visual Basic のアプリケーションで構築する場合や、 JMS(Java Messaging Service)のメッセージング・ブローカを呼び出すアプリケーションを開発 するための、C/C++言語用のライブラリを提供しています。
このお試し版では、Java EE 開発用である WebOTX Developer (with Developer's Studio)を 提供し、開発・実行・運用を融合させた WebOTX Developer を使用することで、効率よく開発 からデバッグ、テストまでを行うことができ、高い生産性を実現します。
2
2. 動作環境
ソフトウェア要件
WebOTX Developer でサポートする基本ソフトウェア(OS)と、WebOTX に含まれる各機能を使用する場合 に必要なソフトウェアを説明します。
オペレーティング・システム (OS) - WebOTX Developer (with Developer’s Studio) WebOTX Developer (with Developer’s Studio)の動作対象の OSとして32 ビット環境の場合には、 次の種類をサポートします。 Windows® 7, Ultimate Windows® 7, Enterprise Windows® 7, Professional Windows® XP, Professional SP3 64 ビット環境の場合は、以下のとおりです。 Windows® 7, Ultimate Windows® 7, Enterprise Windows® 7, Professional
Java SE Development Kit
WebOTX システムは、実行時に Java™ Platform, Standard Edition を必要とします。サポートする SDK バージョンは次のとおりです。
Java SE Development Kit 7 Update 21 以降
適用するJava SDK のバージョンには、次の注意・制限事項がありますのでご注意下さい。
米国Oracle Corporation 社が提供する SDK のみをサポートします。 Windows 32 ビット OS と Intel 64 の組み合わせは、32 ビットで動作します。
3
あります。Java SE Development Kit 7 Update 55 をご利用になる場合は以下の回避策を行 ってください。 http://www.support.nec.co.jp/View.aspx?id=3010100850 対応ソフトウェア － データベース・サーバ WebOTX AS がサポート対象とするデータベース・サーバは、プログラミング言語、オペレーティング・ システムによって次の製品に対応しています。 Java WebOTX AS は、JDBC 2.0 から JDBC4.0 の仕様に準拠している JDBC ドライバを介して任意の DBMS への接続をサポートするように設計されています。アプリケーションが独自の方式でデータベース・ サーバに接続したり、WebOTX AS が提供する JDBC データソースによる接続、あるいは、WebOTX の Transaction サービス機能と連携した JTA トランザクションを使用する場合には、データベース・サーバ 製品にバンドルされるJDBC ドライバを入手して、セットアップしなければなりません。
4
WebOTX AS では以下の JDBC ドライバについて動作確認を行っております。
JDBC ベンダー JDBC ドライ バ・タイプ
サポートするデータベース・サーバ 備考
Oracle Type 2、4 Oracle Database 10g Release 2 (10.2.0) (*1) Oracle Database 11g Release 1 (11.1.0)
Oracle Database 11g Release 2 (11.2.0.4) Oracle Database 12c Release 1 (12.1.0.1.0) Oracle UCP Type 2、4 Oracle Database 11g Release 1 (11.1.0)
Oracle Database 11g Release 2 (11.2.0) Oracle Database 12c Release 1 (12.1.0.1.0) IBM Type 4 DB2 V9.1
DB2 V9.7 DB2 V10.1
Microsoft Type 4 Microsoft SQL Server 2005 Microsoft SQL Server 2008 Microsoft SQL Server 2012
Sybase Type 4 Sybase Adaptive Server Enterprise 12.5
DataDirect Type4 「Connect for JDBC 3.3 以降」経由による Oracle 接続
Type 3 「SequeLink for JDBC 5.0」経由による Oracle 接続 PostgreSQL
Development Group
Type 4 PostgreSQL 8.1 (JDBC ドライバ 8.1 Build 401)以 降、9.2.4 (JDBC ドライバ 9.2 Build 1004)まで
Cloudscape Type 4 Cloudscape 3.0.3 (J2EE 1.3.1 SDK にバンドルさ れるもの)
Apache Derby Type 4 Apache Derby 10.2.2 ～ 10.8.2
WebOTX AS は、Java EE 6 仕様互換性テスト・パッケージ(Java EE CTS)を「Connect for JDBC 3.5」と「Oracle 10g」の組み合わせでパスしています。
その他の製品についても、例えば MySQL Connector/J 5.0 など、JDBC 2.0 から JDBC4.0 の仕様 に準拠しているJDBC ドライバであれば、WebOTX AS と連携して使用することができます。ただし、十分 な評価を行ってください。
5
*1 Oracle Real Application Cluster (RAC)と X/Open XA の機能を利用して 2 フェーズコミッ トを行うため には、必ず次のパッチを適用してください。 - PSR 10.1.0.3 パッチの詳細についてはOracle 社の情報をご参照ください。
必要リソース
ここでは、インストールするために必要な固定ディスク空き容量と、インストール中、およびインストール 後の初期動作で必要なメモリ容量について説明します。 下記に示すハードディスク容量は、選択インストール可能な機能やプロダクトを全てインストールした場 合を表しています。ただし、JDK などの関連ソフトウェアのディスク消費量は含まれていません。 メモリ容量は、インストール時に既定値を選択して動作させた場合を表しています。 必要ハードディスク容量・ WebOTX Developer（with Developer’s Studio） 1GB 以上
必要メモリ
・ WebOTX Developer（with Developer’s Studio） 最小512MB 以上、推奨 1GB 以上
6
3. インストール方法
インストール前の作業
インストール時の注意事項を以下に示します。 • WebOTX 製品は、新旧の複数バージョンのインストールと、同一バージョンの複数位置へのインスト ールはできません。したがって、既に旧バージョンのWebOTX か本バージョンの WebOTX がインスト ールされている場合は、WebOTX のサービス群を停止した後にアンインストールを行なってください。 操 作 手 順 に つ い て は 、 ご 利 用 に な っ て い る バ ー ジ ョ ン の マ ニ ュ ア ル を ご 参 照 く だ さ い 。 • インストール作業は、必ず Administrators グループに所属した管理者権限があるユーザで行わな ければなりません。管理者権限があるユーザでログインしていることを確認してください。Windows 7 にインストールを行う場合は、Built-in Administrator ユーザで行うか、管理者権限のあ るユーザでも「管理者として実行」によりインストーラを起動してください。
• WebOTX のインストール中は、インストーラの内部で Java を使ってセットアップを行います。 そのた め、WebOTX をインストールする前に、JDK がインストール済みかを確認してください。 まだ JDK が インストールされていない場合は、必ずWebOTX インストール前に JDK をインストールしてください。 • WebOTX をインストールする前に、Microsoft Internet Information Services (IIS)などの他の Web サーバが起動している場合、WebOTX で使用されるポート番号などの設定内容が重複する恐れ があります。この問題を回避するために、一旦 Web サーバを停止するようにしてください。停止方法な どはインストールされている各Web サーバのマニュアルを参照してください。
7
WebOTX Developer（with Developer
’s Studio） のインストール
(1) [WebOTX Developer のインストールへようこそ]画面
ダウンロードしていただいた「OTXDEV92.exe」を起動すると、Windows インストーラが起動し「インスト ールの準備中」というメッセージのあとに次の画面が表示されます。「次へ」ボタンを押してください。(2)
[ユーザ情報]画面
[ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力し ます。[ライセンスキー] ボックスには、「NOREGISTDEV
」(カッコは含みません)を正しく入力します。 入力した情報に間違いがなければ「次へ」ボタンを押してください。8 (3)
[インストール先フォルダ]画面
[インストール先のフォルダ] 画面が表示されますので、インストール先フォルダを決定後、「次へ」ボタ ンを押してください。インストール先フォルダを変更する場合には「変更」ボタンを押してください。他の WebOTX 製品がすでにインストールされている場合、同じフォルダを指定してください。9 (4)
[カスタムセットアップ]画面
[カスタムセットアップ] 画面が表示されます。インストールする機能を選択後、「次へ」ボタンを押してく ださい。 リストにある各アイコンの意味は次のとおりです。 アイコン 説明WebOTX Developer WebOTX を利用した開発に、必要となる環境をインストールし ます。
Developer’s Studio(※) WebOTX Developer's Studio をインストールします。 NEC で独自に開発した Java EE 6 対応アプリケーション開 発機能をもつ、 Eclipse ベースの統合開発環境(IDE)を提供 します。
サーバ連携ツール WebOTX Application Server との連携に必要なプラグイン をインストールします。 アプリケーション開発ツ ール Java EE 開発に必要なプラグインをインストールします。 開発支援ツール バグ検出ツール（FindBugs）、カバレッジツール（JaCoCo）、 ソース解析ツール(PMD)を インストールします。 ヘルプ ヘルプをインストールします。 Eclipse 言語パック メニューや画面を、各国語表示とする環境をインストールしま
10 す。 テスト用サーバ 開発環境上で動作する、テスト用サーバをインストールしま す。 Java EE 6 対応アプリケーションの配備／実行／デバックが 可能です。
なお WebOTX Application Server の別エディションがす でにインストールされている場合には、 この機能を選択するこ とはできません。 (5)
[インストール済みの JDK フォルダ]画面
[インストール済みの JDK フォルダ]画面が表示されますので、既にマシンにインストールされている JDK のフォルダを選択後、「次へ」のボタンを押してください。 環境変数にJAVA_HOME を設定している場合、その設定値が表示されます。 別のフォルダを選択する場合には、「変更」ボタンを押してください。 (6)[ポート番号の設定]画面
「テスト用サーバ」を選択した場合、[ポート番号の設定]画面が表示されますので、 テスト用サーバのド メイン(domain1)で利用する HTTP/HTTPS 通信用のポート番号を設定後、「次へ」ボタンを押してく11 ださい。ここで設定するポート番号は、他の製品で利用するポート番号と重複しないように設定してくだ さい。 (7)
[プログラムをインストールする準備ができました]画面
[プログラムをインストールする準備ができました]画面が表示されます。「インストール」ボタンを押してく ださい。12
(8)
[WebOTX Developer（with Developer’s Studio） をインストールしています]画面
[WebOTX Developer をインストールしています]画面が表示され、ファイルのコピーが始まります。選 択された機能により、セットアップに必要な時間は異なります。ファイルのコピーが終了するまでお待ち ください。
13 [WebOTX 環境設定]画面
「テスト用サーバ」を選択した場合、ファイルのコピー後にWebOTX の初期ドメイン環境(WebOTXAdmin, domain1)を Apache Ant コマンドで設定するため、次の画面が表示されます。画面が終了するまでしば ら く お 待 ち く だ さ い 。Apache Ant コ マ ン ド の 実 行 結 果 は <WebOTX の イ ン ス ト ー ル フ ォ ル ダ >¥ant_setup.log で確認できます。
(9)
[インストールの完了]画面
14 (10)
マシンの再起動
インストール完了後、マシンを再起動してください。インストール後の作業
[カスタムセットアップ]画面で「テスト用サーバ」を選択した場合(デフォルト) マシン再起動後にドメインが生成されているか確認してください。 １． 「スタート」-「すべてのプログラム」-「WebOTX」-「運用管理コマンド」を起動し、次のコマンドを入力 します。 otxadmin> list-domains ２． [WebOTXAdmin]、[domain1] のステータスが表示されることを確認してください。 なお、WebOTX で利用するポート番号が起動済みの他のプログラムで利用しているポート番号と重 複している場合、ドメインの生成に失敗する場合があります。 ドメインの生成に失敗した場合には、起動済みのプログラムの停止や、netstat コマンドなどを参照し てポート番号の重複を解消してから、次のコマンドを起動しドメインを再生成してださい。 <WebOTX インストールフォルダ>\ant_setup.bat Windows 7 にインストールした場合15 1. 「スタート」-「すべてのプログラム」-「WebOTX」-「Developer's Studio」を右クリックし、「プロパティ」を 選択します。 2. 「Developer's Studio のプロパティ」の「互換性」タブを開き、「特権レベル」の「管理者としてこのプロ グラムを実行する」を選択します。 お試し版ライセンスの残り利用期限の確認 お試し版はインストール後 365 日間利用可能です。ライセンスが無効となるまでの残り日数を確認した い場合には、次のコマンドを実行することで確認できます。 >cd <WebOTX インストールフォルダ>¥share¥bin >OTXLLmt 5
The time limit of Trial-License is xxx days.
利用可能日数が xxx に表示されます。この値が 0 になるか、または、コマンドの実行結果で「No License.」が表示された場合、お試し版のライセンスが無効となったことを意味します。この場合、お試し版 のアンインストールを実行してください(※)。 (※)お試し版のライセンスが無効な状態で、お試し版のアンインストールを実行すると、アンインストール 処理の途中で「不正なライセンスコードです。」というダイアログが表示されますが、「OK」ボタンを押下して、 そのままアンインストール処理を続行してください。
16
4. アンインストール方法
アンインストール前の作業
(1) WebOTX Developer’s Studio が動作している場合は停止してください。
以下はWebOTX テスト用サーバをインストールしている場合に実施してください。 (2) トランザクションの有無の確認 Transaction サービス利用時には、統合運用管理ツールもしくは運用管理コマンドより全ての トランザクションが終了していることを確認してください。トランザクションが残っている場 合は全てのトランザクションを終了させてください。詳細についてはオンラインマニュアル 「運用編」を参照してください。 (3) Administrator 権限をもつユーザでログインし、次のサービスが起動していればサービスマネ ージャで停止します。
WebOTX AS Agent Service
WebOTX Developer（with Developer’s Studio） のアンインストール
(1) アンインストールの開始コントロールパネルの「プログラムと機能」から「WebOTX Developer（with Developer’s Studio）」を選択し「変更」ボタンを押します。
(2) [WebOTX Developer（with Developer’s Studio）のメンテナンス]画面
Windows インストーラが起動し、「インストール準備中」というメッセージが表示されたあ と、次の画面が表示されます。「次へ」ボタンを押してください。
17 (3) [プログラムの保守]画面 [プログラムの保守]画面が表示されます。アンインストールを行うために「削除」を選択し「次 へ」ボタンを押します。プログラムの修復を行う場合には「修復」を選択します。
18 (4) [削除オプション]画面 [削除オプション]画面が表示されます。定義情報を削除するときは「定義情報の削除」をチェ ック後「次へ」ボタンを押してください。 (5) [プログラムの削除]画面 [プログラムの削除]画面が表示されます。「削除」ボタンを押して、ファイルの削除を開始し ます。
19 (6) [アンインストールしています]画面 [アンインストールしています]画面が表示され、ファイルの削除が始まります。削除が終了す るまで時間がかかりますので、しばらくお待ちください。 (7) [アンインストールの完了]画面 次の画面が表示されたら、アンインストールは完了です。「完了」ボタンを押します。 (8) マシンの再起動
20
アンインストールが完了したら、マシンを再起動してください。
アンインストール後の作業
WebOTX Developer(with Developer's Studio)のアンインストール後に行う必要のある作業につ いて説明します。
• WebOTX Developer(with Developer's Studio) で作成したプロジェクトの情報を再度使用し ない場合には次のファイルを削除してください。
<WebOTX のインストールディレクトリ>¥Developer¥Studio¥workspace 配下の全ファイル • 以下のディレクトリが残っている場合には、削除してください。
<WebOTX のインストールディレクトリ>¥Developer¥Studio¥p2
<WebOTX のインストールディレクトリ>¥Developer¥Studio¥configuration
• WebOTX Developer(with Developer's Studio) のテスト用サーバを使用していた場合、 WebOTX の動作環境(ドメイン情報)が残っている場合があります。WebOTX を再インストール しない場合は、次のファイルを削除してください。
21
5. 動作確認
セットアップしたWebOTX Developer(with Developer's Studio)が正しく動作するかを確認す る方法について説明します。
Windows の「スタート」メニューの「WebOTX」の「Developer's Studio」をクリックし、「WebOTX Developer's Studio」を起動してください。正常に起動すれば正しくインストールされています。 テスト用サーバをインストールしている場合は、運用管理コマンド「otxadmin」で動作確認を行 います。コマンドは次のとおりです。 1. Windows の「スタート」-「すべてのプログラム」-「WebOTX」-「運用管理コマンド」をク リックしてください。 プロンプト画面が表示されます。 2. プロンプト画面で次のコマンドを入力してください。 「domain1」と「WebOTXAdmin」が running 状態になっていることを確認してください。 3. ブラウザを起動し、次の URL を入力してください。 http://<WebOTX をインストールしたマシン名>:5858/ 運用管理コンソールが起動されれば正しくインストールされています。 otxadmin> list-domains
22
6. 注意制限事項
インストール時にJava SE 7 Update 55 を指定すると、ドメインの作成に失敗します。 Java SE 7 Update 55 をご利用になる場合は、Java SE 7 Update 51 の環境にインストール 後、利用するJava を Java SE 7 Update 55 に変更してください。
詳細は以下のページをご確認ください。
「Java SE 7 Update 55 で実施された改修による WebOTX への影響について」 http://www.support.nec.co.jp/View.aspx?id=3010100850 WebOTX Developer のインストール後、運用を行う場合には必ずコンピュータの再起動を行 ってください。コンピュータを再起動しないと、WebOTX Developer は正常に動作しません。 アンインストールする製品以外の WebOTX 製品がマシンにインストールされている場合に は、「定義情報の削除」をチェックしないでください。 アンインストール時に「定義情報の削除」を選択した場合でも、インストールフォルダにデ ィレクトリやファイルが残る場合があります。アンインストール完了後、すべて削除してく ださい。
「テスト用サーバ」は、外部Web サーバ(IIS、WebOTX Web サーバ、Apache HTTP Server、 Sun Java System Web Server、Sun ONE Web Server 等)と連携動作することはできません。
「テスト用サーバ」をインストールした場合、WebOTX のサービスが自動起動プログラムと して登録されます。WebOTX のサービスを手動起動に設定する場合、「コントロールパネル」 の「サービス」から次のサービスを選択し、「スタートアップの種類」を「手動」に変更して ください。
WebOTX AS Agent Service
「テスト用サーバ」とWebOTX 各 Edition 製品の同時インストール
WebOTX Developer のインストール時に選択できる「テスト用サーバ」機能は、「WebOTX Application Server Express / Standard / Enterprise 」と同一環境にインストールすること はできません。
既に「テスト用サーバ」がインストールされている環境に、WebOTX の各 Edition 製品をイ ンストールする場合には、「プログラムと機能」から「WebOTX テスト用サーバ」を削除し ます。その後、WebOTX の各 Edition 製品のインストールを実行してください。
「テスト用サーバ」を利用して評価するとき、JDBC ドライバで Apache Derby を使用する 場合、Java SE Development Kit 7 Update 51 以降の SDK のバージョンでは、セキュリテ ィ機能が強化された影響により、既定値でデータベースを開始することができません。
WebOTX 統合運用管理コンソールを起動し、[アプリケーションサーバ]-[データベースコントロ ーラ]をクリックし、右ページの[定義情報]タブをクリックして、[データベースの起動コマンド]
23 の引数で「-noSecurityManager」を設定してください。 例）"C:¥Program Files¥Java¥jdk1.7.0_51¥db¥bin¥startNetworkServer.bat" -h localhost -p 1527 -noSecurityManager 試用期間の365 日を経過するとドメインの起動に失敗します。 運用管理コマンドから起動した場合 start-domain コマンド実行後、以下のメッセージが表示され、ドメインの起動に失敗し ます。
「com.nec.webotx.enterprise.admin.servermgmt.DomainException: Your license is invalid. Please obtain a valid license for server.」
サービスから起動した場合
Windows サービス上は起動完了と表示されますが、サービス開始後、<WebOTX イン ストール先>¥logs¥WOAgentSvc_start.log ファイルに以下のメッセージが表示され、 ドメインの起動に失敗します。
「com.nec.webotx.enterprise.admin.servermgmt.DomainException: Your license is invalid. Please obtain a valid license for server.」
