Referencia de mandatos de Docker Compose

Puede ejecutar el mandato ./om-compose.sh con argumentos que se ajusten a sus requisitos. Por ejemplo, ./om-compose.sh <arguments>.

La tabla siguiente proporciona la lista de mandatos y argumentos para ejecutar om-compose.sh:
Mandatos Descripción
./om-compose.sh setup
<optional: full_path_to_custom jar>
Configura un entorno de kit de herramientas de desarrollador contenerizado por primera vez. Además, despliega el JAR de personalización proporcionado, aunque es opcional. Para obtener más información, consulte Configuración del entorno del kit de herramientas de desarrollador contenerizado.
./om-compose.sh setup-upg
<optional: full_path_to_custom_jar>

Actualiza un entorno de kit de herramientas de desarrollador contenerizado existente con nuevas imágenes (actualización). Además, despliega el JAR de personalización proporcionado, aunque es opcional. Esto es similar al argumento de configuración, pero ejecuta datos de fábrica de carga y vistas de carga en la modalidad de 'actualización'.

Antes de ejecutar setup-upg para actualizar al siguiente paso, se recomienda que cree una copia de seguridad de la configuración ejecutando la exportación de la herramienta de despliegue de configuración (CDT) desde el tiempo de ejecución del host.

Para obtener más información, consulte Actualización de un entorno de kit de herramientas de desarrollador contenerizado existente.

./om-compose.sh update-extn
<optional: full_path_to_custom_jar>
Actualiza un entorno existente con sólo el paquete de personalización, sin captar nuevas imágenes.

Asimismo, integre el kit de herramientas para desarrolladores con servicios en la nube, como Sterling™ Intelligent Promising Inventory Visibility y Sterling Store Engagement.

Para obtener más información, consulte Actualizar extensiones personalizadas en un entorno de kit de herramientas de desarrollador contenerizado.
./om-compose.sh check-services Prueba la conectividad con servicios integrados en la nube, como Sterling Intelligent Promising Inventory Visibility y Sterling Store Engagement.
./om-compose.sh extract-rt

Extrae el contenido de tiempo de ejecución en el directorio devtoolkit_docker/runtime de la máquina host.

Puede crear una copia del tiempo de ejecución de Sterling Order Management System en la máquina host desde la imagen Docker de om-runtime. Este directorio de tiempo de ejecución se puede utilizar para desarrollar personalizaciones, acceder a Javadoc, ejecutar agentes y scripts como CDT. No es necesario especificar el contenedor Docker para realizar ninguna de estas tareas.

./om-compose.sh start <optional: service name>
./om-compose.sh stop <optional: service name>
./om-compose.sh restart <optional: service name>
Inicia las paradas y reinicia todos los servicios de Docker Compose . Si no se pasa ningún nombre de servicio al mandato, todos los servicios se inician, se detienen o se reinician. De lo contrario, el mandato sólo funciona en el servicio pasado. Los nombres de servicio para distintos servicios son omruntime, appserver, mqserver y db2server.
./om-compose.sh wipe-clean Destruye todos los contenedores y suprime todos los volúmenes correspondientes al entorno de Docker Compose . Restablece el entorno para que pueda volver a ejecutar la configuración. Opcionalmente, puede mantener una copia de seguridad de la configuración utilizando CDT.
Nota: La ejecución del script compuesto con este argumento elimina por completo la configuración.
./om-compose.sh add-queue
<new_queue_name_in_all_caps> <queue length>
Añade una nueva cola local en el servidor IBM MQ y también actualiza el archivo de enlaces IBM MQ . También puede proporcionar una longitud de cola personalizada, el valor predeterminado es 5000.
./om-compose.sh delete-queue
<queue_name_to be deleted_in_all_caps>
Suprime la cola local especificada en el servidor IBM MQ y también actualiza el archivo de enlaces IBM MQ .
./om-compose.sh import-cert <arg1> <arg2> Importa certificados de terceros.
Tiene en cuenta los siguientes argumentos:
  • El primer argumento es la vía de acceso relativa al directorio devtoolkit_docker/certificates .
  • El segundo argumento es el alias.
./om-compose.sh remove-cert <arg1> Elimina certificados de terceros.

El primer argumento es que hay que eliminar el alias.

