Solución de problemas 26.03
Esta página enumera los mensajes que pueden aparecer al configurar BBjShip, implementar una aplicación, iniciar una ejecución de desarrollo o usar la línea de comandos de bbjship. Para cada mensaje, indica la causa y qué hacer.
Si falla un objetivo de Maven, la compilación termina con un mensaje breve sobre el objetivo, seguido del motivo. El motivo es la parte que se enumera en esta página:
BBj deployment failed. Check the application package, dependencies and deployment settings: BBj deployment failed with HTTP 409. Entry class com.example.Application is already published as inventory. Undeploy inventory first
Credenciales y conexi ón
Estos mensajes pueden aparecer con cualquier objetivo que se comunique con BBjShip: bbj-setup, bbj-deploy, bbj-undeploy y watch.
| Mensaje | Causa | Qué hacer |
|---|---|---|
Warning: the BBj factory administrator account admin is in use with its factory password... | No se configuró ni el nombre de usuario ni la contraseña, así que el objetivo inicia sesión como admin con admin123. | Cambia la contraseña en Enterprise Manager y configura las credenciales nuevas; consulta Configuración. |
The BBj administration user name is missing, The BBj administration password is missing | Solo se configuró el nombre de usuario o la contraseña. | Configura ambos, o ninguno para usar la cuenta de fábrica. bbj-deploy y bbj-undeploy también aceptan un token. |
BBj deployment requires bbj.deployment.url... | No se configuró ninguna URL de implementación. | Establece <bbj><deployment><url> o pasa -Dwebforj.bbj.deployment.url=<URL>. |
BBj deployment URL must be an HTTP or HTTPS URL without credentials, query or fragment | La URL usa otro esquema o incluye un nombre de usuario, una consulta o un fragmento. | Usa http://<host>:<port>/webforj-bbjship o https://<host>:<port>/webforj-bbjship y coloca las credenciales en <admin>. |
Connect to ... failed: Connection refused | No hay respuesta en el host y el puerto de la URL de implementación. | Inicia BBjServices y comprueba que el host y el puerto de la URL coincidan con los del servidor web de BBjServices. |
could not read the BBjShip version at <URL>, HTTP 404... | La URL no apunta a BBjShip, o BBjShip no está instalado o su punto de conexión no está habilitado en ese puerto. | Comprueba la ruta /webforj-bbjship y el puerto. En la máquina de BBj, ejecuta mvn webforj:bbj-setup o, en un servidor, bbjship remote enable. |
failed with HTTP 401. Check the BBj administration credentials or token | BBjServices rechazó el nombre de usuario y la contraseña, o el token. | Comprueba las credenciales. Renueva en Enterprise Manager cualquier token que haya caducado o se haya revocado. |
BBjShip <version> at <URL> does not match webforJ <version>... | BBjShip instalado y webforj-maven-plugin tienen versiones distintas. | En tu propia máquina, ejecuta mvn webforj:bbj-setup -Dwebforj.bbj.force=true. En un servidor, instala la versión correspondiente de BBjShip con BBj Plugin Manager. |
could not establish a trusted HTTPS connection to <URL>... | Java no confía en el certificado del servidor web de BBjServices. | Instala en la máquina de BBj un certificado para el nombre de host de la URL, o agrega su certificado al almacén de confianza de Java de la compilación. |
BBj deployment URL <URL> sends the administration credentials over an unencrypted connection to another machine... | La URL de implementación es una URL http:// que apunta a otra máquina. El objetivo se detiene antes de enviar nada. Con allowUnencrypted, el mismo texto es una advertencia y el objetivo continúa. | Usa una URL https:// con el puerto SSL, o permite HTTP en ambos extremos; consulta Implementar desde otra máquina. |
Configuración
Estos mensajes aparecen al ejecutar mvn webforj:bbj-setup y durante la primera ejecución de desarrollo de un proyecto, que configura BBjShip de la misma manera.
| Mensaje | Causa | Qué hacer |
|---|---|---|
BBj setup failed. Check the BBj plugin artifact and setup settings | El objetivo falló. A continuación aparece el motivo. Si el motivo está relacionado con la resolución de artefactos, Maven no pudo descargar webforj-bbjship-plugin con la versión de webforj-maven-plugin. | Lee el motivo. Si se trata de la resolución de artefactos, comprueba los repositorios y el acceso a la red de la compilación. |
BBj setup is local only. Run setup on the BBj host | La URL de implementación apunta a otra máquina. | Ejecuta la configuración en la máquina de BBj o instala allí BBjShip con BBj Plugin Manager. |
BBj setup cannot resolve the deployment URL host <host>... | No se reconoce el nombre de host de la URL de implementación. | Usa localhost o el nombre de esta máquina. |
BBj setup requires the administration password. Configure bbj.admin.password instead of a token | Hay un token configurado para una ejecución de desarrollo. Las ejecuciones de desarrollo solo inician sesión con un nombre de usuario y una contraseña. | Configura <admin><username> y <admin><password>. |
Cannot detect a BBj installation. Configure bbj.home or BBJ_HOME | El objetivo no encontró ninguna instalación de BBj en esta máquina. | Establece <bbj><home>, -Dwebforj.bbj.home o la variable BBJ_HOME en la carpeta de instalación de BBj. |
Invalid BBj home. Configure a local BBj installation, BBj executable is missing or not executable. Check bbj.home | La carpeta configurada no contiene una instalación completa de BBj. | Apunta la configuración a la carpeta que contiene bin y cfg de BBj. |
Installed BBjShip version <version> does not match <version>... | Hay instalada otra versión de BBjShip, por ejemplo, después de actualizar webforJ. | Ejecuta mvn webforj:bbj-setup -Dwebforj.bbj.force=true. Las aplicaciones implementadas permanecen implementadas. |
Installed BBjShip version is missing... | La carpeta de BBjShip instalado está incompleta. | Ejecuta mvn webforj:bbj-setup -Dwebforj.bbj.force=true. |
The plugin directory is a symbolic link..., BBj plugin destination must not contain symbolic links | La carpeta plugins de BBj, o la carpeta de BBjShip que contiene, es un enlace simbólico o contiene uno. | Instala en una carpeta normal. |
BBj setup command failed. Check credentials and local BBjServices. seguido de la salida del comando | Falló el comando que habilita el punto de conexión de implementación. La salida indica el motivo; por ejemplo, un inicio de sesión rechazado o un puerto en el que el servidor web no escucha. | Comprueba las credenciales, que BBjServices esté en ejecución y que el puerto de la URL de implementación corresponda a un puerto del servidor web de BBjServices. |
BBj setup command timed out. Check local BBjServices | El comando no terminó en 120 segundos. | Comprueba que BBjServices esté en ejecución y responda; después, vuelve a ejecutar el objetivo. |
Previous BBjShip files are preserved at <folder> | Falló el reemplazo y se conservaron en esa carpeta los archivos de la versión anterior. | Corrige la causa del fallo y vuelve a ejecutar el objetivo. |
Implementar y retirar la implementación
Antes de la carga
Estos mensajes aparecen con bbj-package, bbj-deploy y bbj-undeploy antes de que nada llegue a BBjShip.
| Mensaje | Causa | Qué hacer |
|---|---|---|
BBj deployment requires jar packaging, this project is packaged as <packaging> | El proyecto no está empaquetado como un archivo jar. | Establece <packaging>jar</packaging>. |
BBj deployment requires the packaged application jar... | El objetivo se ejecutó sin la fase package en la misma compilación. | Ejecuta mvn install o mvn package webforj:bbj-deploy. |
BBj deployment must not carry webforj-engine, BBj is the engine... | webforj-engine está en la ruta de clases de ejecución de la aplicación. | Exclúyelo de la dependencia webforj; consulta Sin el complemento de instalación. |
BBj deployment requires webforj-foundation on the runtime classpath | La aplicación no tiene una dependencia de webforJ en tiempo de ejecución. | Agrega la dependencia webforj con ámbito compile. |
BBj deployment dependency is unresolved... | Una dependencia de la aplicación no tiene ningún archivo. | Comprueba que Maven resuelva todas las dependencias del proyecto. |
Publish name <name> is invalid... | El nombre de publicación infringe las reglas de Nombres de publicación. | Elige otro <publishName>. |
The publish name <name> is reserved by BBjServices for its own web paths... | BBjServices usa ese nombre para sus propias direcciones. | Elige otro <publishName>. |
BBj deployment archive could not be written... | bbj-package no pudo escribir target/bbj/<publish name>.zip. A continuación aparece el motivo. | Lee el motivo. |
Respuestas de BBjShip
Cuando BBjShip rechaza una implementación o una retirada, el mensaje comienza con BBj deployment failed with HTTP <status> o BBj undeployment failed with HTTP <status>, seguido del motivo.
| Estado | Motivo | Causa | Qué hacer |
|---|---|---|---|
| 400 | Publish name <name> is invalid... o ...is reserved by BBjServices... | Se rechaza el nombre de publicación. | Elige otro nombre de publicación. |
| 400 | BBj deployment webforj.conf is invalid. <detail> | No se puede leer el webforj.conf de la aplicación o una configuración de la aplicación tiene un tipo incorrecto. | Corrige el archivo según lo que indique el detalle. |
| 400 | The uploaded body is not a BBj deployment archive..., Invalid BBj deployment archive entry: <entry> u otro motivo relacionado con el archivo comprimido | El complemento de compilación no creó el archivo comprimido o este se modificó después. | Implementa el archivo comprimido que genera la compilación, con la misma versión de webforJ que BBjShip. |
| 401 | Check the BBj administration credentials or token | Se rechazó el inicio de sesión. | Comprueba las credenciales o renueva el token. |
| 403 | BBjShip refuses the administration credentials over an unencrypted connection from another machine. Use the SSL port of the BBjServices web server | La solicitud llegó por HTTP desde otra máquina. | Usa la dirección HTTPS del punto de conexión o ejecuta bbjship remote enable --allow-unencrypted en la máquina de BBj. |
| 403 | Development runs are not enabled on this BBj machine. Run bbjship development enable | Una ejecución de desarrollo llegó a una máquina en la que las ejecuciones de desarrollo están desactivadas. | Ejecuta bbjship development enable en la máquina de BBj. |
| 404 | No BBj application named <name> was deployed by BBjShip. Check the publish name | Se intentó retirar una aplicación que BBjShip no implementó. | Comprueba el nombre de publicación con bbjship apps list. |
| 409 | Entry class <class> is already published as <name>. Undeploy <name> first | La clase de entrada de la aplicación ya se ejecuta con otro nombre de publicación. | Retira la otra aplicación o implementa con su nombre. |
| 409 | Published BBj application <name> is not owned by BBjShip... | Una aplicación registrada en Enterprise Manager ya usa ese nombre. | Elige otro nombre de publicación o elimina esa aplicación en Enterprise Manager. |
| 409 | Published BBj application <other> differs from <name> only by letter case... | Otra aplicación usa el mismo nombre con mayúsculas y minúsculas distintas. | Elige otro nombre de publicación. |
| 409 | <name> is a development run. Stop the watch first | Hay una ejecución de desarrollo activa para la aplicación. | Detén watch con Ctrl+C y luego implementa. |
| 409 | <name> is deployed from an archive. Undeploy it first | Una ejecución de desarrollo usa el nombre de una aplicación implementada. | Retira la aplicación o establece otro <publishName> para la ejecución de desarrollo. |
| 413 | BBj deployment archive exceeds the allowed size of 1 GiB | El archivo comprimido es más grande de lo que BBjShip acepta. | Elimina las dependencias que la aplicación no necesite en tiempo de ejecución. |
| 500 | BBj deployment failed. Check the BBjServices log | BBjServices falló al instalar o eliminar la aplicación. | Lee los registros de BBjServices. |
Si una implementación termina con did not confirm the requested application. Check the BBjShip version and BBjServices log, llegó a BBjShip, pero no recibió confirmación de la aplicación. Comprueba que BBjShip y webforj-maven-plugin tengan la misma versión y luego lee el registro de BBjServices.
La aplicación en ejecución
| Mensaje | Causa | Qué hacer |
|---|---|---|
Icons protocol requires webforj.assetsSource = packaged when running with BBj Services | La aplicación usa icons:// sin recursos empaquetados. | Agrega webforj.assetsSource = packaged a webforj.conf e implementa de nuevo. |
Ejecuciones de desarrollo
Estos mensajes aparecen al ejecutar mvn o mvn compile webforj:watch en un proyecto configurado para BBjShip. Una ejecución de desarrollo fallida comienza con BBj development run failed. Check the deployment settings and that development runs are enabled on the BBj machine, seguido del motivo de Configuración, Credenciales y conexión o Respuestas de BBjShip.
| Mensaje | Causa | Qué hacer |
|---|---|---|
The class folder <folder> does not exist. Run compile before webforj:watch | watch se inició antes de compilar el proyecto. | Ejecuta mvn compile webforj:watch o mvn en un proyecto de arquetipo. |
BBj development class folder must be an absolute directory on the BBj machine | <development><classFolder> indica una carpeta que BBjServices no encuentra. | Establece la ruta absoluta de la carpeta de clases en la máquina de BBj. |
BBjServices properties file not found at <file>. Configure bbj.properties | El archivo de propiedades de BBjServices no está en la ubicación donde la ejecución lo busca. | Establece <bbj><properties> o -Dwebforj.bbj.properties en la ruta del archivo. |
BBjServices did not stop within 180 seconds | La ejecución pidió detener BBjServices para aplicar la configuración de hotswap, pero el proceso siguió en ejecución. | Detén BBjServices manualmente, vuelve a iniciarlo y ejecuta watch de nuevo. |
BBjServices start program is missing: <program> | La instalación de BBj no incluye un programa para iniciar BBjServices. | Inicia BBjServices manualmente y ejecuta watch de nuevo. |
BBjServices did not start. The program ended with exit code <code>, BBjServices did not start within 120 seconds | BBjServices no volvió a iniciarse después del reinicio. | Inicia BBjServices manualmente y luego ejecuta watch de nuevo. |
BBjShip did not answer within 120 seconds | BBjServices se inició, pero el punto de conexión de implementación no respondió. | Comprueba el registro de BBjServices y luego ejecuta watch de nuevo. |
BBjServices restarted without the hotswap settings. Check <file> | BBjServices se inició con argumentos de Java distintos de los escritos en el archivo de propiedades. | Comprueba la configuración de Java de BBjServices en Enterprise Manager y en ese archivo. |
webforJ watch: development run of <name> was not stopped. <reason> | No se pudo eliminar la aplicación cuando se detuvo la compilación. | Elimínala con bbjship apps undeploy <name> o vuelve a iniciar watch, que la reemplazará. |
La primera ejecución de desarrollo que agrega la configuración de hotswap reinicia BBjServices. En macOS y Linux, inicia BBjServices con bin/bbjservices. En Windows, inicia el servicio de Windows BBjServices si está registrado; de lo contrario, ejecuta bin\BBjServices.exe -noservice. Si BBjServices se inicia con bin/bbjservices o -noservice, se ejecuta fuera del administrador de servicios del sistema operativo hasta que se reinicie la máquina.
Línea de comandos
Todos los comandos de bbjship se ejecutan dentro de BBjServices, por lo que BBjServices debe estar en ejecución. Sin él, el comando no puede iniciarse.
Los argumentos no válidos terminan con el código de salida 2 y un mensaje que indica qué especificar:
| Mensaje | Qué hacer |
|---|---|
Specify a command. Use --help for available commands, Unknown command <command>... | Indica un comando; consulta Línea de comandos. |
Unknown option <option>..., Option <option> is not available for <command>... | Usa una opción disponible para ese comando, tal como se indica en --help. |
Specify a user name after --username, Specify a password after --password, Specify a port after --port | Asigna un valor a la opción. |
Specify --port from 1 to 65535, Specify --ssl-port from 1 to 65535 | Indica un número de puerto. |
Specify <option> only once | Elimina la opción repetida. |
Specify only one of --password and --password-stdin | Conserva solo una de las dos opciones. |
The BBj administration password is missing. Specify --username and --password <value> or --password-stdin, or set WEBFORJ_BBJ_USERNAME and WEBFORJ_BBJ_PASSWORD | Indica el nombre de usuario y la contraseña juntos. El mensaje indica cuál falta. |
Specify an application name or --all, Specify one application name | Proporciona un nombre de publicación a apps undeploy, o indica --all. |
Specify the path of a deployment archive ending in .zip, Specify one deployment archive | Proporciona un archivo .zip a apps deploy. |
Deployment archive <path> does not exist, Deployment archive <path> cannot be read | Comprueba la ruta. BBjServices lee el archivo, así que el usuario del sistema operativo que ejecuta BBjServices necesita permiso de lectura. |
Development archives are deployed by the watch, not by apps deploy | Implementa el archivo comprimido de bbj-package, no el de una ejecución de desarrollo. |
Publish name <name> is invalid..., The publish name <name> is reserved... | Cambia el nombre del archivo comprimido. El nombre de publicación es el nombre del archivo sin .zip. |
Un comando que falla termina con el código de salida 1 y Command failed., seguido del motivo:
| Motivo | Causa | Qué hacer |
|---|---|---|
| Un fallo de inicio de sesión de BBjServices | El nombre de usuario o la contraseña son incorrectos. | Comprueba las credenciales. |
The BBjServices web server does not answer on port <port>. Use the HTTP port of the BBjServices web server | --port o --ssl-port no corresponde a un puerto en el que escuche el servidor web de BBjServices. El punto de conexión anterior permanece activo. | Usa los puertos configurados para el servidor web en Enterprise Manager. |
Application <name> is not deployed by BBjShip | apps undeploy indicó una aplicación que BBjShip no implementó. | Comprueba el nombre con bbjship apps list. |
Another deployment is in progress | Otra implementación o retirada ocupó la máquina durante 30 segundos. | Espera a que termine y vuelve a ejecutar el comando. |
The BBjShip context belongs to another application, The assets context belongs to another application | Otra aplicación de Enterprise Manager usa el contexto web webforj-bbjship o webforj-bbjship-assets. | Cambia el nombre de ese contexto o elimínalo en Enterprise Manager. |
The BBjShip command classpath belongs to another application, The BBjShip base classpath contains an unowned library | Se modificaron las rutas de clases _webforj_bbjship_cli o _webforj_bbjship en Enterprise Manager. | Elimina ambas rutas de clases en Enterprise Manager y vuelve a ejecutar el comando para que las cree de nuevo. |
The BBjShip servlet is missing. Check the plugin installation, The BBjShip library is missing. Check the plugin installation | La carpeta de BBjShip está incompleta. | Vuelve a instalar BBjShip. |
BBjServices does not manage web contexts. Update BBj | La versión de BBj es demasiado antigua para BBjShip. | Instala la versión de BBj que corresponda a webforJ. |
reset termina con el código de salida 1 y Reset cancelled si la respuesta a Continue? [y/N] no es y ni Y. Cuando restaura la configuración de Java de BBjServices, termina con Restart BBjServices now to apply the restored Java settings. Reinicia BBjServices para ejecutarlo sin la configuración de hotswap.
Windows
| Situación | Qué hacer |
|---|---|
Al ejecutar bbj.exe con el programa BBjShip no se muestra nada. | Ejecuta bbjship.cmd en <BBj home>\plugins\webforj-bbjship, que muestra la salida del comando. |
--password-stdin termina con el código de salida 2 y Standard input is not available on Windows. Use --password <value> or WEBFORJ_BBJ_PASSWORD. | Pasa la contraseña con --password o establece WEBFORJ_BBJ_USERNAME y WEBFORJ_BBJ_PASSWORD. |
reset termina con el código de salida 2 y Standard input is not available on Windows. Run reset --yes to confirm. | Ejecuta bbjship.cmd reset --yes. |
apps undeploy o reset muestra Not removed: <folder>. <reason> y termina con el código de salida 0. | BBjServices todavía mantiene abiertos archivos de la aplicación. La aplicación se elimina de Enterprise Manager. Reinicia BBjServices. La carpeta se eliminará con la próxima implementación de ese nombre; también puedes eliminarla después del reinicio. |
| La instalación de BBjShip sobre una versión instalada falla porque sus archivos están en uso. | BBjServices todavía mantiene abiertos los archivos de BBjShip instalado. Reinicia BBjServices y vuelve a instalarlo. |
| BBjServices no se ejecuta como servicio de Windows después de que lo reinicia una ejecución de desarrollo. | La ejecución de desarrollo lo inició con BBjServices.exe -noservice porque no hay ningún servicio BBjServices registrado. Se ejecuta fuera del administrador de servicios de Windows hasta que se reinicie la máquina. |
No se puede iniciar un comando bbjship.cmd. | Inicia BBjServices. Todos los comandos de bbjship necesitan que esté en ejecución. |
