zac para Linux (1)

Name

zac - La interfaz de gestión de línea de comandos para el agente ZENworks de Micro Focus instalada y en ejecución en los dispositivos gestionados con Linux.

Sintaxis

zac command options

Descripción

La utilidad zac lleva a cabo funciones de gestión de línea de comandos sobre los dispositivos gestionados de ZENworks, incluida la instalación y desinstalación de lotes de software, la aplicación de directivas y el registro y anulación del registro de los dispositivos.

Guía de uso

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

La mayoría de los comandos cuenta con una forma larga y otra corta:

  • Forma larga: add-reg-key
  • Forma corta: ark

Si las dos formas están disponibles, el comando se describe del modo siguiente:

add-reg-key (ark) opciones

Para utilizar el comando, emplee solo la forma larga o la corta:

zac add-reg-key opciones

zac ark opciones

Si una opción incluye un espacio, utilice comillas:

zac ark "opción 1"

Argumentos obligatorios y opcionales

Los argumentos incluidos entre paréntesis ( ) son obligatorios, mientras que los que se incluyen entre corchetes [ ] son opcionales.

Puntos suspensivos (…)

Los puntos suspensivos indican que un comando acepta varias entradas del último tipo de argumento. Los argumentos se deben separar mediante espacios o comas, según el comando. Por ejemplo:

zac <comando> [opciones] (servidor) (lote) [...]

Los puntos suspensivos indican que <comando> puede aceptar varios lotes. En la ayuda del nivel de comandos, la ayuda de argumento de entrada múltiple se indica como [(lote) (lote) ... (lote)] para que sea más clara.

Comandos de ayuda

/? o ‑‑help

Muestra la ayuda del sistema.

COMANDO /?

Muestra la descripción de un comando específico.

/g o ‑‑group

Muestra los comandos del grupo especificado.

Comandos del servidor satélite de autenticación

authentication server reconfigure (asr) [-t all|config|jetty|casa] [-u usuario] [-p contraseña]

Reconfigura un satélite habilitado para la autenticación.

Ejemplos:

Para recuperar los archivos de configuración desde el servidor:

zac asr -t config

Para reconfigurar el certificado de firma CASA:

zac asr -t casa

Para reconfigurar el servidor web Jetty:

zac asr -t jetty -u Administrador -p contraseña

Para reconfigurar todo el satélite:

zac asr -t all -u Administrador -p contraseña

Si se requiere un nombre de usuario y una contraseña, pero no se indican en la línea de comandos, se le solicitará que lo haga.

import-authentication-cert(iac)[-pk <private-key.der>] [-c <signed-server-certificate.der>] [-ca <signing-authority-public-certificate.der>] [-ks <keystore.jks>] [-ksp <keystore-pass-phrase>] [-a <signed-cert-alias>] [-ks <signed-cert-passphrase>] [-u usuario] [-p contraseña] [-rc]

Configura un dispositivo satélite de autenticación con certificados firmados externamente.

  • rc: confirma la reconfiguración del servidor satélite de autenticación, para que no se solicite la reconfiguración al administrador.

Cada satélite debe tener su propio certificado de servidor y clave privada individuales. Para obtener información sobre cómo generar certificados externos, consulte la Guía de instalación del servidor ZENworks.

Comandos de lotes

bundle-install (bin) [opciones] [nombre del lote | GUID | Patrón]

Instala los lotes especificados según el nombre de visualización que coincida con la expresión exacta o la cadena o con el GUID del lote. Utilice el comando bundle-list para obtener una lista de los lotes disponibles y sus nombres de visualización.

Se admiten las siguientes expresiones exactas:

Expresión regular

Función

^abc

Da como resultado las cadenas que empiezan por "abc".

[abc]

Da como resultado las cadenas que contienen "a", "b" o "c".

a*c

Da como resultado las cadenas que empiezan por ninguna, una o varias "a" seguidas de "c", como "ac", "aac", "aaac" o "c".

Acepta la siguiente opción:

  • -N, ‑‑dryrun: prueba y muestra pero no realiza realmente la acción solicitada. Solo es posible realizar una ejecución de simulación en una versión del lote una vez. Esta opción solo es aplicable para las acciones de Instalar RPM del lote.

Ejemplo de instalación de un lote basado en el nombre del lote:

zac bin lote1

bundle-launch (bln) [nombre de visualización del lote] [-noSelfHeal]

Lanza el lote especificado. Se ejecutan las acciones del conjunto de acciones Lanzar.

Si intenta lanzar un lote que no esté instalado, primero se instala el lote y luego se lanza.

Utilice el comando bundle-list para obtener una lista de los lotes disponibles y sus nombres de visualización.

Ejemplo de lanzamiento de un lote basado en el nombre de visualización:

zac bln lote1

Ejemplo de lanzamiento de un lote basado en el nombre de visualización y desactivación de la autorreparación si se produce un error en la acción de lanzamiento (por defecto, la autorreparación está activada):

zac bln bundle1 -noSelfHeal

bundle-list (bl) [opciones]

Muestra la lista de los lotes asignados al dispositivo y a los usuarios que han entrado en la sesión.

El resultado de este comando se muestra en columnas, que proporcionan información de todos los lotes asignados o disponibles para el dispositivo gestionado. Las columnas Nombre de visualización, Versión y Tipo de lote representan el nombre de visualización del lote, el número de versión del lote o la zona protegida y el tipo de lote, respectivamente. La columna Estado muestra los siguientes estados:

  • Disponible: muestra este estado si el lote está instalado.
  • No instalado: muestra este estado si la versión concreta del lote no está instalada.
  • Descargado: muestra este estado si el contenido está descargado pero la acción del conjunto Instalar acciones no se ha ejecutado.

Este comando acepta las opciones siguiente:

  • -a, ‑‑all: muestra tanto los lotes filtrados como los no filtrados. Los lotes filtrados son lotes de cadena. Se muestran por defecto los lotes no filtrados.
  • -g, ‑‑show-guid: muestra el GUID del lote.

