WebSphere Application Server for i5/OS, Version 6.1   
             オペレーティング・システム: i5/OS

             目次と検索結果のパーソナライズ化

プログラミングによるアプリケーションのインストール

アプリケーションのインストールは、管理コンソール、 wsadmin ツール、またはプログラミングによって行うことができます。この例を使用し、プログラミングによって アプリケーションをインストールします。

始める前に

このタスクでは、MBean プログラミングに関する基本的な知識があることが前提になっています。MBean プログラミングについては、MBean Java アプリケーション・プログラミング・インターフェース (API) 資料を参照してください。

WebSphere Application Server 上にアプリケーションをインストールする前に、まず アプリケーションを作成または更新し、アセンブリー・ツールを使用してアセンブルする必要があります。

このタスクについて

以下のタスクを実行し、プログラミングによってアプリケーションをインストールします。

プロシージャー

  1. エンタープライズ・アーカイブ (EAR) ファイルに WebSphere Application Server 固有のバインディング情報を取り込みます。
    1. コントローラーを作成し、EAR ファイルに適切なオプションを取り込みます。
    2. オプションで、デフォルトのバインディング・ジェネレーターを実行します。
    3. EAR ファイルを保管してクローズします。
    4. installApplication MBean (API) に渡される、保管済みオプション・テーブルを検索します。
  2. WebSphere Application Server に接続します。
  3. アプリケーション管理プロキシーを作成します。
  4. 準備フェーズ (EAR ファイルへのデータ取り込み) が実行されない場合は、以下のアクションを実行します。
    1. installApplication MBean API に渡されるオプション・テーブルを作成します。
    2. サーバー関係に対してモジュールのテーブルを作成し、そのテーブルをオプション・テーブルに追加します。

      installApplication MBean API に渡すことができるさまざまなオプションを理解するには、Application Server API 資料の「com.ibm.websphere.management.application.AppManagement」クラスを参照してください。

  5. インストール・イベントを listen するための通知フィルターを作成します。
  6. リスナーを追加します。
  7. アプリケーションをインストールします。
  8. プログラムが終了しないように、タイムアウトまで待ちます。
  9. Java Management Extensions (JMX) 通知を listen し、オペレーションの完了を認識します。
  10. インストールされたら、リスナーを除去して終了します。

結果

コードが正常に実行されると、アプリケーションがインストールされます。

以下の例には、前のステップに基づいた、アプリケーションのインストール方法が示されています。 一部のステートメントは印刷目的のために複数行に分割されています。

import java.lang.*;
import java.io.*;
import java.util.*;
import java.lang.reflect.*;
import com.ibm.websphere.management.application.*;
import com.ibm.websphere.management.application.client.*;
import com.ibm.websphere.management.*;

import javax.management.*;

public class Install {

