rug (1)

Name

rug - La interfaz de línea de comandos del Agente de Novell ZENworks Linux Management.

Sintaxis

Descripción

rug es la interfaz de línea de comandos del Agente de ZENworks Linux Management (Gestión de ZENworks Linux). Funciona con el daemon ZENworks Linux Management (Gestión de ZENworks Linux) para instalar, actualizar y eliminar software de acuerdo con los comandos que se especifiquen. El software que instala puede ser de servidores ZENworks 7. x Linux Management, ZENworks 6.6.x Linux Management, repositorios YUM, servicio ZYPP, además de archivos locales.

Los servidores de ZENworks Linux Management clasifican el software por categorías en catálogos, que son grupos de software similar. Por ejemplo, un catálogo puede contener software de un proveedor de sistema operativo y otro catálogo puede contener SUSE Linux Enterprise Desktop. Puede suscribirse a catálogos individuales para controlar la visualización de los paquetes disponibles y evitar la instalación accidental de software no deseado. Por defecto, todas las operaciones se realizan en software de catálogos a los que esté suscrito, aunque este hecho se puede modificar usando el indicador--allow-unsubscribed. La utilidad rug también ofrece otras funciones, como retroceso, bloqueos, historial y preferencias que permiten gestionar con facilidad paquetes y lotes.

Según el tipo de dispositivo gestionado, la ubicación de la utilidad rug varía.

En el caso de dispositivos de SUSE Linux Enterprise Server 10 (SLES 10) y SUSE Linux Enterprise Desktop 10 (SLED 10), la utilidad rug está situada en el siguiente directorio:

/usr/bin

En el resto de dispositivos gestionados, la utilidad rug se instala en la siguiente ubicación:

/opt/novell/zenworks/bin

Guía de uso

Esta sección incluye información sobre las convenciones y el formato general de los comandos.

Carpetas

Si no se especifica ninguna carpeta para los comandos que usan un argumento de carpeta, el comando en cuestión utilizará la carpeta raíz. Para especificar una vía de carpeta, indique todas las carpetas de la raíz separadas por una barra inclinada (/). Por ejemplo, si dispone de una carpeta cuyo nombre es carpeta1 en la raíz que, a su vez, contiene una subcarpeta llamada subcarpeta1, podrá hacer referencia a esta carpeta como carpeta1/subcarpeta1. Las carpetas que se especifiquen deben existir previamente.

Puntos suspensivos (...)

Los puntos suspensivos indican que un comando acepta varias entradas del último tipo de argumento. Por ejemplo, los puntos suspensivos en el siguiente comando indican que catalog-add-bundle puede aceptar varios lotes:

rug bundle-history [opciones] [cadena de búsqueda] [...]

Indicadores de opción

En la referencia correspondiente a los comandos que no disponen de opciones específicas (es decir, que aceptan sólo los indicadores de opción estándar) no aparece ninguna opción como argumento. Por ejemplo, la entrada de referencia para el siguiente comando no enumera las opciones porque acepta sólo los indicadores estándar:

rug list-updates (lu) [catálogo]

Sin embargo, el siguiente comando muestra las opciones porque el comando tiene una opción específica de comando (-a):

rug bundle-history [opciones] [cadena de búsqueda] [...]

Comandos

rug ofrece una serie de comandos (indicados como [comando] en la sección Sintaxis). Cada uno de ellos acepta los indicadores de opción mostrados en la sección Opciones globales. Asimismo, muchos comandos cuentan con indicadores específicos, que se muestran con los comandos.

El comando usado con más frecuencia es rug update que permite descargar e instalar actualizaciones de los catálogos a los que se está suscrito.

Comandos de gestión de lotes

bundle-history (bhi) [opciones] [cadena de búsqueda] [...]

Busca las entradas de registro del lote que coincidan con las cadenas especificadas en [cadena de búsqueda]. Acepta los siguientes indicadores de opción:

  • -n, --search-name: busca por nombre de lote (opción por defecto)
  • -a, --search-action: busca por acción
  • --search-user: busca por usuario
  • --match-all: los paquetes deben coincidir con todas las cadenas de búsqueda (opción por defecto)
  • --match-any: permite que los paquetes coincidan con cualquier cadena de búsqueda
  • --match-substrings: las cadenas de búsqueda deben coincidir con cualquier parte del texto
  • --match-words: los paquetes deben coincidir con todas las cadenas de búsqueda
  • -d, --days-back: número máximo de días en los que buscar (por defecto 30)
