1. セットアップ

本編では、WebOTX Developerのセットアップについて説明します。

WebOTX Developerは、提供する開発機能により「WebOTX Developer (with Developer's Studio)」と「WebOTX Developer (for CORBA Application)」に分かれています。

WebOTX Developer (with Developer's Studio) は、Java EEアプリケーションの開発に利用できるIDE機能(Developer's Studio)と各種プラグイン機能をインストールします。 また、評価版 WebOTX Application Server Expressを同梱しています。評価版 WebOTX Application Server Expressをインストールすることで、Java EEアプリケーションの開発/配備/実行(デバッグ)までを一貫して実行できます。

WebOTX Developer (for CORBA Application) は、CORBAアプリケーションの開発を行うために必要なヘッダ、ライブラリ、およびデバッグ用のDLLファイルをインストールします。 また、Microsoft Visual BasicクライアントアプリケーションやJMSアプリケーションの開発に必要なファイルもインストールします。

このように、用途によって2つのインストーラが存在しますが、1つのWebOTX Developer ライセンスで両方を共通に使用できます。 Java EEとCORBAのアプリケーションを1つのマシンで開発するために両方をインストールする場合は、1つのライセンスキーを双方で利用できます。

以降の説明では、「評価版WebOTX Application Server Express」を「テスト用サーバ」と記載します。

1.1. 使用上の条件

本章では、WebOTX Developerを利用するために必要なメモリ容量、固定ディスク空き容量などのハードウェア・リソースと、動作対象オペレーティング・システムやJava、データベース・サーバなどのソフトウェアについて説明します。

1.1.1. 必要リソース

ここでは、WebOTX Developerをインストールするために必要な固定ディスク空き容量と、インストール中、およびインストール後の初期動作で必要なメモリ容量について説明します。

下記に示すメモリ容量は、インストール時に既定値を選択して動作させた場合を表しています。

ハード ディスク容量は、選択インストール可能な機能やプロダクトを全てインストールした場合を表しています。 ただし、CコンパイラやJ2SE SDKなどの関連ソフトウェアのディスク消費量は含まれていません。

(注) WebOTX Developerのインストーラーは、Java EE開発用途の「WebOTX Developer (with Developer's Studio)」とCORBA開発用途の「WebOTX Developer (for CORBA Application)」に分離しています。
1つのライセンスで両方をインストールすることができます。

1.1.1.1. WebOTX Developer (with Developer's Studio)

表1.1.1.1-1
プラットフォーム メモリ ハード ディスク
Windows - Intel x86
Windows - Intel 64 		最小 512 MB、推奨 1 GB以上 1.5 GB
ディスプレイは、解像度1024 x 768、16ビットカラー以上が表示可能なカラーモニタを推奨します。
これらのリソースには、テスト用サーバの容量も含まれます。

1.1.2. ソフトウェア条件について

サポートするオペレーティング・システム(OS)とハードウェア、および、利用するために必要な関連ソフトウェアについて説明します。

1.1.2.1. オペレーティング・システム

動作対象であるオペレーティング・システムとハードウェアの対応を以下に示します。

1.1.2.2. Java 2 SDK, Standard Edition

WebOTX DeveloperでJavaアプリケーションを開発する場合は、Java™ 2 Platform, Standard EditionのSDKを必要とします。 サポートするSDKバージョンは次のとおりです。

適用するJava SEのSDKバージョンの注意・制限事項や動作対象OSに関しては、[ セットアップガイド > 1. 使用上の条件 > 1.2. ソフトウェア条件について > 1.2.2. Java 2 SDK, Standard Edition ] を参照してください。

1.1.2.3. 対応ソフトウェア

開発するアプリケーションがサーバ側の実行時環境でデータベース・サーバなどの外部サービスと連携する場合には、必要に応じて開発環境に利用する外部サービスから提供されるライブラリやドライバを準備することになります。

対応しているサーバ製品に関しては、[ セットアップガイド > 1. 使用上の条件 > 1.2. ソフトウェア条件について > 1.2.5. 対応ソフトウェア ] を参照してください。

1.1.2.4. SAP連携モジュールを利用する場合に必要なソフトウェア

ESB開発ツールのSAP連携モジュールを利用する場合は以下のソフトウェアが必要になります。
表1.1.2.4-1
ソフトウェア バージョン
.NET Framework 4.5, 4.5.1, 4.5.2
SAP .NET Connector(*1) 3.0.15.0
SAP Java Connector(*1)(*2) 3.0.12
(*1)SAP社から入手が必要です。32bit用と64bit用が分かれているためインストールの環境に合わせて入手してください。
(*2)テスト用のESBサーバでSAP連携モジュールを利用して作成したアプリケーションを動かす場合に必要です。

1.2. WebOTX Developer (with Developer's Studio)

1.2.1. インストール

本章では、WebOTX Developerのインストール方法について説明します。

WebOTXメディアは、対応するプラットフォームによって枚数や収録内容が異なります。 WebOTX Developerが格納されている位置は、WebOTX ASのセットアップガイドに記載された内容から確認してください。

1.2.1.1. インストール前の作業

インストール前に必ず行う必要がある作業と確認事項について説明します。

一般的な確認事項は、 WebOTX ASで記載される「WebOTXの停止とアンインストール」と「JDKのインストール」を参照してください。

製品をインストールする前に次の作業を行います。

インストール作業は、必ず管理者権限があるユーザで行わなければなりません。 管理者権限があるユーザでログインしていることを確認してください。
インストールを行う場合は、Build-in Administratorユーザで行うか、 管理者権限のあるユーザでも「管理者として実行」 によりインストーラを起動してください。

この作業が完了したら「 1.2.1.2. インストール作業」に進んでください。

1.2.1.2. インストール作業

WebOTX Developer をインストールする手順について説明します。

関連する下記の項目は、WebOTX ASの説明を参照してください。

WebOTX Client
WebOTX マニュアル
  1. WebOTXメディアのDVD-ROM媒体 をDVD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Developer (with Developer's Studio) V9.3] を選び、「Install」ボタンを押してください。

    DVD-ROM を挿入しても下の画面が自動的に表示されない場合は、 エクスプローラで下記のいずれかを実行してください。

    <ドライブ>:\wo_setup.exe
     
    <ドライブ>:\DEV\setup.exe
     
    <ドライブ>:\x86\DEV\setup.exe
    (Windows(x64)用 DVDメディアに格納されている Windows(x86) 用インストーラ)
    <ドライブ>は、DVD-ROMドライブのドライブ文字です。

    WebOTX メディアの開始画面
    図1.2.1.2-1

  2. Windowsインストーラが起動し、「インストールの準備中」というメッセージが表示されたあと、 次の画面が表示されます。「次へ」ボタンを押してください。

    開発環境のインストーラ開始画面
    図1.2.1.2-2




  3. [ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力します。
    [ライセンスキー] ボックスには、製品に添付されている 「ソフトウェア使用認定証」の「製品番号」に記載されている19桁の番号を正しく入力します。
    入力した情報に間違いがなければ「次へ」ボタンを押してください。

    ユーザ名登録画面
    図1.2.1.2-3




  4. [インストール先のフォルダ] 画面が表示されますので、インストール先フォルダを決定し「次へ」ボタンを押してください。
    インストール先フォルダを変更する場合には「変更」ボタンを押してください。
    他のWebOTX 製品がすでにインストールされている場合、同じフォルダを指定してください。

    インストール先指定画面
    図1.2.1.2-4




  5. [カスタムセットアップ] 画面が表示されます。インストールする機能を選択し「次へ」ボタンを押してください。

    カスタムセットアップ画面
    図1.2.1.2-5



    リストにある各アイコンの意味は次のとおりです。

    表1.2.1.2-1
    アイコン 説明
    WebOTX Developer WebOTXを利用した開発に、必要となる環境をインストールします。
      Developer's Studio WebOTX Developer's Studio をインストールします。
    NECで独自に開発したJava EE 6 対応アプリケーション開発機能をもつ、 Eclipseベースの統合開発環境(IDE)を提供します。
      サーバ連携ツール WebOTX Application Server との連携に必要なプラグインをインストールします。
    アプリケーション開発ツール Java EE開発に必要なプラグインをインストールします。
      Portal開発ツール ポートレット開発に必要なプラグインをインストールします。
    Enterprise Service Bus開発ツール Enterprise Service Bus開発に必要なプラグインをインストールします。
      SAP連携モジュール SAPと連携するESBアプリケーション開発に必要なプラグインをインストールします。インストールには.NET Frameworkが必要です。
    開発支援ツール バグ検出ツール（FindBugs）、カバレッジツール（JaCoCo）、ソース解析ツール(PMD)を インストールします。
    ヘルプ ヘルプをインストールします。
    Eclipse言語パック メニューや画面を、各国語表示とする環境をインストールします。
    テスト用サーバ(*1) 開発環境上で動作する、テスト用サーバをインストールします。
    Java EE 6 対応アプリケーションの配備／実行／デバックが可能です。
    なお WebOTX Application Server の別エディションがすでにインストールされている場合には、 この機能を選択することはできません。
    拡張製品の開発機能を選択している場合は、以下の対応したテスト用サーバもインストールされます。
    • Portal開発ツールを選択している場合はテスト用のポータルサーバ(*2)
    • Enterprise Service Bus開発ツールを選択している場合はテスト用のESBサーバ

    (*1) WebOTX Developer (with Developer's Studio)のオプション製品に関する開発機能が追加されている 場合があります。それらの機能については、インストールに使用するWebOTX Mediaのセットアップカードを ご参照ください。

    (*2) WebOTX Portalのテスト用サーバのインストールではテーブル構築のため、JDKに同梱されている Java DB(Derby)を利用します。 選択したJDKをインストール時にJava DB をインストールしていない場合は、 Java DB をインストール後に再度実施して下さい。また、再インストール等で構築済みのDBが残っている場合、 DBの内容は初期化されます。



  6. [インストール済みの JDK フォルダ] 画面が表示されますので、 既にマシンにインストールされている JDK のインストールフォルダを選択後、 「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。

    インストール先指定画面
    図1.2.1.2-6




  7. 「テスト用サーバ」を選択した場合、[ポート番号の設定]画面が表示されますので、 テスト用サーバのドメイン(domain1)で利用する HTTP/HTTPS 通信用のポート番号を設定後、「次へ」ボタンを押してください。
    ここで設定するポート番号は、他の製品で利用するポート番号と重複しないように設定してください。

    ポート設定画面
    図1.2.1.2-7




  8. [プログラムをインストールする準備ができました] 画面が表示されます。「インストール」ボタンを押してください。

    インストール開始画面
    図1.2.1.2-8




  9. [WebOTX Developer をインストールしています] 画面が表示され、ファイルのコピーが始まります。選択された機能により、セットアップに 必要な時間は異なります。ファイルのコピーが終了するまでお待ちください。

    インストール中の画面
    図1.2.1.2-9




  10. 「Portal開発ツール」ならびに「テスト用サーバ」を選択した場合、ファイルのコピー後に以下の画面が表示されます。

    webotx_portal_portlet.key更新の画面
    図1.2.1.2-10




  11. 「テスト用サーバ」を選択した場合、ファイルのコピー後にWebOTX の初期ドメイン環境(WebOTXAdmin, domain1)を Apache Antコマンドで設定するため、次の画面が表示されます。画面が終了するまでしばらくお待ちください。Apache Ant コマンドの実行結果は<WebOTX のインストールフォルダ>\ant_setup.log で確認できます。

    ant_setup.bat 起動画面
    図1.2.1.2-10




  12. 「Portal開発ツール」ならびに「テスト用サーバ」を選択した場合、WebOTX の初期ドメイン環境構築後に以下の画面が表示されます。 WebOTX Portalのテスト用サーバのためのデータベース設定をJDK付属のDerbyに行いますので、画面が終了するまでしばらくお待ちください。

    WebOTX Portalテスト用サーバのDB構築の画面
    図1.2.1.2-12




  13. 「Portal開発ツール」ならびに「テスト用サーバ」を選択した場合、WebOTX Portalテスト用サーバのDB構築後に以下の画面が表示されます。 WebOTX Portalのテスト用サーバの環境構築を行いますので、画面が終了するまでしばらくお待ちください。

    WebOTX Portalのテスト用サーバの環境構築の画面
    図1.2.1.2-13




  14. 次の画面が表示されたら、セットアップは完了です。「完了」ボタンを押してください。

    インストール終了画面
    図1.2.1.2-11




  15. コンピュータを再起動してください。


次は、「 インストール後の作業」を行います。

1.2.1.3. インストール後の作業

WebOTXをインストールした後に行う必要のある作業について説明します。

1.2.2. アンインストール

本章では、WebOTX Developerのアンインストール方法について説明します。

1.2.2.1. アンインストール前の作業

1.2.2.2. アンインストール作業

WebOTX Developerをアンインストールする手順について説明します。

  1. 「コントロールパネル」の「プログラムと機能」から「変更」ボタンを押します。
    または、WebOTX DVD-ROM をDVD-ROMドライブに挿入して、アンインストールする製品を選択して [Uninstall」ボタンを押します。


  2. Windowsインストーラが起動し、「インストール準備中」というメッセージが表示されたあと、次の画面が表示されます。「次へ」ボタンを押してください。

    アンインストール完了画面
    図1.2.2.2-1




  3. [プログラムの保守]画面が表示されます。
    アンインストールを行うために「削除」を選択し「次へ」ボタンを押します。 プログラムの修復を行う場合は「修復」を選択します。

    プログラムの保守画面
    図1.2.2.2-2




  4. [削除オプション]画面が表示されます。
    定義情報を削除するときは「定義情報の削除」をチェック後「次へ」ボタンを押してください。 アンインストール後も定義情報(ドメインの情報)を残したいときや他のWebOTX 製品がまだインストールされている 場合はそのまま「次へ」ボタンを押します。

    削除オプション画面
    図1.2.2.2-3




  5. [プログラムの削除]画面が表示されます。「削除」ボタンを押して、ファイルの削除を開始します。

    プログラムの削除始画面
    図1.2.2.2-4




  6. [アンインストールしています]画面が表示され、ファイルの削除が始まります。削除が終了するまで時間がかかりますので、しばらくお待ちください。

    アンインストール中の画面
    図1.2.2.2-5




  7. 次の画面が表示されたら、アンインストールは完了です。「完了」ボタンを押します。

    アンインストール開始画面
    図1.2.2.2-6



[注意事項]

1.2.2.3. アンインストール後の作業

アンインストール後に行う必要のある作業について説明します。

1.2.3. バックアップ

製品のバージョンアップ等のために、WebOTX Developerをアンインストールして、その後にインストールしなおす場合があります。 この際のバックアップについて説明します。

1.2.3.1. 環境の退避

環境の退避は、バージョンアップ前の環境を保存したり、環境の移行の際の移行前の環境を保存するといった際に利用します。 バージョンアップの際には、旧バージョンのWebOTX製品をアンインストールする前に行ってください。

開発環境IDEで作成したプロジェクト情報をバックアップする場合は、次のファイルをバックアップしてください。

<WebOTXのインストールディレクトリ>\Developer\Studio\workspace

テスト用サーバの情報をバックアップする場合は、次のファイルをバックアップしてください。

<WebOTXインストールディレクトリ>\config 配下の全ファイル
<WebOTXインストールディレクトリ>\domains 配下の全ファイル

1.2.3.2. 環境の復元

退避した環境を、バージョンアップしたWebOTXに戻したり、移行するマシンに適用するといった際に利用します。
ただし、以下の場合はファイルコピーのみでは復元できません。

この場合、設定の変更や必要なドメイン作成によるOSのサービス登録情報復元などを行う必要があります。 詳細は「ドメインの運用」をご覧ください。

テスト用サーバの復元は以下の手順で行ってください。

  1. バックアップした次のファイルを元の場所にコピーしてください。
     
    <WebOTXインストールディレクトリ>\config 配下のファイル
    <WebOTXインストールディレクトリ>\domains 配下のファイル

1.2.3.3. 環境の移行

WebOTXの環境を別のマシンに移行する場合の手順は以下のとおりです。 ただし、移行前のマシンと移行後のマシンで別々のWebOTXのライセンスを利用する場合は、移行前のマシンのWebOTXを削除する必要はありません。

  1. 移行前のマシンの環境の退避
    環境の退避を参照してください。

  2. 移行前のマシンのWebOTXの削除
    移行前のマシンのWebOTXをアンインストールしてください。 UNIX版の場合は、設定したライセンスも削除してください。

  3. 移行後のマシンへのWebOTXのインストール
    移行するマシンにWebOTXをインストールしてください。

  4. 移行後のマシンに環境を復元
    環境の復元を参照してください。

1.2.4. 動作確認

本章では、セットアップしたWebOTX Developerが正しく動作するかを確認する方法について説明します。

Windowsの「スタート」-「すべてのプログラム」-「WebOTX」-「Developer's Studio」をクリックし、「WebOTX Developer's Studio」を起動してください。正常に起動すれば正しくインストールされています。

テスト用サーバをインストールしている場合は、運用管理コマンド「otxadmin」で動作確認を行います。コマンドは次のとおりです。

  1. Windowsの「スタート」-「すべてのプログラム」-「WebOTX」-「運用管理コマンド」をクリックしてください。 プロンプト画面が表示されます。

  2. プロンプト画面で次のコマンドを入力してください。
    otxadmin> list-domains
    「domain1」と「WebOTXAdmin」がrunning状態になっていることを確認してください。

  3. ブラウザを起動し、次のURLを入力してください。
    http://localhost:5858/
    運用管理コンソールが起動されれば正しくインストールされています。

  4. WebOTX Portalのテスト用サーバがインストールされている場合は、次のURLを入力してください。
    http://localhost/webotxportal/login
    WebOTX Portalのログイン画面が表示され、以下のユーザIDとパスワードでログインできれば正しくインストールされています。
    表1.2.4-1
    項目 値
    ユーザID USER0000
    パスワード 空白以外の任意文字