Installation d'une application par programmation

Vous pouvez installer une application via la console d'administration, l'outil wsadmin ou la programmation. Cet exemple permet d'installer une application par programmation.

Avant de commencer

Cette tâche suppose une connaissance de base de la programmation MBean. Pour plus d'informations sur la programmation MBean, voir la documentation sur l'API (Application Programming Interface) Java™ MBean. Dans le centre de documentation, cliquez sur Référence > Interfaces Mbean.

Avant de pouvoir installer une application sur WebSphere Application Server, vous devez installer cette dernière.

Pourquoi et quand exécuter cette tâche

L'instance AppDeploymentController contient des métadonnées définies dans les descripteurs de déploiement XML1 ainsi que des annotations définies dans les classes Java au sein du fichier d'archive d'entreprise (EAR) d'entrée.

Procédez comme suit pour installer une application par programmation.

Procédure

  1. Remplissez le fichier EAR avec les informations de liaisons spécifiques deWebSphere Application Server.
    1. Créez le contrôleur et intégrez les options appropriées aux fichier EAR.
    2. Exécutez éventuellement le générateur de liaison par défaut.
    3. Enregistrez et fermez le fichier EAR.
    4. Récupérez le tableau d'options enregistrées à transmettre à l'API MBean installApplication.
  2. Connectez-vous à WebSphere Application Server.
  3. Créez le proxy de gestion d'applications.
  4. Si la phase de préparation (remplissage du fichier EAR) n'a pas lieu, procédez comme suit :
    1. Créez un tableau d'options à transmettre à l'API MBean installApplication.
    2. Créez un tableau pour les relations module/serveur et ajoutez-le à celui d'options.

      Voir la classe com.ibm.websphere.management.application.AppManagement dans la documentation des interfaces de programme d'application pour comprendre les diverses options qu'il est possible de transmettre à l'API MBean installApplication.

  5. Créez le filtre de notification pour écouter les événements d'installation.
  6. Ajoutez le module d'écoute.
  7. Installez l'application.
  8. Patientez un instant pour que le programme ne prenne pas fin.
  9. Ecoutez les notifications JMX (Java Management Extensions) pour connaître la fin de l'opération.
  10. Au terme de l'installation, supprimez le module d'écoute et quittez l'application.

Résultats

Une fois le code exécuté, l'application est installée.

Exemple

L'exemple suivant explique comment installer une application en suivant la procédure précédente. Certaines instructions sont présentées sur plusieurs lignes à des fins d'affichage.

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 
// product-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 the product.
  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);
        }
    }
}

Que faire ensuite

Une fois l'application installée, vous devez explicitement démarrer l'application ou vous devez arrêter, puis redémarrer le serveur.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjmx_install_app
Nom du fichier : tjmx_install_app.html