Difference between revisions of "WPKG flags:sp"

Revision as of 10:23, 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)

Frequently used parameters

(package operations, you need to chose one)

/install:<package>

Installs the specified package on the system.

/query:<option>

Displays a list of packages matching the specified criteria. Valid options are:

    a - all packages
    i - packages that are currently installed on the system
    x - packages that are not currently installed on the system
    u - packages that can be upgraded 

/remove:<package>

Removes the specified package from the system.

/show:<package>

Displays a summary of the specified package, including it's state.

/upgrade:<package>

Upgrades the already installed package on the system.

/synchronize

Synchronizes the current program state with the suggested program state of the specified profile. This is the action that should be called at system boot time for this program to be useful.

/help

Shows this message.

Optional parameters

(usually defined within config.xml)

/base:<path>

Sets the local or remote path to find the xml input files. Can also be set to a web URL for direct XML retrieval from wpkg_web.

/dryrun

Does not execute any action. Implicites /debug.

/quiet

Uses the event log to record all error/status output. Use this when running unattended.

/nonotify

Logged on users are not notified about impending updates.

/noreboot

System does not reboot regardless of need.

/quitonerror

Quits execution if installation of any package was unsuccessful (default: install next package and show the error summary).

Rarely used parameters

(mainly for testing)

/config:<path>

Path to the configuration file to be used. The path might be absolute or relative but including the XML file name. This parameter is entirely OPTIONAL and should normally not be specified at all. If not specified the configuration will be searched at:

   <script-path>\config.xml 

where <script-path> is the directory from which the script is executed.e.g.

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

/debug or /verbose

Enables debug output. Please note that this parameter only influences notification and event log output. It does not affect the logging level. It is possible to get debug-level output even without using this switch.

/force

Uses force when performing actions (does not honour wpkg.xml).

/forceinstall

Forces installation over existing packages.

/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.