Difference between revisions of "WPKG flags:sp"

Revision as of 10:42, 19 November 2010

Este documento en otros idiomas: Inglés

wpkg.js flags para WPKG-0.9.10

/profile:<profile> - Fuerza el nombre del perfil actual. Si no se indica, será el perfil localizado en el fichero hosts.xml.

/base:<path> - Establece el camino local/remoto para buscar los ficheros de configuración.

/query:<option> - Muestra un lista de los paquetes que se detectan con el criterio especificicado en la opción. Estas opciones pueden ser:

    a - todos lo paquetes
    i - paquetes actualmente instalados en el equipo
    x - paquetes que no se han instalado en el equipo
    u - paquetes que pueden ser actualizados

/show:<package> - Muestra un listado del paquete indicado, incluyendo su estado.

/install:<package> - Instala el paquete indicado en el equipo.

/remove:<package> - Desinstala el paquete indicado en el equipo.

/upgrade:<package> - Actualiza el paquete indicado y previamente instalado en el sistema.

/synchronize - Sincroniza el estado del programa actual con el estado proporcioado por el perfil indicado. Esta acción debería ser ejecutada en cada arranque del equipo para que WPKG sea realmente útil.

/quiet - Utiliza el log de eventos para grabar todos los mensajes de error/estado. Utilizar esta opción cuando se ejecute de forma desatendida.

/nonotify - Evita notificar al usuario sobre las actualizaciones que se van a realizar.

/noreboot - El equipo no se reiniciará a menos que sea necesario por alguna actualización/instalación/...

/rebootcmd:<option> - Utilizar el comando indicado para reiniciar. El camino será el completo o el relativo a la localización del fichero wpkg.js. Indicando "special" como opción se utiliza tools\psshutdown.exe de www.sysinternals.com - si existe - y un bucle de notificaciones.

/force - Utilizar force para realizar acciones manuales. Estas acciones manuales no aseguran que tu equipo quede actualizado con el estado descrito por el fichero hosts.xml, packages.xml and profiles.xml (p.e., cuando alguien ha añadido/eliinado software por otros medios diferentes a WPKG). De esta forma se escaneará el equipo para todos los posibes paquetes indicados en packages.xml, y entonces, instalará y/o desinstalará los packages, de acuerdo a contenido de profiles.xml / packages.xml / hosts.xml para un equipo dado.

