Descripción de Propiedades de Claves de Licencia

Las Ediciones Profesional y Estándar del Java Service Wrapper son activadas a través de la configuración de la Clave de las Licencias. Es necesario que las Claves de las Licencias sean configuradas en la sección de Propiedades de la Clave de cada Licencia y que sean incluidas en el archivo de configuraciones del Wrapper.

Lista de Propiedades de la Clave de cada Licencia

A continuación cada una de las propiedades de la Clave de cada Licencia estan explicadas en detalle (Clave de una Licencia para Servidor, Clave de una Licencia de Desarrollo).

  • wrapper.license.debug
  • wrapper.license.dev_application
  • wrapper.license.features
  • wrapper.license.host_id
  • wrapper.license.id
  • wrapper.license.key.<n>
  • wrapper.license.lease_term.begin_date
  • wrapper.license.lease_term.end_date
  • wrapper.license.licensee
  • wrapper.license.type
  • wrapper.license.upgrade_term.begin_date
  • wrapper.license.upgrade_term.end_date

¿Tiene dudas?:

Si experimenta algún problema con su licencia, por favor configure la propiedad wrapper.license.debug y habilite Depuración del archivo de inclusión. De esta manera la mayoría de los problemas más comunes durante la configuración serán detectados.

Descripción de las Propiedades de la Clave de una Licencia para Servidor

Las Claves de las Licencias para Servidor consisten en un conjunto de propiedades las cuales son colocadas directamente en el archivo de configuración "wrapper.conf" o incluidas usando un archivo de configuraciones en cascada. La Clave de la Licencia está ligada a una máquina específica usando el host id especificado en la Clave de la Licencia.

El host id de cualquier servidor puede ser obtenido al ejecutar el Wrapper binario con el parámetro '-h' desde la línea de comandos(shell) o el Símbolo del sistema. Esto dará como resultado la siguiente salida de datos.

Ejemplo de Salida de Datos: 
Java Service Wrapper Professional Edition nn-bit n.n.n
  Copyright (C) 1999-20nn Tanuki Software, Ltd. All Rights Reserved.
    http://wrapper.tanukisoftware.com

The Java Service Wrapper requires a License Key to activate the
software.  Licenses can be purchased on the Java Service Wrapper
web site:
  https://wrapper.tanukisoftware.com/purchase

You can also immediately obtain a one-month Free trial license:
  http://wrapper.tanukisoftware.com/trial

License Keys can be generated for the following HostId:
  HostId #1:   00123456789a
  HostId #2:   00123456789b

You may include license keys for several servers within a single file by
  prefixing the property names of each key with their respective
  server host name or HostId. Please use the following syntax:
  wrapper.<hostname|hostid>.license.*.
  The host name of this machine is: myhost

Cualquiera de los host ids que se muestran pueden ser usados para generar la Clave de una Licencia.

Ejemplo de una Clave de Licencia para Servidor: 
wrapper.license.type=NODE
wrapper.license.id=200804010006
wrapper.license.licensee=Acme, Inc.
wrapper.license.host_id=00123456789a
wrapper.license.features=pro, 64bit
wrapper.license.upgrade_term.begin_date=2008-04-01
wrapper.license.upgrade_term.end_date=2009-04-01
wrapper.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.license.key.2=007d-7e3c-5e2a-427e
wrapper.license.key.3=ce16-f5f0-59f4-d18a
wrapper.license.key.4=b6ca-c31a-6be8-323d

  • El ".type" siempre será 'NODE' para Claves de Licencias para Servidor.

  • La ".id" es usada para identificar de manera única la Clave de la Licencia la cual aparecerá en su página de Administrar Licencia.

  • El valor de ".licensee" será desplegado en la consola y en el archivo wrapper.log cada vez que el Wrapper sea lanzado. En caso específico la Clave de la Licencia que se muestra en la parte de arriba, la salida de datos del Wrapper sería como a continuación se muestra: 

    Java Service Wrapper Professional Edition nn-bit n.n.n
  Copyright (C) 1999-2009 Tanuki Software, Ltd.  All Rights Reserved.
    http://wrapper.tanukisoftware.org
  Licensed to Acme, Inc.

  • El ".host_id" identifica un servidor en el cual el Wrapper será autorizado para ser ejecutado.

  • Las ".features" son usadas para describir la edición autorizada del Wrapper. En este caso "64-bit Edición Profesional" esta autorizada. Esto también permitirá que versiones menores por ejemplo "32-bit Edición Estándard del Wrapper " sean ejecutadas.

  • El ".upgrade_term.begin_date" y ".upgrade_term.end_date" especifican las fechas en la que la Clave de la Licencia del Wrapper será autorizada para ser usada. La licencia en la parte de arriba autorizará la descarga de versiones del Wrapper que han sido liberadas antes de esta fecha 2009-04-01. Las versiones liberadas del Wrapper que se encuentren dentro del término de actualización estarán autorizadas para ser descargadas y para ser ejecutadas incluso después de que el término de actualización haya terminado.

  • Otra opción relacionada con el término de arrendamiento puede ser desplegado en algunas Claves de Licencias de prueba. Estas claves tienen las fechas específicas del tiempo en el cual se podrá ejecutar el Wrapper. Una vez que dicho arrendamiento haya expirado, ya no será posible hacer uso del Wrapper.

  • Estos valores ".key.1-4" son usadas para validar el resto de las propiedades de la licencia.