Un ejemplo para mostrar todos los lotes:

zac bl -a

bundle-lock-add (bla) [opciones] [nombre de lote] […]

Bloquea los lotes especificados que coincidan con la expresión exacta o la cadena y evita que se actualicen o se eliminen.

Se admiten las siguientes expresiones exactas:

Expresión regular

Función

^abc

Da como resultado las cadenas que empiezan por "abc".

[abc]

Da como resultado las cadenas que contienen "a", "b" o "c".

a*c

Da como resultado las cadenas que empiezan por ninguna, una o varias "a" seguidas de "c", como "ac", "aac", "aaac" o "c".

Acepta las siguientes opciones:

  • -li, ‑‑lock-install: bloquea el lote e impide la instalación del lote especificado en el bloqueo.

NOTA:los bloqueos de lotes solo son aplicables al conjunto de acciones Instalar.

  • -t, ‑‑type: especifique el tipo de lote que se debe bloquear. Los tipos disponibles son linux y patch. Si no se especifica ningún tipo, se seleccionará el tipo de lote.
bundle-lock-list (bll)

Muestra una lista con los bloqueos de lotes. Los bloqueos de lotes están ordenados por ID.

Ejemplo:

zac bll

bundle-lock-remove (blr) [opciones] [índicelote] […]

Elimina el bloqueo de lote que ha especificado según su número. Puede buscar el número para cada bloqueo usando el comando bundle-lock-list (bll).

Acepta las siguientes opciones:

  • -n: elimina los bloqueos de lote especificados por nombre. Asegúrese de que el nombre no contiene ningún patrón.
  • ‑‑remove-all: elimina todos los bloqueos de lotes.

Ejemplo para eliminar un bloqueo de lote abc:

zac blr -n abc

Ejemplo para eliminar todos los bloqueos de lotes:

zac blr ‑‑remove-all

bundle-refresh (br) [nombre de visualización | GUID del lote]

Actualiza la información acerca del lote especificado.

Ejemplo:

zac br lote1

bundle-search (bse) [opciones] pattern

Busca lotes que coincidan con la cadena o expresión regular especificada.

Se admiten las siguientes expresiones exactas:

Expresión regular

Función

a+bc

Da como resultado las cadenas que empiezan por una o más "a" seguidas de "bc".

Por ejemplo, "abc" o "aabc".

[a-z]\*

Da como resultado las cadenas vacías y las cadenas que solo incluyen caracteres alfabéticos.

Por ejemplo, coincide con la cadena vacía "" o con cadenas solo con caracteres alfabéticos como "abc" o "xyz".

a*bc

Da como resultado las cadenas que empiezan por ninguna, una o varias "a" seguidas de "bc".

Por ejemplo, "abc", "aabc", "aaabc" o "bc".

El resultado de este comando es similar al del comando zac bl.

Acepta la siguiente opción:

  • -i,‑‑installed-only: busca solo la lista de lotes instalados.
bundle-uninstall (bu) [nombre visualización | GUID del lote]

Desinstala el lote especificado. Las acciones que admiten la acción Deshacer se ejecutan mientras se desinstala el lote. Cuando se completa la desinstalación del lote, el estado del lote indica No instalado.

Utilice el comando bundle-list para obtener una lista de los lotes instalados y sus nombres de visualización.

Ejemplo:

zac bu lote1

bundle-verify (bv) [nombre de visualización del lote]

Vuelve a instalar el lote y ejecuta los conjuntos de acciones Verificar para garantizar que no se ha eliminado ni dañado ningún archivo. Utilice el comando bundle-list para obtener una lista de los lotes instalados y sus nombres de visualización.

Ejemplo:

zac bv lote1

Comandos de certificado

cert-info (ci) [vía de archivo de certificado de ca] [-u <usuario> -p <contraseña>]

Muestra información de certificados de claves públicas de cada servidor de ZENworks conocido o añade un certificado raíz de confianza al almacén de confianza del dispositivo. El archivo puede estar en formato ASN.1 DER o codificado en base 64 y delimitado por ‑‑‑‑BEGIN CERTIFICATE‑‑‑‑ y ‑‑‑‑END CERTIFICATE‑‑.

Ejemplo:

Para mostrar el certificado de cada servidor de ZENworks conocido:

zac ci

Para añadir un certificado raíz de confianza al almacén de confianza del dispositivo:

zac ci c:\certs\certificadodeconfianza.der -u usuario -p contraseña

Comandos de transferencia ascendente de recopilación

collection-clients (crc)

Muestra los dispositivos que han subido archivos a la recopilación.

Ejemplo:

zac crc

collection-point (cp)

Muestra el estado y la configuración de la función de recopilación.

Ejemplo:

collection-point [wake]

wake - Activa los módulos que realizan la recopilación (inventario, estado de MD, remitente).

collection-queued (crq)

Muestra los archivos recopilados cuya transferencia ascendente no se ha realizado todavía.

Ejemplo:

zac crq

collection-state (crs)

Muestra el estado de la función de recopilación del satélite en cada momento.

Ejemplo:

zac crs

collection-upload-orphans (cuo)

Busca los archivos huérfanos del dispositivo satélite y realiza una transferencia ascendente de esos archivos al servidor primario o los suprime en el caso de que la transferencia ascendente ya se haya realizado.

Este comando genera una lista de los archivos de las carpetas incluidas en /var/opt/novell/zenworks/work/collection (excepto los de la carpeta collectionStatsDB) y, a continuación, intenta encontrar la información de carga original de cada entrada de la base de datos de estadísticas de recopilación.

Si la base de datos incluye una entrada para un archivo y se indica en ella que no se ha realizado una transferencia ascendente del archivo, se realiza la transferencia. Si la entrada indica que ya se ha realizado la transferencia ascendente del archivo, este se elimina del dispositivo satélite. Si la base de datos no incluye ninguna entrada para un archivo, se realiza la transferencia ascendente del archivo. Este comando muestra además todos los archivos que no se han transferido ni suprimido.

