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:
| Para | En la terminal |
|---|---|
| Pegar | Ctrl+Shift+V, o botón derecho del mouse › Pegar |
| Copiar | Ctrl+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.
| Ruta | Qué 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/ttyUSB0 | El 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.50y192.168.0.60sí;192.168.0.50y192.168.1.60no. - La máscara
255.255.255.0(también escrita/24, como en192.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.
Menú de arranque
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 updateActualiza la lista de programas disponibles.
sudo apt install -y nanoInstala 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.jsonManual 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 shcurl -fsSLy la dirección descargan el instalador del Smart Safe Client. Las letras-fsSLhacen 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 shejecuta 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:
dateSi 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 -ISi 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 aBusque 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).
ipconfigManual 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-2Con -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.jsonSi el archivo no existe, nano abre una pantalla vacía y lo crea al guardar.
| Para | Presione |
|---|---|
| Moverse por el texto | Las flechas del teclado |
| Borrar | Backspace (la tecla de borrar) |
| Pegar texto copiado | Ctrl+Shift+V |
| Guardar | Ctrl+O y después Enter |
| Salir | Ctrl+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 nmtuiElija 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 fromes una respuesta. - Con
-c 3, prueba 3 veces y termina solo:ping -c 3 1.1.1.1.1.1.1.1es un servidor público de internet, útil para probar la conexión;3 receivedsignifica 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-configMué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 rebootreinicia la computadora.sudo poweroffapaga 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 conssh_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/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- Antes de la
@va el usuario; después, la dirección IP. - Para salir,
exit. - Usa el puerto 22.
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
sudosolo 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:
-
Entre como root. Pide la contraseña de root:
su - -
Instale
sudo, por si falta:apt install -y sudo -
Dé el permiso al usuario. Cambie
glorypor el nombre del usuario:usermod -aG sudo glory -
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.
| Comando | Qué hace |
|---|---|
systemctl status ssh | Muestra si el servicio está activo (active (running)). Presione q para volver. |
sudo systemctl enable --now ssh | Lo activa ahora y en cada encendido. |
sudo systemctl disable --now ssh | Lo desactiva ahora y en cada encendido. |
sudo systemctl restart ssh | Lo reinicia. |
Manual oficial (en inglés): systemctl.
timedatectl
Configura la zona horaria y la hora automática.
| Comando | Qué hace |
|---|---|
sudo timedatectl set-timezone America/Panama | Pone la zona horaria del país (en el ejemplo, Panamá). |
sudo timedatectl set-ntp true | Activa la hora automática por internet. |
timedatectl list-timezones | Muestra 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 dialoutagrega el usuario al grupodialout: los usuarios de ese grupo pueden usar los puertos seriales. No olvide laa: sin ella, el usuario sale de sus otros grupos.$USERse 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.