NOTA

Los valores de las propiedades de la Clave de la Licencia son únicos y la licencia no funcionará para autorizar el Wrapper si alguno de dichos valores fuese modificado en cualquier aspecto.

Es posible incluir las Claves de Licencias para múltiples servidores en un solo archivo, al incluir los nombres de los "host names" en la propiedad de la Clave de la Licencia. En el siguiente ejemplo se muestra una Clave de Licencia con el nombre 'nombredemiequipo'. También es posible cambiar la parte del "host name" de las propiedades de la Clave de la Licencia sin la necesidad de volver a generar otra Clave. 

wrapper.myhost.license.type=NODE
wrapper.myhost.license.id=200804010006
wrapper.myhost.license.licensee=Acme, Inc.
wrapper.myhost.license.host_id=00123456789a
wrapper.myhost.license.features=pro, 64bit
wrapper.myhost.license.upgrade_term.begin_date=2008-04-01
wrapper.myhost.license.upgrade_term.end_date=2009-04-01
wrapper.myhost.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.myhost.license.key.2=007d-7e3c-5e2a-427e
wrapper.myhost.license.key.3=ce16-f5f0-59f4-d18a
wrapper.myhost.license.key.4=b6ca-c31a-6be8-323d

Alternativamente, a partir de la versión del Wrapper 3.3.2, es posible usar los mismos hostIds desde la propiedad de nombres de la Clave de la Licencia. Esto hace posible definir más de una Clave para un solo anfitrión. Un ejemplo en donde esto se necesita es en un sistema que usa una descarga balanceada de tarjeta de red en donde el HostId cambia dependiendo de la tarjeta física actual de tipo subyacente. 

wrapper.00123456789a.license.type=NODE
wrapper.00123456789a.license.id=200804010006
wrapper.00123456789a.license.licensee=Acme, Inc.
wrapper.00123456789a.license.host_id=00123456789a
wrapper.00123456789a.license.features=pro, 64bit
wrapper.00123456789a.license.upgrade_term.begin_date=2008-04-01
wrapper.00123456789a.license.upgrade_term.end_date=2009-04-01
wrapper.00123456789a.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.00123456789a.license.key.2=007d-7e3c-5e2a-427e
wrapper.00123456789a.license.key.3=ce16-f5f0-59f4-d18a
wrapper.00123456789a.license.key.4=b6ca-c31a-6be8-323d

Descripción de las Propiedades de la Clave de una Licencia de Desarrollo

Las Claves de Licencias de Desarrollo consisten en un conjunto de propiedades, las cuales son colocadas directamente en el archivo de configuración "wrapper.conf" o incluidas usando una Configuración de Archivos en Cascada. La licencia está ligada a una aplicación específica usando los valores de la clase principal de la aplicación.

La clase principal de la aplicación es específicada usando la propiedad wrapper.java.mainclass. Si la clase principal es una de las clases auxiliares incluidas con el Wrapper (org.tanukisoftware.wrapper.WrapperSimpleApp o también org.tanukisoftware.wrapper.WrapperStartStopApp) entonces la clase principal será especificada usando la propiedad wrapper.app.parameter.1. En cualquier caso la licencia autorizará el Wrapper solo si la clase principal permanece sin cambio alguno.