bundle-install (bin) [opciones] [nombre de lote] [...]

Instala los lotes especificados. rug intenta hallar dichos lotes en los catálogos a los que esté suscrito. Utilice bundle-upgrade para actualizar un lote que ya esté instalado. Acepta los siguientes indicadores de opción:

  • -y,--no-confirmation: no pedir confirmación.
  • -p,--prepare-only: sólo prepara los lotes pero no los instala.
  • -f,--freshen: actualiza los hijos.
  • -N,--dryrun: prueba y muestra pero no realiza realmente las acciones solicitadas.
bundle-list (bl) [opciones] [ [catálogo] [catálogo] [. . .] ]

Muestra los lotes disponibles en los catálogos a los que esté suscrito. Acepta los siguientes indicadores de opción:

  • -i, --installed-only: muestra sólo los lotes instalados
  • -u, --uninstalled-only: muestra sólo los lotes sin instalar
  • -c, --incomplete-only: muestra sólo los lotes incompletos
bundle-lock-add (bla) [opciones] [nombre de lote] [versión] [...]

Añade una regla de bloqueo de lotes. Impide cambios en el estado de instalación de los lotes no especificados en el bloqueo. El nombre del lote se puede especificar individualmente, con patrones de comodines, o incluso con relaciones de números de versión. Por ejemplo, el comando rug bla gnome* rechaza eliminar los lotes que comiencen por "gnome". Acepta las siguientes opciones:

-c, --catalog: catálogo con el que coincide el bloqueo.

bundle-lock-delete (bld) [opciones] [número de bloqueo] [...]

Suprime el bloqueo de lote que ha especificado según su número. Puede buscar los números para cada bloqueo de lote con el comando lock-list (bll).

bundle-lock-list (bll) [opciones]

Muestra una lista de los bloqueos activos. Los bloqueos se ordenan según el número de ID.

bundle-remove (brm) [opciones] [nombre de lote] [...]

Elimina los lotes especificados. Acepta los siguientes indicadores de opción:

  • -y,--no-confirmation: no pedir confirmación.
  • -p,--prepare-only: sólo prepara los lotes, no los instala.
  • -f,--freshen: actualiza los hijos.
  • -r,--allow-removals: elimina todos los paquetes conflictivos.
  • -N,--dryrun: prueba y muestra pero no realiza realmente las acciones solicitadas.
bundle-search (bse) [opciones] [cadena de consulta]

Busca los lotes que coincidan con la cadena de consulta. Acepta los siguientes indicadores de opción:

  • -i,--installed-only: busca sólo la lista de lotes instalados.
bundle-upgrade (bup) [opciones] [nombre de lote] [...]

Actualiza los lotes especificados. Acepta los siguientes indicadores de opción:

  • -y,--no-confirmation: no pedir confirmación.
  • -p,--prepare-only: sólo prepara los lotes, no los instala.
  • -f,--freshen: actualiza los hijos.
  • -N,--dryrun: prueba y muestra pero no realiza realmente las acciones solicitadas.
catalogs (ca) [opciones]

Enumera los catálogos disponibles para los servicios que haya añadido. Acepta los siguientes indicadores de opción:

-u,--uri: muestra el URI de servicio.

subscribe (sub) [opciones] [nombre de catálogo] [...]

Realiza una suscripción a los catálogos especificados. Cada catálogo especificado debe estar disponible desde uno de los servicios que haya añadido. Acepta los siguientes indicadores de opción:

  • -s,--strict: falla si intenta suscribirse a un catálogo ya suscrito.
  • -a,--all: se suscribe a todos los catálogos.
  • -e, --service: especifica el servicio
unsubscribe (unsub) [opciones] [nombre de catálogo] [...]

Cancela la suscripción a los catálogos especificados. Acepta los siguientes indicadores de opción:

  • -s,--strict: falla si intenta cancelar la suscripción de un catálogo no suscrito.
  • -a,--all: cancela la suscripción de todos los catálogos.
  • -e, --service: especifica el servicio

Comandos de gestión de paquetes