Antes de ejecutar este comando, se debe ejecutar el comando zac crw para enviar todos los archivos pendientes al servidor padre.

Ejemplo:

zac cuo

collection-wake (crw)

Envía los archivos recopilados al servidor padre.

Ejemplo:

zac crw

Comandos de distribución de contenido

cdp-checksum (cchk) [-l:<vía al registro>]

Valida el contenido del satélite calculando la suma de comprobación de cada archivo.

El archivo de registro opcional detalla el resultado de la comparación de la suma de comprobación.

Ejemplo:

zac cchk -l:"/var/opt/novell/zenworks/logs/cchk.log"

cdp-verify-content (cvc) [-c] [-l:<vía al registro>]

Compara la lista de ID de contenido y sus estados de sincronización en este CDP con lo que los servidores primarios consideran que debería tener.

Puede emplear las siguientes opciones:

  • c - Calcula la suma de comprobación del contenido local.

Ejemplo:

zac cvc -l:"/var/opt/novell/zenworks/logs/cvc.log"

cdp-import-content (cic) <vía del contenido> [<vía al registro>]

Importa el contenido que falte desde el directorio especificado como vía del contenido y crea el archivo de registro especificado en la vía del registro.

Ejemplo:

zac cic /usr/content_Dir /var/opt/novell/zenworks/logs/cic.log

distribution-info (cdi) [opción]

Muestra información estadística acerca de la función de contenido. Puede emplear las siguientes opciones:

  • all - Se ejecutan todas las opciones marcadas con *.
  • ss - Muestra el estado de sincronización.*
  • rs - Obtiene el tamaño del repositorio de contenido.*
  • da - Muestra los dispositivos que han recuperado datos de este dispositivo.*
  • ne - Obtiene el número de errores de distribución de contenido.*
  • ds - Obtiene el tamaño de los datos servidos por este dispositivo.*
  • fs - Obtiene el número de archivos servidos.*
  • ah [n] - Muestra n (por defecto, todas) entradas del historial de acceso.
  • ch - Borra el historial.
  • eh <archivo> - Exporta el historial de acceso al archivo especificado en <archivo>. Se debe incluir la vía y el archivo en sí no debe existir.

Ejemplos:

zac cdi

zac cdi rs

distribution-state (cds)

Muestra el estado de la función de contenido del satélite. Muestra si la función está habilitada o inhabilitada, el estado (Iniciando, Activo, Deteniendo o Detenido), las URL padres y la programación de replicación.

Ejemplo:

zac cds

distribution-wake (cdp) [replicate | cleanup]

Activa el hilo de trabajo del punto de distribución de contenido. Es posible utilizar cualquiera de estas opciones:

  • replicate - Descarga el contenido nuevo o modificado del servidor de ZENworks padre del punto de distribución de contenido.
  • cleanup - Elimina el contenido que debe dejar de estar almacenado en el punto de distribución de contenido.

Ejemplos:

zac cdp

zac cdp replicate

Comandos principales

get-settings (gs) <clave>

El módulo de configuración descarga los valores en la caché local en cada actualización. Este comando devuelve la configuración en vigor asociada con la clave especificada.

Ejemplo:

zac gs clave1

Ejemplo para mostrar la lista de valores de configuración de gestión remota:

zac gs RemoteManagement

Todas las claves válidas valores de configuración de ZENworks se almacenan en el directorio /var/opt/novell/zenworks/zmd/cache/settings/.

get-pref (get) <nombre de preferencia>

Muestra las preferencias que están definidas en cada momento.

Ejemplo para mostrar todas las preferencias definidas:

zac get-pref

Ejemplo para mostrar todas las preferencias cuyo nombre comienza con abc:

zac get-pref abc

set-pref (set) <nombre de preferencia> <valor de preferencia>

Define el valor para una preferencia.

Ejemplo para definir el valor de la preferencia abc como 123:

zac set-pref abc 123

NOTA:si quiere configurar un servidor proxy para un dispositivo gestionado, asegúrese de que el dispositivo gestionado tienen configuradas las preferencias proxy-host y proxy-port. Si el servidor proxy requiere autenticación, el dispositivo gestionado debe tener configuradas también las preferencias proxy-username y proxy-password.

set-proxy (sp) [opciones] <dirección IP/nombre de host:puerto>

Permite especificar un servidor proxy de contacto en lugar de contactar directamente con un servidor ZENworks.

Las opciones son:

  • ‑‑default - Establece un servidor proxy que se puede anular mediante los ajustes de proxy de la zona de gestión.
  • ‑‑clear - Borra el servidor proxy actual, pero utiliza los ajustes de proxy de la zona de gestión.

Ejemplos:

IPv4:

zac sp 123.456.78.90:2349 administrator novell

zac sp /default 123.456.78.90:2349

zac sp /clear

Si no se especifica un nombre de usuario y una contraseña, se le pedirá que introduzca esos datos.

Comandos de actualización del sistema

zac zeus-refresh / zeus-ref

Recupera la actualización del sistema cuando se asigna a un dispositivo.

Comandos de servicio externo

Estos comandos se utilizan para gestionar servicios externos.

external-service-add (esa) ‑‑type (tipo) (url) (nombre del servicio) [propiedades]

Añade los repositorios de paquetes externos como YUM, ZYPP o el directorio local que contienen los RPM. Todas las propiedades específicas de tipo deben comenzar por -D.

Puede mostrar los tipos de servicios que puede añadir mediante el comando zac est.