Ejemplo de una Clave de Licencia de Desarrollo: 
wrapper.license.type=DEV
wrapper.license.id=200804010003
wrapper.license.licensee=Acme, Inc.
wrapper.license.dev_application=Acme Control Server
wrapper.license.features=pro, 64bit
wrapper.license.upgrade_term.begin_date=2008-04-01
wrapper.license.upgrade_term.end_date=2009-04-01
wrapper.license.key.1=a0a5-b478-ca71-8d59
wrapper.license.key.2=9296-6f2d-0e58-75e6
wrapper.license.key.3=0f5d-2cf2-ad36-54f9
wrapper.license.key.4=b859-dc75-61d7-b0ca

  • El ".type" siempre será 'DEV' para Claves de Licencias de Desarrollo.

  • La ".id" es usada para identificar de manera única la Clave de la Licencia la cual aparecerá en su página de Administrar Licencia.

  • El valor de ".licensee" y ".dev_application" serán desplegados en la consola y en el archivo wrapper.log cada vez que el Wrapper sea lanzado. En caso específico de la Clave de la Licencia que se muestra en la parte de arriba, la salida de datos del Wrapper sería como a continuación se muestra: 

    Java Service Wrapper Professional Edition nn-bit n.n.n
  Copyright (C) 1999-2009 Tanuki Software, Ltd.  All Rights Reserved.
    http://wrapper.tanukisoftware.org
  Licensed to Acme, Inc. for Acme Control Server

  • Las ".features" son usadas para describir la edición autorizada del Wrapper. En este caso "64-bit Edición Profesional" esta autorizada. Esto también permitirá que versiones menores por ejemplo "32-bit Edición Estándard del Wrapper " sean ejecutadas.

  • El ".upgrade_term.begin_date" y ".upgrade_term.end_date" especifican las fechas en la que la Clave de la Licencia del Wrapper será autorizada para ser usada. La licencia en la parte de arriba autorizará la descarga de versiones del Wrapper que han sido liberadas antes de esta fecha 2009-04-01. Las versiones liberadas del Wrapper que se encuentren dentro del término de actualización estarán autorizadas para ser descargadas y para ser ejecutadas incluso después de que el término de actualización haya terminado.

  • Otra opción relacionada con el término de arrendamiento puede ser desplegado en algunas Claves de Licencias de prueba. Estas claves tienen las fechas específicas del tiempo en el cual se podrá ejecutar el Wrapper. Una vez que dicho arrendamiento haya expirado, ya no será posible hacer uso del Wrapper.

  • Estos valores ".key.1-4" son usadas para validar el resto de las propiedades de la licencia.

    A partir de la versión del Wrapper 3.3.6, Es posible ocultar el término de actualización en un quinto valor de la Clave. Esto puede ser de gran ayuda para evitar que sea visible la validez del término de actualización de un producto software a clientes de algún proveedor. Por la misma razón que se oculta dicho término de la Clave de la Licencia, puede ser un poco más difícil de dar soporte a usuarios que deseen actualizar el Wrapper por si mismos. Cuando un Wrapper binario sea más nuevo que el término de actualización lo permite, se generará un mensaje de error. Este mensaje incluirá la fecha de finalización del término, esto podría ser un pequeño problema

    La característica del término de actualización oculto puede accederse al descargar un Clave de Licencia nueva o con una que ya exista.

Ejemplo de una Clave de Licencia de Desarrollo: 
wrapper.license.type=DEV
wrapper.license.id=200804010003
wrapper.license.licensee=Acme, Inc.
wrapper.license.dev_application=Acme Control Server
wrapper.license.features=pro, 64bit
wrapper.license.key.0=ada5-ac8d-6f2d-54f9
wrapper.license.key.1=a0a5-b478-ca71-8d59
wrapper.license.key.2=5296-6d2d-0e58-79e6
wrapper.license.key.3=6f5d-acf2-3d36-64f9
wrapper.license.key.4=c859-dcf5-61d7-b8ca

NOTA

Los valores de las propiedades de la Clave de la Licencia son únicos y la licencia no funcionará para autorizar el Wrapper si alguno de dichos valores fuese modificado en cualquier aspecto.

Archivo de la Licencia en el Archivo de Configuraciones en Cascada

Siempre es bueno colocar las propiedades de la Clave de la Licencia del Wrapper en un archivo diferente a wrapper.conf. Esto es muy fácil de llevar a cabo haciendo uso las funcionalidades del archivo de configuración del "Archivo de inclusión" (en estilo cascada).

Se le sugiere que las propiedades de la Clave de Licencias sean colocadas en un archivo por nombre wrapper-license.conf, localizado en el mismo directorio al del archivo wrapper.conf. El archivo de la licencia es entonces incluido al colocar una línea como la que a continuación se presenta en la parte superior del archivo wrapper.conf: 

#include ../conf/wrapper-license.conf

Tome en cuenta que la ruta del "Archivo de inclusión" es relativa a la ubicación del Wrapper binario y no a la ubicación del archivo wrapper.conf. Vea la sección sobre Configuración de Archivos en Cascada ("Archivo de inclusión") Para más detalles y consejos en este tema por favor visite ¿Cómo llevar a cabo una depuración de problemas con Archivo de inclusión?.

Una manera simple de administrar una gran número de archivos de licencias, el Wrapper puede ser configurado para cargar los archivos de las licencias en los host anfitriones. Esto hará que la distribución de todos los archivos de las licencias se haga a todos los servidores. 

#include ../conf/wrapper-license-%WRAPPER_HOST_NAME%.conf

¿Tiene dudas?:

Si experimenta algún problema con su licencia, por favor configure la propiedad wrapper.license.debug y habilite Depuración del archivo de inclusión. De esta manera la mayoría de los problemas más comunes durante la configuración serán detectados.

License file in Cascading Configuration File

It is often desirable to place the Wrapper License Key properties in a file other than the wrapper.conf. This can be done easily by making use of the "include file" (cascading style) functionality of Configuration files.

It is suggested that the License Key properties be placed in a file called wrapper-license.conf, located in the same directory as the wrapper.conf file. The license file is then included by placing a line like the following at the top of your wrapper.conf file: 

#include ../conf/wrapper-license.conf

Note that the include file path is relative to the location of the Wrapper binary and NOT the wrapper.conf file. See the section on Cascading Configuration File ("include file") for further details and advice on how to debug problems with include files.

To make it simple to manage large numbers of license files, the Wrapper can be set up to load in license files based on the host names. This makes it possible to deploy all license files to all servers. 

#include ../conf/wrapper-license-%WRAPPER_HOST_NAME%.conf

Problems?

If you encounter any licensing problems, please set the wrapper.license.debug property and enable include file debugging. In combination, most configuration problems become obvious.