GLORYSmart Safe Client

Glosario de Linux

Las palabras y los comandos de Linux y de redes que usa esta documentación, explicados uno por uno.

Esta página explica, con palabras simples, todo lo de Linux y de redes que aparece en esta documentación. No hace falta saber Linux para instalar el Smart Safe Client: alcanza con copiar los comandos tal como están. Si una palabra no se entiende, búsquela aquí.

Para saber más

Cada comando tiene un enlace a su manual oficial. Algunos manuales están en español y otros solo en inglés. Para aprender Linux desde cero, Debian tiene una guía en español: Tutoriales de GNU/Linux.

Lo básico

Terminal

La terminal es una ventana donde se escriben órdenes para la computadora, en lugar de usar el mouse.

Para abrirla: en el menú de aplicaciones, abra Terminal.

Comando

Un comando es una orden escrita en la terminal. Se escribe (o se pega) y se ejecuta presionando Enter.

Algunos comandos llevan más palabras después. Por ejemplo, ls /opt/smart-safe-2 muestra lo que hay en la carpeta /opt/smart-safe-2.

En esta documentación, los comandos aparecen en un recuadro gris. Cópielos completos, tal como están.

Copiar y pegar en la terminal

En la terminal de Linux, los atajos de siempre cambian:

ParaEn la terminal
PegarCtrl+Shift+V, o botón derecho del mouse › Pegar
CopiarCtrl+Shift+C, o botón derecho del mouse › Copiar

En la terminal de Windows, pegue con Ctrl+V o con el botón derecho del mouse.

Ctrl+C no copia en la terminal

En la terminal, Ctrl+C detiene el comando que está corriendo. Úselo solo si quiere cancelar algo.

La contraseña no se ve

Cuando un comando pide la contraseña, es normal que no aparezca nada mientras la escribe: ni letras ni asteriscos. Escríbala completa y presione Enter.

Usuario y root

  • El usuario es la cuenta con la que se entra a la computadora, por ejemplo glory. El Smart Safe Client se instala y funciona con el usuario que va a operar.
  • root es el administrador del sistema: puede cambiar todo. No entre con la cuenta root. Cuando un comando necesita permisos de administrador, se usa sudo.

El usuario de la computadora puede llamarse igual que otros usuarios de esta documentación (por ejemplo, glory), pero es otra cuenta: esta es la de la computadora.

Carpetas y rutas

En Linux, el lugar de un archivo se escribe con barras /. Eso se llama ruta.

RutaQué es
/opt/smart-safe-2/La carpeta del Smart Safe Client.
/home/glory/La carpeta personal del usuario glory.
/etc/La configuración del sistema.
/dev/ttyUSB0El puerto de un adaptador USB a serial, por ejemplo el cable de la DE-70.

Mayúsculas y minúsculas

Linux distingue mayúsculas de minúsculas: License-Request.json y license-request.json son dos archivos distintos. Escriba los nombres exactamente como aparecen.

Completar con Tab

Al escribir el nombre de una carpeta o de un archivo, presione Tab: la terminal completa el resto si lo encuentra. Así se evitan errores al escribir.

Redes

Vea el dibujo de una red completa en Acceso remoto por SSH.

Router y switch

El router es el aparato que une las computadoras de la red del cliente y les da salida a internet. Un switch agrega más conexiones de cable a esa misma red. Las computadoras conectadas al mismo router o switch, por cable o por Wi-Fi, están en la misma red.

Dirección IP

Es la «dirección» de cada equipo en la red: cuatro números separados por puntos, por ejemplo 192.168.0.50.

  • En la mayoría de las redes de los clientes, dos equipos están en la misma red cuando los tres primeros números son iguales: 192.168.0.50 y 192.168.0.60 sí; 192.168.0.50 y 192.168.1.60 no.
  • La máscara 255.255.255.0 (también escrita /24, como en 192.168.0.50/24) es la que indica que la red son los tres primeros números.
  • Para verla: en Linux, hostname -I; en Windows, ipconfig.

DHCP

La forma automática de recibir una dirección IP: el router se la da a cada equipo al conectarse. Es la opción habitual («red automática»). La dirección puede cambiar después de reiniciar; cuando tiene que ser siempre la misma, se usa una dirección fija.

Puerto