Admite los tipos siguientes:

  • YUM: añade un repositorio de tipo YUM. Acepta las siguientes propiedades:

    • -Dusername=valor -Dpassword=valor: esta propiedad es opcional y se usa para añadir un repositorio YUM sin autenticar.
    • -DsyncExternal=true: esta propiedad es opcional y se usa para sincronizar con la herramienta de gestión de paquetes local.

    Por ejemplo, ejecute el comando siguiente para añadir un servicio de tipo YUM:

    zac esa ‑‑type YUM -Dusername=nombre de usuario -Dpassword=contraseña https://nu.novell.com/sles11 sles11-yum-repo

  • ZYPP: añade un repositorio de tipo ZYPP. Acepta las siguientes propiedades:

    • -DsyncExternal=true: esta propiedad es opcional y se usa para sincronizar con la herramienta de gestión de paquetes local.

    Por ejemplo, ejecute el comando siguiente para añadir un servicio de tipo ZYPP:

    zac esa ‑‑type ZYPP http://zypp.source.com/sles11/x86_64 sles11-zypp-repo

  • Montaje: añade un repositorio de tipo Montaje. Este tipo añade un servicio del directorio local que contiene los RPM. Acepta las siguientes propiedades:

    • -Drecursive=(valor): esta propiedad es opcional. Los valores válidos son Verdadero y Falso. Si es verdadero, los RPM se añaden de forma recurrente desde todos los directorios de la vía absoluta especificada.
    • -DsyncExternal=true: esta propiedad es opcional y se usa para sincronizar con la herramienta de gestión de paquetes local.

    Por ejemplo, ejecute el comando siguiente para añadir paquetes de forma recurrente desde todos los directorios mediante el tipo de servicio Montaje:

    zac esa ‑‑type mount -Drecursive=true file:///mnt/sles11-cd/i586 sles11-rpms

NOTA:los servicios ZYPP y Montaje no se sincronizan con la herramienta de gestión de paquetes YUM en los dispositivos Red Hat.

external-service-delete (esd) (índice | nombre | url | ‑‑all)

Elimina los servicios externos especificados.

La opción ‑‑all suprime todos los servicios externos.

external-service-list (esl)

Muestra una lista de todos los servicios externos.

La columna Origen muestra los agentes de ZENworks que se han añadido mediante el comando zac y muestra el servidor de ZENworks que se ha añadido mediante la directiva de servicio externo.

La columna Estado muestra si el servicio externo está activo o inactivo. No es posible actualizar los servicios externos que muestran el estado inactivo.

La otra columna Estado muestra si el servicio externo está habilitado o inhabilitado.

external-service-refresh (esr) (índice | nombre | url | ‑‑all)

Actualiza los servicios externos especificados.

La opción ‑‑all actualiza todos los servicios.

external-service-state (ess) (habilitar | inhabilitar) (índice | nombre | url | ‑‑all)

Habilita o inhabilita los servicios externos especificados.

La opción ‑‑all cambia el estado de todos los servicios.

external-service-types (est)

Muestra una lista de los tipos de servicios disponibles.

Comandos de imagen

file-system-guid (fsg)[-d] [-r]

Elimina y restaura el GUID de la estación de trabajo en el sistema de archivo como preparación para tomar una imagen.

Ejemplo para eliminar el GUID del sistema de archivos:

zac file-system-guid -d

Ejemplo para restaurar el GUID al sistema de archivos:

zac file-system-guid -r

Ejemplo para imprimir el valor del GUID:

zac fsg

Comandos de inventario

inventory (inv) [scannow | cdf]

Ejecuta una exploración de inventario o abre el formulario de datos de recopilación.

Ejemplo para ejecutar una exploración de inventario:

zac inv scannow

Ejemplo para abrir el formulario de datos de recopilación:

zac inv cdf

Comandos solo de inventario

Estos comandos se usan solo para los agentes de solo inventario (IOA).

zac ioa cfg <IP del servidor>

Configura el dispositivo de IOA de Linux en la IP de servidor mencionada.

Ejemplo para ejecutar una exploración solo de inventario:

zac ioa cfg 10.70.13.124

zac ioa version

Muestra la versión del agente de solo inventario (IOA).

inventory (inv) [scannow]

Ejecuta un escáner de inventario.

Ejemplo para ejecutar un escáner de inventario:

zac inv scannow

Comandos de gestión del usuario local

Estos comandos se usan para gestionar usuarios locales y sus privilegios.

user-add (ua) (nombre usuario)

Añade un usuario local al almacén de privilegios de ZENworks.

Ejemplo:

zac ua nombre de usuario

user-delete (ud) (nombre de usuario)

Suprime un usuario local del almacén de privilegios de ZENworks.

Ejemplo:

zac ud nombre de usuario

user-list (ul)

Muestra lo siguiente:

  • - Los nombres de usuario y los privilegios de los usuarios locales añadidos al almacén de privilegios de ZENworks.
  • - Los privilegios de los usuarios locales no añadidos al almacén de privilegios de ZENworks (usuario por defecto). El usuario por defecto se indica mediante un asterisco (*).

Ejemplo:

zac ul

user-edit (ue) (nombre de usuario) [+/-privilegio]

Permite editar los privilegios del usuario local. Use un signo + (más) para añadir un privilegio nuevo y un signo - (menos) para eliminar un privilegio existente.

Por defecto, un usuario local recién creado tiene el privilegio Ver. Los usuarios locales que no se añaden al almacén de privilegios de ZENworks heredan el privilegio asignado al usuario por defecto representado por el asterisco (*). Es posible cambiar los privilegios asignados a cualquier usuario local y asignar al usuario los privilegios siguientes:

Privilegio

Función

Ver

Permite ver o mostrar la información de lotes, directivas, configuración, etc.

Instale

Permite instalar o desinstalar lotes, directivas, paquetes, etc.

Configure (Configurar)

Permite ejecutar los comandos de configuración.

Superusuario

Permite ejecutar todos los comandos de zac, porque los superusuarios tienen asignados todos los privilegios. Por defecto, el usuario Root tiene asignado el privilegio de Superusuario, que no se puede modificar.

Ejemplos:

Si quiere permitir que los usuarios locales del almacén de privilegios de ZENworks puedan ver, instalar y desinstalar lotes y directivas, puede asignar los privilegios Ver e Instalar a estos usuarios mediante el comando siguiente:

zac ue nombre de usuario +Install

Si quiere permitir que los usuarios locales que no están añadidos al almacén de privilegios de ZENworks puedan ver, instalar y desinstalar lotes y directivas, puede asignar los privilegios Ver e Instalar al usuario con el asterisco mediante el comando siguiente:

