Dépannage du logiciel Oracle Java Web Console

Les informations suivantes permettent de résoudre les problèmes que vous pouvez rencontrer lors de votre utilisation du logiciel Oracle Java Web Console.

Vérification des propriétés et de l'état de la console

Vous pouvez utiliser les commandes smcwebserver, wcadmin et svcs pour obtenir différents types d'informations sur la console, qui peuvent être utiles dans le cadre de la résolution de problèmes.

Procédure permettant de vérifier si la console est en cours d'exécution et activée

Connectez-vous en tant que superutilisateur ou endossez un rôle équivalent.
Les rôles contiennent des autorisations et des commandes privilégiées. Pour plus d'informations sur les rôles, reportez-vous à la section Configuring RBAC (Task Map) du System Administration Guide: Security Services.

Vérifiez l'état du serveur.

# smcwebserver status
Sun Java(TM) Web Console is running

Solaris 10 11/06 : vérifiez l'état d'activation et le statut SMF de la console.
```
# svcs -l system/webconsole:console
```
Si vous démarrez et arrêtez le serveur à l'aide de la commande smcwebserver sans activation ni désactivation, la propriété enabled peut s'afficher comme false (temporary) ou true (temporary).

Procédure permettant de répertorier les propriétés et ressources de la console

Connectez-vous en tant que superutilisateur ou endossez un rôle équivalent.
Les rôles contiennent des autorisations et des commandes privilégiées. Pour plus d'informations sur les rôles, reportez-vous à la section Configuring RBAC (Task Map) du System Administration Guide: Security Services.

Répertoriez les ressources et les propriétés de la console.

Si vous exécutez Solaris 10 11/06 ou une version ultérieure, utilisez cette commande :

# wcadmin list

Deployed web applications (application name, context name, status):
 
    console      ROOT            [running]
    console      com_sun_web_ui  [running]
    console      console         [running]
    console      manager         [running]
    legacy       myapp           [running]
 