bundle-packages (bp) [lote]

Muestra los paquetes de un lote concreto.

checkpoint-add (cpa) [nombre] [fecha]

Añade un punto de comprobación. Si no se ha especificado la fecha, añade un punto de comprobación con la fecha actual.

checkpoint-remove (cpr) [nombre] [nombre] [...]

Elimina los puntos de comprobación especificados.

checkpoints (cp)

Obtiene una lista de puntos de comprobación guardados.

dump [nombre de archivo de salida]

Obtiene un volcado de la información de sistema como base de datos de SQLite.

file-list (fl) [nombre de paquete]

Muestra una lista de los archivos de un paquete.

history (hi) [opciones] [término para buscar]

Busca en el historial de paquetes el término de búsqueda que haya especificado. Por defecto, busca nombres de paquetes para el término de búsqueda y muestra el historial de la versión del paquete. Use el siguiente indicador de opción para realizar una búsqueda diferente:

  • -n, --search name: busca por el nombre del paquete (por defecto).
  • -a, --search-action: busca por la acción.
  • -d, --days-back: número máximo de días en los que buscar (por defecto 30)
info (if) [opciones] [nombre de paquete] [...]

Muestra la información completa para el paquete especificado. Acepta los siguientes indicadores de opción:

  • -i, --uninstalled: busca los paquetes no instalados.
  • -u, --unsubscribed: busca en los catálogos con la suscripción cancelada.
info-conflicts (ic) [nombre de paquete]

Muestra una lista de todos los conflictos del paquete especificado.

info-obsoletes (io) [nombre de paquete]

Muestra una lista de todos los elementos obsoletos del paquete especificado.

info-provides (ip) [nombre de paquete]

Muestra la información proporcionada por el paquete especificado.

info-requirements (ir) [nombre de paquete]

Muestra los requisitos de paquetes. Acepta los siguientes indicadores de opción:

  • -a, --all-providers: muestra todos los paquetes que puedan satisfacer un requisito.
  • -v, --show-versions: muestra la información de la versión completa de los paquetes.
install (in) [opciones] [-t tipoResolución] [-c catálogo] resolución1 [resolución2]

Instala las resoluciones que se especifiquen. Si el usuario solicita un paquete con una versión, zmd instala la versión exacta del paquete. Si la versión del paquete no se especifica, zmd instala la versión más adecuada. En plataformas de SLE 10, tipoResolución puede corresponder a un paquete, un patrón, un producto o un parche. Por defecto corresponde a un paquete. Acepta los siguientes indicadores de opción:

  • -u, --allow-unsubscribed: permite los catálogos con la suscripción cancelada.
  • -d, --download-only: sólo descarga los paquetes.
  • --entire-catalog: instala todos los paquetes de los catálogos especificados.
  • -N, --dry-run: realiza pruebas y las muestra pero no lleva a cabo realmente las acciones solicitadas.
  • -i, --confirm: exige siempre confirmación.
  • -y, --no-confirmation: no pide confirmación.
list-updates (lu) [catálogo] [ . . . ]

Muestra las actualizaciones disponibles en los catálogos especificados. La adición de catálogos como argumentos limita la lista a aquellos catálogos que especifique. Si no está suscrito a un catálogo, no habrá actualizaciones disponibles, aun cuando se indique el nombre del catálogo como argumento. Deberá suscribirse para que se muestren las actualizaciones.

Puede que el resultado de este comando no coincida con las actualizaciones pendientes que se muestran en el servidor. Ello se debe a que la lista de actualizaciones pendientes del servidor muestra actualizaciones para todos los catálogos disponibles, no solamente para los que esté suscrito el cliente. Para que coincidan las listas, el cliente debe estar suscrito a todos los catálogos disponibles.

Acepta los siguientes indicadores de opción:

-t, --type: especifique el tipo de actualizaciones.

lock-add (la) [opciones] [nombre o patrón] [versión] [...]

Añade una regla de bloqueo de paquetes. Impide que se realicen cambios en el estado de la instalación del paquete especificado en el bloqueo. El nombre del paquete se puede especificar individualmente, con patrones de comodines o incluso con relaciones de números de versión.

lock-delete (ld) [opciones] [número de bloqueo] [...]