zac ue '*' +Install

user-privilege-export (upe) (nombre de archivo .xml)

Exporta una lista de usuarios locales y sus privilegios a un archivo .xml especificado para volver a utilizar esta lista en otros dispositivos gestionados.

Ejemplo:

zac upe /tmp/privileges.xml

Después de exportar la lista, puede importarla en otros dispositivos gestionados mediante el comando user-privilege-import (upi).

user-privilege-import (upi) (nombre de archivo .xml)

Importa una lista de usuarios locales y sus privilegios a otros dispositivos gestionados desde un archivo .xml especificado. Esta lista se puede exportar a un archivo .xml mediante el comando user-privilege-export (upe).

Ejemplo:

zac upi /tmp/privileges.xml

Comandos de ubicación

config-location (cl)

Muestra la ubicación de la configuración. La ubicación de la configuración determina a qué servidor (o servidores) de ZENworks se conecta el dispositivo para fines de autenticación, configuración, contenido y recopilación.

Ejemplos:

zac config-location

zac cl

Comandos de registro

logger [resetlog | level [MANAGED|ERROR|WARN|INFO|DEBUG] | managedlevel]

Cambia la configuración del registrador.

Puede emplear las siguientes opciones:

  • resetlog - Restaura el registro.
  • level - Si se utiliza sin un nivel, muestra el nivel de registro gestionado actualmente. Si se utiliza con uno de los niveles, cambia el nivel de registro al nivel especificado.
  • managedlevel: muestra el nivel de registro global de la zona.

Ejemplo para restaurar el archivo de registro:

zac logger resetlog

Ejemplo para mostrar el nivel de registro actual:

zac logger level

Ejemplo para establecer el nivel de registro como DEBUG y superiores:

zac logger level DEBUG

Comandos de gestión de paquetes

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.

checkpoints-list

Muestra una lista de los puntos de comprobación guardados.

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

Elimina los puntos de comprobación especificados.

dist-upgrade (dup) [opciones] [nombre del lote|nombre del servicio] […]

Realiza una actualización de distribución. Este comando lleva a cabo una actualización de todos los paquetes con un algoritmo de Resolver especial que se encarga del cambio de arquitectura del paquete, las divisiones de paquetes, las actualizaciones de patrones y productos, etc. Si no se proporcionan argumentos, se tienen en cuenta los paquetes de todos los lotes y servicios externos de ZENworks a la hora de actualizar la distribución.

Acepta las siguientes opciones:

  • -d, ‑‑download-only: solo descarga los paquetes.
  • -N, ‑‑dry-run: prueba y muestra las acciones solicitadas pero no las realiza en realidad.
  • -y, ‑‑no-confirm: no solicita confirmación.

Por ejemplo, puede actualizar la distribución de SLES 10 SP2 a SLES 10 SP3.

info (info) [opción] pattern

Muestra la información acerca del paquete especificado que coincide con el patrón indicado.

Se admiten las siguientes expresiones exactas:

Expresión regular

Función

^abc

Da como resultado las cadenas que empiezan por "abc".

[abc]

Da como resultado las cadenas que contienen "a", "b" o "c".

a*c

Da como resultado las cadenas que empiezan por ninguna, una o varias "a" seguidas de "c", como "ac", "aac", "aaac" o "c".

El comando muestra el nombre, la versión, la arquitectura y la descripción de los paquetes.

Acepta las siguientes opciones:

  • ‑‑provides: muestra los paquetes y archivos proporcionados por el paquete que coincide con el patrón especificado.
  • ‑‑requires: muestra los paquetes y archivos que necesita el paquete que coincide con el patrón especificado.
install (in) [opciones] (nombre paquete) […]

Instala los paquetes especificados. Si especifica un paquete con una versión, se instala la versión exacta del paquete. Si especifica un paquete con un nombre, se instala la versión más adecuada del paquete.

NOTA:si quiere devolver el paquete a una versión anterior, especifique la versión a la que quiere volver.

Acepta las siguientes opciones:

  • -b, ‑‑bundle [nombre de lote]: instala un paquete desde el lote especificado. El lote que especifique también puede ser un lote de dependencias de Linux. Sin embargo, para instalar un lote de dependencias de Linux, la opción Publicar paquetes se debe definir en Verdadero. Para obtener más información acerca de la publicación de paquetes, consulte Creación de dependencias de lotes en Linux.
  • -d, ‑‑download-only: descarga los paquetes al directorio caché de zen. Por defecto, está situado en /var/opt/novell/zenworks/zmd/cache.
  • -N, ‑‑dry-run: prueba y muestra las acciones solicitadas pero no las realiza en realidad.
  • -y, ‑‑no-confirm: no solicita confirmación.
  • -f, ‑‑freshen: instala paquetes solo si hay una versión anterior del paquete.
  • -s, ‑‑service [nombre de servicio]: instala un paquete desde el servicio especificado.
  • -p, ‑‑pattern [nombre de patrón]: instala un paquete de un patrón específico. Sin embargo, solo se instala la parte de paquetes obligatoria del patrón.
  • ‑‑entire-bundle [nombre de lote] […]: instala todos los paquetes desde los lotes especificados. Puede especificar un único lote o varios lotes.
  • ‑‑ignore-dependency: no comprueba las dependencias. Los paquetes dependientes se omiten y solo se instalan los paquetes.
  • -r, ‑‑regex-pattern <patrón de regex> [<patrón de regex>] - Instala todos los paquetes que coinciden con la expresión regular especificada.

Se admiten las siguientes expresiones exactas:

Expresión regular

Función

^abc

Da como resultado las cadenas que empiezan por "abc".

[abc]

Da como resultado las cadenas que contienen "a", "b" o "c".

a*c

Da como resultado las cadenas que empiezan por ninguna, una o varias "a" seguidas de "c", como "ac", "aac", "aaac" o "c".