Registered jar files (application name, identifier, path):
 
    console  audit_jar     /usr/lib/audit/Audit.jar
    console  console_jars  /usr/share/webconsole/lib/*.jar
    console  jato_jar      /usr/share/lib/jato/jato.jar
    console  javahelp_jar  /usr/jdk/packages/javax.help-2.0/lib/*.jar
    console  shared_jars   /usr/share/webconsole/private/container/shared/lib/*.jar
 
Registered login modules (application name, service name, identifier):
 
    console  ConsoleLogin  userlogin
    console  ConsoleLogin  rolelogin
 
Shared service properties (name, value):
 
    ENABLE yes
    java.home         /usr/jdk/jdk1.5.0_06

Remarque - Cette propriété ENABLE n'est pas prise en compte, car l'utilitaire SMF utilise sa propre propriété enabled, comme illustré dans la procédure précédente. La propriété ENABLE est utilisée sur les systèmes plus anciens où le serveur de la console n'est pas géré par l'utilitaire SMF.

Pour les versions Oracle Solaris 10, Solaris 10 1/06 et Solaris 10 6/06, utilisez cette commande :

# smreg list

 The list of registered plugin applications:

com.sun.web.console_2.2.4       /usr/share/webconsole/console
com.sun.web.ui_2.2.4    /usr/share/webconsole/com_sun_web_ui
com.sun.web.admin.example_2.2.4 /usr/share/webconsole/example

The list of registered jar files:

com_sun_management_services_api.jar scoped to ALL
com_sun_management_services_impl.jar scoped to ALL
com_sun_management_console_impl.jar scoped to ALL
com_sun_management_cc.jar scoped to ALL
com_sun_management_webcommon.jar scoped to ALL
com_iplanet_jato_jato.jar scoped to ALL
com_sun_management_solaris_impl.jar scoped to ALL
com_sun_management_solaris_implx.jar scoped to ALL

The list of registered login modules for service ConsoleLogin:

com.sun.management.services.authentication.PamLoginModule optional
use_first_pass="true" commandPath="/usr/lib/webconsole";
com.sun.management.services.authentication.RbacRoleLoginModule requisite
force_role_check="true" commandPath="/usr/lib/webconsole";

The list of registered server configuration properties:

session.timeout.value=15
authentication.login.cliservice=ConsoleLogin
logging.default.handler=com.sun.management.services.logging.ConsoleSyslogHandler
logging.default.level=info
logging.default.resource=com.sun.management.services.logging.resources.Resources
logging.default.filter=none
logging.debug.level=off
audit.default.type=None
audit.None.class=com.sun.management.services.audit.LogAuditSession
audit.Log.class=com.sun.management.services.audit.LogAuditSession audit.class.fail=none
authorization.default.type=SolarisRbac
authorization.SolarisRbac.class=
com.sun.management.services.authorization.SolarisRbacAuthorizationService
authorization.PrincipalType.class=
com.sun.management.services.authorization.PrincipalTypeAuthorizationService
debug.trace.level=0
.
.
.
No environment properties have been registered.

Problèmes d'accès à la console

Les problèmes d'accès à la console peuvent indiquer que le serveur de la console n'est pas activé ou que les paramètres de sécurité sont restrictifs. Pour plus d'informations, reportez-vous aux sections Vérification des propriétés et de l'état de la console et Considérations relatives à la sécurité Oracle Java Web Console.

Problèmes liés à l'enregistrement de l'application

Cette section contient des informations sur la résolution des problèmes d'enregistrement des applications de la console. Pour plus d'informations sur une application de la console en particulier, reportez-vous à sa documentation.

Remarque - En général, les applications de la console sont enregistrées au cours de leur installation, de sorte que vous ne devez normalement pas effectuer l'enregistrement vous-même.

À partir de la version Solaris 10 11/06, la console Web a modifié l'approche de l'enregistrement des applications, mais elle prend toujours en charge les applications développées pour ses versions antérieures. Les applications en cours sont enregistrées et déployées à l'aide d'une commande unique pendant l'exécution du serveur de la console. Les applications développées pour la console antérieure sont appelées applications existantes et exigent l'arrêt du serveur de la console lors de leur enregistrement. Si vous devez enregistrer une application ou en annuler l'enregistrement, vous devez d'abord déterminer s'il s'agit d'une application existante, comme décrit dans la procédure suivante.

Procédure permettant de déterminer si une application est une application existante

Consultez le fichier app.xml de l'application.
Le fichier app.xml réside dans le répertoire WEB-INF de l'application.
Examinez la balise registrationInfo dans le fichier app.xml.
Pour une application existante, la balise registrationInfo est une version 2.x. Par exemple, registrationInfo version="2.2.4".
Pour une application actuelle, la version dans la balise registrationInfo est au moins 3.0. Par exemple, registrationInfo version="3.0".

Procédure permettant de répertorier les applications déployées

Connectez-vous en tant que superutilisateur ou endossez un rôle équivalent.
Les rôles contiennent des autorisations et des commandes privilégiées. Pour plus d'informations sur les rôles, reportez-vous à la section Configuring RBAC (Task Map) du System Administration Guide: Security Services.
Répertoriez les applications déployées.
Si vous exécutez Solaris 10 11/06 ou une version ultérieure, utilisez cette commande :
```
# wcadmin list -a

Deployed web applications (application name, context name, status):
 
    console  ROOT            [running]
    console  com_sun_web_ui  [running]
    console  console         [running]
    console  manager         [running]
    legacy   myapp           [running]
```
La commande répertorie toutes les applications enregistrées et déployées. Les applications existantes sont répertoriées avec le nom d'application legacy. Reportez-vous à la section Procédure permettant de déterminer si une application est une application existante . Toutes les autres applications répertoriées sont des applications actuelles, enregistrées selon la procédure décrite à la section Procédure d'enregistrement d'une application actuelle avec Oracle Java Web Console .
En règle générale, l'état qui apparaît pour les applications est soit running ou stopped. Si l'état est running, l'application est chargée et disponible. Si l'état est stopped, l'application n'est pas chargée ni disponible. Il arrive qu'une application soit enregistrée et déployée correctement, sans pouvoir être chargée en raison d'un problème interne. Si c'est le cas, l'état de l'application est stopped. Dans le journal console_debug_log , vérifiez s'il existe une erreur avec une trace du conteneur Web sous-jacent de la console, Tomcat, lors de la tentative de chargement de l'application. Pour plus d'informations sur console_debug_log, reportez-vous à la section Utilisation du journal de suivi du débogage de la console.
Si toutes les applications affichent stopped (y compris l'application de la console), le conteneur Web de la console n'est généralement pas en cours d'exécution. La liste des applications dans ce cas est dressée à partir des fichiers statiques .xml enregistrés avec le conteneur Web.
Pour les versions Oracle Solaris 10, Solaris 10 1/06 et Solaris 10 6/06, utilisez cette commande :
```
# smreg list -a

The list of registered plugin applications:

        com.sun.web.console_2.2.4       /usr/share/webconsole/console
        com.sun.web.ui_2.2.4    /usr/share/webconsole/com_sun_web_ui
        com.sun.web.admin.yourapp_2.2.4 /usr/share/webconsole/yourapp
```

Procédure d'enregistrement d'une application existante avec Oracle Java Web Console

Remarque - Cette procédure s'applique à toutes les applications de console dans les versions Oracle Solaris 10, Solaris 10 1/06 et Solaris 10 6/06. À partir de Solaris 10 11/06, cette procédure s'applique uniquement aux applications identifiées en tant qu'applications existantes. La section Procédure d'enregistrement d'une application actuelle avec Oracle Java Web Console décrit la procédure d'enregistrement des applications actuelles. Reportez-vous également à la section Procédure permettant de déterminer si une application est une application existante .

Connectez-vous en tant que superutilisateur ou endossez un rôle équivalent.
Les rôles contiennent des autorisations et des commandes privilégiées. Pour plus d'informations sur les rôles, reportez-vous à la section Configuring RBAC (Task Map) du System Administration Guide: Security Services.
Arrêtez le serveur Web.
```
# smcwebserver stop
```
Enregistrez l'application.
```
# smreg add -a /directory/containing/application-files 
```
La commande smreg gère les informations contenues dans la table d'enregistrement d'Oracle Java Web Console. Ce script exécute également des tâches supplémentaires pour le déploiement de l'application. La page de manuel smreg(1M) contient les autres options associées à cette commande.
Redémarrez le serveur Web.
```
# smcwebserver start
```

Exemple 3-8 Enregistrement d'une application existante

Cet exemple illustre comment enregistrer une application existante dont les fichiers résidant dans le répertoire /usr/share/webconsole/example. Notez que pour les applications existantes, le serveur de la console doit être arrêté avant et démarré après leur enregistrement. Un avertissement émis par la commande smreg peut être ignoré, car il s'agit d'une application de console existante.

# smcwebserver stop
# smreg add -a /usr/share/webconsole/example

    Warning: smreg is obsolete and is preserved only for
    compatibility with legacy console applications. Use wcadmin instead.

    Type "man wcadmin" or "wcadmin --help" for more information.

Registering com.sun.web.admin.example_version.

# smcwebserver start

Procédure d'annulation de l'enregistrement d'une application existante d'Oracle Java Web Console

Remarque - Cette procédure s'applique à toutes les applications de console dans les versions Oracle Solaris 10, Solaris 10 1/06 et Solaris 10 6/06. À partir de Solaris 10 11/06, cette procédure s'applique uniquement aux applications identifiées en tant qu'applications existantes. La section Procédure d'annulation de l'enregistrement d'une application actuelle d'Oracle Java Web Console décrit la procédure d'annulation de l'enregistrement des applications actuelles.

Si vous ne souhaitez pas qu'une application existante s'affiche dans la page de démarrage de la console Web sans pour autant désinstaller le logiciel, vous pouvez annuler son enregistrement à l'aide de la commande smreg. Reportez-vous à la section Procédure permettant de déterminer si une application est une application existante .

Connectez-vous en tant que superutilisateur ou endossez un rôle équivalent.
Les rôles contiennent des autorisations et des commandes privilégiées. Pour plus d'informations sur les rôles, reportez-vous à la section Configuring RBAC (Task Map) du System Administration Guide: Security Services.
Annulez l'enregistrement d'une application.
```
# smreg remove -a app-name
```

Exemple 3-9 Annulation de l'enregistrement d'une application existante d'Oracle Java Web Console

Cet exemple illustre comment annuler l'enregistrement d'une l'application existante à l'aide de la commande app-name com.sun.web.admin.example.

# smreg remove -a com.sun.web.admin.example

 Unregistering com.sun.web.admin.example_version.

Procédure d'enregistrement d'une application actuelle avec Oracle Java Web Console

Solaris 10 11/06 : cette procédure s'applique aux applications de la console mises à jour qui peuvent être enregistrées et déployées sans qu'il soit nécessaire d'arrêter et de démarrer le serveur de la console. Reportez-vous à la section Procédure d'enregistrement d'une application existante avec Oracle Java Web Console pour connaître la procédure d'enregistrement des applications existantes et de toutes les applications de console présentes dans les versions Oracle Solaris 10, Solaris 10 1/06 et Solaris 10 6/06. Reportez-vous également à la section Procédure permettant de déterminer si une application est une application existante .

Connectez-vous en tant que superutilisateur ou endossez un rôle équivalent.
Les rôles contiennent des autorisations et des commandes privilégiées. Pour plus d'informations sur les rôles, reportez-vous à la section Configuring RBAC (Task Map) du System Administration Guide: Security Services.

Enregistrez et déployez l'application.

wcadmin deploy -a app-name -x app-context-name
 /full path/to/app-name

Exemple 3-10 Enregistrement des applications actuelles

Cet exemple illustre comment enregistrer et déployer une application développée ou mise à jour pour la console Web actuelle.

# wcadmin deploy -a newexample_1.0 -x newexample /apps/webconsole/newexample

Procédure d'annulation de l'enregistrement d'une application actuelle d'Oracle Java Web Console

Solaris 10 11/06 : cette procédure s'applique aux applications de la console mises à jour dont l'enregistrement et le déploiement peuvent être annulés sans qu'il soit nécessaire d'arrêter et de démarrer le serveur de la console. Reportez-vous à la section Procédure d'annulation de l'enregistrement d'une application existante d'Oracle Java Web Console pour connaître la procédure d'annulation de l'enregistrement des applications existantes et de toutes les applications de console présentes dans les versions Oracle Solaris 10, Solaris 10 1/06 et Solaris 10 6/06. Reportez-vous à la section Procédure permettant de répertorier les applications déployées and Procédure permettant de déterminer si une application est une application existante afin de déterminer si une application est existante ou mise à jour.

Connectez-vous en tant que superutilisateur ou endossez un rôle équivalent.
Les rôles contiennent des autorisations et des commandes privilégiées. Pour plus d'informations sur les rôles, reportez-vous à la section Configuring RBAC (Task Map) du System Administration Guide: Security Services.
Annulez le déploiement et l'enregistrement de l'application.
```
# wcadmin undeploy -a newexample_1.0 -x newexample
```

Ignorer les liens de navigation
Quitter l'aperu
	Guide d'administration système : administration de base