    public static void main(String[] args) {

        try {
  String earFile = "C:/test/test.ear";
  String appName = "MyApp";
             
// Preparation phase: Begin
// Through the preparation phase you populate the enterprise archive (EAR) file with 
// WebSphere Application Server-specific binding information. For example, you can specify
// Java Naming and Directory Interface (JNDI) names for enterprise beans, or virtual hosts 
// for Web modules, and so on.

// First, create the controller and populate the EAR file with the appropriate options.
  Hashtable prefs = new Hashtable();
  prefs.put(AppConstants.APPDEPL_LOCALE, Locale.getDefault());

// You can optionally run the default binding generator by using the following options.
// Refer to Java documentation for the AppDeploymentController class to see all the 
// options that you can set.
  Properties defaultBnd = new Properties();
  prefs.put (AppConstants.APPDEPL_DFLTBNDG, defaultBnd);
  defaultBnd.put (AppConstants.APPDEPL_DFLTBNDG_VHOST, "default_host");
  
// Create the controller.
  AppDeploymentController controller = AppDeploymentController
    .readArchive(earFile, prefs);
  AppDeploymentTask task = controller.getFirstTask();
  while (task != null)
  {
// Populate the task data.
   String[][] data = task.getTaskData();
// Manipulate task data which is a table of stringtask.
   task.setTaskData(data);
   task = controller.getNextTask();
  }
  controller.saveAndClose();
  
  Hashtable options = controller.getAppDeploymentSavedResults();
// The previous options table contains the module-to-server relationship if it was set by
// using tasks.
//Preparation phase: End

// Get a connection to WebSphere Application Server.
  String host = "localhost";
  String port = "8880";
  String target = "WebSphere:cell=cellName,node=nodeName,server=server1";

  Properties config = new Properties();
  config.put (AdminClient.CONNECTOR_HOST,  host);
  config.put (AdminClient.CONNECTOR_PORT,  port);
  config.put (AdminClient.CONNECTOR_TYPE, AdminClient.CONNECTOR_TYPE_SOAP);
  System.out.println ("Config: " + config);
     AdminClient _soapClient = AdminClientFactory.createAdminClient(config);

// Create the application management proxy, AppManagement.
  AppManagement proxy = AppManagementProxy. getJMXProxyForClient (_soapClient);

// If code for the preparation phase has been run, then you already have the options table.
// If not, create a new table and add the module-to-server relationship to it by uncommenting
// the next statement.
//Hashtable options = new Hashtable();
  options.put (AppConstants.APPDEPL_LOCALE, Locale.getDefault());

// Uncomment the following statements to add the module to the server relationship table if 
//  the preparation phase does not collect it.
//Hashtable module2server = new Hashtable();
//module2server.put ("*", target);
//options.put (AppConstants.APPDEPL_MODULE_TO_SERVER, module2server);

//Create the notification filter for listening to installation events.
  NotificationFilterSupport myFilter = new NotificationFilterSupport();
  myFilter.enableType (AppConstants.NotificationType);


//Add the listener.  NotificationListener listener = new AListener(_soapClient, myFilter, "Install: " + appName, AppNotification.INSTALL);
// Install the application.
  proxy.installApplication (earFile, appName, options, null);
  System.out.println ("After install App is called..");

// Wait for some timeout. The installation application programming interface (API) is 
//  asynchronous and so returns immediately.
// If the program does not wait here, the program ends.
  Thread.sleep(300000); // Wait so that the program does not end.

        }
        catch (Exception e) {
            e.printStackTrace();
        }

    }

}

// Specify the Java Management Extensions (JMX) notification listener for JMX events.
class AListener implements NotificationListener
{
    AdminClient _soapClient;
    NotificationFilterSupport  myFilter;
    Object handback;
    ObjectName on;
    String eventTypeToCheck;

    public AListener(AdminClient cl, NotificationFilterSupport fl,
Object h, String eType) throws Exception
    {
        _soapClient = cl;
        myFilter = fl;
        handback = h;
        eventTypeToCheck = eType;

        Iterator iter = _soapClient.queryNames (new ObjectName(
"WebSphere:type=AppManagement,*"), null).iterator();
        on = (ObjectName)iter.next();
        System.out.println ("ObjectName: " + on);
        _soapClient.addNotificationListener (on, this, myFilter, handback);
    }

    public void handleNotification (Notification notf, Object handback)
    {
            AppNotification ev = (AppNotification) notf.getUserData();
            System.out.println ("!! JMX event Recd: (handback obj= " + handback+ "): " + ev);


            //When the installation is done, remove the listener and quit.

            if (ev.taskName.equals (eventTypeToCheck) &&
                (ev.taskStatus.equals (AppNotification.STATUS_COMPLETED) ||
                 ev.taskStatus.equals (AppNotification.STATUS_FAILED)))
            {
                    try
                    {
                            _soapClient.removeNotificationListener (on, this);
                    }
            catch (Throwable th)
                    {
                        System.out.println ("Error removing listener: " + th);
                    }
                    System.exit (0);
        }
    }
}

次の作業

アプリケーションをインストールしたら、明示的にアプリケーションを開始するか、または停止してサーバーを再始動する必要があります。




サブトピック
プログラミングによるアプリケーションの開始
関連タスク
アプリケーション・サーバーの管理
プログラミングによるアプリケーションのアンインストール
プログラミングによるアプリケーションの更新
プログラミングによるアプリケーションの部分的な追加、更新、または削除
モジュールの準備とプログラミングによる既存アプリケーションへの追加
プログラミングによるモジュールの準備および更新
プログラミングによるモジュールの削除
プログラミングによるファイルの追加
プログラミングによるファイルの更新
プログラミングによるファイルの削除
タスク・トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 5:46:14 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.base.iseries.doc/info/iseries/ae/tjmx_install_app.html