El comando también muestra los paquetes dependientes necesarios para completar correctamente la instalación.

list-updates (lu) [opciones] [nombre de lote|nombre de servicio] […]

Muestra las actualizaciones disponibles en los lotes y servicios especificados. Puede especificar un único lote o servicio o varios lotes y servicios para los que desee mostrar las actualizaciones. Si no se especifica ningún lote o servicio, el comando muestra todas las actualizaciones disponibles.

Acepta la siguiente opción:

  • -t, ‑‑type [tipo]: muestra una lista con las actualizaciones para el tipo de servicio especificado.
lock-add (la) (nombre o patrón)[versión]

Añade una regla de bloqueo de paquetes. Este comando bloquea los paquetes especificados, que además, si coinciden con la expresión exacta o la cadena especificadas, no se actualizan ni se eliminan. El nombre del paquete se puede especificar individualmente, con patrones de comodines o incluso con relaciones de números de versión. El número de versión se debe especificar entre comillas simples o dobles.

Operador de relación

Función

=

Bloquea solo la versión del paquete especificado.

<

Bloquea todas las versiones del paquete anteriores a la versión especificada, excepto como a ella misma.

>

Bloquea todas las versiones del paquete posteriores a la versión especificada, excepto a ella misma.

<=

Bloquea todas las versiones del paquete anteriores a la versión especificada, así como a ella misma.

>=

Bloquea todas las versiones del paquete posteriores a la versión especificada, así como a ella misma.

Si desea instalar un versión específica del paquete, este comando comprueba en primer lugar si la versión del paquete está bloqueada y, a continuación, la instala solo si no lo está. Por ejemplo, imaginemos que todas las versiones anteriores del paquete “X 1.7” se han bloqueado utilizando el comando zac la X '>' 1.7. Si intenta instalar el paquete X 1.9 mediante el comando zac in X (1.9), se produce un fallo en la instalación.

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

Suprime el bloqueo de paquete 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)

Muestra una lista con los bloqueos de paquetes.

packagehistory (ph) [opciones] […]

Muestra el historial de transacciones del paquete realizado mediante ZENworks. Este comando muestra el nombre, la fecha, la operación, la versión y el lanzamiento del paquete.

Acepta las siguientes etiquetas de opción:

  • -n, ‑‑search-name [nombre de paquete] - Realiza una búsqueda por nombre de paquete.
  • -a, ‑‑search-action [nombre de acción] - Realiza una búsqueda por nombre de acción. Los nombres de acciones válidos son: Ninguna, Instalación, Eliminación y Actualización.
  • -d, ‑‑days-back [días]: número máximo de días en los que se debe buscar hacia atrás (valor por defecto 30).
  • -c, ‑‑clean-history: limpia el historial de paquetes.
  • -o, ‑‑search-operation [operación]: realiza búsquedas según la operación. La operación realizada puede ser Instalar, Eliminar o Actualizar.
remove (rm) [opciones] (nombre de paquete) […]

Elimina los paquetes especificados.

Acepta las siguientes opciones:

  • ‑‑entire-bundle [nombre de lote]: elimina todos los paquetes del lote especificado.
  • -N, ‑‑dry-run: realiza pruebas y las muestra pero no realiza realmente las acciones solicitadas.
  • -y, ‑‑no-confirm: no solicita confirmación.
  • -r, ‑‑regex-pattern <patrón de regex> [<patrón de regex>] - Elimina todos los paquetes que coincidan con la expresión regular especificada.

Se admiten las siguientes expresiones exactas:

Expresión regular

Función

^abc

Da como resultado las cadenas que empiezan por "abc".

[abc]

Da como resultado las cadenas que contienen "a", "b" o "c".

a*c

Da como resultado las cadenas que empiezan por ninguna, una o varias "a" seguidas de "c", como "ac", "aac", "aaac" o "c".

Este comando muestra también los paquetes dependientes necesarios para completar correctamente la eliminación del paquete especificado.

rollback (ro) [opciones] [fecha o punto de control]

Devuelve las transacciones del paquete a la hora y la fecha que especifique, si esta preferencia está definida. Esta preferencia está inhabilitada por defecto. Puede habilitar la preferencia de deshacer ejecutando el comando zac set rollback true.

Si desea volver a una versión concreta del paquete, tanto la versión concreta como sus dependencias deben estar disponibles como parte del servicio o del lote asignado. Si la versión del paquete o sus dependencias no están disponibles, la operación de deshacer falla.

Este comando también muestra los paquetes dependientes necesarios para realizar correctamente la acción de deshacer.

Acepta las siguientes opciones:

  • -d, ‑‑download-only: solo descarga los paquetes.
  • -N, ‑‑dry-run: realiza pruebas y las muestra pero no realiza realmente las acciones solicitadas.
  • -y, ‑‑no-confirm: no solicita confirmación.
  • -p, ‑‑package (nombre de paquete): nombre del paquete que se debe deshacer.
search (se) [opciones] [patrón]

Busca paquetes que coincidan con un patrón especificado. Si no se proporcionan argumentos, muestra todos los paquetes. Este comando muestra el nombre de origen, el tipo de origen, el nombre del paquete, la versión y la arquitectura.

Acepta las siguientes opciones:

  • -b, ‑‑bundle [nombre de lote]: busca paquetes en el lote especificado.
  • -d, ‑‑search-in-description: busca en las descripciones de paquete, pero no en los nombres.
  • -i, ‑‑installed-only: muestra solo los paquetes instalados.
  • -u, ‑‑uninstalled-only: muestra solo los paquetes no instalados.
  • -s, ‑‑service [nombre de servicio]: busca paquetes en el servicio especificado.
  • -t, ‑‑type [tipo de servicio]: busca paquetes en función del tipo de servicio especificado.
  • -p, ‑‑pattern [nombre de patrón]: muestra los patrones disponibles.
  • ‑‑sort-by-bundle: ordena los paquetes por lote, no por el nombre. La ordenación por defecto es mediante los nombres de paquete.
  • ‑‑show-nevra: muestra los detalles NEVRA de los paquetes.