Es un número que indica a qué servicio de una computadora va una conexión. Por ejemplo:

  • 22: SSH.
  • 80: el Smart Safe Client le habla al Cash Infinity.
  • 443: HTTPS, por ejemplo la licencia y las actualizaciones.
  • 587 o 465: el servidor de correo (SMTP).
  • 55562: el Cash Infinity le avisa al Smart Safe Client.

No confundir con el puerto serial, que es un conector físico (el de la DE-70).

Firewall

Un programa que decide qué conexiones pueden entrar a una computadora. En Windows, el Firewall de Windows tiene que permitir la entrada TCP por el puerto 55562 (vea Preparación del Cash Infinity). Debian y Raspberry Pi OS no traen firewall activo. Si la red del cliente tiene su propio firewall, tiene que dejar salir la computadora a internet por el puerto 443 (vea Instalación).

Preparar la computadora

Las palabras de Preparar la computadora: instalar Debian o Raspberry Pi OS desde cero.

Imagen del sistema (ISO)

Un archivo que contiene el instalador de un sistema operativo, listo para grabarse en un pendrive o en una tarjeta. Debian se descarga como un archivo que termina en .iso. Raspberry Pi OS lo descarga y lo graba el Raspberry Pi Imager.

Netinst

La imagen pequeña de Debian: trae lo mínimo y descarga el resto por internet durante la instalación. Por eso la computadora necesita internet mientras se instala.

Se descarga en la página oficial debian.org/distrib/netinst: en Imagen pequeña para CD o memoria USB, el enlace amd64.

Pendrive de instalación

Un pendrive con la imagen del sistema grabada, desde el que la computadora puede arrancar para instalar el sistema. Al grabarlo, todo lo que tenía el pendrive se borra.

Rufus

Programa de Windows que graba una imagen .iso en un pendrive. Se descarga gratis en rufus.ie. Aparece en el idioma de Windows.

Al encender la computadora, una tecla abre un menú para elegir desde dónde arranca: el disco o el pendrive. La tecla depende del fabricante; las más comunes son F12, F11 y Esc. Suele aparecer escrita en la pantalla durante uno o dos segundos al encender. En algunas computadoras, el arranque se elige en la configuración (BIOS o UEFI), que se abre con F2 o Supr.

BIOS y UEFI

La configuración básica de la computadora, que funciona antes del sistema operativo. Las computadoras de los últimos años usan UEFI; las muy antiguas, BIOS. Por eso Rufus pregunta el esquema de partición:

  • GPT: para UEFI. Es lo normal.
  • MBR: solo para computadoras muy antiguas, si con GPT no arrancan.

GRUB

El programa que arranca Debian cada vez que se enciende la computadora. El instalador de Debian lo pone en el disco.

Réplica (mirror)

El servidor de internet desde donde Debian descarga sus programas. deb.debian.org sirve en cualquier país.

Raspberry Pi Imager

Programa oficial de Raspberry Pi para Windows: descarga Raspberry Pi OS y lo graba en la tarjeta microSD, ya con el usuario, la contraseña, la red y SSH configurados. Se descarga gratis en raspberrypi.com/software.

microSD

La tarjeta de memoria donde la Raspberry Pi guarda su sistema: es su «disco». Para grabarla desde una computadora con Windows se usa un lector de tarjetas.

Comandos

apt

Instala y actualiza programas desde los servidores de Debian. Necesita sudo e internet.

sudo apt update

Actualiza la lista de programas disponibles.

sudo apt install -y nano

Instala el programa nano. El -y responde «sí» a la pregunta de confirmación. Si el programa ya está instalado, no pasa nada malo: apt lo avisa.

Manual oficial (en inglés): apt.

cat

Muestra en la terminal el contenido de un archivo, sin cambiarlo. Sirve para revisar un archivo.

cat /opt/smart-safe-2/license-request.json

Manual oficial (en español): cat.

curl

Descarga algo de internet. En la instalación se usa así:

curl -fsSL https://api.smartsafe2.com/api/v1/download/install.sh | sudo sh
  • curl -fsSL y la dirección descargan el instalador del Smart Safe Client. Las letras -fsSL hacen que no se vea la barra de progreso, que se sigan las redirecciones y que, si la descarga falla, se muestre el error.
  • La barra vertical | pasa lo descargado al comando siguiente.
  • sudo sh ejecuta el instalador como administrador.