/forceinstall - Fuerza la reinstalación de los paquetes. El comando "install" se ejecutará aunque se detecten condiciones de comprobación (cláusulas check"). Esto puede ser util para "reparar" paquetes, etc. No utilizarlo a menos que esté completamente seguro de lo que se va ha hacer (WPKG arrancará todos los comandos de instalación de todos los paquetes). Una forma mejor es supervisar la actualización de un sólo paquete (el que sabe que está ocasionando problemas), y manualmente provocar la actualización de un sólo paquete.

/norunningstate - En exportar el estado de ejecución al registro (HKLM\Software\WPKG\running se pone a true cuando WPKG se está ejecutando, y a false cuando finaliza la ejecución).

/quitonerror - Interrumpe inmediatamente la ejecución, si la instalación de algún paquete no es satisfactoria (por defecto: Instala el siguiente paquete y muestra/guarda el error en los listados de estado).

/debug or /verbose - Imprime información de debug. Imprime todas las acciones realizadas por WPKG. Esto es útil en instalaciones de paquetes, para conocer la forma de actuar de WPKG (y así comprender como trabaja WPKG).

/dryrun - "Simula" la instalación de un paquete, sin instalar nada. No se ejecuta ninguna acción. Se asume también el argumento /debug en este caso.

/help - Muestra estos argumentos y describe resumidamente la función de cada uno.

wpkg.js flags (for WPKG-1.0)

Parámetros utilizados frecuentemente

(Para operaciones con paquetes hay que indicar el mismo)

/install:<package>

Instala el paquete indicado en el equipo.

/query:<option>

Muestra una lista de los paquetes que casan con el criterio indicado. Opciones válidas son:

    a - todos los paquetes
    i - paquetes que actualmente están instalados en el equipo
    x - paquetes que no han sido instalados en el equipo
    u - paquetes que deben ser actualizados

/remove:<package>

Desinstala un paquete del equipo.

/show:<package>

Muestra un listado sobre el paquete indicado; incluyendo su estado.

/upgrade:<package>

Actualiza un paquete ya instalado en el equipo.

/synchronize

Sincroniza el estado del programa actual con el estado proporcioado por el perfil indicado. Esta acción debería ser ejecutada en cada arranque del equipo para que WPKG sea realmente útil.

/help

Muestra este mensaje.

Parámetros opcionales

(normalmente definidos dentro de config.xml)

/base:<path>

Establece el path local/remoto para localizar los ficheros .xml de entrada. También puede ser una dirección de internet con formato URL desde donde recuperar directamente los ficheros XML para un entorno wpkg_web.

/dryrun

No ejecuta ninguna acción. Asume /debug.

/quiet

Usa la log de eventos para guardar todos los mensajes de estado/errores. Utilizar este comando en ejecuciones desatendidas.

/nonotify

No notifica al usuario que ha accedido de las actualizaciones pendientes de realizar.

/noreboot

El equipo no se reiniciará a menos que sea necesario.

/quitonerror

Iterrumpe la ejecución si si la instalación de uno cualquiera de los paquetes no es satisfactoria (por defecto: Instala el siguiente paquete y anota un mensaje de error).

Parámetros ráramente utilizados

(principalmente para testeos)

/config:<path>

Path del fichero de configuración a utilizar. El path puede ser absoluto o relativo, pero debe incluir el nombre del fichero XML. Este argumento es generalmente opcional, y normalmente no debería utilizarse nunca. Si no se indica, el fichero de configuración será buscado en:

   <script-path>\config.xml 

donde <script-path> es el directorio desde el que será ejecutado el script. P.e.:

   '\\server\share\directory\config.xml'. 
   'directory\config.xml'. 

/debug or /verbose

Habilita la salida para operaciones de debug. Tenga en cuenta, que este parámetro solo influye en el sistema donde generar las notificaciones. No afecta al nivel de log. Es posible guardar mensajes de log sin utilizar este argumento.

/force

Forzar la realización de las acciones (ignorando las comprobaciones realizadas automáticamente por wpkg.xml).

/forceinstall

Fuerza la instalación de los paquetes existentes.

/host:<hostname>

Use the specified hostname. This option is for testing puropses to test if a given hostname gets the correct profile assigned.

/ignoreCase

Disable case sensitivity of packages and profiles. Therefore you can assign the package 'myapp' to a profile while only a package 'MyApp' is defined within the packages.

Note that this change requires modifying of the package/profile/host nodes read from the XML files. All IDs are converted to lowercase.

Note: This requires converting all profile/package IDs to lowercase. Therefore you will see only lowercase entries within the log files and also within the local package database.

/logfilePattern:<pattern>

Pattern for log file naming. Recognized patterns:

[HOSTNAME]  replaced by the executing hostname 
[PROFILE]   replaced by the  name 
[YYYY]      replaced by year (4 digits) 
[MM]        replaced by month number (2 digits) 
[DD]        replaced by the day of the month (2 digits) 
[hh]        replaced by hour of the day (24h format, 2 digits) 
[mm]        replaced by minute (2 digits) 
[ss]        replaced by seconds (2 digits) 

Example:

'wpkg-[YYYY]-[MM]-[DD]-[HOSTNAME].log' 

results in a name like 'wpkg-2007-11-04-myhost.log' NOTE: Using [PROFILE] causes all messages before reading or profiles.xml to be temporarily written to local %TEMP% folder. So they might appear on the final log file with some delay.

/logLevel:[0-16]

Level of detail for log file. Log level is defined as a bitmask. Just sum up the values of each log severity you would like to include within the log file and add this value to your config.xml or specify it at /logLevel:<num>.

 0  disable logging. 
 1  log errors only 
 2  log warnings 
 4  log information 
 8  log audit success 
16 log audit failure 

Examples:

31 log everything (1+2+4+8+16=31  Bits: 00011111) 
13 logs errors, information and audit success (1+4+8=13  Bits: 00001101) 
 3 logs errors and warnings only (1+2=3  Bits: 00000011) 

Default is 0 which will suppress all messages printed before log level is properly initialized by config.xml or by /logLevel:<#> parameter.

/log_file_path:<path>

Path where the log files will be stored. Also allows specifying an UNC path (e.g. '\serversharedirectory'). Make sure the path exists and allows write for the executing user.

NOTE: If you set this parameter within config.xml please note that you need to escape backslashes, e.g.

'\\\\server\\share\\directory'. 

/noforcedremove

Do not remove packages from local package database if remove fails even if the package does not exist in the package database on the server and is not referenced within the profile. By default packages which have been removed from the server package database and the will be uninstalled and then removed from the local package database even if uninstall failed.

This has been introduced to prevent a package whose uninstall script fails to repeat its uninstall procedure on each execution without the possibility to fix the problem since the package (including its uninstall string) is available on the local machine only.

HINT: If you like the package to stay in the local database (including uninstall-retry on next boot) just remove it from the profile but do not completely delete it from the package database.

/norunningstate

Do not export the running state to the registry.

/profile:<profile>

Forces the name of the current profile. If not specified, the profile is looked up using hosts.xml.

/rebootcmd:<option>

Use the specified boot command, either with full path or relative to location of wpkg.js. Specifying 'special' as option uses tools\psshutdown.exe from www.sysinternals.com - if it exists - and a notification loop.