update (up) [opciones] [nombre de lote|nombre de servicio] […]

Actualiza los paquetes instalados. Puede especificar un único nombre de lote o servicio o varios nombres de lotes o servicios cuyos paquetes se deban actualizar. Si no se especifica ningún nombre de lote o servicio, se actualizarán todos los paquetes.

Si hay paquetes instalados con el mismo nombre y arquitectura pero versiones distintas, solo se actualizan los paquetes con la versión más alta.

Acepta las siguientes opciones:

  • -d, ‑‑download-only: solo descarga los paquetes.
  • -N, ‑‑dry-run: realiza pruebas y las muestra pero no realiza realmente las acciones solicitadas.
  • -y, ‑‑-no-confirm: no solicita confirmación.
  • -t, ‑‑type [tipo de servicio]: actualiza los paquetes desde un tipo de servicio externo especificado.
what-provides (wp) pattern

Muestra los paquetes que proporcionan la biblioteca, el programa o el paquete que coincide con un patrón especificado. Solo se admite el patrón de carácter comodín asterisco (*).

Ejemplo para mostrar los paquetes que terminan por a:

zac wp *a

what-requires (wr) pattern

Muestra los paquetes que requieren la biblioteca, el programa o el paquete que coincide con un patrón especificado.

Ejemplo para mostrar paquetes que empiezan por a:

zac wr a*

Comandos de gestión de revisiones

patch-scan (ps)

Explora el dispositivo en busca de parches que no se hayan aplicado. Para ello, usa el archivo de firma de parche (DAU) actual del dispositivo. Los resultados se cargan en el servidor.

Ejemplo para ejecutar una exploración de parches:

zac ps

patch-scan ‑‑quick (ps ‑‑quick)

Carga los resultados de la última exploración en el servidor. No ejecuta una exploración de detección nueva.

Ejemplo para ejecutar una exploración de parches rápida:

zac ps ‑‑quick

patch-apply-policy (pap)

Actualiza los dispositivos con la versión más reciente de todas las directivas de parches.

Ejemplo para ejecutar una directiva de aplicación de parches:

zac pap

patch-quarantine-release (pqr)

Libera todos los parches en cuarentena en el dispositivo donde se ejecuta el comando para que se pueda realizar un único intento de instalación, ya sea mediante una programación de directiva de parches o una programación de correcciones.

Ejemplo para ejecutar una liberación de cuarentena de parches:

zac pqr

Comandos de directivas

policy-list (pl)

Muestra las directivas que se están aplicando actualmente en el dispositivo (directivas vigentes). Para mostrar todas las directivas (las que están en vigor y las que no), utilice la opción ‑‑all.

Ejemplos:

zac pl

zac pl ‑‑all

policy-refresh (pr)

Aplica todas las directivas asignadas al dispositivo y al usuario.

Ejemplo:

zac pr

Comandos de registro

add-reg-key (ark) <clave de registro>

Registra el dispositivo empleando la clave especificada. El registro mediante claves es acumulativo. Si el dispositivo se ha registrado anteriormente con una clave y lo registra con una nueva, el dispositivo recibirá todas las asignaciones de grupos asociadas a ambas claves.

Ejemplo:

zac ark clave12

register (reg) [-k <clave>] [-u <usuario> -p <contraseña>] <dirección de servidor de ZENworks:puerto>

Registra el dispositivo en una zona de gestión. Para ejecutar este comando, debe tener los derechos de dispositivo Crear/Suprimir para la carpeta en la que se intenta registrar.

Ejemplos:

zac reg -k clave1 https://123.456.78.90

zac reg -k clave1 https://zenserver.novell.com:8080

El número de puerto solo es obligatorio si el servidor de ZENworks no utiliza el puerto HTTP por defecto (80). Si no especifica el nombre de usuario y la contraseña, el sistema solicitará estos datos.

NOTA:la opción -k no se tendrá en cuenta si el objeto de dispositivo correspondiente ya está presente en el servidor y tiene lugar la reconciliación con dicho objeto de dispositivo.

reregister (rereg)[-u <nombre de usuario> -p <contraseña>] <GUID nuevo>

Registra un dispositivo en la zona actual y le asigna el GUID de un objeto de dispositivo existente. El objeto de dispositivo asociado actualmente se suprime. Para ejecutar este comando, debe tener los derechos de dispositivo Crear/Suprimir para la carpeta cuyo registro intenta volver a registrar.

Por ejemplo, si genera la imagen de un dispositivo después de sustituir el disco duro, el dispositivo deberá obtener un GUID nuevo. Sin embargo, si se utiliza el comando para volver a registrar, se puede asignar el mismo GUID que tenía antes de sustituir el disco duro.

Ejemplos:

Para volver a registrar, especifique un nombre de usuario y una contraseña:

zac reregister -u miusuario -p micontraseña eaa6a76814d650439c648d597280d5d4

Para volver a registrar y que se le solicite un nombre de usuario y una contraseña:

zac reregister eaa6a76814d650439c648d597280d5d4

unregister (unr) [-f] [-s] [-a] [-u <usuario> -p <contraseña>]

Elimina el registro del dispositivo de la zona de gestión. Para ejecutar este comando, debe tener los derechos de dispositivo Crear/Suprimir para la carpeta cuyo registro intenta anular.

Ejemplo:

Para forzar la anulación local del registro de un dispositivo en caso de que no sea posible contactar con el servidor:

zac unr -f -u miusuario -p micontraseña

Para anular localmente el registro y suprimir la solicitud del nombre de usuario y la contraseña:

zac unr -s

Use la opción -a para anular el registro de forma asíncrona. Con esta opción, el servidor suprime el dispositivo de forma asíncrona.