Si aparece curl: command not found, instale curl con sudo apt update && sudo apt install -y curl. El && ejecuta el segundo comando solo si el primero terminó bien.

Manual oficial (en inglés): curl.

date

Muestra la fecha y la hora de la computadora:

date

Si están mal, corríjalas con timedatectl.

Manual oficial (en español): date.

exit

Cierra la terminal o, si está conectado a otra computadora por SSH, cierra esa conexión. También sale de la cuenta root después de su -.

hostname

Muestra el nombre de la computadora. Con -I (la letra i mayúscula) muestra sus direcciones IP:

hostname -I

Si aparecen varias, la que sirve es la que empieza igual que la de su notebook.

Manual oficial (en español): hostname.

ip

Muestra las conexiones de red de la computadora:

ip a

Busque inet seguido de la dirección IP, por ejemplo inet 192.168.0.50/24. Si ninguna conexión tiene inet con una dirección como esa, la computadora no está en la red: revise el cable o el Wi-Fi.

Manual oficial (en inglés): ip.

ipconfig (Windows)

Es un comando de Windows, no de Linux: muestra la dirección IP de su notebook. Ejecútelo en la terminal de Windows y busque Dirección IPv4 (en inglés, IPv4 Address).

ipconfig

Manual oficial (en español): ipconfig.

ls

Muestra los archivos y las carpetas que hay en una carpeta. Sirve para confirmar que un archivo existe.

ls /opt/smart-safe-2

Con -l muestra más detalles, como el dueño, el tamaño y la fecha: ls -l /opt/smart-safe-2.

Manual oficial (en español): ls.

nano

Un editor de texto que funciona dentro de la terminal. Sirve para crear o cambiar archivos de texto.

Para abrir un archivo (o crearlo, si no existe):

sudo nano /opt/smart-safe-2/license-request.json

Si el archivo no existe, nano abre una pantalla vacía y lo crea al guardar.

ParaPresione
Moverse por el textoLas flechas del teclado
BorrarBackspace (la tecla de borrar)
Pegar texto copiadoCtrl+Shift+V
GuardarCtrl+O y después Enter
SalirCtrl+X

En la parte de abajo, nano muestra sus atajos: el símbolo ^ significa Ctrl. Por ejemplo, ^X es Ctrl+X.

Si al salir nano pregunta si quiere guardar los cambios, presione S (o Y si nano está en inglés) y después Enter.

Si nano no está instalado, instálelo con sudo apt install -y nano (vea apt).

Atajos de nano (en inglés): hoja de atajos.

nmtui

Un menú de texto para conectar la red cuando no hay escritorio, por ejemplo el Wi-Fi del cliente:

sudo nmtui

Elija la opción para activar una conexión, después la red Wi-Fi, y escriba su contraseña. Muévase con las flechas, elija con Enter y vuelva con Esc. Funciona después de instalar el Smart Safe Client, que deja la red a cargo de NetworkManager. También se puede conectar el Wi-Fi desde el Smart Safe Client: Configuración › Red › Conexiones.

Manual oficial (en inglés): nmtui.

ping

Prueba si otra computadora responde por la red:

ping 192.168.0.50
  • En Windows prueba 4 veces y termina solo. Respuesta desde… significa que la otra computadora responde.
  • En Linux sigue probando hasta que presione Ctrl+C. Cada línea con bytes from es una respuesta.
  • Con -c 3, prueba 3 veces y termina solo: ping -c 3 1.1.1.1. 1.1.1.1 es un servidor público de internet, útil para probar la conexión; 3 received significa que las 3 pruebas volvieron.

Manuales oficiales (en español): ping en Linux y ping en Windows.

raspi-config

Solo en Raspberry Pi: el menú de configuración del sistema.

sudo raspi-config

Muévase con las flechas, elija con Enter y use Tab para llegar a Finish (terminar).

Manual oficial (en inglés): raspi-config.

reboot y poweroff

  • sudo reboot reinicia la computadora.
  • sudo poweroff apaga la computadora.

Manuales oficiales (en español): reboot y poweroff.

rm

Borra archivos. No hay papelera: lo borrado no se recupera.

  • Úselo solo en los comandos de esta documentación, copiados exactamente.
  • El asterisco * significa «todos los que empiezan así»: ssh_host_* son todos los archivos cuyo nombre empieza con ssh_host_.

Manual oficial (en español): rm.

scp

