CUPS en FreeBSD | Portal de documentación de FreeBSD
Description: Cómo instalar y usar CUPS en FreeBSD
Keywords: CUPS,FreeBSD,Guide,configuration,introduction

# CUPS en FreeBSD

This translation may be out of date. To help with the translations please access the FreeBSD translations instance.

Marcas registradas

FreeBSD es una marca registrada de la Fundación FreeBSD

Muchos de los nombres usados por los fabricantes y vendedores para diferenciar sus productos son designados como marcas comerciales. Allí donde estos nombres aparezcan en este documento y el Proyecto FreeBSD fuera consciente de la alegación de marca comercial, los nombres tienen a continuación el símbolo “™” o “®”.

Resumen

Un artículo sobre la configuración de CUPS en FreeBSD.

## 1. Una introducción al sistema de impresión común de Unix (CUPS)

CUPS, Common UNIX Printing System, proporciona una capa portable de impresión para sistemas operativos basados en UNIX®. Ha sido desarrollado por Easy Software Products para promover una solución de impresión estándar para todos los fabricantes y usuarios de UNIX®.

CUPS utiliza el Internet Printing Protocol (IPP) como base para gestionar trabajos de impresión y colas. Los protocolos Line Printer Daemon (LPD), Server Message Block (SMB) y AppSocket (también conocido como JetDirect) también están soportados con funcionalidad reducida. CUPS añade navegación de impresoras de red y opciones de impresión basadas en PostScript Printer Description (PPD) para soportar impresión en el mundo real bajo UNIX®. Como resultado, CUPS encaja perfectamente para compartir y acceder a impresoras en entornos mixtos de FreeBSD, Linux®, Mac OS® o Windows®.

El sitio principal para CUPS es http://www.cups.org/.

## 2. Instalación del servidor de impresión CUPS

Para instalar CUPS utilizando un binario precompilado, ejecuta el siguiente comando desde un terminal root:

    # pkg install cups

Otros paquetes opcionales, pero recomendados, son print/gutenprint y print/hplip que añaden controladores y utilidades para varias impresoras. Una vez instalado, los ficheros de configuración de CUPS se pueden encontrar en el directorio /usr/local/etc/cups.

## 3. Configurando el servidor de impresión CUPS

Después de la instalación, se tienen que editar unos pocos ficheros para configurar el servidor CUPS. Primero, crea o modifica, según el caso, el fichero /etc/devfs.rules y añade la siguiente información para establecer los permisos apropiados en todos los dispositivos de impresión y asociar impresoras con el grupo de usuarios `cups`:

    [system=10]
    add path 'unlpt*' mode 0660 group cups
    add path 'ulpt*' mode 0660 group cups
    add path 'lpt*' mode 0660 group cups
    add path 'usb/X.Y.Z' mode 0660 group cups

| Date cuenta de que X, Y y Z deberían ser reemplazados con el dispositivo USB listado en el directorio /dev/usb y que corresponde a la impresora. Para encontrar el dispositivo correcto, examina la salida de dmesg(8), donde ugenX.Y lista el dispositivo de impresión, que es un enlace simbólico a un dispositivo USB en /dev/usb.

Después, añade dos líneas a /etc/rc.conf como sigue:

    cupsd_enable="YES"
    devfs_system_ruleset="system"

Estas dos entradas levantarán el servidor de impresión de CUPS en el arranque e invocarán las reglas locales de devfs creadas arriba, respectivamente.

Para activar la impresión CUPS bajo ciertos clientes Microsoft® Windows®, se debe descomentar la línea de abajo en /usr/local/etc/cups/mime.types y /usr/local/etc/cups/mime.convs:

    application/octet-stream

Una vez hechos estos cambios, se deben reiniciar los sistemas devfs(8) y CUPS, bien reiniciando el ordenador o ejecutando los siguientes dos comandos en una terminal root:

    # /etc/rc.d/devfs restart
    # /usr/local/etc/rc.d/cupsd restart