Los parámetros -a, -f, -u y -p son opcionales. Si no utiliza los parámetros -u ni -p, se le pedirá que introduzca un nombre de usuario y una contraseña. Si se especifica la opción -a, el servidor de ZENworks devuelve la llamada de anulación de registro rápidamente, pero suprime el objeto de dispositivo de forma asíncrona de la base de datos más tarde. Si no se completa la supresión del dispositivo e intenta registrarlo de nuevo, el servidor de ZENworks muestra un error. Si hay muchos datos asociados con el dispositivo en la base de datos, suprimir el dispositivo podría tardar mucho tiempo. Asegúrese de usar la opción -a si la supresión del dispositivo tarda mucho y provoca que se agote el tiempo límite para el comando de anulación de registro del agente.

NOTA:al ejecutar el comando UNR, se produce un uso elevado de la base de datos. Esto puede deberse a uno de los siguientes motivos:

  • El comando UNR se ejecuta en el servidor.

  • La zona contiene un gran número de dispositivos gestionados.

  • Los dispositivos gestionados tienen una historia enorme.

  • Está habilitada la gestión de parches.

reestablish-trust (retr) [-u <usuario> -p <contraseña>]

Restablece la confianza con la zona de gestión actual. El nombre de usuario y la contraseña deben corresponder al administrador de la zona.

Ejemplo:

zac retr -u usuario -p contraseña

Los parámetros -u y -p son opcionales. Si no utiliza los parámetros -u ni -p, se le pedirá que introduzca un nombre de usuario y una contraseña.

Comandos de la función de satélite

remint-satellite-cert (rsc)

Vuelve a acuñar el certificado SSL para el satélite.

Ejemplo: zac rsc

satellite-cachecfg (satcfg)

Lee las funciones de satélite del caché.

Ejemplo:

zac satcfg

satellite-clearcache (satcc)

Borra la información de configuración de satélite del caché.

Ejemplo:

zac satcc

satellite-refreshcfg (satrc)

Actualiza las funciones de satélite.

Ejemplo:

zac satrc

satellite-roles (satr)

Informa sobre las funciones de satélite en uso y su estado.

Ejemplo:

zac satr

imgsatserver status (iss status)

Muestra las propiedades de la función de imagen del dispositivo, incluidos el estado, el estado de los servicios de PXE, los archivos de imagen y las estadísticas de imagen.

Estado actual: muestra si el dispositivo está actualmente configurado para realizar las operaciones de generación de imágenes. El estado actual es Activo cuando el dispositivo se ha subido de nivel para convertirlo en servidor satélite con función de generación de imágenes.

Estado de servicio PXE: muestra si el servicio DHCP del servidor proxy está habilitado en el dispositivo.

Peticiones PXE: el número de peticiones de generación de imágenes de cualquier tipo que ha recibido el servidor generador de imágenes desde que se inició. Se incluyen las peticiones que fallan, que se deniegan o que hacen referencia a otros servidores generadores de imágenes. La información sobre cada una de estas peticiones, como el origen, el tipo, la fecha o la hora y los resultados, se registra en el servidor generador de imágenes.

Imágenes enviadas: el número de imágenes que el servidor generador de imágenes ha enviado a los clientes desde que se inició el servidor por última vez. Se incluyen únicamente las imágenes recuperadas desde este servidor generador de imágenes.

Imágenes recibidas: el número de imágenes nuevas recibidas y almacenadas en el servidor generador de imágenes desde que se inició el servidor por última vez. Se incluyen las imágenes que se reciben a través de referencias de cliente.

Ejemplo:

zac iss status

Comandos de estado

agent-properties (agp)

Proporciona información acerca de ZENworks Agent. Los campos siguientes proporcionan información acerca del agente ZENworks:

Dirección del dispositivo: la dirección IP del dispositivo.

Dispositivo. el nombre del equipo del dispositivo.

Estado del dispositivo: el estado del dispositivo, que puede ser gestionado, no gestionado, retirado o desconocido. El estado Desconocido se muestra solo si se produce un error.

Último contacto con el servidor: la última vez que el agente ZENworks ha contactado con el servidor ZENworks.

Siguiente contacto con el servidor: la hora programada a la que el agente ZENworks debe contactar con el servidor ZENworks.

Usuario principal: usuario que ha entrado a la sesión en ese momento.

Ejemplo:

zac agp

zac agent-properties

cache-clear (cc)

Borra el caché de ZENworks del dispositivo. De esta forma se eliminan todas las entradas de la base de datos caché y se suprimen todos los archivos de caché asociados con esas entradas.

Ejemplo:

zac cc

refresh (ref)[general [bypasscache] | partial [bypasscache] | bypasscache]

Inicia una actualización general o parcial para actualizar los valores de configuración y de registro.

Utilice bypasscache para que no se utilicen los datos del caché del servidor durante la actualización. Esta opción es útil para realizar pruebas o solucionar problemas.

Ejemplos:

zac ref general bypasscache

zac ref partial bypasscache

zac ref bypasscache

zenhttp-status (zhs)

Muestra una lista de puertos y etiquetas de los gestores registrados.

Ejemplo:

zac zhs

zone-config (zc)

Muestra información acerca del servidor de ZENworks al que está accediendo el dispositivo para obtener información sobre la configuración (servidor de configuración) o muestra la información del servidor de configuración.

Ejemplos:

zac zc

get-settings (gs) <clave>

El módulo de configuración descarga los valores en la caché local en cada actualización. Este comando devuelve la configuración en vigor asociada con la clave especificada.

Ejemplo:

zac gs clave1

Todas las claves válidas de valores de configuración de ZENworks se almacenan en el directorio /var/opt/novell/zenworks/cache/zmd/settings.

Ejemplo para mostrar la lista de valores de configuración de gestión remota:

zac gs RemoteManagement

statussender (sts)

Este comando realiza una transferencia ascendente de la información de estado al servidor primario. Puede realizar la transferencia ascendente de la información que se ha actualizado desde la última vez que se realizó esta operación para la información del estado o puede transferir la información de estado completa.

Ejemplos:

Para realizar una transferencia ascendente de la información de estado que se ha actualizado desde la última operación de este tipo correcta:

zac sts rollup

Para realizar una transferencia ascendente de información de estado completa:

zac sts rollup full