Copia archivos de una computadora a otra por SSH. Se escribe primero el origen y después el destino; la otra computadora se escribe usuario@dirección: seguido de la carpeta:

scp archivo.txt glory@192.168.0.50:/home/glory/

Vea Acceso remoto por SSH.

Manual oficial (en inglés): scp.

ssh

SSH es la forma segura de abrir la terminal de otra computadora por la red: lo que viaja va cifrado.

ssh glory@192.168.0.50

Guía completa: Acceso remoto por SSH.

Manuales oficiales: ssh (en inglés) y SSH en Windows (en español).

ssh-keygen

Maneja las «huellas» (identidades) de SSH. En esta documentación se usa de dos formas:

  • En su notebook, para olvidar la huella guardada de una computadora que cambió: ssh-keygen -R 192.168.0.50.
  • En la computadora del Smart Safe Client, para crear su identidad SSH si falta: sudo ssh-keygen -A.

Manual oficial (en inglés): ssh-keygen.

sudo

Ejecuta un comando como administrador. Se escribe antes del comando, por ejemplo sudo reboot.

  • La primera vez pide la contraseña del usuario (no la de root). Mientras la escribe no aparece nada: es normal.
  • Durante unos minutos, en la misma terminal, no la vuelve a pedir.
  • Use sudo solo en los comandos de esta documentación: como administrador, un comando equivocado puede dañar el sistema.

Si sudo dice que el usuario no está en «sudoers», o «sudo: command not found»

El usuario no tiene permiso de administrador. Pasa cuando, al instalar Debian, se definió una contraseña para root. Para darle el permiso:

  1. Entre como root. Pide la contraseña de root:

    su -
  2. Instale sudo, por si falta:

    apt install -y sudo
  3. Dé el permiso al usuario. Cambie glory por el nombre del usuario:

    usermod -aG sudo glory
  4. Reinicie la computadora, todavía como root:

    reboot

Al volver, el usuario ya puede usar sudo.

Manual oficial (en inglés): sudo.

systemctl

Maneja los servicios: programas que funcionan en segundo plano, como el de SSH.

ComandoQué hace
systemctl status sshMuestra si el servicio está activo (active (running)). Presione q para volver.
sudo systemctl enable --now sshLo activa ahora y en cada encendido.
sudo systemctl disable --now sshLo desactiva ahora y en cada encendido.
sudo systemctl restart sshLo reinicia.

Manual oficial (en inglés): systemctl.

timedatectl

Configura la zona horaria y la hora automática.

ComandoQué hace
sudo timedatectl set-timezone America/PanamaPone la zona horaria del país (en el ejemplo, Panamá).
sudo timedatectl set-ntp trueActiva la hora automática por internet.
timedatectl list-timezonesMuestra todas las zonas. Presione q para salir.

Algunas zonas: America/Panama, America/Santo_Domingo, America/Bogota, America/Sao_Paulo.

Manual oficial (en inglés): timedatectl.

truncate

Cambia el tamaño de un archivo. En la imagen clonada se usa para vaciar el archivo que identifica a la computadora:

sudo truncate -s 0 /etc/machine-id

-s 0 deja el archivo vacío. Al encender, cada copia crea su propia identidad.

Manuales oficiales: truncate (en español) y machine-id (en inglés).

usermod

Cambia una cuenta de usuario. En esta documentación se usa para dar permiso a los puertos seriales, como el de la DE-70:

sudo usermod -aG dialout $USER
  • -aG dialout agrega el usuario al grupo dialout: los usuarios de ese grupo pueden usar los puertos seriales. No olvide la a: sin ella, el usuario sale de sus otros grupos.
  • $USER se reemplaza solo por el nombre del usuario que está usando la terminal.
  • El permiso vale después de reiniciar la computadora.

El instalador del Smart Safe Client ya da este permiso. Este comando solo hace falta si el Smart Safe Client dice que el puerto está ocupado.

Manual oficial (en inglés): usermod.

El Smart Safe Client en Linux

AppImage

En Linux, el Smart Safe Client es un solo archivo: /opt/smart-safe-2/SmartSafe2.AppImage. Las actualizaciones reemplazan ese archivo solas.

Modo quiosco

La computadora queda dedicada al Smart Safe Client: entra sola con el usuario y abre el Smart Safe Client en pantalla completa. Vea Instalar en Linux.

On this page