Gestionar servicio de órdenes

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

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

¿Qué es el servicio de pedidos?

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 antiguo tipo de consenso de Kafka, 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 escalar. Con el tipo de consenso Raft, la red puede tener un número arbitrario de nodos de orden, y cada canal puede definir su propio conjunto de nodos de orden. Los diferentes canales pueden utilizar diferentes nodos de orden, y los nodos de orden 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 el canal e incluso la red puede no funcionar. Las siguientes directrices pueden reducir el número de problemas que se producen:

Mantener la mayoría de los nodos de servicio de pedidos (OSN) activos

El algoritmo de consenso Raft requiere que la mayoría de los nodos de servicio de orden (OSN) estén funcionando; de lo contrario, no se puede llegar a un consenso. La mayoría significa más del 50%. Por ejemplo, para cinco OSN, debe haber al menos tres OSN en funcionamiento; para seis OSN, debe haber al menos cuatro OSN en funcionamiento.
  • 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 canales, no se pueden agregar nuevos nodos de orden a la red, no se puede eliminar ningún orden 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; sin embargo, fallarán las operaciones administrativas, como agregar una nueva organización, cambiar la lista de control de acceso o desplegar códigos de cadena.

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 OSN es robusto.

Al eliminar OSN o una organización, asegúrese de que más del 50% de los OSN sigan funcionando. Por ejemplo, si tuviera dos organizaciones con tres OSN cada una, si eliminara una organización, durante la eliminación se interpretaría que solo el 50% de los OSN funcionaban. Agregue un OSN al resto de la organización antes de suprimir la organización externa para asegurarse de que siempre supera el 50% de los OSN que funcionan.

No agregue ni elimine pedidos 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 Raft OSN se volverá brevemente inestable. Durante este período, no se pueden manejar transacciones y un mensaje de error similar al siguiente puede indicar este estado:
UNKNOWN: Stream removed
SERVICE UNAVAILABLE
BAD REQUEST

Esto puede durar unos 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 indicaciones con frecuencia. Si se deben agregar o eliminar varios solicitantes, realice uno a la vez y asegúrese de que la red haya vuelto al estado operativo antes de realizar el siguiente cambio.

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

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

Únete al participante o a los OSN escalados al servicio de pedidos del fundador

Al aprovisionar una instancia de participante, se crea con 3 solicitantes. Los solicitantes están 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.

Para agregar o eliminar varios solicitantes, agregue o elimine uno a uno y asegúrese de que la red haya vuelto al estado operativo antes de realizar el siguiente cambio. Consulte What is the Ordering Service? para obtener más información importante sobre la adición, eliminación, inicio y detención de solicitantes de balsa.

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

Para unirse al participante o a los solicitantes escalados a una red, exporte su configuración e impórtela al fundador.

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

    Esto genera un archivo JSON con la configuración y guarda el archivo. El archivo contiene el certificado de la organización y la configuración seleccionada del nodo de servicio de ordenador (OSN) firmada por la clave privada del administrador de la organización del participante. Envíe este archivo al administrador de la instancia fundadora.

    Las aplicaciones que se ejecutan en canales que utilizan este OSN también necesitan este certificado TLS exportado.

  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 participante o el ordenador recién escalado se agrega a la sección de organización del ordenante de la lista de canales del sistema.

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

Después de que el participante o los ordenadores escalados se hayan agregado al fundador, debe exportar la configuración del fundador e importarlos al participante o al ordenador escalado.

  1. En la consola fundadora, abra el separador Red. Haga clic en Export Network Config Block (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 del fundador para los ordenadores escalados), en el separador Nodo, busque el nodo del ordenador (o el primer nodo del ordenador si existen varios nodos). Seleccione el menú Acción de este nodo y seleccione Importar bloque de configuración de red.

    Se le solicitará el archivo que ha enviado el administrador de la instancia fundadora.

  3. En la consola del participante, refresque el separador Nodo. El estado del nodo de ordenador se mostrará como down. Desde el menú Acción, seleccione Start (Iniciar).

    Cada nodo de orden que se inicie se agregará al cluster de Raft del fundador.

Cada vez que se agrega un nuevo OSN mediante la ampliación horizontal del ordenador (como se describe en Escala 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 único lote. Asegúrese de que solo se agregue un 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 pedido para la instancia fundadora.

  • La configuración actualizada se utiliza al crear canales y no se aplica a los canales existentes.
  • Puede actualizar la configuración del servicio de orden para un canal existente individual, como se describe en Editar configuración del servicio de orden para un canal.
  • Si cambia la configuración del servicio de orden y hay aplicaciones que se ejecutan en la red, dichas aplicaciones se deben actualizar manualmente para usar la configuración revisada del servicio de orden.
  • 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 Únase al participante o a los OSN escalados al servicio de pedidos del fundador.
Debe ser administrador para completar esta tarea.
  1. Vaya a la consola del fundador y haga clic en el separador Network.
  2. Haga clic en el botón Configuración de servicio de orden.
    Se muestra el cuadro de diálogo Configuración de servicio de orden.
  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 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 desea incluir en un lote. Introduzca un número entre 1 y 4294967295.
    Bytes de mensaje absolutos 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 que introduzca en el campo Bytes de mensajes preferidos.

    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 Bytes de mensajes absolutos.

    Normalmente, este valor se define 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 el que se toma una instantánea.
  4. Haga clic en Actualizar.
    La configuración actualizada se guarda.

Ver configuración de servicio de pedidos

Puede ver la configuración del servicio de orden del fundador que se importó a 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 Únase al participante o a los OSN escalados al servicio de orden del fundador. Si hay aplicaciones que se ejecutan en la red, dichas aplicaciones se deben actualizar manualmente para usar la configuración revisada del servicio de orden.
  1. Vaya a la consola del participante y seleccione el separador Red.
  2. Haga clic en Configuración de servicio de orden y en Ver.
    Se muestra el cuadro de diálogo Configuración de indicación.