## 4. Configuración de impresoras en el servidor de impresión CUPS

Después de que el sistema CUPS haya sido instalado y configurado, el administrador puede empezar a configurar las impresoras locales asociadas al servidor de impresión CUPS. Esta parte del proceso es muy similar, si no idéntica, a configurar impresoras CUPS en otros sistemas operativos basados en UNIX®, como una distribución Linux®.

El medio principal para gestionar y administrar el servidor CUPS es mediante la interfaz basada en web, que se puede encontrar abriendo un navegador web y tecleando http://localhost:631 en la barra de direcciones del navegador. Se el servidor CUPS está en otra máquina de la red, sustituye `localhost` por la IP local del servidor. El interfaz web de CUPS es bastante auto explicativo, ya que hay secciones para gestionar impresores y trabajos de impresión, autorizar usuarios y más. Además, en el lado derecho de la pantalla de Administración hay varios check-boxes que permiten acceso sencillo a ajustes que cambian habitualmente, como si hay que compartir impresoras publicadas conectadas al sistema, si hay que permitir la administración remota del servidor CUPS y si hay que conceder a los usuarios acceso y privilegios adicionales para las impresoras y trabajos de impresión.

Por lo general, añadir una impresora es tan fácil como hacer clic en "Add Printer" en la pantalla de Administración de la interfaz web de CUPS, o haciendo clic en uno de los botones "New Printers Found" también en la pantalla de Administración. Cuando se muestre el cuadro desplegable "Device", simplemente seleccione la impresora local deseada y continúe con el proceso. Si has agregado los ports o paquetes mencionados anteriormente print/gutenprint-cups o print/hplip, entonces, los controladores de impresión adicionales estarán disponibles en las siguientes pantallas pudiendo proporcionar más estabilidad o características.

## 5. Configurando clientes de CUPS

Una vez haya sido configurado el servidor CUPS y se hayan agregado y publicado impresoras en la red, el siguiente paso es configurar los clientes o las máquinas que van a acceder al servidor CUPS. Si uno tiene una sola máquina de escritorio que actúa como servidor y como cliente, es posible que gran parte de esta información no sea necesaria.

### 5.1. Clientes UNIX®

CUPS necesitará estar instalado también en tus clientes UNIX®. Una vez que CUPS esté instalado en los clientes, las impresoras CUPS que estén compartidas en la red se descubren automáticamente por los gestores de impresión de los diferentes entornos de escritorio como GNOME o KDE. De forma alternativa, uno puede acceder al interfaz local de CUPS en la máquina cliente en http://localhost:631 y pinchar en "Add Printer" en la sección de Administración. Cuando aparezca la caja de selección "Device", simplemente selecciona la impresora de red de CUPS, si fue automáticamente descubierta o selecciona `ipp` o `http`e introducir la IPP o la URI HTTP de la impresora de red CUPS, habitualmente con alguna de las dos sintaxis siguientes:

    ipp://server-name-or-ip/printers/printername

    http://server-name-or-ip:631/printers/printername

Si los clientes CUPS tienen dificultades encontrando otras impresoras CUPS compartidas en la red, a veces es útil añadir o crear un fichero /usr/local/etc/cups/client.conf con una sola línea como la que sigue:

    ServerName server-ip

En este caso, server-ip sería reemplazado por la dirección IP local del servidor CUPS en la red.

### 5.2. Clientes Windows®

Versiones de Windows® anteriores a XP no tenían la posibilidad de interactuar en red con impresoras basadas en IPP. Sin embargo, Windows® XP y posteriores tienen esta capacidad. Por lo tanto, añadir una impresora CUPS a estas versiones de Windows® es bastante fácil. Generalmente, el administrador de Windows® ejecutará el asistente `Add Printer` de Windows®, seleccionará `Network Printer`e introducirá la URI con la siguiente sintaxis:

    http://server-name-or-ip:631/printers/printername

