zac (1)

Name

zac - Interfaz de gestión de la línea de comandos para satélites Linux de Novell.

Sintaxis

zac comando opciones

Descripción

La utilidad zac realiza funciones de gestión de la línea de comandos en los dispositivos no gestionados de ZENworks, incluidos la configuración del satélite y el registro o la anulación del registro de los dispositivos.

Guía de uso

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 sólo 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"

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 servidor 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 servidor 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]

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

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-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, éste 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 cualquier contenido nuevo o cambiado del servidor de ZENworks padre del punto de distribución de contenido.
• cleanup - Elimina cualquier contenido que no se deba seguir almacenando en el punto de distribución de contenido.

Ejemplos:

zac cdp

zac cdp replicate

Comandos principales

get-settings (gs) <clave de registro>

Muestra los valores de configuración efectivos asociados con la clave de registro 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

Para definir un servidor proxy, se usan las siguientes preferencias:

• proxy-host - Especifica el servidor proxy que se debe usar para canalizar las peticiones HTTP.
• proxy-port - Especifica el puerto con el que se establece la conexión con el servidor proxy.
• proxy-username - Especifica el nombre de usuario que se debe usar para conectar con el servidor proxy.
• proxy-password - Especifica la contraseña que se debe usar para conectar con el servidor proxy.

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 gestionado actualmente.

Ejemplo de restauración de 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 MANAGED

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 <nombre de usuario> -p <contraseña>] <dirección de servidor de ZENworks:puerto>

Registra el dispositivo en una zona de gestión.

Ejemplos:

zac reg -k clave1 https://123.456.78.90

zac reg -k clave1 -u administrador -p novell https://servidorzen.novell.com:8080

El número de puerto sólo es obligatorio si el servidor de ZENworks no utiliza el puerto HTTP por defecto (80). Si no se proporciona un nombre de usuario y una contraseña, se le solicitarán.

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.

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] [-u <nombre de usuario> -p <contraseña>]

Elimina el registro del dispositivo de la zona de gestión.

Ejemplo:

zac unr -u administrador -p novell

Los parámetros -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. El parámetro -f ignora la base de datos de ZENworks y fuerza que se anule el registro del dispositivo de forma local. Esta opción sólo es necesaria si el objeto de dispositivo ya se ha suprimido de la base de datos de ZENworks o si el dispositivo no puede conectar con la base de datos.

Comandos de la función de satélite

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 Adaptive Agent. Los campos siguientes proporcionan información acerca de ZENworks Adaptive Agent:

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 sólo si se produce un error.

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

Siguiente contacto con el servidor: la hora programada a la que el agente de Adaptive debe contactar con el servidor de 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

Autores

Copyright 2009-2010, Novell, Inc. Reservados todos los derechos. http://www.novell.com