Suprime el bloqueo de paquetes que ha especificado según su número. Puede buscar el número para cada bloqueo con el comando lock-list (ll).

lock-list (ll) [opciones] [número de bloqueo] [...]

Muestra una lista de los bloqueos de paquetes activos. Los bloqueos se ordenan según el número de ID.

package-file (pf) [nombre de archivo]

Obtiene el paquete que contiene el archivo especificado.

packages (pa) [opciones] [catálogo] [...]

Muestra los paquetes de un catálogo concreto. Si no se especifica ningún catálogo, se muestran los paquetes de todos los catálogos. Acepta los siguientes indicadores de opción:

  • -i, --installed-only: muestra sólo los paquetes instalados.
  • -u, --uninstalled-only: muestra sólo los paquetes no instalados.
  • --sort-by-name: ordena los paquetes por el nombre (por defecto).
  • --sort-by-catalog: ordena los paquetes por catálogo.
patch-search (pse) [opciones] [cadena de consulta]

Busca revisiones que coincidan con un patrón. Acepta los siguientes indicadores de opción:

  • --match-all: necesita revisiones que coincidan con todas las cadenas de búsqueda (por defecto).
  • --match-any: permite revisiones que coincidan con cualquier cadena de búsqueda.
  • --math-substrings: hace coincidir las cadenas de búsqueda con cualquier parte del texto.
  • --match-words: necesita cadenas de búsqueda que coincidan con palabras completas.
  • -d, --search-descriptions: busca en las descripciones de las revisiones pero no en sus nombres.
  • -i, --installed-only: sólo muestra las revisiones que ya se han instalado.
  • -u, --uninstalled-only: muestra sólo las revisiones que no están instaladas actualmente.
  • -c, --catalog: muestra sólo las revisiones del catálogo que especifique.
  • --sort-by-name: ordena las revisiones por el nombre (por defecto).
  • --sort-by-catalog: ordena las revisiones por catálogo, no por nombre.
remove (rm) [opciones] [paquete] [...]

Elimina los paquetes especificados. Acepta los siguientes indicadores de opción:

  • -N, --dry-run: realiza pruebas y las muestra pero no lleva a cabo realmente las acciones solicitadas.
  • -i, --confirm: siempre necesita confirmación.
  • -y, --no-confirmation: no pide confirmación.
rollback (ro) [opciones] [fecha]

Deshace las transacciones de paquetes hasta la hora y la fecha que se especifique. Establece la preferencia a la hora de deshacer, que está desactivada por defecto. Acepta los siguientes indicadores de opción:

  • -d, --download-only: sólo descarga los paquetes.
  • -N, --dry-run: realiza pruebas y las muestra pero no lleva a cabo realmente las acciones solicitadas.
  • -i, --confirm: siempre necesita confirmación.
  • -y, --no-confirmation: no pide confirmación.
search (se) [opciones] [cadena de consulta]

Busca paquetes que coincidan con un patrón. Acepta los siguientes indicadores de opción:

  • --match-all: necesita paquetes que coincidan con las cadenas de búsqueda (por defecto).
  • --match-any: permite paquetes que coinciden con cualquier cadena de búsqueda.
  • --math-substrings: hace coincidir las cadenas de búsqueda con cualquier parte del texto.
  • --match-words: necesita cadenas de búsqueda que coincidan con palabras completas.
  • -d, --search-descriptions: busca en las descripciones de paquete pero no en los nombres.
  • -i, --installed only: sólo muestra paquetes que ya se han instalado.
  • -u, --uninstalled-only: sólo muestra paquetes que no se han instalado actualmente.
  • -c, --catalog: sólo muestra los paquetes del catálogo que especifique.
  • --sort-by-name: ordena los paquetes por el nombre (por defecto).
  • --sort-by-catalog: ordena los paquetes por catálogo, no por nombre.
summary (sum)

Muestra un resumen de las actualizaciones disponibles para cada catálogo.

update (up) [catálogo] [...]

