Documentación de BQN

Antes de comenzar con la instalación, compruebe que el servidor cumple con los requisitos de hardware.

‍

Generar unidad de arranque

Una nueva instalación requiere que el servidor arranque una imagen ISO, la imagen de instalación de Bequant. La imagen ISO contiene los programas de instalación, el sistema operativo y el software del producto.

Obtenga el archivo ISO más reciente del soporte de Bequant (support@bequant.com).

‍

La ISO de BQN ya es de arranque. Para grabar el archivo ISO en una unidad USB:

En Linux, utilice el comando dd:

# dd if=path-to-bqn-iso of=/dev/usb-device

‍

Ejemplo (controlador USB en /dev/sdb y mostrando información de progreso):

# dd status=progress if=./bqnos-R4.9.2-20230120.iso of=/dev/sdb

‍

En Windows, utilice Rufus (https://rufus.ie). Seleccione el esquema de partición MBR y el modo de imagen DD.

Alternativamente, en servidores con una interfaz de administración fuera de banda (LOM) (como HPE iLO, Dell iDRAC o Supermicro IPMI), el archivo ISO se puede montar directamente como una unidad virtual.

‍

Configuración del BIOS

Para acceder a la configuración del BIOS/Sistema, deberá presionar una tecla especial durante la secuencia de autoprueba de encendido (POST) (puede ser F2, F9, DEL o alguna otra tecla que se muestre en la pantalla).

Las siguientes secciones describen la configuración que se debe verificar en la BIOS del servidor.

‍

Modo de arranque

El servidor debe tener su modo de arranque predeterminado de fábrica (por ejemplo, DUAL).

La ISO es compatible con el modo legacy/MBR/BIOS o con el modo UEFI. Muchos servidores modernos solo admiten el modo de arranque UEFI, pero para el resto, cualquiera de los dos modos está disponible.

‍

Si se selecciona el modo UEFI como modo de arranque, asegúrese de que el Arranque seguro esté desactivado en la configuración de la BIOS/Sistema.

‍

Reloj del servidor

El reloj del servidor debe estar configurado en UTC (tiempo universal coordinado) en la BIOS.

La hora UTC actual se puede obtener en la página: https://www.timeanddate.com/worldclock/timezone/utc.

Verifique tanto la fecha como la hora en la configuración de fecha.

Nota: la zona horaria se configurará más adelante, durante la instalación de la ISO de BQN.

‍

Ajustes de rendimiento

Algunos servidores tienen varios perfiles de energía cuya elección afecta el rendimiento del servidor. Verifíquelos si este es el caso. Por ejemplo, en los servidores Dell, seleccione la opción Performance en la sección System Profiles de la BIOS.

Configuración del disco

Si no hay un controlador RAID disponible, omita esta sección.

Si hay un controlador RAID, en la mayoría de los casos, el controlador RAID requiere que los discos disponibles para el sistema operativo se definan en la configuración del controlador RAID, incluso si solo hay un disco o si no se utiliza ningún esquema de redundancia RAID. Por lo tanto, antes del proceso de instalación de BQN, es necesario crear una unidad lógica o virtual dentro del controlador RAID. Además, la unidad lógica o virtual debe marcarse como un disco de arranque.

La configuración del controlador RAID suele estar disponible durante la secuencia de autoprueba de encendido (POST) del servidor.

El tipo de RAID depende del número de discos físicos disponibles:

• Si solo hay un disco físico: RAID0.
• Si hay dos discos físicos: RAID 1.
• Si hay cuatro o más discos físicos: RAID 1+0 (seccionamiento de espejos).

Nota: si hay un número impar de discos físicos, el disco restante se utilizará como repuesto.

‍

Configuración de la BIOS de servidores NUMA

Esta sección solo debe seguirse con servidores NUMA. Un servidor NUMA es un servidor con más de un procesador donde el coste de acceso a la memoria no es constante y depende de la posición del módulo de memoria con respecto al núcleo de la CPU que realiza el acceso. Bequant solo admite servidores NUMA con hasta dos procesadores.

Servidores AMD EPYC

Debido al diseño interno de EPYC, todos los servidores AMD EPYC son NUMA, incluidos los servidores con una sola CPU física. Se necesitan los siguientes ajustes de las opciones de la BIOS:

Nodos NUMA por Socket‍

Si cada CPU del servidor tiene más de 32 hyperthreads, dividimos cada CPU física (socket de CPU) en dos nodos NUMA utilizando la siguiente configuración de la BIOS:

• Nodos NUMA por Socket: 2

Como resultado, veremos cuatro nodos NUMA en un servidor de dos CPU y dos nodos NUMA en un servidor de una CPU.

Entrelazado de memoria‍

El entrelazado de memoria asigna posiciones de memoria con direcciones contiguas a diferentes módulos DIMM de RAM. Esto es deseable, pero queremos el entrelazado sólo a través de módulos DIMM del mismo nodo NUMA. En AMD, esto se consigue con la siguiente opción:

• Entrelazado de memoria: Automático.

Servidores Intel

Entrelazado de memoria‍

El entrelazado de memoria asigna posiciones de memoria con direcciones contiguas a diferentes módulos DIMM de RAM. Esto es deseable, pero queremos el entrelazado sólo a través de módulos DIMM del mismo nodo NUMA. En Intel, esto se consigue con la siguiente opción:

• Entrelazado de memoria: desactivar.

Esta opción todavía hace el entrelazado de memoria, pero está restringido a los módulos DIMM en el mismo nodo NUMA, que es lo que queremos evitar la penalización de rendimiento de acceder a los módulos DIMM en el otro modo NUMA.

‍

Instalar el software desde la unidad de arranque

Después de completar todos los pasos requeridos de la configuración del BIOS, inserte la unidad USB.

Inicie o reinicie el sistema, seleccione el menú de inicio único y elija la unidad USB.

Una vez cargada la imagen de instalación de Bequant, presenta la siguiente pantalla:

‍

Pulse ENTER en la primera opción, BQN OS installation (si no se hace nada, se seleccionará automáticamente después de diez segundos).

Algunas notas sobre la navegación por las pantallas de instalación de la ISO:

• Utilice las flechas derecha e izquierda o la tecla TAB para moverse entre los botones.
• Pulse ENTER para seleccionar un botón.
• Utilice las teclas de flecha arriba y abajo para moverse por una lista.
• Al presionar una letra, la lista se colocará en el primer elemento que comience con esa letra.
• Presione la barra espaciadora para seleccionar un elemento de la lista.

‍

Selección de disco

Si hay más de un disco disponible, se mostrará un menú con las opciones disponibles (de lo contrario, la instalación irá a la ventana de partición, consulte la siguiente sección):

‍

Seleccione un disco para instalar el software BQN (normalmente /dev/sda) y presione ENTER. Tenga en cuenta que la unidad USB puede aparecer en la lista, así que no se confunda y no la seleccione para la instalación (la unidad USB es la fuente del software, no el destino de la instalación).

‍

Particiones de disco

Seleccione el esquema de partición Predeterminado en casi todos los casos, excepto si el servidor no es nuevo y tiene una instalación anterior que no utilizaba el formato de etiqueta de disco DOS o MBR (por ejemplo, si se formateó con GPT).

El esquema de partición predeterminado utiliza todo el disco y borra todos los datos existentes. Este esquema de partición crea dos particiones:

• Una partición de intercambio, con un tamaño de la mitad de la cantidad de memoria RAM física. El tamaño de intercambio predeterminado no es superior a 64 GB o al 25% del espacio total del disco.
• Una partición Linux del SO BQN, dimensionada utilizando todo el espacio restante del disco.

‍

Partición personalizada

Siempre que sea posible, recomendamos utilizar la opción de partición predeterminada, pero si se necesita una partición personalizada (por ejemplo, un servidor con una instalación anterior no DOS/MBR), haga clic en la opción Custom.

La personalización de la partición se realiza con la utilidad Linux fdisk.

La instalación requiere 2 particiones:

• Linux swap: fdisk tipo 82
• Partición de Linux: fdisk tipo 83

Si no existe un tipo de partición, se debe crear una nueva utilizando la utilidad fdisk. Los siguientes comandos de fdisk se utilizan para modificar la tabla de particiones:

• n: crea una nueva partición, ya sea una partición primaria o una partición lógica (dentro de una partición extendida).
• p: imprime la tabla de particiones.
• d: elimina una partición.
• t: cambia el ID del sistema de partición, que está configurado en Linux (83) de forma predeterminada. Para una partición de intercambio de Linux, el código del sistema es 82.
• o: crea una tabla de particiones DOS vacía. Este comando es necesario si el disco se particionó previamente con un tipo de tabla de particiones diferente, como GPT (si se utilizó UEFI).
• w: escribe la tabla de particiones en el disco y sale.
• q: sale sin guardar los cambios.

Selección del mapa de teclado

El teclado de EE. UU. está seleccionado de forma predeterminada. Para seleccionar un mapa de teclas diferente, muévase en la lista (por ejemplo, presionar “e” más tres flechas hacia abajo colocará la lista en el mapa de teclas en español “es”). Seleccione el elemento de la lista con la barra espaciadora y presione ENTRAR.

‍

Nombre del host

Ingrese el nombre de host del servidor BQN (esto se puede cambiar más adelante durante el procedimiento posterior a la instalación o, después de eso, usando la GUI de BQN).

‍

Selección de la zona horaria

La zona horaria de la hora central europea (CET) está seleccionada por defecto. Para seleccionar una zona horaria diferente, muévase por la lista, seleccione con la barra espaciadora y pulse ENTER (esto se puede cambiar más adelante durante el procedimiento posterior a la instalación o, después de eso, utilizando la GUI de BQN).

‍

Contraseña de root

Es importante guardar la contraseña de root en un lugar seguro para iniciar sesión en el servidor BQN durante la post instalación. La contraseña de root se puede cambiar posteriormente.

‍

Instalar el gestor de arranque

ENTER Install, para instalar el gestor de arranque en el Master Boot Record (MBR).

‍

Configuración de la interfaz de gestión de BQN

INTRODUZCA Yes para iniciar la configuración de la interfaz de gestión del BQN.

Seleccione la interfaz de red de administración de BQN. Se prefiere el primer puerto en la placa base del servidor (normalmente denominado en0o1). Esto se puede cambiar más adelante durante el procedimiento posterior a la instalación o, después de eso, utilizando la GUI de BQN.

Introduzca la dirección IP de gestión de BQN con su máscara de subred (por defecto, 192.168.0.121/24):

Diga Sí para configurar la puerta de enlace predeterminada y especifique su dirección en la pantalla que aparece a continuación (por defecto, 192.168.0.1):

Si todo va bien, un diálogo informa sobre el final de la configuración.

‍

La configuración de administración se puede cambiar más adelante durante el procedimiento posterior a la instalación o, después de eso, usando la GUI de BQN.

‍

Reiniciar el servidor

Diga Sí para iniciar el reinicio del servidor:

Quite la unidad USB y SELECCIONE Reboot.

‍

Pasos posteriores a la instalación

Una vez que se ha completado el procedimiento de instalación del software de la sección anterior, después de reiniciar el sistema, se necesitan algunas tareas posteriores a la instalación.

‍

Asistente de configuración, caso básico

Inicie sesión en el sistema como root (con la contraseña que se estableció anteriormente), inicie el shell de BQN con el comando bqnsh y ejecute wizard bta, un comando de asistente que generará una configuración inicial, creará los usuarios de administración predeterminados y habilitará la GUI:

bqn01:~ # bqnsh
Copyright (c) 2009-2015 Bequant S.L.

root@bqn01# wizard bta
System vendor: Dell Inc. 
System name: PowerEdge R230 
System serial: ABCDEFG
CPU model: 12th Gen Intel(R) Core(TM) i7-12700H
CPU cores: 4

Management interface:  en0p0s3
Management IP:         192.168.0.121/24
Management gateway:    192.168.0.1

Wire 1: en0p0s8(access)-en0p0s9(internet)

If the proposed configuration is not valid execute the command
     wizard bta interactive
to manually enter the configuration.

Proceed with configuration? (yes/no) [yes]: yes
Set "bqnadm" user password to "ABCDEFG"
Set "bqnop" user password to "ABCDEFG" 

root@bqn01#

Tenga en cuenta que si el modelo de hardware es compatible con el asistente, el número de serie del sistema (ABCDEFG en este ejemplo) se utiliza para establecer automáticamente las contraseñas del administrador predeterminado (bqnadm) y del operador (bqnop). Esas contraseñas se pueden cambiar más adelante (consulte la sección sobre los pasos opcionales).

‍

Asistente de configuración, caso interactivo

El asistente también se puede ejecutar en modo interactivo para decidir en cada paso la configuración. Esto puede ser útil, por ejemplo, si queremos cambiar la interfaz de administración o la dirección IP que introdujimos durante el proceso de instalación. ENTER tomará el valor sugerido por el asistente entre corchetes

En este ejemplo, realizaremos los siguientes cambios a los valores predeterminados:

• Registre un servidor DNS (8.8.8.8).
• La dirección de administración será 10.0.0.23/24 en la VLAN 12 con la puerta de enlace predeterminada 10.0.0.1.

Tenga en cuenta que cuando se realiza un cambio de IP de administración, deberá iniciar sesión nuevamente desde la nueva red y con la nueva dirección IP.

bqn01:~ # bqnsh
Copyright (c) 2009-2015 Bequant S.L.

root@bqn01# wizard bta interactive
Available network interfaces:
  en0p0s3
  en0p0s8
  en0p0s9
Enter management interface [en0p0s3]:
Enable VLAN on management interface? (yes/no) [no]: yes
VLAN ID (1-4095): 12
Enter management IP address and prefix [192.168.0.121/24]: 10.0.0.23/24
Enter default gateway IP address [192.168.56.1]: 10.0.0.1
Configure a nameserver? (yes/no) [no]: 8.8.8.8

Available network interfaces:
  en0p0s8
  en0p0s9
Select access-side interface for wire: en0p0s8
Select internet-side interface for wire: en0p0s9

‍

Actualizar al último paquete bqn

Deberá solicitar el paquete bpkg bqn más reciente a Bequant e instalarlo en este momento. Siga los pasos descritos aquí.

‍

Verificaciones Finales

‍Acceso a la GUI

Verifique que se pueda acceder a la GUI del servidor BQN a través de HTTPS utilizando la dirección IP de administración y el usuario bqnadm que acaba de crear (no puede iniciar sesión en la GUI como root). En el ejemplo anterior, https://10.0.0.23.

‍

Activación de la licencia

Para obtener una licencia válida, proporcione el ID de hardware del servidor a Bequant o al distribuidor de Bequant. Asegúrese de que haya conectividad entre el servidor y el administrador de licencias de Bequant (en el icono del panel de control de licencias, el license-mgr-connection debe estar en estado normal).

‍

Sincronización NTP

Es importante que el reloj del sistema BQN sea correcto en todo momento. Compruebe que el servidor BQN pueda acceder a los servidores NTP. El icono de NTP en el panel de control debe estar en estado Normal (puede tardar unos segundos en sincronizarse).

‍

Información adicional

Consulte la sección de resolución de problemas para obtener una descripción del estado de los iconos del panel y cómo devolverlos a su estado normal.

‍

Instalación en KVM

Si desea ejecutar BQN con un hipervisor KVM, los requisitos de software de KVM son los siguientes:

• El kernel de Linux de la máquina host debe ser la versión 4.11 o posterior.
• QEMU debe ser la versión 2.9 o posterior.

Las siguientes secciones describen los detalles de la configuración. Utilizaremos virt-manager, el Administrador de máquinas virtuales que forma parte del paquete libvirt, para interactuar con QEMU, pero comandos equivalentes deberían estar disponibles en otros administradores populares.

‍

Creación de la máquina virtual

• Copie el archivo ISO de Bequant en la máquina host donde se creará la VM.
• Seleccione New Virtual Machine virtual.
• En Connection, elija el host donde se creará la VM (local o remoto al virt-manager).
• Seleccione Choose ISO or CDROM como medio de instalación.
• Escriba la ruta al archivo ISO de Bequant copiado previamente en la máquina host.
• En Choose the operating system you are installing, introduzca openSUSE.
• En Choose memory and CPU setting, seleccione la cantidad deseada de memoria y el número de CPU (consulte la sección de plataforma virtual de Requisitos de hardware).
• No emule un modelo de CPU, conserve el hardware del host.
• En la ventana que aparece, seleccione el tamaño de disco deseado.
• Seleccione la opción Customize configuration before install.

‍

Disco virtual

• Seleccione los tipos de bus de disco VirtIO o SATA.

‍

Interfaces de red

Se debe crear un mínimo de tres interfaces en la VM. La primera interfaz, utilizada para la administración, normalmente se agrega cuando se crea la VM. Si no es así, seleccione Añadir hardware y elija Red.

Los puertos físicos que se utilizarán para el plano de datos de la máquina virtual deben ser Intel y estar configurados en modo PCI-passthrough:

• Verifique que la CPU del servidor host tenga habilitado el conjunto de instrucciones VT-d. Esto generalmente se establece en el menú de la BIOS del servidor.
• El kernel del sistema operativo host debe tener habilitado el parámetro del kernel intel_iommu.
• Seleccione Add Hardware.
• Seleccione PCI Host Device.
• En Dispositivo host seleccione la interfaz de red que se utilizará en PCI passthrough.

‍

Instalación en VmWare

Si desea ejecutar BQN con un hipervisor KVM

Se debe crear un mínimo de tres interfaces en la VM, una para la administración y dos para el tráfico del plano de datos.

• La interfaz de gestión se puede conectar a un conmutador virtual preexistente utilizado para la gestión de otras VMs.
• Los puertos físicos que se utilizarán para el plano de datos de la máquina virtual deben ser Intel y estar configurados en modo PCI-passthrough. En Host->Manage->Hardware->PCI devices, marque Toggle Passthrough en los dos puertos del plano de datos.
• Cree la máquina virtual con Guest OS family igual a Linux y Guest OS version igual a SUSELinux Enterprise 12.
• En Memoria, marque Reservar toda la memoria del huésped.‍
• No emule un modelo de CPU, conserve el hardware del host.
• En el menú MachineAdd other device->PCI device, los dos puertos físicos colocados previamente en modo passthrough deberían estar disponibles. Seleccione ambos.
• Seleccione la cantidad deseada de memoria, CPU y espacio en disco (consulte la sección de plataforma virtual de Requisitos de hardware).
• Configure un CD/DVD Media de tipo Datastore ISO file y seleccione el archivo ISO de BQN para instalar.

‍

Servidores con puerto serie

Para los servidores donde el acceso a la consola solo puede ser a través de un puerto serie (por ejemplo, Advantech), los pasos son los siguientes:

1. Conecte el puerto serie del servidor con un PC usando un cable adecuado (por ejemplo, de DB9 a USB).
2. Utilice una aplicación de terminal en su PC para conectarse a la consola a través del puerto serie. Por ejemplo, en Windows, una opción es una conexión putty con la siguiente configuración.

En Linux, puede utilizar el siguiente comando:

myuser@myserver:~: screen{serial-port-device} 115200

‍

Una vez conectado, puede seguir el procedimiento normal (configuración de la BIOS, arranque desde ISO y post instalación).