Si se tiene una versión más antigua de Windows® sin soporte nativo para impresión IPP, entonces la forma general de conectar a una impresora CUPS es utilizar el paquete net/samba413 junto con CUPS, que es un tema que excede el ámbito de este capítulo.

## 6. Solución de problemas en CUPS

Las dificultades con CUPS habitualmente tienen que ver con permisos. Primero, comprueba los permisos de devfs(8) como se ha mencionado arriba. Seguido, comprueba los permisos reales de los dispositivos creados en el sistema de ficheros. También ayuda asegurarse de que tu usuario es miembro del grupo `cups`. Si los check boxes de permisos en la sección de Administración del interfaz web de CUPS parece que no están funcionando, otro arreglo podría ser hacer una copia de seguridad manual del fichero de configuración de CUPS que se encuentra en /usr/local/etc/cups/cupsd.conf y editar las distintas opciones de configuración e intentar distintas combinaciones de opciones de configuración.

    # Log general information in error_log - change "info" to "debug" for
    # troubleshooting...
    LogLevel info

    # Administrator user group...
    SystemGroup wheel

    # Listen for connections on Port 631.
    Port 631
    #Listen localhost:631
    Listen /var/run/cups.sock

    # Show shared printers on the local network.
    Browsing On
    BrowseOrder allow,deny
    #BrowseAllow @LOCAL
    BrowseAllow 192.168.1.* # change to local LAN settings
    BrowseAddress 192.168.1.* # change to local LAN settings

    # Default authentication type, when authentication is required...
    DefaultAuthType Basic
    DefaultEncryption Never # comment this line to allow encryption

    # Allow access to the server from any machine on the LAN
    <Location />
      Order allow,deny
      #Allow localhost
      Allow 192.168.1.* # change to local LAN settings
    </Location>

    # Allow access to the admin pages from any machine on the LAN
    <Location /admin>
      #Encryption Required
      Order allow,deny
      #Allow localhost
      Allow 192.168.1.* # change to local LAN settings
    </Location>

    # Allow access to configuration files from any machine on the LAN
    <Location /admin/conf>
      AuthType Basic
      Require user @SYSTEM
      Order allow,deny
      #Allow localhost
      Allow 192.168.1.* # change to local LAN settings
    </Location>

    # Set the default printer/job policies...
    <Policy default>
      # Job-related operations must be done by the owner or an administrator...
      <Limit Send-Document Send-URI Hold-Job Release-Job Restart-Job Purge-Jobs \
    Set-Job-Attributes Create-Job-Subscription Renew-Subscription Cancel-Subscription \
    Get-Notifications Reprocess-Job Cancel-Current-Job Suspend-Current-Job Resume-Job \
    CUPS-Move-Job>
        Require user @OWNER @SYSTEM
        Order deny,allow
      </Limit>

      # All administration operations require an administrator to authenticate...
      <Limit Pause-Printer Resume-Printer Set-Printer-Attributes Enable-Printer \
    Disable-Printer Pause-Printer-After-Current-Job Hold-New-Jobs Release-Held-New-Jobs \
    Deactivate-Printer Activate-Printer Restart-Printer Shutdown-Printer Startup-Printer \
    Promote-Job Schedule-Job-After CUPS-Add-Printer CUPS-Delete-Printer CUPS-Add-Class \
    CUPS-Delete-Class CUPS-Accept-Jobs CUPS-Reject-Jobs CUPS-Set-Default>
        AuthType Basic
        Require user @SYSTEM
        Order deny,allow
      </Limit>

      # Only the owner or an administrator can cancel or authenticate a job...
      <Limit Cancel-Job CUPS-Authenticate-Job>
        Require user @OWNER @SYSTEM
        Order deny,allow
      </Limit>

      <Limit All>
        Order deny,allow
      </Limit>
    </Policy>

Last modified on: 3 de noviembre de 2021 by Sergio Carlavilla Delgado