Descarga e instala las actualizaciones. Si no se especifican argumentos, se instalan actualizaciones para todos los catálogos suscritos. Proporciona el nombre del catálogo para mantener las actualizaciones específicas con los catálogos mencionados. En el caso de lotes o paquetes únicos, utilice rug install. Si no está suscrito a ningún catálogo, no habrá actualizaciones disponibles. Incluso si indica el nombre del catálogo como argumento, deberá suscribirse para que se instalen las actualizaciones. Acepta los siguientes indicadores de opción:

  • -d, --download-only: sólo descarga los paquetes.
  • -t, --type: especifica el tipo de actualización.
  • --skip-interactive: omite las actualizaciones interactivas.
  • -g, --category: especifica la categoría de las revisiones que actualizar.
  • -N, --dry-run: realiza pruebas y las muestra pero no lleva a cabo realmente las acciones solicitadas.
  • -i, --confirm: siempre necesita confirmación.
  • -y, --no-confirmation: no necesita confirmación.
verify (ve) [opciones]

Verifica las dependencias del sistema. Si no se satisfacen las dependencias del sistema, rug sugiere que se eliminen o que se instalen los paquetes necesarios para resolver los conflictos. Acepta los siguientes indicadores de opción:

  • -N, --dry-run: realiza pruebas y las muestra pero no lleva a cabo realmente las acciones solicitadas.
  • -i, --confirm: siempre necesita confirmación.
  • -y, --no-confirmation: no necesita confirmación.
what-conflicts (wc) [dep-paquete]

Muestra una lista de los paquetes que entran en conflicto con el elemento que especifique.

what-provides (wp) [cadena de consulta]

Muestra paquetes que proporcionan la biblioteca, el programa o el paquete que especifique como [cadena de consulta].

what-requires (wr) [cadena de consulta]

Muestra paquetes que requieren la biblioteca, el programa o el paquete que especifique como[cadena de consulta].

Comandos de gestión de revisiones

patches (pch) [opciones] [catálogo] [catálogo] [...]

Muestra los parches de un catálogo concreto. Acepta los siguientes indicadores de opción:

  • -i, --installed-only: muestra sólo las revisiones instaladas.
  • -u, --uninstalled-only: muestra sólo las revisiones no instaladas.
patch-info [parche]

Muestra información detallada para un parche.

Comandos de gestión de patrones

pattern-info [patrón]

Muestra información detallada para un patrón.

patterns (pt) [opciones] [catálogo] [catálogo] [...]

Muestra los patrones de un catálogo concreto. Acepta los siguientes indicadores de opción:

  • -i, --installed-only: muestra sólo los patrones instalados.
  • -u, --uninstalled-only: muestra sólo los patrones no instalados.

Comandos de gestión de preferencias

get-prefs (get) [testigo]

Muestra el valor del testigo de preferencia especificado. Si no se especifica ningún testigo, se mostrarán todas las preferencias. Acepta los siguientes indicadores de opción:

  • -d, --no-descriptions: no muestra las descripciones de las preferencias.
set-prefs (set) [testigo] [valor]

Define una variable de preferencia.

Utilice rug get para mostrar las preferencias y los valores actuales.

Comandos de gestión de productos

product-info [producto]

Muestra información detallada para un producto.

products (pd) [opciones] [catálogo] [catálogo] [...]

Muestra los productos de un catálogo concreto. Acepta los siguientes indicadores de opción:

  • -i, --installed-only: muestra sólo los productos instalados.
  • u, --uninstalled-only: muestra sólo los productos no instalados.

Comandos de gestión de seguridad

key-add (ka) [nombre de clave] [ID de clave]

Añade un elemento a la lista de claves permitidas para un servicio.

key-delete (kd) [ID de clave]

Elimina un elemento de la lista de claves permitidas para un servicio.

key-list (kl) [...]

Muestra las claves permitidas para un servicio.

Comandos de gestión de servicios

mount [opciones] [vía]

Monta un directorio como si fuera un catálogo y añade todos los paquetes del directorio al catálogo. Se considera que la plataforma del catálogo es la misma que la del servidor. Acepta los siguientes indicadores de opción:

  • -r, --recurse: recurso en el directorio.
  • -a, --alias: alias para el nuevo canal.
  • -n, --name: nombre del nuevo canal.
refresh (ref) [...]

Actualiza los servicios especificados. Si no se especifica ningún servicio, se actualizarán todos ellos. Debe añadir un servicio usando el comando rug service-add antes de actualizar. Use rug service-list para ver la lista actual de servicios. El argumento del servicio puede ser el número de servicio obtenido de la salida de service-list.

