Gestionar servicio de ordenación

Este tema contiene información sobre cómo los fundadores y los participantes gestionan el servicio de pedidos.

Además del contenido tratado en este tema, se pueden realizar varias tareas específicas del canal para los nodos de ordenante en la página Canales de la consola. Consulte:

¿Qué es el servicio de orden?

Oracle Blockchain Platform admite Raft como tipo de consenso.

Para obtener más información sobre la implementación de Hyperledger Fabric del protocolo Raft, consulte: The Ordering Service - Raft.

Con el tipo de consenso de Kafka más antiguo, toda la red puede tener como máximo dos nodos de orden, y tienen que unirse a todos los canales. En algunos casos, pueden estar sobrecargados y no se pueden reducir. Con el tipo de consenso Raft, la red puede tener un número arbitrario de nodos de ordenante, y cada canal puede definir su propio conjunto de nodos de ordenante. Los diferentes canales pueden utilizar diferentes nodos de ordenante, y los nodos de ordenante ya no serán el cuello de botella.

Sin embargo, el tipo de consenso Raft puede ser complicado de configurar correctamente. Hay reglas sobre lo que se puede o no se puede hacer, y si estas reglas no se siguen en el canal e incluso la red puede no funcionar. Las siguientes directrices deben reducir los problemas que se encuentran:

Mantener activa la mayoría de los nodos de servicio de órdenes (OSN)

El algoritmo de consenso Raft requiere que la mayoría de los nodos de servicio de pedidos (OSN) estén funcionando; de lo contrario, no se puede lograr ningún consenso. Mayoría significa más del 50%. Por ejemplo, para cinco OSN, debe haber al menos tres OSN trabajando; para seis OSN, debe haber al menos cuatro OSN trabajando.
  • Si hay un 50% o menos de OSN trabajando en la red, la gestión de red ya no será funcional. No se pueden crear nuevos canales, no se pueden agregar nuevos nodos de solicitante a la red, no se puede eliminar ningún solicitante de la red, etc.
  • Si hay un 50% o menos de OSN trabajando en el canal de aplicación, no se puede enviar ninguna transacción a este canal de aplicación. Las consultas pueden seguir funcionando correctamente, pero fallarán las operaciones administrativas, como agregar una nueva organización, cambiar la lista de control de acceso o crear instancias o desplegar códigos de cadenas.

Tenga cuidado al agregar un nuevo OSN a la red o a un canal de aplicación. Asegúrese de que el propietario es confiable y de que la OSN es sólida.

Al eliminar OSN o una organización, asegúrese de que más del 50% de los OSN sigan funcionando. Por ejemplo, si tuviera 2 organizaciones con 3 OSN cada una, si eliminó una organización, durante la eliminación se interpretaría como que solo el 50% de los OSN son funcionales. Agregue un OSN a la organización restante antes de suprimir la organización externa para asegurarse de que siempre supera el 50% de los OSN que funcionan.

No agregar ni eliminar solicitantes con frecuencia

Cada vez que se agrega un nuevo OSN a una red o canal, o se elimina un OSN existente de un canal, el cluster actual de OSN de Raft se volverá brevemente inestable. Durante este período, no se puede gestionar ninguna transacción y un mensaje de error similar al siguiente puede indicar dicho estado:
UNKNOWN: Stream removed
SERVICE UNAVAILABLE
BAD REQUEST

Esta operación puede durar algunos minutos. Si ha eliminado el OSN líder de la balsa anterior del canal, esto puede durar hasta 20 minutos.

Asegúrese de no agregar ni eliminar pedidos con frecuencia. Si se deben agregar o eliminar varios solicitantes, asegúrese de que la red haya vuelto al estado operativo antes de realizar el siguiente cambio.

Asegúrese de que el nuevo solicitante se inicia lo antes posible

Al agregar un nuevo ordenador a la red, generalmente participarán dos organizaciones: el fundador y el propietario del nuevo ordenador. Ambas partes deben seguir las instrucciones de Unirse a los OSN participantes o escalados al servicio de pedidos del fundador hasta su finalización o el fundador no podrá gestionar la red.

Unirse a los OSN participantes o escalados al servicio de pedidos del fundador

Al aprovisionar una instancia de participante, se crea con 3 solicitantes. Hay pedidos inactivos hasta que se unen a una red. Cuando escalas horizontalmente a un fundador, los nuevos solicitantes también están inactivos hasta que se unen a una red.

Si se deben agregar o eliminar varios solicitantes, asegúrese de que la red haya vuelto al estado operativo antes de realizar el siguiente cambio. Consulte ¿Qué es el servicio de órdenes? para obtener más información importante sobre cómo agregar, eliminar, iniciar y detener pedidos de balsa.

Exportación de la configuración de OSN de los solicitantes de participante o escalado horizontal