./om-compose.sh start-agent "<server args,
starting with servername>" <optional:debug port>
<optional:suspend option, Y or y>
Ejecute el servidor de agente en modalidad de depuración.
  • Los argumentos primero y segundo son obligatorios.
  • Si no se proporciona el argumento <debug port> , la depuración no está habilitada.
  • Si se proporciona el puerto de depuración, pero no se proporciona el argumento de opción de suspensión (Y o y), la depuración se habilita con suspend=n.
  • Si se proporciona el puerto de depuración y la opción de suspensión se proporciona como Y o y, la depuración se habilita con suspend=y.
Por ejemplo, para ejecutar el servidor ScheduleOrder con más parámetro -jvminstance schedOrdL1, con la depuración habilitada en el puerto 8384 y la suspensión para la depuración habilitada, ejecute el mandato siguiente:
./om-compose.sh start-agent "ScheduleOrder 
-jvminstance schedOrdL1" 8384 Y
./om-compose.sh start-intg "<server args,
starting with servername>" <optional:debug port>
<optional:suspend option, Y or y>
Ejecute el servidor de integración en modalidad de depuración.
  • Los argumentos primero y segundo son obligatorios.
  • Si no se proporciona el argumento <debug port> , la depuración no está habilitada.
  • Si se proporciona el puerto de depuración, pero no se proporciona el argumento de opción de suspensión (Y o y), la depuración se habilita con suspend=n.
  • Si se proporciona el puerto de depuración y la opción de suspensión se proporciona como Y o y, la depuración se habilita con suspend=y.
./om-compose.sh resetpsw-mq <o:user>

La contraseña predeterminada para la consola de IBM MQ se establece en el archivo compose/docker/docker-compose.properties . La variable MQ_PASS contiene una contraseña para el usuario administrativo y MQ_PASS2 contiene una contraseña para el usuario lector.

Puede actualizar las contraseñas de usuario de la consola de IBM MQ utilizando el argumento ./om-compose.sh resetpsw-mq <o:user> .

El argumento <o:user> hace referencia a usuarios de IBM MQ que son usuarios administradores o lectores.

Después de actualizar la contraseña, puede iniciar sesión en la consola de IBM MQ especificando el nombre de usuario, que es admin o reader, y la contraseña actualizada.

./om-compose install-ri Instala la implementación de referencia en el Developer Toolkit (DTK).
Nota: Los registros para cada mandato que se ejecuta están presentes en el directorio compose/logs .

Referencias de mandatos de Docker Compose para IBM Sterling Call Center

Si desea utilizar Sterling Call Center, puede ejecutar el mandato ./cc-compose.sh con argumentos que se ajusten a sus requisitos. Por ejemplo, ./cc-compose.sh <arguments>

La tabla siguiente proporciona la lista de mandatos y argumentos para ejecutar cc-compose.sh:
Mandato Descripción
./ cc-compose.sh start
./ cc-compose.sh stop
./ cc-compose.sh restart
Inicia las paradas y reinicia los contenedores de Sterling Call Center .

Los contenedores de Sterling Call Center son:

  • om-call-center-ext and
  • om-call-center-base

Pasos a seguir si la máquina host se reinicia o se reinicia

  1. Una vez reiniciada la máquina host, asegúrese de que Docker y Docker Compose estén en ejecución. Ejecute el mandato siguiente para asegurarse de que Docker se está ejecutando. Si devuelve los contenedores en el estado de salida, siga el paso 3. De lo contrario, siga el paso 2.
    docker ps -a
  2. Si Docker no se está ejecutando, ejecute el mandato siguiente como superusuario:
    systemctl start docker

    Además, puede habilitar de forma permanente Docker ejecutando el mandato siguiente como superusuario:
    systemctl enable docker

  3. Vaya al directorio devtoolkit_docker/compose/ y ejecute el mandato siguiente:
    ./om-compose.sh start
    Nota: Si utiliza IBM® Sterling Call Center, ejecute el mandato ./cc-compose.sh start .
    Importante: Si el kit de herramientas de desarrollador se ejecuta en un entorno WSL 2 de Windows, el localhost es el sistema WSL 2. En lugar del mandato systemctl , debe ejecutar el mandato siguiente como superusuario para iniciar Docker:
    sudo service docker start

    Ejecute el mandato cada vez que se reinicie el sistema WSL 2 o puede establecer en el nivel fstab , que a continuación iniciará y habilitará Docker cada vez que se reinicie el sistema WSL 2.