Configuración Desde la Línea de Comandos

El Wrapper permite establecer cualquier propiedad de configuración desde la línea de comandos. Esto puede ser útil en situaciones en las que los valores de configuración solo se pueden establecer en tiempo de ejecución. Un ejemplo se puede ver observando el script de shell (sh) incluido con el Wrapper.

Las propiedades de configuración se pueden establecer en la línea de comandos incluyéndolas después de que se cargue el archivo de configuración cuando se inicia el Wrapper. Cada propiedad consiste en la formación como "un nombre de propiedad = el valor de la propiedad". La sintaxis es exactamente la misma que en el archivo wrapper.conf.

Ejemplo :

En este ejemplo, se está iniciando una aplicación Java usando el Wrapper con el registro de depuración habilitado.

Windows NT/2000:
wrapper.exe -c ..\conf\wrapper.conf wrapper.java.command=java wrapper.debug=TRUE
Linux / Solaris:
./wrapper ../conf/wrapper.conf wrapper.java.command=java wrapper.debug=TRUE

Prioridad :

Las propiedades establecidas en la línea de comandos tienen prioridad sobre otras propiedades predeterminadas, y anularán cualquier valor de propiedad predeterminado establecido en el archivo de configuración o en cualquier "archivo de inclusión" (estilo en cascada).

Las propiedades se pueden especificar desde la línea de comandos al usar cualquiera de los comandos del Wrapper, incluido el comando -i, utilizado para instalar la aplicación como un servicio en sistemas Windows.

Al ejecutar el Wrapper y su JVM como una aplicación de consola usando el comando -c, las propiedades especificadas anularán cualquier valor en el archivo wrapper.conf y se usarán al iniciar la JVM.

Del mismo modo, el comando -i, que se usa para instalar el Wrapper como un servicio, recordará las propiedades especificadas y luego las usará más tarde cuando el servicio se inicie realmente. Del mismo modo, las propiedades especificadas se usarán para anular valores en el archivo wrapper.conf al instalar el servicio.

Todos los demás comandos harán uso de las propiedades de la línea de comandos para anular valores en el archivo de configuración. Estas afectarán el registro o la forma en que se hace referencia al servicio. No tendrán ningún efecto en la JVM en ejecución. No es posible, por ejemplo, pasar un valor de propiedad a un servicio al iniciarlo con el comando -t, por ejemplo.

Espacios entrecomillados:

NOTA

Las propiedades especificadas en la línea de comandos no pueden contener espacios sin entrecomillar. Si necesita incluir espacios en el valor de la propiedad, simplemente incluya el par completo de "nombre de propiedad y valor" entre comillas:

Ejemplo (incluir espacios sin entrecomillar):
wrapper.exe -c ..\conf\wrapper.conf "wrapper.java.command=C:\My App\jre\bin\java.exe"

Entrecomillado en Windows:

NOTA

Al entrecomillar valores de ruta en Windows, tenga en cuenta un problema con la forma en que Windows analiza los valores entrecomillados. Trata todas las barras invertidas en el valor entrecomillado de forma normal EXCEPTO una barra invertida final. En el siguiente ejemplo, verá que la barra invertida final está escapando la propia comilla, lo que resulta en que se pasen argumentos no deseados al Wrapper.

Ejemplo:
wrapper.exe -c ..\conf\wrapper.conf "wrapper.working.dir=C:\" wrapper.debug=TRUE"

La operación prevista es llamar al Wrapper con los argumentos ( [-c], [..\conf\wrapper.conf], [wrapper.working.dir=C:\], y [wrapper.debug=TRUE]). Sin embargo, lo que realmente ocurre es que la segunda comilla se escapa, lo que resulta en los siguientes 3 argumentos; [-c], [..\conf\wrapper.conf], [wrapper.working.dir=C:" wrapper.debug=TRUE].

La primera solución es no tener nunca una barra invertida final. Sin embargo, esto no es posible con el ejemplo "C:\" anterior. Otra buena solución que encontramos es añadir un punto final después de la barra invertida. Esto resulta en un directorio "C:\.", que tiene el mismo significado que "C:\" pero que Windows analiza correctamente.

Ejemplo:
wrapper.exe -c ..\conf\wrapper.conf "wrapper.working.dir=C:\." wrapper.debug=TRUE"

Referencia: Iniciar su Aplicación con el Wrapper