register [URI | número | nombre] [clave]

Registra al cliente en el servidor especificado.

service-add (sa) [opciones] [URI]

Añade el servidor especificado como servicio. En la mayoría de los casos, el URI es la URL del servidor ZENworks Linux Management (Gestión de Linux ZENworks) como, por ejemplo, https://zlmserver. Acepta los siguientes indicadores de opción:

  • -t, --type: tipo de servicio. El valor por defecto es zenworks. Utilice rug service-types para ver los servicios disponibles. Los servidores ZENworks Linux Management 6.6.x necesitan el tipo 'rce'.
  • -d, --device-type: el tipo de dispositivo que está registrando.
  • -k, --key: clave de registro.
  • -f, --ignore-failure: reintenta el servicio si falla. Por defecto, el intervalo de reintento es 5 minutos y el número de reintentos es 3. Si no utiliza la opción -f, el servicio no se añadirá si el daemon de ZENworks Management (ZMD) no puede resolver el servicio ni registrarlo.
service-delete (sd) [URI | número | nombre] [...]

Suprime los servicios especificados.

service-list (sl)

Muestra una lista de los servicios disponibles.

service-types (st)

Muestra una lista de los tipos de servicios disponibles.

Comandos del sistema

clean-cache (cc) [...]

Limpia el caché HTTP.

load-modules (lm) [...]

Carga los módulos del daemon de ZENworks Management (zmd).

ping

Rastrea el daemon de ZMD del cliente.

restart

Reinicia el daemon ZLM. Acepta los siguientes indicadores de opción:

  • -f, --force: fuerza el apagado.
  • -n, --no-wait: no espera la confirmación de que se ha reiniciado el daemon.
  • --clean: limpia al reiniciar.
schedule (sch)

Muestra elementos programados.

shutdown [opciones] [...]

Detiene el daemon ZLM. Acepta los siguientes indicadores de opción:

  • -f, --force: fuerza el apagado.
  • -n, --no-wait: no espera a que se confirme que se ha apagado el daemon.
sleep [opciones] [...]

Pone el daemon en reposo. Acepta los siguientes indicadores de opción:

  • -f, --force: fuerza el reinicio.

Comandos de gestión de usuarios

user-add (ua) [nombre usuario] [privilegio] [...]

Añade un nuevo usuario con el nombre y los privilegios especificados. Se pueden otorgar los siguientes privilegios: instalar, bloquear, eliminar; suscribir, de confianza, actualizar, ver y superusuario. Si no proporciona argumentos, se le solicitarán. Después de añadir el usuario, rug user-update se ejecuta automáticamente. Utilice esta herramienta para otorgar privilegios adicionales. Acepta los siguientes indicadores de opción:

  • -r, --replace: sustituye el usuario si ya existe.
user-delete (ud) [nombre de usuario] [...]

Suprime los usuarios especificados.

user-edit (ue) [nombre de usuario]

Modifica un usuario existente. Este comando es interactivo: en primer lugar se muestran los privilegios y después se ofrece una indicación. Escriba el signo más (+) o menos (-) y el nombre del privilegio y, a continuación, pulse Intro. Por ejemplo, para permitir que el usuario instale el software, deberá escribir +install. Para guardar los cambios y salir, pulse Intro en una línea en blanco. Se pueden otorgar o revocar los siguientes privilegios: instalar, bloquear, eliminar, suscribir, de confianza, actualizar, ver, superusuario.

user-list (ul)

Muestra los usuarios.

Opciones globales

Las siguientes opciones se pueden aplicar a cualquier transacción de rug:

--normal-output

Resultado normal (es el modo por defecto). Se trata de algún lugar entre la salida de depuración y la concisa.

--terse

Resultado conciso.

--no-abbrev

Sin abreviatura.

--quiet

Resultado silencioso. Imprime sólo mensajes de error.

--depurar

Resultado de depuración. Imprime indicios de excepción completos.

Autores

Copyright 2005-2007, Novell, Inc.. Reservados todos los derechos.

Véase

zlman (1), zmd (8), zrmservice (1), zlm-debug (1), zlmmirror (1)

Para informar sobre problemas relacionados con este software o su documentación, visite Novell Bugzilla.