Para unirse al participante o a los encargados escalados a una red, debe exportar su configuración e importarla al fundador.

  1. En la consola del participante (o la consola fundadora para los pedidos escalados), en el separador Nodo, busque el nodo del solicitante (o el primer nodo del solicitante si existen varios nodos). Seleccione el menú Acción de este nodo y seleccione Exportar Valores de OSN.

    Esto generará un archivo JSON con la configuración y guardará el archivo. El archivo contiene el certificado de la organización y la configuración del nodo de servicio de solicitante (OSN) seleccionado firmados por la clave privada del administrador de la organización participante. Este archivo se debe enviar al administrador de la instancia fundadora.

    Las aplicaciones que se ejecutan en canales con este OSN también necesitan este certificado TLS exportado. Consulte Antes de desarrollar una aplicación.

  2. En la consola fundadora, abra el separador Red. Haga clic en Agregar OSN. Se abre una ventana que le solicita la ubicación del archivo JSON proporcionado por el participante. Seleccione esta opción para cargar el archivo y haga clic en Agregar.

    La organización de participante o el ordenador recientemente escalado se agregarán a la sección de organización de ordenador de la lista de canales del sistema.

Exportación de los valores de configuración del fundador

Una vez que el participante o los ordenantes escalados se han agregado al fundador, debe exportar la configuración del fundador e importarla al participante o al ordenador escalado.

  1. En la consola fundadora, abra el separador Red. Haga clic en Exportar bloque de configuración de red.

    El bloque de configuración de red contiene el último bloque de configuración de canal del sistema. Se puede guardar y enviar al administrador del participante.

  2. En la consola del participante (o la consola fundadora para los pedidos escalados), en el separador Nodo, busque el nodo del solicitante (o el primer nodo del solicitante si existen varios nodos). Seleccione el menú Acción para este nodo y seleccione Importar bloque de configuración de red.

    Se le pedirá el archivo enviado por el administrador de la instancia fundadora.

  3. En la consola del participante, refresque el separador Nodo. El estado del nodo del solicitante debe aparecer como "down". En el menú Acción, seleccione Iniciar.

    Cada nodo de solicitante iniciado se agregará al cluster de balsa en el fundador.

Cada vez que se agrega un nuevo OSN escalando horizontalmente el solicitante (como se describe en Escalado de la instancia), estos pasos se deben repetir para agregar el nuevo OSN al cluster de Raft.

Note:

No puede agregar varios OSN a una red en un solo lote. Asegúrese de que solo se agrega 1 OSN a la vez.

Edición de la configuración del servicio de pedidos para la red

Puede actualizar la configuración del servicio de orden para la instancia fundadora.

Tenga en cuenta la siguiente información importante sobre la edición de la configuración del servicio de indicación:
  • La configuración actualizada se utiliza al crear nuevos canales y no se aplica a los canales existentes.
  • Por separado, puede actualizar la configuración del servicio de ordenación para un canal existente individual, como se describe en Edit Ordering Service Settings for a Channel.
  • Si cambia la configuración del servicio de pedido y hay aplicaciones que se ejecutan en la red, dichas aplicaciones se deben actualizar manualmente para utilizar la configuración revisada del servicio de pedido.
  • No es común, pero en algunas situaciones, puede exponer un servicio de pedidos diferente a algunos de los participantes de la red. En este caso, exportará el bloque de configuración de red actualizado y los participantes necesarios importarán la configuración revisada. Consulte Join the Participant or Scaled-Out OSNs to the Founder's Ordering Service.
Debe ser administrador para realizar esta tarea.
  1. Vaya a la consola del fundador y seleccione el separador Red.
  2. Haga clic en el botón Configuración de servicio de pedido.
    Se muestra el cuadro de diálogo Configuración del servicio de pedido.
  3. Actualice la configuración según sea necesario.
    Campo Descripción
    Timeout de lote (ms) Especifique la cantidad de tiempo en milisegundos que el sistema debe esperar antes de crear un lote. Introduzca un número entre 1 y 3600000.
    Recuento Máximo de Mensajes Especifique el número máximo de mensajes que se van a incluir en un lote. Introduzca un número entre 1 y 4294967295.
    Bytes de mensaje absoluto Especifique el número máximo de bytes permitidos para los mensajes serializados en un lote.

    Este número debe ser mayor que el valor introducido en el campo Preferred Message Bytes.

    Bytes de mensaje preferidos Especifique el número preferido de bytes permitidos para los mensajes serializados en un lote. Un mensaje mayor que este tamaño da como resultado un lote mayor, pero el tamaño del lote será igual o menor que el número de bytes especificado en el campo Absolute Message Bytes.

    Oracle recomienda definir este valor en 1 MB o menos.

    El valor que introduzca en este campo debe ser menor que el valor que introduzca en el campo Bytes de mensaje absoluto.

    Tamaño de intervalo de instantánea Define el número de MB por los que se toma una instantánea.
  4. Haga clic en Actualizar.
    Se guarda la configuración actualizada.

Ver configuración de servicio de pedidos

Puede ver la configuración del servicio de pedido del fundador que se importó en la instancia de Oracle Blockchain Platform de un participante.

Si el fundador cambia la configuración del servicio de orden, la nueva configuración se debe transferir al participante, como se describe en Unirse a los OSN de participante o escalado al servicio de orden del fundador. Si hay aplicaciones que se ejecutan en la red, dichas aplicaciones se deben actualizar manualmente para utilizar la configuración revisada del servicio de indicación.
  1. Vaya a la consola del participante y seleccione el separador Red.
  2. Haga clic en Configuración de servicio de órdenes y haga clic en Ver.
    Se muestra el cuadro de diálogo Configuración de indicación.