TeselaDB
DocumentaciónDescargar

teseladb start

Cómo se usa teseladb start, con sus opciones y sus ejemplos.

Uso

teseladb start [--dbpath <dir>] [--cores <n>] [--bind_ip <dirs>] [--port <n>] [--peer-listen <addr>] [--admin-listen <addr>] [--join <addr>] [--insecure] [--insecure-allow-remote] [--log-format text|json] [--config <fichero.yaml>]

Descripción

Arranca un nodo. Sin --insecure, crea o carga la PKI del directorio de datos, sirve el puerto de clientes solo con TLS y pide autenticación a toda orden salvo las del saludo. Cuando el clúster está creado, escribe ready node_id=<n> cluster_id=<hex> peer=<ip:puerto> en la salida estándar.

Opciones

OpciónPor defectoDescripción
--dbpath./teseladb-dataDirectorio de datos del nodo. En teseladb admin, el directorio de cuya PKI se toman las credenciales.
--coreslos núcleos lógicosNúmero de núcleos, igual en todos los nodos.
--bind_ip127.0.0.1Direcciones del puerto de clientes, separadas por comas.
--port27017Puerto de clientes. Con 0, el sistema elige uno. En dev, el nodo k escucha en este puerto más k.
--peer-listen127.0.0.1:27100Dirección del puerto entre nodos.
--admin-listen127.0.0.1:27200Dirección del puerto de administración.
--joinDirección de un nodo del clúster al que unirse.
--insecureArranca sin PKI ni usuarios, solo en 127.0.0.1. Solo para pruebas locales.
--insecure-allow-remoteCon --insecure, deja escuchar fuera de 127.0.0.1.
--log-formattextFormato del log, que puede ser una línea de texto o un objeto JSON por evento.
--configFichero de configuración YAML con el subconjunto de claves de mongod. La línea de órdenes manda sobre el fichero.
--enroll-tokenToken de alta con el que el nodo entra en el clúster la primera vez.
--tlsModeModo TLS del puerto de clientes, que puede ser requireTLS, allowTLS, preferTLS o disabled.
--tlsCertificateKeyFilelos de la PKICertificado y clave en PEM. En un nodo, sustituyen a los de la PKI; en admin y mcp, son los del cliente.
--tlsCAFilela de la PKICA en PEM. En un nodo, la que verifica los certificados de cliente; en admin y mcp, la que firmó el certificado del nodo.
--tlsCertificateKeyFilePasswordContraseña de una clave privada cifrada.
--tlsCRLFileLista de revocación con la que se rechazan los certificados de cliente revocados.
--tlsAllowConnectionsWithoutCertificatesfalseDeja entrar a clientes sin certificado aunque haya --tlsCAFile.
--tlsFIPSModefalseRestringe los algoritmos al modo FIPS.
--enableEncryptionfalseCifra en disco todo lo que guarda el nodo.
--encryptionKeyFileFichero con tu propia clave de cifrado. Sin él, la clave sale de la clave maestra de la PKI.
--encryptionCipherModeAES256-CBCAlgoritmo de cifrado en reposo, AES256-CBC o AES256-GCM.
--kmipServerNameServidor KMIP que guarda la clave maestra.
--kmipPortPuerto del servidor KMIP.
--kmipKeyIdentifierIdentificador de la clave en el servidor KMIP.
--kmipClientCertificateFileCertificado de cliente para el servidor KMIP.
--kmipServerCAFileCA del servidor KMIP.
--kmipRotateMasterKeyRota la clave maestra en el servidor KMIP al arrancar.
--auditFormatFormato del registro de auditoría en fichero: JSON o BSON. Obligatorio con --auditDestination file.
--auditSchemamongoEsquema de los eventos de auditoría, mongo u OCSF.
--auditDestinationsin auditoríaDestino del registro de auditoría, que puede ser file, syslog o console.
--auditPathFichero del registro de auditoría con --auditDestination file.
--auditFilterFiltro de los eventos que se auditan, con la forma de auditLog.filter de MongoDB.
--redactClientLogDatafalseOculta en el log los datos de los clientes.
--ldapServersServidores LDAP para el mecanismo PLAIN, con las demás opciones de LDAP de MongoDB.
--setParameterFija un parámetro del servidor con la forma nombre=valor.
--noscriptingDesactiva JavaScript en el servidor. Las consultas que lo usan responden con un error.
--cpu-listlas CPU permitidas al procesoCPU en las que se fija cada hilo de núcleo, en orden.
--io-executorautoEjecutor de disco, que puede ser io_uring, hilos de E/S o la elección automática.
--direct-ioautoEscritura con O_DIRECT, que puede estar activada, desactivada o en automático.
--memory-limit75 % del mínimo entre la memoria física y el límite del cgroupMemoria total del nodo.
--authSe acepta por compatibilidad. La autorización está siempre activa salvo con --insecure.
--keyFileFichero de clave compartida para la autenticación entre nodos, como en MongoDB.
--clusterAuthModex509Cómo se autentican los nodos entre sí.
--replSetPresenta el clúster como un replica set con ese nombre.
--maxConns1.000.000Conexiones de clientes como máximo.
--networkMessageCompressorszstd,snappy,zlibCompresores de mensajes que acepta el nodo.
--logpathFichero del log. Sin él, el log va a la salida de error.
--logappendEscribe al final del fichero del log y conserva lo que ya tenía.
--quietEscribe menos en el log.
--verboseEscribe más detalle en el log.
--profile0Nivel del perfilador de consultas, que puede ser 0, 1 o 2.
--slowms100Milisegundos a partir de los que una operación cuenta como lenta.
--slowOpSampleRate1,0Fracción de las operaciones lentas que se registran.
--http-portPuerto de la API REST y del servidor MCP.
--http-bindla de --bind_ipDirección de la API REST y del servidor MCP.

Ejemplos

Un nodo nuevo

Shell
teseladb start --dbpath /var/lib/teseladb

Un nodo que se une a un clúster

Shell
teseladb start --dbpath /var/lib/teseladb --join node-01:27100 --enroll-token <token>

Códigos de salida

  • 0 La orden terminó bien.
  • 1 La orden falló al ejecutarse; el error dice por qué.
  • 2 La orden se escribió mal, porque falta un argumento o sobra una opción.

Ver también

AnteriorCLISiguienteteseladb dev